@@ -2,32 +2,24 @@
[English ](README.md ) | 中文
展示 harness 如何接线的可运行演示（不是 workspace）。每个示例都是一个 **轻量叶节点 ** ：要么是一份选择可替换后端、加载一个应用包的 `cordis.yml` 配置树，要么是一个 **overlay ** ——由 `dsh --config` 叠加到交付组合（[ `apps/cli/config/base.cordis.yml` ]( ../apps/cli/config/base.cordis.yml ) 加一份 surface overlay）之上的 patch 列表。成组的组合位于 [ `@deepseek-ai/dsh-cli-demo` ]( ../packages/examples/cli-demo )、[ `@deepseek-ai/dsh-acp-demo` ]( ../packages/examples/acp-demo ) 及它们共享的 [ `@deepseek-ai/dsh-agent-spine-demo` ]( ../packages/examples/agent-spine-demo ) 组合包中； `dsh` 的各 surface 则改用平铺 config tree。没有 `start.ts` ；终端 `demo:*` 脚本通过 [ `dsh` ]( ../apps/cli/README.md ) CLI（命令行界面）启动，无头／ACP（ `cli-demo` / `acp-demo` bin 。
展示 DeepSeek Harness 主要接口和扩展点的可运行演示。每个子目录负责自己的配置、前置条件、命令和详细行为 。
## mcp-memory
三份默认关闭的参考 overlay 通过通用 MCP 客户端连接一个记忆 MCP 服务器。选择其中一份文件传给 `dsh --config` ；DSH 不负责安装或配置上游记忆系统。版本固定的前置条件、身份映射、可选的共用提示词，以及「写入 → 新会话召回 → 使用」验证流程 详见 [mcp-memory/README.md mcp-memory/README.md )。
通过通用 MCP 客户端连接受支持第三方记忆服务器的可选 overlay。 详见[记忆示例参考 mcp-memory/README.md )。
## headless-agent
非交互式 agent（智能体）演示 ：接受一个位置任务，在 `@deepseek-ai/dsh-cli-demo` 应用上运行一个完整模型／工具轮次，持久化新会话，打印 `text` 、 `json` 或 `stream-json` ，然后退出 。
运行：`pnpm run demo:headless "task"` （需要 `DEEPSEEK_API_KEY` ）。输出契约、安全边界和快照套件详见 [headless-agent/README.md ](headless-agent/README.md )。
非交互式 agent（智能体）：接受一项任务并运行，然后以选定的机器可读或人类可读格式输出结果。详见[ 无头示例参考 ]( headless-agent/README.md ) 。
## jsonrpc-agent
通过 Python SDK 驱动的无人值守编码 agent： stdio、仅前台 `bash` 、 `read` / `write` / `edit` 、一个前台 `subagent` 、 `todo_write` 、JSONL 持久化和压缩。它不包含终端 UI、stdout 日志、批准、skill 和后台任务控制。详见 [ jsonrpc-agent/README.md jsonrpc-agent/README.md )。
由 Python SDK 和 JSON-RPC 驱动的无人值守编码 agent。详见 [ JSON-RPC 示例参考 ](jsonrpc-agent/README.md )。
## web-cordis
**自指 ** 演示：编码主干加 [ `@deepseek-ai/dsh-tool-cordis` ]( ../packages/cordis/tool-cordis )，其三个工具（ `cordis_inspect` / `cordis_mount` / `cordis_unmount` ）使 agent 可以检查当前 DSH 进程、挂载模型编写的临时 Plugin（事件监听器、一个全新工具，或一个供另一临时 Plugin 注入的服务），并再次卸载它们。这些 Plugin 只存在于内存中，共享一个内部 `cordis-dynamic` fiber 子树； `ctx.fs` / `ctx.web` 仅作为它们可用的能力提供方 。
使用 `pnpm run demo:cordis` 在 `http://127.0.0.1:3081` 启动浏览器 UI，或使用 `pnpm run demo:cordis acp` 启动 ACP 服务器（两者均需 `DEEPSEEK_API_KEY` ）。设计与沙箱注意事项详见[工具集 Agent Note ](../.agents/notes/implemented/feature/2026-07-08-self-referential-cordis-toolset.md )。
能够检查并更改内存中 Cordis 插件树的自指 agent。详见 [ web-cordis 示例参考 ]( web-cordis/README.md ) 。
## acp-agent
作为 ** Agent Client Protocol (ACP) ** 自动化服务器通过 JSON-RPC stdio 公开的 agent，由 [ `@deepseek-ai/dsh-acp-demo` ]( ../packages/examples/acp-demo ) 提供。程序化客户端可以创建新会话、发送文本提示词、消费已提交的 assistant 文本、回答一次性权限请求并取消工作。它拥有 ACP 无密钥快照套件 。
运行：`pnpm run demo:acp` （需要 `DEEPSEEK_API_KEY` ）；`pnpm run demo:code-mode` 通过 `code-mode.cordis.yml` 覆盖以 Code Mode 启动同一服务器。协议与快照测试契约详见 [acp-agent/README.md ](acp-agent/README.md )。
默认 `cordis.yml` 组合 [`@deepseek-ai/dsh-sandbox-local` ](../packages/sandbox/sandbox-local )、[`@deepseek-ai/dsh-bash-sandbox` ](../packages/bash/bash-sandbox ) 和 [`@deepseek-ai/dsh-user-approval` ](../packages/ui/user-approval )。`workspace-write` 将 bash 和文件系统变更限制在每个会话 workspace 中；范围更广的重试会通过 ACP 成为一次性机器权限请求。
面向程序化客户端的 ACP（ Agent Client Protocol）自动化服务器，支持会话、权限和取消操作。详见 [ ACP 示例参考 ]( acp-agent/README.md ) 。
Turtle