跳转至

简体中文 · English

面向 Codex Desktop,修复实际门禁、GPT-6 控制器和原生回执恢复;旧根保持原路由与账目语义。内部脚本仅用于管理与验证,不构成独立 CLI 产品支持轨道。

正式版 V7.17.3 已于 2026-10-29(UTC)公开发布。

Codex 跨项目长期技术助手

Codex 跨项目长期技术助手双语项目预览

面向 Codex 的跨项目工程协作框架:Skill 路由、多 Agent 独立复审、可恢复任务记忆、生命周期事件与受控演进。

CI 双语文档站 Latest release Apache-2.0 增强运行时 Python 3.11+ Codex Desktop

当前实现保留消息与 Stop 非阻断、Operation v2、基础 Skill 与可选增强分离等边界。可选文件门禁仍默认关闭;启用后,缺少索引或可选材料按限定范围继续,不临时关闭门禁。能力档位不代表业务语义正确或权限已授予。详见模型策略和桌面门禁与恢复。

快速入口: 双语文档站 · 下载 · 四条日常路径 · 使用示例 · 兼容矩阵 · 安装 · 文档

安装后可直接使用,普通任务不需要先理解 Profile、索引或台账。首次全扫可以跳过;拒绝、未回答或辅助存储不可用时,助手仍按当前源码与基础能力继续。需要排障时依次使用 doctor、只读 inventory 和规范 recover,它们会说明受影响功能、当前还能做什么和唯一下一步。

四条日常路径与统一入口

解压后的源码树和发行 ZIP 都提供同一组 cp-assistant 入口;Windows 使用 scripts\\cp-assistant.ps1,POSIX 使用 scripts/cp-assistant.sh。help 与 install-base 不需要本包 Python,其他管理命令会明确提示 Python 3.11+ 依赖,不会伪造 Plugin 状态。

日常路径 示例请求 入口动作
修 Bug “修复失败验证并运行最小相关测试” 先描述问题;需要状态时运行 status / doctor
做功能 “实现这个功能并按风险验证” 直接描述目标;增强能力按需安装
审查 “审查当前分支的兼容与安全风险” 直接描述审查范围;独立 Reviewer 按风险启用
继续任务 “继续上次任务,说明做到哪里和下一步” 运行只读 resume,不自动恢复安装事务
.\scripts\cp-assistant.ps1 help
.\scripts\cp-assistant.ps1 install-base
.\scripts\cp-assistant.ps1 status
.\scripts\cp-assistant.ps1 doctor
.\scripts\cp-assistant.ps1 inventory --scope user --mode plugin --json
.\scripts\cp-assistant.ps1 resume --repo-path E:\\work\\repo --profile C:\\safe-state\\project-profile.json --checkpoint-dir C:\\safe-state\\task
.\scripts\cp-assistant.ps1 recover --scope user

status、doctor、inventory 和 resume 只读;install-base、install-enhancement 和 recover 是写操作。resume 支持绑定 Profile/State/Evidence,也支持只提供明确的旧 Markdown 检查点目录;它只报告阶段、检查点、仓库变化、需重验项和一个下一步,不创建 Profile、不修复检查点、不续跑任务。默认 status 保留完整检查;只有明确指定 status --quick 时才使用低成本诊断视图。需要机器 JSON 时追加 --json。

POSIX 将上述路径替换为 ./scripts/cp-assistant.sh。四条路径的完整说明见 使用说明。

下载

以下为已公开的 V7.17.3 安装包,发布日期为 2026-10-29(UTC)。

发行包 适用界面 下载
Codex-Skills-V7.17.3-zh-CN.zip 简体中文 下载中文安装包
Codex-Skills-V7.17.3-en.zip English Download English package

Release · SHA256SUMS.txt

两步开始

  1. 解压安装包后,运行原生基础安装入口;它不需要本包 Python runtime 或 API Key。
.\scripts\install-base.ps1
./scripts/install-base.sh
  1. 直接描述工程任务,例如:
