持久运行时智能体OpenCnid/recursus

Recursus

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

Recursus 是构建于 DeepSeek Harness 之上的 OpenCnid 智能体运行时的产品与组装层。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 适配器 | 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 源锁定信息：许可证状态、获取方式、确切的包管理器与锁文件摘要、组件自有的验证/构建/打包命令、包选择器、公开 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 基础。
- 由 DeepSeek RLM 改编的持久内核与递归代理技术的 Prime Agent 贡献者；
- 作为计算基底的 Project Jupyter 和 IPython；
- 用于跨会话推理和官方 Honcho SDK 的 Honcho 和 Plastic Labs；
- Matthew Murphy、Lexideck、SPARK 作者，以及所有 OpenCnid Dovetail 贡献者，他们的方法为工作流层提供了参考；
- 组件锁定文件和声明中记录的所有库和工具的每一位维护者。

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

路线图

实现顺序在 GAMEPLAN.md 中定义：

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

规范性产品边界和完成定义见 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 仍然是无依赖检查，用于验证组件固定版本以及已实现的里程碑 1 模式、源锁定、包/配置文件证据、冒烟报告和声明闭合。在此次有意的固定版本过渡期间，它会根据其明确的历史身份验证已接受的前任证据，并独立验证当前源锁定。仓库验证器通过并不意味着历史报告是最新的或里程碑 1 已完成；完整的包、配置文件、冒烟、Linux 和 §20.6 证据集仍必须在新源锁定下重新生成并接受。

许可证

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