持久运行时智能体 lilCnid/recursus

Recursus

一个持久、全权限的运行时智能体，能记忆、计算、委派、恢复、验证并完成任务。

Recursus 是 OpenCnid 智能体运行时的产品与装配层，构建在 DeepSeek Harness 之上。DeepSeek Harness 仍是控制平面：智能体循环、会话、工具、审批、策略、血缘、取消和遥测都由它负责。Recursus 围绕这个核心，把各自独立版本化的能力组合起来，并将加入持久运行状态、执行监督、验证驱动的完成、协同委派、有界上下文编译和自适应模型路由。

[!IMPORTANT]
Recursus 正在实现里程碑 1。已验收的 Windows 包、配置档和冒烟证据，仍是上一个 Harness 修订版的历史证据。经评审的确定性打包修复现已固定到 e52c224fe00954fb7e8cda19eb2411dceef15989；Linux 包、配置档、冒烟和 §20.6 证据必须在该源码锁定点重新生成。本仓库尚未创建 Recursus 发布版，组件的再分发限制仍然适用。

Recursus 有意以操作者授予的主机权限运行。它的定位是可信开发机上的强力智能体，不是安全沙箱。不可逆的外部操作仍需显式闸门、精确目标和持久证据。

运行时组成

flowchart TD
operator["Operator"] --> recursus["Recursus product and run layer"]
recursus --> dsh["DeepSeek Harness control plane"]
dsh --> codex["OpenAI Codex model provider"]
dsh --> rlm["Persistent RLM compute and native recursion"]
dsh <--> honcho["Honcho cross-session memory"]
rlm --> artifacts["Project-local exact artifacts"]
artifacts --> dsh
dsh --> dovetail["Dovetail workflows and evaluation skills"]
dsh --> truth["Git, files, tests, CI, and durable run state"]

| 组件 | 职责 | 仓库 |
| DeepSeek Harness | 智能体循环、工具、会话、策略、血缘、取消、UI | OpenCnid/deepseek-harness |
| OpenAI Codex adapter | ChatGPT 订阅制模型服务商 | OpenCnid/deepseek-openai-codex |
| DeepSeek RLM | 持久 IPython、快照、递归 DSH 子进程、Python 工具桥 | OpenCnid/deepseek-rlm |
| DeepSeek Honcho | 跨会话记忆、精确产物、脱敏实验卡片 | OpenCnid/deepseek-honcho |
| DeepSeek Dovetail | 提示词、委派、评估、自我对弈、引导和交接工作流 | OpenCnid/deepseek-dovetail |

精确修订版和许可边界记录在 manifests/components.json 和 THIRD_PARTY_NOTICES.md。

装配契约状态

manifests/assembly.json 在已接受的组件版本锁定基础上，扩展出带版本号的 Milestone 1 源码锁：许可证状态、获取方式、精确的包管理器与 lockfile 摘要、组件自有的校验/构建/打包命令、包选择器、公开的 DSH 配置档贡献、平台支持，以及兼容性约束。它的严格 schema 是 manifests/assembly.schema.json，而 manifests/profile-lock.yaml 在 pnpm 11.19.0 下冻结了组装后配置档的第三方依赖解析结果。

私有包 packages/assembly 定义了与服务商无关的生命周期、只读 Git 获取、精确的组件命令执行、有界的 npm-tarball 检查、隔离的 DSH 配置档生命周期，以及组装后的冒烟运行器。操作者提供绝对的 Recursus 工作根目录；所有源码、包管理器、依赖、Python、分发和打包输出状态都留在该目录之下。检查器会在归档文本中拒绝这个确切的根路径，包括斜杠归一化形式和转义形式。manifests/package-integrity.json 以及 Windows 包、配置档、默认冒烟和可选启用的实时冒烟报告，为前一个 Harness 版本锁定保留了不含路径的证据。这些证据相对新审查的源码锁是有意过期的，不得重新标注。在完整的 §20.6 工作流在新版本锁定下重新生成证据之前，Linux 验收仍然缺失。工作流、已验证行为和剩余限制见 docs/ASSEMBLY.md。

