deepseek-harness/examples/cordis-agent/README.zh.md

cordis-agent

English | 中文

自指 harness 演示：在全屏 TUI 上运行 DeepSeek V4 编码主干，并加载 @deepseek-ai/dsh-tool-cordis。后者让模型检查当前 DSH 进程、挂载仅存于内存的临时插件，并卸载它们。临时插件可跨轮次保持活跃，但会在卸载、工具集卸载或 DSH 重启后消失；它们不创建文件或配置，也可能影响同一进程中的其他会话。ctx.fs 和 ctx.web 仅以能力提供方形式加载，供这些插件使用。设计详见工具集 Agent Note（agent 决策记录）。

运行

# repo root .env (gitignored) or exported env:
#   DEEPSEEK_API_KEY=sk-…
#   DEEPSEEK_BASE_URL=https://…   # optional; defaults to the public API
pnpm run demo:cordis      # TUI (default)
pnpm run demo:cordis web  # browser UI at http://127.0.0.1:3081
pnpm run demo:cordis acp  # ACP server

预期演示分阶段进行：先验证监听器链路，再让 agent（智能体）扩展自身：

> Mount a temporary Plugin that listens to the 'agent/status' event and logs every status change, then run `echo hi` with bash.
  [tool call] cordis_mount({"code": "return { name: 'status-logger', apply(ctx) { ctx.on('agent/status', (agent, status) => console.log('status →', status)) } }"})
  [tool result] Temporary Plugin dyn-1 is running (plugin "status-logger"; available until unmounted or DSH restarts).
  [tool call] bash({"command": "echo hi"})
[cordis:dyn-1] status → …            ← the temporary listener firing, live
> Now give yourself a reverse_text tool and use it on "harness".
  [tool call] cordis_mount({"code": "return { name: 'reverse-text', inject: ['tools'], apply(ctx) { ctx.tools.register(harness.defineTool({ name: 'reverse_text', … })) } }"})
  [tool call] reverse_text({"text": "harness"})   ← a tool the agent built for itself, one step earlier
> Unmount both temporary Plugins.
  [tool call] cordis_unmount({"id": "dyn-1"})

请求 cordis_inspect 并使用 what: "api" 或 what: "events"，即可查看编写插件代码所用的生成服务／事件资料。还可挂载两个协作临时插件（一个中调用 ctx.provide，另一个中使用 inject），观察 Cordis 如何暂停并恢复消费方。

端到端测试

tests/keyless-smoke.e2e.ts 使用虚拟密钥通过 Loader 启动真实 cordis.yml，并断言横幅、包名解析，以及收到 EOF 后正常退出。tests/cordis-tools.e2e.ts 是带密钥的冒烟测试：真实模型挂载一个临时状态监听器，测试验证其带标记的控制台输出行；然后创建并使用 reverse_text 工具，再通过 provide/inject 组合两个临时插件。packages/cordis/tool-cordis 包含相关单元测试，并受逐文件 100% 覆盖率门禁约束。