CO Codex Team OS 开始使用

当前版本 0.17.0

Codex Team OS

一个本地优先的 Codex 操作层，把记忆、任务、并行 claim、数字员工、验收证据和自我迭代放进同一个可追责工作流。

安装教程 查看更新日志

产品截图来自当前 Team Workspace 控制台，展示任务判断、团队状态和证据面板。

系统介绍

不是一个更花的面板，而是一套交付纪律。

Codex Team OS 解决的是跨会话、跨窗口、跨任务的连续性问题。它把本来散落在聊天记录里的项目事实，沉淀成可读、可验证、可协作的文件层。

当前用户请求永远优先；项目规则、团队规则和个人偏好依次生效。每次写入前先 claim 路径，完成后用验收和 handoff 收口。

01 Local-first

状态默认留在仓库和本机，云端只是可选的协作镜像。

02 Claim before edit

多窗口写作以路径 claim 协调，冲突时停下，不靠运气合并。

03 Evidence gated

计划、QA、自测、验收、签收和学习都要留下可追溯证据。

成熟项目能力面

从一个 CLI，长成可运行的团队工作台。

A

记忆与项目上下文

全局记忆、项目记忆、active task、handoff 和本地搜索让新窗口能接住上下文，而不是从聊天历史里猜。

B

任务合同与并行 claim

任务写清目标、风险、验收和回滚；写入前 claim 路径，避免多个 Codex 同时覆盖同一批文件。

C

数字员工与团队循环

Product、QA、CTO、学习等角色不是装饰名词；它们产出计划、验收、签收和复盘证据。

D

Dashboard 与云端协作

本地 dashboard 汇总任务、协作、自动化、风险和证据；云端 hub 已有低成本部署，用于同步受控状态。

使用安装教程

三分钟跑起来，十分钟接入一个真实项目。

下面的命令都在本仓库根目录执行。Codex Team OS 不需要运行数据库，也不把 secret 写进仓库。

1. 查看 CLI 
./bin/codexos help
2. 初始化个人层 
./bin/codexos init-global
3. 初始化项目层 
./bin/codexos init-project /path/to/repo
4. 开始一个任务 
./bin/codexos task new "Ship billing dashboard" /path/to/repo
./bin/codexos task claim "Ship billing dashboard" /path/to/repo --agent codex-window-a --paths app/billing
npm run acceptance
./bin/codexos task release codex-window-a /path/to/repo
版本更新日志

从 55 条运行记录里重建出来的真实演进史。

版本日志来自 .codex-os/evolution/RUN_LOG.jsonl、review packet、handoff、浏览器验收和 git 基线记录。这里记录的不是宣传口号，而是已经落到 CLI、项目文件、dashboard、自动化、云资产和验收脚本里的能力边界。