Recursus 将负责什么

- 可复现、一条命令完成的运行时组装；
- 权威且持久化的任务与运行状态；
- 持久化的进程、内核、CI 和唤醒监督；
- 机器可读的完成契约；
- 依赖感知的多智能体协调；
- 带信任与新鲜度标签的有界上下文编译；
- 模型、推理强度与 RLM 路由；
- 操作者的状态、暂停、恢复、取消和审批控制；
- 端到端兼容性、打包、评估和发布。

Recursus 不负责什么

- 在 DSH 之外再造一个智能体循环；
- 另一个对话记录存储或通用记忆系统；
- Honcho 内部的当前代码真相；
- Honcho 内部的产物字节；
- 隐藏的重新许可或复制的组件历史；
- 声称获得任何上游项目的官方背书。

站在巨人的肩膀上

Recursus 之所以存在，是因为许多项目把困难的部分变得清晰可读、可复用。我们尤其感谢：

- DeepSeek AI 和 DeepSeek Harness 贡献者，提供了插件优先的智能体控制平面；
- Cordis 及相关框架贡献者，提供了时空服务组合能力；
- OpenAI 和 Codex 生态，提供了我们通过服务商适配器使用的模型体验；
- Mario Zechner、Pi 生态和 @earendil-works/pi-ai 贡献者，提供了直接服务商与 OAuth 基础层；
- Prime Agent 贡献者，他们提出的 persistent-kernel 与 recursive-agent 技术被 DeepSeek RLM 采用；
- Project Jupyter 和 IPython，提供计算底座；
- Honcho 和 Plastic Labs，提供跨会话推理能力与官方 Honcho SDK；
- Matthew Murphy、Lexideck、SPARK 作者，以及所有 OpenCnid Dovetail 贡献者，他们的方法构成了工作流层的基础；
- 组件 lockfile 和 notices 中记录的每个库与工具的维护者。

署名不能替代许可证。每个依赖和组件都保留各自的版权与条款。详见 THIRD_PARTY_NOTICES.md。

路线图

实现顺序定义在 GAMEPLAN.md：

1. 可复现的运行时组装；
2. 持久化的运行状态；
3. 执行监督；
4. 验证驱动的完成判定；
5. 协同委派；
6. 有界上下文编译；
7. 自适应模型与算力路由；
8. 操作者体验、评估与发布。

规范性的产品边界与完成定义（Definition of Done）见 SPEC.md。组件拓扑见 docs/ARCHITECTURE.md。

要在全新的 Codex 会话中继续实现，请使用 NEXT_SESSION_PROMPT.md 中维护的启动提示词。它会引导会话查阅规范性规格文档，并定位第一个尚未完成的里程碑。

仓库验证

使用 Node.js 22.19.0 或受支持的 Node.js 24 版本，以及 pnpm 11.19.0：

pnpm install --frozen-lockfile
pnpm check

node scripts/verify.mjs 仍然是不依赖第三方库的检查，覆盖组件版本锁定、已实现的 Milestone 1 schema、源码锁、package/profile 证据、smoke 报告和 notice 闭环。在这次有意的版本锁定过渡期间，它会按明确的历史身份校验已接受的前序证据，并独立校验当前源码锁。仓库验证器通过，并不代表历史报告就是最新的，也不代表 Milestone 1 已完成；完整的 package、profile、smoke、Linux 和 §20.6 证据集，仍须在新的源码锁下重新生成并通过验收。

许可证

Recursus 原创代码与文档采用 MIT License 授权。引用及后续组装的组件保留各自的许可证。Recursus 是独立的 OpenCnid 项目，并非 DeepSeek、OpenAI、Honcho 或 Prime 的官方产品。