Continuity Orchestrator

Pro 支持“@插件 + 项目路径 + 任务”的直接操作链路。 开启 local_access 后，Chat 可根据用户消息中的绝对路径直接读取项目、编写修改，本地自动建立 Git 快照、运行测试并在通过后写回；无需逐项目登记或手动 APPLY。支持非 Git 和有未提交修改的工程，不调用 Codex 或本地模型。接入步骤见 一句话使用指南 与 连续编辑指南。本仓库内的回归证据一律为本地合同证据（Local Contract Evidence），不等同于真实网页或真实账户的端到端验收。

让支持 MCP 的聊天客户端读取你明确共享的本地项目，获取真实源码、行号和搜索结果。基础只读入口不调用 Codex、Claude 或 DSH，不需要 API key 或浏览器驱动。也保留了实验性的 Codex 额度接力实现。

Read explicitly shared local source files from an MCP client, without spending local model quota. The project reader is usable independently of the experimental quota relay.

从项目读取开始

需要 Node.js 22+。在此目录安装依赖、构建，将示例复制为本机配置，修改项目根路径与允许共享的目录：

npm ci --ignore-scripts
npm run build
Copy-Item config/projects.example.json config/projects.local.json
# 编辑 config/projects.local.json 中的 root 与 share
$env:CONTINUITY_PROJECTS_CONFIG = (Resolve-Path config/projects.local.json).Path
npm run reader:check
npm run reader:stdio

STDIO 入口启动后等待 MCP 客户端输入，终端没有欢迎文字是正常现象。客户端配置和网页连接步骤见 项目读取指南。网页 ChatGPT 需要实际可用的 Developer Mode 与 Secure MCP Tunnel 或受保护的 HTTPS MCP 传输；本项目不保证所有 Plus 账户准入。

当前 relay 入口已完成本地合同接线（包括 continuity_task_register 注册账本、continuity_drain 完整排空与 handoff 生成、Bridge worker 受控监督及回滚、continuity_resume_codex 原线程回接与 FileRelayServerStore 跨重启持久化），详见 Plus 模式说明 (2026-09-23)。默认 dry-run 开启、生产接力开关由环境变量门控（如 CONTINUITY_AUTO_DRAIN_ENABLED、CONTINUITY_RETURN_TO_CODEX_ENABLED）。

Related MCP server: agent-mcp-gateway

Plus（接力）模式的当前状态与边界

• 生命周期与终态：CODEX_ACTIVE -> DRAINING -> HANDOFF_READY -> WEB_UNATTENDED_EXECUTING -> WEB_TERMINAL -> RETURN_READY -> CODEX_RESUMED。封闭终态原因仅限 ALL_TASKS_COMPLETED、WEB_QUOTA_EXHAUSTED 与 HUMAN_STOP 三种；普通网络抖动/超时/阶段完成均不是终态。

• 证据边界：当前全部接力证据为本地合同证据（Local Contract Evidence），不代表真实网页或真实账户端到端已通过。Gate D-MOUNT（将生产 Tunnel profile 切换至 Continuity App）仍为待用户明确确认才可执行的动作，当前未执行、未验证。

• 能力门控：REAL_WEBGPT_DRIVE_CAPABILITIES 四项全 false 是刻意且经过单元测试固定的安全决定；生产环境默认不开放未验证的真实 web 传输。

• 刻意未挂载模块：

  • src/web/auto-wakeup.ts：进程内无调度宿主（stdio MCP 服务内 setInterval 计数为 0），其 payload 格式会被真实传输拒绝，且内部引用类型在 MCP schema 边界不可达。

  • src/web/multi-task.ts：纯内存隔离注册表，跨重启无法持久化恢复任务映射，且其项目锁未做持久化。

验证与开源准备

npm run typecheck
npm run test:reader
npm run test:unit
npm run test:integration:mock

test:reader 和 test:pro 包含真实临时文件与 MCP 子进程测试。已有真实网页源码读取证据；网页执行的完成情况应查看日期明确的验收记录，不能由本地测试推断。

本目录尚未建立独立 Git 仓库，private: true 保留以防误发 npm。开源前应选定本项目许可证，确认依赖与上游版权，并从干净的源码导出创建发布仓库；不要发布整个父工作区。个人 evidence/、本机项目配置、账本和浏览器资料均不属于发布产物。旁边的 engineering-bridge 是独立的第三方 MIT 项目。

Experimental Plus lifecycle contract

The experimental Plus relay uses this lifecycle (the independent Pro entry does not load it):

CODEX_ACTIVE -> DRAINING -> HANDOFF_READY -> WEB_UNATTENDED_EXECUTING
              -> WEB_TERMINAL -> RETURN_READY -> CODEX_RESUMED

WEB_UNATTENDED_EXECUTING has EXECUTING, RETRYING, and BLOCKED_WAITING substates. A stage completion, empty ready queue, error, timeout, Codex recovery, or ordinary human message is not terminal. The closed terminal reasons are ALL_TASKS_COMPLETED, WEB_QUOTA_EXHAUSTED, and HUMAN_STOP only. A web-quota terminal is absorbing for its relayEpoch; recovery is recorded as data and cannot resume web execution.

handoff.md is the Markdown source of truth. Its complete remaining_work set is checked by count, task ID, item content, and hash. A sidecar cannot repair a missing or incomplete Markdown handoff.

Commands

npm ci --ignore-scripts
npm run typecheck
npm run test:unit

Tests use temporary directories and do not write a user repository ledger. No package lifecycle scripts are required for installation.

Evidence boundary

Passing unit tests are local contract evidence only. They are not real web, Tunnel, App Server, Bridge, account, or worker evidence; G3/G4/G6/G7 remain 未验证 until their specified real receipts exist. The Plus Admission Test is preserved as user/account evidence, not a universal plan guarantee.

docs/ADR-0004-recovery-and-retention.md records historical recovery decisions. Its acceptance is not proof that all production recovery paths have been implemented or verified.