skycurtain
e4d25526f3
- 需求清单：独立计费平台定位，R1-R15 全部定案（12 项裁决 + R10 裁撤 + R3/R4 延后），裁决档案含访问主体模型（作者登录体系 + 成员长期令牌）、分摊哲学（平台不做价值判断只提供事实服务）、双形态交付（完整前后端先行，CFW 抽取版后续） - 数据模型定稿（一表一文档）：api_keys（16 列，401 状态机裁撤——引擎记录不决策）/ usage_logs（25 列，billing_source 与 subscription_id 提列，非消费行去重含 content 指纹）/ payments（币种无关支付记录，只存事实）/ qpu_history（按日志时刻取值）/ members（成员实体与长期令牌）/ users（空库双通道初始化与重置）/ sessions（服务端会话，否决 JWT） - 接口参考：NewAPI-接口范围融合字段级实证，定位 docs/references/（计费平台可用接口参考，唯一上游参考） - README / AGENTS：新版设计语境（项目沿革、重开设计动因、协作约定、文档自立原则）
2.4 KiB
2.4 KiB
AGENTS.md
给 AI 协作者的仓库指引。开始任何工作前，先读 README.md——它是全景入口：项目是什么、为什么长这样、走到哪了。
协作约定（长期有效）
- Git：仅当项目作者明确说"提交 / commit"时才执行提交；
git push永远由项目作者手工执行，AI 绝不推送 - 命名：需求 / 设计 / 交互 / 技术 / 计划等文档名用中文（
README/AGENTS/LICENSE等约定俗成除外）、目录用英文；新文档按性质放入docs/design/（我们定的方案与决策）或docs/references/（平台可用接口参考——实证事实，不做设计决策），并同步更新 README 的「文档地图」；docs/deprecated/只归档已废弃文档——勿引用、勿作依据（本分支暂无此目录，需要时再建） - 文档状态：头部表格标「状态」（草案 → 讨论中 → 待审阅 → 定稿(日期) → 已实现）；设计文档定稿后不搬家、只改状态；被取代时删除（git 历史即考古）
- 部署：交付物必须保证「一条命令链」可部署；双形态并行已裁决——完整前后端（运营方服务器）先行，Cloudflare Workers 抽取版（作者自部署）后续（见
docs/design/需求清单.mdR13） - 不引入版本叙事：不使用 v1/v2/v3 之类版本编号，不以「MVP」等标签或指称显式描述任何历史阶段；文档内容必须自立——不得引用、描述任何当前分支之外、可能被删除的分支内容
项目速览（速记）
design（本分支）= 新版设计文档中心，无代码- 数据模型：四张基线表（
api_keys·usage_logs·payments·qpu_history）+ 三张访问主体表（members·users·sessions）设计见本目录，七篇已定稿（2026-10-01，经作者逐篇审阅）；同步架构（轮询 +request_id去重 + 攒库）的动因由上游物理约束决定，架构结论不变 - 需求总集与待裁决项（平台身份体系、费用分摊与账单、充值折算、多订阅、数据资产保护）见
docs/design/需求清单.md；交付形态已裁决（双形态并行，完整形态先行） - 上游约束速记：只有 sk-key、无时间过滤接口 → 轮询攒库是唯一路径（README「架构的根本动因」）
命令
本分支为纯文档分支，无构建 / 测试命令。