CodeAct 工具集 lyuwen/dsh-codeact-tools

dsh-codeact-tools

给 DeepSeek Harness 用的自包含极简 AI 编程工具集：

| 工具 | 包 | 作用 |
| str_replace_editor | @dsh-codeact-tools/tool-str-replace-editor | 在文件系统接缝上做 view/create/str_replace/insert/undo_edit 文件编辑 |
| execute_bash | @dsh-codeact-tools/tool-execute-bash | 每个智能体一个常驻 bash 会话；每次调用可传 timeout（秒）和 reset |
| finish | @dsh-codeact-tools/tool-finish | 用消息作为最终答案结束本轮 |

共用的常驻 shell 机制（基于标记的输出捕获、回滚缓冲拼装、会话重置、按属主串行化）内联在 @dsh-codeact-tools/persistent-shell 里，改写自 @deepseek-ai/dsh-tool-bash-persistent（DeepSeek Harness，MIT）。编辑器 fork 自 @deepseek-ai/dsh-tool-str-replace-editor，加了 undo_edit。所有工具包只依赖已经发布的 harness 核心（@deepseek-ai/dsh-tools、dsh-terminal、dsh-agent、 dsh-timeout、dsh-agent-loop…… 版本 0.1.0-rc.8）——没有任何未发布的东西——所以这个仓库可以单独安装。

工具 schema 和描述由 tests/schema-parity.spec.ts 对照 tools.json 里的参考 CodeAct 工具集锁定。唯一有记录的差异是参考实现里 execute_bash 的 is_input 模式（向仍在运行的进程发送输入），这一项暂缓；已发布的描述里没有宣传它。

包

- @dsh-codeact-tools/persistent-shell — 共用核心：registerPersistentShellTool、 resolvePersistentBashConfig、persistentShellConfigSchema。
- @dsh-codeact-tools/tool-str-replace-editor — 带 undo_edit 的文件编辑器（str_replace/insert 历史按属主和路径记录）。
- @dsh-codeact-tools/tool-execute-bash — 注册 execute_bash 工具。
- @dsh-codeact-tools/tool-finish — 注册 finish 工具；调用成功会带上 concludesTurn 终止标记，于是智能体循环提交结果并结束本轮，不再发一次模型请求。

开发

pnpm install
pnpm build # tsc -b, emits lib/ per package
pnpm test # vitest: tool specs + tools.json schema-parity gate

安装

两条路径，都从这个仓库出发：

本地（不需要 registry）

pnpm install
pnpm build
pnpm run install-mode # copies the mode preset + installs the tool packages
pnpm run install-mode -- --link # live developing: symlink preset + packages into the repo

然后启动会话，选 CodeAct Mode 智能体预设（或在 settings 里设 agent-presets.default）。安装器替换已有的 codeact 模式前会先备份；用 --link 时，在仓库里重新构建（pnpm build）会立刻把改动推到部署环境。

已发布的 bundle

仓库发布 @dsh-codeact-tools/codeact（bundle/）：这是一个配置档 bundle，它的依赖会把各个工具包拉进部署，它的 preset/ 存放模式，它的 dsh-codeact-install bin 负责安装。执行 pnpm publish 之后：

{
"dsh": { "profile": { "bundles": ["@dsh-codeact-tools/codeact"] } }
}

pnpm install
pnpm dlx dsh-codeact-install

组合方式供参考（模式本身位于 bundle/preset/agent.cordis.yml）：

- id: execute-bash
name: '@dsh-codeact-tools/tool-execute-bash'
config:
timeoutMs: 300000

- id: finish
name: '@dsh-codeact-tools/tool-finish'

- id: str-replace-editor
name: '@dsh-codeact-tools/tool-str-replace-editor'

execute_bash 需要一个归属的 Agent、一个真实的 PTY 后端（@deepseek-ai/dsh-terminal-bash），以及宿主 sandbox/subprocess 行；外围组合可参考 harness 的 minimal preset。

来源

派生自 DeepSeek Harness（MIT）：persistent-bash 核心，以及编辑器和 shell 工具插件，都源自 harness 的 packages/shell/tool-bash-persistent、packages/shell/tool-execute-bash、packages/fs/tool-str-replace-editor 和 packages/guard/tool-finish。行为契约记录在 harness Agent Note 2026-08-20-minimal-mode-tool-set 中。工具描述和 schema 遵循 tools.json 中导出的参考 CodeAct 实现。