firstgold/decisions.md

决策记录

本文件记录重要路线选择。每条决策都应包含背景、选项、决定、理由、风险和复查条件。

记录模板

## DEC-YYYYMMDD-序号 - 标题

- 状态：
- 背景：
- 选项：
- 决定：
- 理由：
- 风险：
- 复查条件：

DEC-20260607-01 - 使用文件制单一事实源同步多个 Agent

• 状态：accepted
• 背景：项目将长期覆盖采购、部署、上游、成本、监控和复盘，且会启用多个 AI Agent 并行处理问题。
• 选项：只用文件；只用 CC-Panes；文件 + Todo。
• 决定：采用文件制单一事实源 + Todo 分派。CC-Panes 可用时用工具分派，不可用时用 todos.md 手动维护。
• 理由：Markdown 文件可追溯、可审查、跨会话稳定；Todo 适合分派和状态追踪；两者结合不绑定单一工具。
• 风险：多个 Agent 可能同时修改同一文件。
• 复查条件：如果 CC-Panes 工具稳定可用，且并行任务明显增多，再考虑把 Todo 状态迁移到工具为主、文件为备份。

DEC-20260607-02 - 首轮按 4C4G 规划服务器规格

• 状态：provisional
• 背景：NewAPI 与酒馆服务主要瓶颈预计在国内线路、上游稳定性、数据库和日志，而不是 CPU。
• 选项：2C2G、4C4G、4C8G、8C8G。
• 决定：首轮优先按 4C4G 规划，最低 2C2G，更稳可看 4C8G，暂不按 8C8G 规划。
• 理由：4C4G 对小规模 NewAPI + 数据库 + Redis + 反代更有余量，成本仍可控；8C8G 对当前需求偏高。
• 风险：如果日志量、并发或数据库写入高于预期，4G 内存可能紧张。
• 复查条件：完成实际部署后，用并发 10-30、长输出、日志写入和数据库备份恢复验证资源占用。

DEC-20260607-03 - 不默认选择 OVH 作为国内主入口

• 状态：provisional
• 背景：用户提到国内站长常用 OVH，并提供 OVH KS-2 GRA 大盘服务器信息。
• 选项：OVH 做主入口；OVH 做源站/备份；三网优化 VPS 做主入口。
• 决定：OVH 不默认作为国内主入口，更适合源站、备份、大盘或抗 D；国内主入口优先看三网优化线路。
• 理由：面向国内用户的 NewAPI/酒馆服务更依赖三网访问质量、晚高峰稳定性和流式不断连，而不是大硬盘或海外大带宽。
• 风险：三网优化 VPS 商家质量参差，宣传需实测。
• 复查条件：如拿到 OVH 与三网优化节点的真实国内三网压测数据，再重新比较入口方案。