4.0 KiB
示例
English | 中文
展示 harness 如何组装的可运行演示（不是 workspace）。每个示例都是一个 轻量叶节点：一份选择可替换后端、加载一个应用包（package）并可添加可选产品工具的 cordis.yml。组合和启动粘合代码位于 @deepseek-ai/dsh-tui-demo、@deepseek-ai/dsh-cli-demo、@deepseek-ai/dsh-acp-demo 及它们共享的 @deepseek-ai/dsh-agent-spine-demo 组合包中。没有 start.ts；终端 demo:* 脚本通过 dsh CLI（命令行界面）启动（该 CLI 挂载 tui-demo 组合包），无头／ACP（Agent Client Protocol）脚本则调用 cli-demo/acp-demo bin。
headless-agent
非交互式 agent（智能体）演示：接受一个位置参数形式的任务，在 @deepseek-ai/dsh-cli-demo 应用上运行一个完整模型／工具轮次，持久化新会话，打印 text、json 或 stream-json，然后退出。
运行：pnpm run demo:headless "task"（需要 DEEPSEEK_API_KEY）。输出契约、安全边界和快照套件详见 headless-agent/README.md。
tui-agent
交互式编码 agent：DeepSeek V4、文件系统与 bash 工具、subagent、工作流、todo_write、压缩（compaction）和全屏 TUI。这里也是 TUI PTY 与快照场景的归属地。
运行：pnpm run demo:tui（需要 DEEPSEEK_API_KEY）。使用 pnpm run demo:code-mode 运行其 Code Mode 覆盖。控制与组合详见 tui-agent/README.md。
jsonrpc-agent
通过 Python SDK 驱动的无人值守编码 agent：JSON-RPC stdio、仅前台 bash、read/write/edit、一个前台 subagent、todo_write、JSONL 持久化和压缩。它不包含终端 UI、stdout 日志、批准、skill（技能）和后台任务控制。详见 jsonrpc-agent/README.md。
cordis-agent
自指 演示：编码主干加 @deepseek-ai/dsh-tool-cordis，其三个工具（cordis_inspect/cordis_mount/cordis_unmount）使 agent 可以检查当前 DSH 进程、挂载模型编写的临时插件（事件监听器、一个全新工具，或一个供另一个临时插件注入的服务），并再次卸载它们。这些插件只存在于内存中，共享一个内部 cordis-dynamic fiber 子树；ctx.fs/ctx.web 仅作为它们可用的能力提供方。
使用 pnpm run demo:cordis 运行 TUI，使用 pnpm run demo:cordis web 在 http://127.0.0.1:3081 启动浏览器 UI，或使用 pnpm run demo:cordis acp 启动 ACP 服务器（三者均需 DEEPSEEK_API_KEY）。分阶段演示脚本详见 cordis-agent/README.md，设计与沙箱注意事项详见工具集 Agent Note（agent 决策记录）。
acp-agent
一个通过 JSON-RPC stdio 公开、作为 Agent Client Protocol (ACP) 自动化服务器运行的 agent，由 @deepseek-ai/dsh-acp-demo 提供。程序化客户端可以创建新会话、发送文本提示词、消费已提交的 assistant 文本、回答一次性权限请求并取消工作。它拥有 ACP 无密钥快照套件。
运行：pnpm run demo:acp（需要 DEEPSEEK_API_KEY）；pnpm run demo:code-mode acp 通过 code-mode.cordis.yml 覆盖以 Code Mode 启动同一服务器。协议与快照测试契约详见 acp-agent/README.md。
默认 cordis.yml 组合 @deepseek-ai/dsh-sandbox-local、@deepseek-ai/dsh-bash-sandbox 和 @deepseek-ai/dsh-user-approval。workspace-write 将 bash 和文件系统变更限制在每个会话 workspace 中；请求更广泛沙箱权限的重试会通过 ACP 触发一次性的机器权限请求。