修复当前仓库失败的验证,并运行最小相关测试。
审查我在这个分支的改动,检查兼容与安全风险。
继续之前的任务;先确认已改内容和仍需验证的部分。

基础 Plugin 只加载十个 Skill,不启动 Hook、Worker、Profile、索引或预算台账。这些属于按需启用的增强能力,不是普通任务前提。

可选增强

需要可恢复的长期状态、Hook、索引、独立 Reviewer、强制预算或受控写入时,再运行现有 install-user 入口。增强安装复用既有备份、事务、验证和恢复;已受管增强 state 不会被基础入口降级。

核心能力

  • 10 个工程 Skill,按当前任务最小充分路由并渐进加载。
  • C01-C25 能力注册表默认 AUTO/BASIC;单项缺条件只降级该项,显式 OFF 和任务风险分别计算。
  • 首次全扫只在明确选择并成功读回后排队;拒绝、未答、取消、保存失败和 Worker 晚到都有独立状态。
  • 4 个稳定主领域:通用后端、通用前端、通用 AI、数据中间件基础设施;语言和框架作为按需 Reference。
  • 7 个逻辑只读 Reviewer,定义文件不写死模型或推理强度。
  • 增强安装登记 8 个注册 Hook 入口:UserPromptSubmit、PreToolUse、PostToolUse、SubagentStart、SubagentStop、Stop、Interrupt、SessionEnd。基础 Plugin 不登记 Hook;增强中的 UserPromptSubmit 为异步观察,Stop 返回中性响应,Interrupt 保持宿主控制。
  • TaskOutcomeEvent 3.0、project_id + repo_fingerprint 双重隔离与独立连续哈希链。
  • 可恢复检查点、延迟 SessionEnd 封印、事件归档与跨项目健康概览。
  • 包级路由回归与真实宿主路由验收分层记录;宿主证据绑定原始最终报告的 SHA-256。
  • 演进候选按信号类型分别检查所需证据,不再因无关遥测缺失而全局阻断。
  • execution_authorization=NONE 的受控优化提案,不授予实施权限。
flowchart LR
    A[任务输入] --> B[Skill 最小路由]
    B --> C[主 Agent 执行]
    C -. 按需增强 .-> D[独立 Reviewer]
    C -. 按需增强 .-> E[生命周期 Hooks]
    D --> E
    E --> F[TaskOutcomeEvent 3.0]
    F --> G[项目隔离与哈希链]
    G --> H[Snapshot / Assessment / Proposal]
    H --> I[人工决策]

可复现使用示例

以下内容展示一次典型只读任务的输入、流程和可检查结果;它是使用示例,不是当前会话的运行证明。

任务输入

检查当前仓库的安装器升级路径,只读分析,不修改文件;
按风险选择 Reviewer,并区分已确认事实、推断和未验证项。

预期流程

任务输入
  -> 路由 engineering-quality-delivery
  -> 读取安装器、清单、测试与升级文档
  -> 按实际风险启动逻辑只读 Reviewer
  -> 汇总并去重 Reviewer 发现
  -> 输出证据、风险和未验证边界

生命周期可形成 TURN_OPENED -> SUBAGENT_STARTED -> SUBAGENT_STOPPED -> TASK_COMPLETED 事件序列;会话结束后由 SessionEnd 进入延迟封印流程。派发记录只证明请求参数符合当前任务的已授权策略;不读取、不推断、不保存或导出宿主实际后台型号与推理强度。

兼容矩阵

环境或模式 当前定位 已有验证层级 边界
Codex Desktop + Plugin 唯一产品目标 本机安装、门禁开启的写入、续跑与回执对账已验收 结论绑定 V7.16.0 的发布提交与验收时宿主;其他环境须另行核验
Windows / Ubuntu Python 矩阵 包级发布门禁 Python 3.11/3.13 测试与构建 不代表桌面原生验收;远端结果以 Actions 为准
旧安装布局与冻结策略 兼容恢复 既有状态、账本与解释器继续保留 不建立独立 CLI 产品适配或验收轨道
macOS 未验证 无当前 CI 或宿主验收证据 状态保持 UNVERIFIED