55运行日志记录
19review / cycle 证据包
7基线与硬化提交
0.5 → 0.17连续可验证版本线
  1. Public Site

    公网展示站与子域名上线

    把 Codex Team OS 从本地项目变成有公网入口、TLS 和部署脚本的产品展示面。

    • Public domainos.panghu123.top 指向现有东京 SWAS，Caddy 同时保留 api.panghu123.top 的 API Broker。
    • Deploy workflowsite:deploy 管理 DNS、上传静态站、重载 Caddy，并把公网资源登记进云资产账本。

    证据：公网 HTTPS curl、API health check、Caddy TLS、浏览器 0 overflow / 0 console error。

  2. Release Notes

    工程化版本日志

    把官网 changelog 从几句摘要升级为按运行记录、review 和验收证据重建的发布账本。

    • Source-backed history从 run log、handoff、review packet 和 git baseline 中提取真实迭代，而不是只写主干能力。
    • Evidence format每条记录都保留交付面、机制变化和验收方式，让系统看起来像持续交付的产品。

    证据：本页面 release ledger、docs/showcase-website.md 内容标准、public deploy。

  3. Live Status

    Live Team Workspace

    把“当前谁在做什么”从静态快照升级为实时工作区状态。

    • 实时状态 API/api/live-status 直接读取 .codex-os/claims 与 ACTIVE_TASK.md，避免 dashboard 误报空闲。
    • 活跃窗口视图首页展示 active writer、任务名称、文件范围数量和 overlap risk，让多窗口协作可见。

    证据：source/published live endpoint、dashboard export/publish、桌面和移动端浏览器验证。

  4. Runtime Guard

    运行时权限与沙箱审计

    让数字员工和自动化不只是“会跑”，而是在本地策略内跑。

    • Runtime profiles员工写入路径、工具权限和上下文类别由 CLI gate 检查，越权 claim 会被拒绝。
    • Sandbox auditruntime sandbox audit 审查 claimed writes、secret/private context 和外部副作用。

    证据：runtime profiles audit、runtime sandbox audit、npm run acceptance。

  5. Feedback Loop

    当前线程反馈自动入队

    修复“用户刚说的问题被当成空队列”的坏体验，让新反馈自动变成可处理任务来源。

    • Feedback promotionfeedback add 默认创建 ready follow-up，heartbeat 不再用空 active task 当作等待借口。
    • Prompt policyself-iterate / heartbeat 提示词明确要求处理当前线程反馈，并保留 claim 与验证边界。

    证据：feedback-to-queue acceptance、handoff passive feedback 修复记录。

  6. Truth Layer

    Idle Truth 与 Freshness 修复

    让“没有活跃任务”这件事可信，不再被已完成 task 指针或过期静态快照污染。

    • Idle active task truthself status、task graph、workspace state 和 live status 不再把 done/archived 指针当当前工作。
    • Cadence-aware freshnesslive status 根据 heartbeat RRULE 计算 freshness window，不再固定用 5 分钟误判 watch。

    证据：idle truth review、freshness acceptance、published live status check。

  7. Architecture

    CLI Registry 与 Exporter 拆分

    从单文件 CLI 继续往工程化内核推进，降低后续功能扩展的耦合。

    • Command registrylib/command-registry.js 接管 top-level command table 和 dispatcher。
    • Dashboard exporterlib/dashboard-exporter.js 接管 data-dir resolution 和 JSON emission。

    证据：CLI registry review、syntax checks、acceptance coverage。

  8. Cloud Memory

    云资产登记与跨会话记忆

    把“另一个对话创建了服务器”这种事实变成项目资产账本，而不是靠聊天记忆碰运气。

    • Asset registry.codex-os/cloud/assets.json 记录香港 hub、东京服务器、月费、预算和保护策略。
    • Audit gatecloud audit-assets 对比登记资产与 live provider inventory，发现未登记资产会失败。

    证据：cloud asset registry review、live audit、dashboard workspace inventory。

  9. Cloud Hub

    云端协作 Hub 与预算 Broker

    Codex OS 不再只是本机文件层，开始有低成本云端状态镜像和受控事件入口。

    • Workspace hubcloud-workspace-hub.js 提供 health、manifest、workspace、claims、events 和 dashboard data endpoints。
    • Cloud brokercloud status/plans/estimate/provision 接入 Alibaba SWAS，执行区域、预算和购买确认策略。

    证据：香港 hub 部署、write-test event、live billing probe、npm run acceptance。

  10. Team Proof

    真实产品团队循环证明

    用 Codex Team OS 自己跑一次 Product / CTO / QA / Learning 的完整任务闭环。

    • Fallback-backed cycle外部员工路由网络降级时记录 network_degraded，本地 Codex/subagent 接管闭环而不是挂死。
    • QA/Product recheckfallback 闭环必须补 QA recheck 与 Product recheck，防止把本地自测伪装成团队通过。

    证据：real product team cycle review、team-cycles export、recheck-stage acceptance。

  11. Workspace Reset

    Codex OS Team Workspace 重构

    把 dashboard 从系统状态墙重做成团队工作区控制台。

    • New IA主页改为 Today、Tasks、Workspace、Collaboration、Skills、Automation、Evidence、Admin。
    • Browser-verified console桌面和移动端验证 7 个工作区 section、5 个任务 lane、9 个 agent role lane、8 个 skill row。

    证据：Team Workspace reset review、Chrome + in-app browser visual checks。

  12. Product Reset

    产品重置 1-5

    回应“看不懂控制台在干嘛”的核心反馈，把系统定位从 telemetry wall 改成交付工作台。

    • Delivery workbench第一屏回答当前任务、owner、phase、risk、next action、是否要用户介入和 acceptance state。
    • Evidence hygiene关闭反馈、清理旧 backlog、更新 heartbeat cadence，并把证据路径折叠到二层。

    证据：product reset 1-5 closure、workspace-state / collaboration-state export、browser checks。

  13. Work Order

    紧凑工作单控制台

    把大块状态海报收紧成可扫描的当前工作单，让界面更像专业操作台。

    • Work-order fields集中显示 status、owner、next、risk、QA、evidence、discussion count。
    • Density pass收紧 topbar、operator cells 和当前工作区域，降低第一屏认知负担。

    证据：0.15.7 browser verification、node --check dashboard/app.js、acceptance。

  14. Operator

    Operator Console 与 Claim 决策条

    让第一屏直接回答“要不要我处理、谁在跑、并行是否安全、下一步是什么”。

    • Claim decision strip并行 claim 区先给结论、原因和下一条命令，再展示明细。
    • Operator action surface首页加入 action/running/parallel/next-task 四组判断。

    证据：0.15.2 / 0.15.3 dashboard checks、claim lint acceptance。

  15. Team Room

    数字员工战情室

    把 Product、QA、CTO、Learning 从“角色名称”变成有产物、有职责、有证据的工作流。

    • Role-by-role cycleemployee cycle 产出 Product、QA、CTO、自测、QA acceptance、Product signoff、Learning review。
    • Full access with guardrailsdashboard 可视化 full_access 自动化模式，同时保留 claim、secret 和生产破坏性动作护栏。

    证据：live employee cycle、team-cycles.json、browser verification at #team-workroom。

  16. Live Employees

    实时员工调用与模型运行审计

    员工不再只是本地配置，可以按 route 调外部模型，并把运行结果脱敏记录。

    • Employee invokeemployee invoke 支持 dry-run 和 --allow-external，按员工 route 调 OpenAI-compatible provider。
    • Model run audit运行记录写入 .codex-os/model-runs/RUN_LOG.jsonl 并导出到 dashboard。

    证据：DeepSeek QA Lead live call、model panel browser verification、no secret leakage check。

  17. Context Policy

    外部模型上下文策略

    把外部模型调用纳入 provider、上下文类别、脱敏和用户确认策略。

    • Context gatemodel context-policy 输出 local-only 默认、确认类别和 redaction rules。
    • Secret hygienedashboard 暴露 provider readiness，但不输出 API key、cookie、私钥或原始凭据。

    证据：0.14.0 browser verification、context policy acceptance、risk/validation export。

  18. Concurrency

    硬并行窗口 Claim 锁

    把多 Codex 窗口协作从口头约定变成路径级写入锁和冲突审计。

    • Path-level locking写入前必须声明 task、agent 和 paths；重叠 active write claim 会被 CLI 拒绝。
    • Claim lifecycle支持 claims、claim、release、stale visibility 和 dashboard export。

    证据：0.13.0 browser verification、fixture conflict tests、heartbeat prompt update。

  19. Model Routing

    模型路由与 OpenCode Provider

    把 Product、QA、CTO、Learning 等角色接入统一 provider / route / agent 配置。

    • Route config共享模型路由配置，支持 Ark Coding Plan、DeepSeek Direct 和 env-only secret loading。
    • Dashboard model panel显示 6 条 routes、2 个 providers 和 readiness，不泄露密钥值。

    证据：0.12.0 browser verification、opencode doctor、model status checks。

  20. Task Contract

    任务契约验证

    让任务不只是标题，而是带目标、风险、验收、验证和回滚字段的合同。

    • Task validate检查 Markdown / JSON task contract 的必需字段、枚举、验收标准和高风险动作。
    • Dashboard status任务契约状态进入 dashboard，作为自迭代前的质量门。

    证据：0.11.0 browser verification、task validate acceptance。

  21. Loop Guard

    自迭代循环守卫

    避免自动化重复同类低价值任务，开始把“继续做”变成可审计的选择。

    • Evolve guard检测连续失败、重复运行指纹和 same-category wake cycles。
    • Pause / redirect policy旧规则要求 pause，后来在 full-access 模式下改为换类别或缩窄范围。

    证据：0.10.0 browser verification、evolve guard acceptance、run log entries。

  22. Governance

    团队治理审计

    把 skills、MCP server、权限策略和 secret handle 纳入团队级检查。

    • Team auditteam governance audit 检查权限策略、skill 审核元数据、MCP 范围和 setup guide。
    • Doctor coverageteam doctor 集成治理检查，dashboard 显示治理能力和问题数。

    证据：0.9.0 browser verification、team governance acceptance。

  23. Memory

    记忆治理与本地搜索

    把项目记忆、学习、文档和技能变成可审计、可搜索、可提升的本地知识层。

    • Memory workflowmemory inbox/promote/stale/audit 管理 inbox、curated、stale 和重复/过期/低置信问题。
    • Local indexindex rebuild 与 search 检索 memory、tasks、learnings、prompts、docs 和 skills。

    证据：0.8.0 browser verification、memory audit 和 local search acceptance。

  24. Evolution

    反馈、学习、实验与运行日志闭环

    用户指出“还像普通 Codex”后，系统开始有可见的自我进化账本。

    • Evolution records新增 feedback inbox、learning log、experiment log、run log 和 dashboard evolution panel。
    • Automation auditautomation-runs.json 导出 heartbeat 运行次数、最近运行和状态摘要。

    证据：0.5.0 dashboard verification、55 条 run log 的起点记录。

子域名访问

公网已上线：os.panghu123.top

展示官网已经发布到现有东京服务器，并由 Caddy 保持 HTTPS 证书。API broker 继续使用 api.panghu123.top，两者在同一台服务器上分域名运行。 

open https://os.panghu123.top
npm run site:serve
open http://codex-os.localhost:4174
查看 Caddy 配置

下一步

把每一次 Codex 工作，变成能被团队接住的证据。

回到安装教程