# NewAPI 运营项目

这是一个面向国内用户的 NewAPI 与酒馆服务长期运营项目。项目用 Markdown 文件管理事实、决策、任务和交接，让多个 AI Agent 可以围绕同一个事实源协作。

## 当前结论

| 主题 | 当前判断 | 证据状态 |
| --- | --- | --- |
| 服务器规格 | 优先 `4C4G`，最低 `2C2G`，暂不需要 `8C8G` | 基于 NewAPI/酒馆资源需求判断，待部署压测验证 |
| 网络方向 | 优先三网优化线路，重点看晚高峰和流式稳定性 | 待继续补充官方资料、论坛反馈和实测 |
| OVH | 不默认作为国内主入口，更适合源站、备份、大盘、抗 D | 已形成初步判断，需在 `decisions.md` 追溯 |
| 部署形态 | NewAPI + PostgreSQL/MySQL + Redis + Nginx/Caddy，同机起步 | 待运维方案细化 |
| 协作方式 | 文件制单一事实源 + Todo 分派 | 已作为项目默认 |

## 目录导航

- `AGENTS.md`：所有 Agent 必读的项目工作规范。
- `task_plan.md`：长期阶段计划。
- `findings.md`：事实、来源、命令和证据等级。
- `progress.md`：每次工作的流水记录。
- `decisions.md`：重要决策和复查条件。
- `todos.md`：手动 Todo 队列，CC-Panes 不可用时使用。
- `服务器选购/`：供应商、线路、套餐、测试 IP、购买建议。
- `上游比价/`：模型上游、中转渠道、价格、稳定性和风控。
- `成本核算/`：月成本、不同规模预算、盈亏线。

## 新 Agent 快速开始

1. 读取 `AGENTS.md`，确认工作规则。
2. 读取 `task_plan.md`，确认当前阶段。
3. 读取 `findings.md` 和 `decisions.md`，不要重复已经验证或否定的路线。
4. 读取相关专题目录的 `README.md`。
5. 在 `todos.md` 中认领任务，或按用户要求执行指定任务。
6. 完成后更新 `progress.md`；如有事实或路线变化，同步更新 `findings.md` 或 `decisions.md`。

## 下一步

1. 补齐服务器候选的证据：官网套餐、购物车状态、测试 IP、线路说明、论坛反馈。
2. 形成首批采购短名单：主入口、备选入口、源站/备份方案。
3. 写出 NewAPI + 酒馆的最小部署方案和验收脚本。
4. 建立成本模型：小规模、增长期、冗余期三档。
5. 购买前做 24-48 小时压测验收清单。

## 禁止事项

- 不在文档中保存密钥、账号密码、Cookie、付款信息或真实用户隐私。
- 不把搜索摘要、论坛传闻、商家宣传直接写成最终事实。
- 不让多个 Agent 并行修改同一文件。
- 不为了未来可能需要的功能提前引入复杂系统。