基础安装无需本包 Python runtime;增强运行时的 Python 最低版本为 3.11;公开 CI 配置为在 Windows 与 Ubuntu 上验证 3.11 和 3.13。其他环境组合应先执行 doctor、dry-run 和 verify,再判断可用状态。

桌面管理组件可使用内部预发布号。安装核验按组件摘要、命令和登记结构进行;组件版本不等于桌面任务运行版本。旧稳定版注册表仅保留历史读取与恢复语义。

当前可选文件门禁使用 Operation v2 的原生来源、目标与前态核验。旧 GateTask 和冻结策略仅用于历史回放;启用的门禁在缺少可选证据时返回可执行的继续路径。流程证据不代表业务语义正确,公开 Release 以授权操作和读回为准。

首次安装与升级

首次安装使用上方基础入口。需要启用增强能力,或升级既有 V7 受管安装时,在解压后的包根目录依次执行:

python scripts\package_manager.py doctor
python scripts\package_manager.py install --scope user --mode plugin --dry-run
python scripts\package_manager.py install --scope user --mode plugin
python scripts\package_manager.py verify --scope user --mode plugin
codex plugin list --json

增强安装只有在 Plugin 读回 installed=true、enabled=true、目标发行版本、兼容宿主快照且旧领域 Skill 不再发现时才成立。doctor 与 status 默认说明可继续的能力、受影响项、原因与唯一下一步;完整机器记录使用 --json。

安装器会识别已有版本、备份并移除受管旧 Skill、拒绝链接与 Reparse Point 风险,并保留未知文件。完整流程见 安装与恢复 和 使用指南。

派发策略与模型身份隐私边界

新任务采用desktop-g6-deterministic-v1:脚本从GPT-6 Luna、Sol、Astra的low/medium/high九档为Reviewer、Worker、Explorer选择组合。一般任务或信息不足使用Sol/medium;模型保留语义判断和有界调整建议,实际调用采用脚本批准的精确参数。

缺少理由、资格卡、收益证明、历史样本或可选材料时,门禁保持开启并返回默认或降级路径。权限、完整性和真实预算限制仍针对相应动作生效;允许继续不等于验证通过。规划单位不是实际费用或模型能力排名。详见模型选择与预算。

请求参数与宿主实际后台身份是不同事实;本包不读取或推断后台实际型号。主Agent保持当前选择;自动xhigh/max/ultra禁止。5.6和旧V3/V4只用于显式兼容与原账目回放,不将旧费用或结果按新规则重算。

文档与协作

本地验证

python scripts\localization-audit.py --strict
python scripts\validate-package.py

发行构建采用固定时间戳、稳定排序和 SHA-256 见证。源码仓库与发行安装包是不同证据层:仓库 CI 证明当前提交,Release 附件及其见证证明可下载产物。

发行来源证明

Release Candidate and Provenance 工作流会校验版本标签、在 Windows 与 Ubuntu 上验证源码、构建两个可复现 ZIP,并通过 GitHub Artifact Attestations 为实际 ZIP 摘要生成签名来源证明。公开 Release 由受权操作创建并单独读回。

$repository = ([uri]"https://github.com/JimmyVGDY/codex-long-term-assistant-skills").AbsolutePath.Trim("/")
gh attestation verify Codex-Skills-V7.17.3-zh-CN.zip --repo $repository

完整门禁和新版本发布步骤见 Release 自动化与制品来源证明。

安全边界

  • 不自动修改 Skill、Reviewer、模型路由、全局配置或业务仓库。
  • 不自动接受或执行优化提案。
  • 不自动提交、推送、部署、重启、操作生产环境或写入业务数据。
  • Evidence 只记录事实,不授予权限。
  • 默认不保存原始 Prompt、完整回答、代码正文、Diff、Token、Cookie、API Key 或凭据。

Apache-2.0 许可,见 LICENSE。

复用入口:能力索引与可选门禁 · 复用验收规程。

当前正式版验证与已知边界