Repository navigation
[收尾] 后端改造完成后简化真实部署与使用，并按新接口重写 README/API 文档 #2189
Description
Written-by: Codex
用户要求与执行时机
现有 README 部署/使用步骤太复杂，接口说明不够清楚。应按 2026-11-02 已确认的后端对象与命令/查询/事件契约刷新。
用户明确要求：先记录 issue，本需求等后端改造完成后再实施。 不提前改 README、不先做临时工具/文档过渡方案，不自动领取或中断当前前端工作。
前置依赖
- [设计] 将个人代理独立为用户级对象，支持内置与外接代理参与 Project #2170/[设计] 统一用户与个人代理的身份、项目参与及授权契约 #2183 独立个人代理、身份与授权
- [设计] 明确 Project 边界：仓库多对多、Owner 二次确认关闭并保留最终记录 #2171 Project 与角色治理
- [设计] 明确角色协作协议：持久化 Handoff、咨询分离、打回续接与个人代理优先 #2175 咨询与持久化 Handoff
- [设计] 统一 Chief 与工作角色的上下文预算、长期记忆整理及会话恢复机制 #2177 上下文预算与长期记忆
- [设计] 收敛 Task 对象与生命周期：Chief 接纳、单线交接、并行子任务及恢复验收 #2179 Task、子任务、接纳与裁定
- [设计] 收敛 Project 状态更新与持久化：确定性事件、按需摘要及 SQLite 迁移 #2182 状态更新、SQLite 与迁移
- [设计] 收敛执行服务生命周期与 Harness／Resource／Session 绑定及恢复 #2184 执行生命周期和 Harness/Resource/Session
- [设计] 统一后端命令、查询和事件接口，支持 SSE 游标恢复与代理接入 #2185 统一命令/查询/API 与事件
- [设计] 保留个人空间并兼容个人 Chief、群聊、公共 Bot 与既有任务迁移 #2186 个人空间、既有能力兼容及数据迁移
在上述后端改造完成、最终实际接口与部署方式稳定后开展本单。文档依据最终代码和验证结果，不机械照抄设计语义名或把 issue 当作已经实现。
1. 简洁且真实的后端部署使用路径
- README 面向新使用者，提供最短的获取、配置、启动、登录、首次查询/咨询和首个开发任务步骤，不要求复制大段 Bash/Python 函数。
- 应支持部署持久化的真实后端服务：明确前置依赖、最少必填配置、数据目录、服务地址、账号初始化、模型/Harness 登录及仓库授权；能正常停止、重启、备份、升级和恢复。
- 若仍需控制台命令或部署入口，复用并整理实际发行/启动能力；缺少必要打包/启动能力时先拆实施依赖，不能靠文档声称已有。
- 临时、确定性 fixture 演示单独说明，不得冒充可持久化的真实 Codex 开发部署。
- 账号服务尽量复用现有 control-plane，无需操作其管理 UI；不要求用户修改 control-plane。
- 密码/Token 等不硬编码、不写入仓库或示例日志。不得写成本机私有路径、固定 Project ID、既有演示账号才可跑通。
- 单独放高级运维、恢复、排障及开发验证，不挤进 README 快速开始。
- 原版 FlyBot 个人 Chief、群聊和公共 Bot 等能力保留清楚导航；避免同时展示多套互相冲突的入口。
2. 按最终新接口重写参考
按 User/PersonalAgent、Project、Role、Task、Handoff、Consultation、Execution/Session/Resource 组织。
每个实际接口清楚给出：
- 用途、调用主体、权限与前置条件；
- 方法/路径或真实命令名、版本、参数 schema/必填项；
- 返回结构、状态语义、可复制请求与响应示例；
- 幂等键、版本/代次冲突、分页/游标、错误和恢复方式。
明确区分： - 咨询与任务主动权交接；
- 已提交、已入池、已接手、已执行、Chief 已裁定完成；
- Task/Attempt/Session、单线执行与并行子任务/父任务恢复；
- 正式项目事实、派生概览、按需摘要与项目定位变更；
- 代码自动更新与必须由 Chief/治理主体判断的节点。
事件接口给出实际 SSE 订阅、断线补取、过期游标、去重及权限行为。已弃用旧接口说明兼容/迁移；未实现能力明确标注，不能提供虚构可执行示例。
README 无需提及 SuperAgent。
验收
- 使用独立环境，从 README 的最短路径启动真实持久服务；登录、首次查询、咨询与项目任务流程可跑通。
- 重启后 Project/Task/Session/授权等按契约保留；敏感信息不出现在公开产物。
- 自动核对示例 JSON、Shell/CLI 语法、本地链接及接口目录与实际路由/schema 一致。
- 以实际 HTTP/CLI 回归覆盖登录、权限/撤权、查询、咨询、Task 接纳与交接、子任务恢复及错误；区分替身测试和真实 SDK/GitHub 验证。
- 同步长期记忆、架构/子系统文档、迁移/运维说明和变更记录。
- 报告准确提交、执行项和未验证范围；不借用旧代码测试证明新契约。
- 不把文档交付等同于生产部署授权，不擅自重启现有服务或中断健康执行。
当前处理
本轮提前开始的 README/接口文档与辅助启动/调用工具仅为未提交修改，将撤回；没有推送、部署或改动 control-plane。后续从最终后端状态实施本单。
Activity
zy95-12 commentedon Nov 3, 2026
Written-by: Codex
用户已授权逐issue实施。前置后端组合当前为#2285（a9662418b，基于#2250；完整4720项通过，0失败/跳过）。本会话现开始本issue，使用独立feat/2189-backend-quickstart分支/一个PR；未发现本issue的既有独立实现PR、其他assignee或认领评论。
先复用现有DSH/FlyBot发行、持久数据与账号入口，补真实服务启动/调用的最短路径，再按实际对象/命令/查询/事件刷新README和详细文档。确定性模型仅作隔离验证，不充当部署形态。不读取/发布现有实例凭证，不改control-plane，不重启现有服务或前端流程；不新增worker/巡检定时器。
zy95-12 commentedon Nov 3, 2026
Written-by: Codex
实现PR：#2289，head
d720f8cced5b09d79123e979de1d448584b94fb6，basefeat/2186-native-compatibility。本批11个issue均有独立PR，按依赖堆叠在交付分支上，没有合入main或部署现有实例。最终分支完整
TZ=UTC npm run verify：4726通过、0失败、0跳过。包含6个真实DSH运行场景，以及直接启动生产入口的DSH/SQLite HTTP/CLI回归；推理使用确定性测试供应商。另有独立新home正常安装器→启动→登录→Project/Task→停止→重启→原回执重放9项验证，明确不把这些算成真实模型自主开发。README已缩为真实持久服务init/start/login和首次调用；详细文档按对象组织全部24查询/26命令、权限/幂等/分页/SSE/迁移。原个人Chief/群聊/公共Bot及原版指南保留，长期记忆/架构/测试/变更记录同步。实际HTTP验收修复外部安全提案impact/scope丢失；服务只在真实Store可写后发布ready。旧历史里程碑原文归档，未抬高384k规则预算或删减当前约定。
所有PR保持Draft：尚无独立Reviewer结论；新入口上的完整真实供应商Dev/Tester/Reviewer/Chief闭环、远程HTTPS、浏览器/桌面和生产迁移/上线仍须分别验收。现有服务、前端流程及control-plane均未修改/重启；没有新增worker或Chief框架巡检定时器。
Add Project boundaries and approved role governance (#2191)
Separate personal-agent identities from Project participations (#2192)
Authenticate scoped personal-agent connections with existing delegati…
Expose durable handoff contracts and separate private consultations (#…
Bound Chief and Task-role context, preserve scoped memory and work su…
Add Chief admission and resumable child waits to Project Tasks (#2226)
Persist Project state and Effects with guarded SQLite migration (#2227)
Unify command recovery, bounded queries and committed Project SSE (#2250
Preserve original FlyBot capabilities across Project task cutover (#2285
Provide persistent backend deployment and current object API guides (#…
zy95-12 commentedon Nov 3, 2026
按 Owner 要求阶段关单：对应 PR #2289 已 squash 合入
delivery/ai-centric-development-service，合并提交f95946fce81ad020cb6dd568c34efe9eb5d2f5be。最终集成提交
f95946fce81ad020cb6dd568c34efe9eb5d2f5be的完整文件树与已通过 4726 项完整验证的源码d720f8cced5b09d79123e979de1d448584b94fb6完全一致。所有已确认功能缺口和未完成的真实任务/运行验收统一迁移至 #2292，继续保持 open。本次关闭表示已实现部分的阶段归档，不表示本 issue 原有所有验收项均已完成；不修改未验证的 checklist。未部署或重启服务。