前言¶

在 DSH 里跑 agent，常见问题是：同类任务第二次做，模型仍可能重复踩坑；会话结束，上一轮里摸索出来的做法也不会自动留给下一轮。有人靠把规则写进系统提示，有人靠外部笔记或向量库，但要么难维护，要么和当前工作区、任务轨迹脱节。

下面介绍社区插件 dsh-ace（维护者 ADkun，分类为「记忆」）。它把 ACE（Agentic Context Engineering，arXiv 2510.04618） 做成 DSH 原生能力：不训练模型、不改权重，只靠提示词和一个 Markdown 手册（playbook），让 agent 在任务前查阅、任务后复盘，并把经验增量写回手册。手册默认落在工作区 .ace/playbook.md，人可以直接打开编辑。

这是什么¶

dsh-ace 是 DeepSeek Harness 的插件，当前 package 版本为 0.3.0（MIT 许可证）。装上后会注册三个工具，并在系统提示里引导 agent 按「读 → 盘 → 并」循环使用手册：

1. 读：任务开始前，用 ace_playbook 查手册里是否有相关经验；
2. 盘：完成有实质工作量的任务后，用 ace_reflect 复盘轨迹，产出结构化候选经验（条件 / 做法 / 依据）；
3. 并：用 ace_curate 把候选经验增量并入手册——支持增、改、删单条，由 LLM 去重，不会整本重写，避免旧经验细节被磨平。

核心功能¶

三个工具¶

手册形态¶

手册是纯 Markdown。条目示例（人可直接编辑，与机器序列化格式一致）：

### [ace-001] 编辑前先读目标文件
- 条件：要对既有文件做任何修改之前
- 做法：先用 read 完整读一遍，确认结构后再动手
- 依据：盲改导致过两次返工
- 元数据：created=2026-02-07 updated=2026-02-07 helpful=0 harmful=0

默认路径为工作区下的 .ace/playbook.md；首次使用无需配置，第一次相关调用会自动创建该文件。

配置与设置页¶

全部配置项有默认值，零配置即可用。需要改手册路径、是否自动提醒复盘、或指定复盘用的 LLM 时，可以：

1. DSH 网页端：Settings → 导航「ACE 手册」（改动即保存，重启会话生效）；reflectProvider / reflectModel 为可搜索下拉，须两项同时非空才覆盖会话模型，可单独清空以跟随会话模型；
2. 补丁层：在 profile 的 cordis.patch.yml 里 override dsh-ace 的 config。

设置页写入的值落在当前 profile 目录下的 dsh-ace.json（各 profile 各一份）。运行环境要求 Node >=22，DSH >=0.2.1-rc.2 <0.3.0（见插件 package.json 的 engines）。

安装与启用¶

官方说明：一条命令安装，无需 Python、无需构建、无第三方 npm 依赖。在 DSH 可用环境的终端执行：

dsh plugin add github:ADkun/dsh-ace

也可使用完整地址：

dsh plugin add https://github.com/ADkun/dsh-ace.git

安装后重启会话生效。卸载：

dsh plugin remove dsh-ace

典型用法¶

经过上面的安装步骤后，可以按下面方式使用。

1. 正常给 agent 派活；完成一个像样的任务后，在 autoReflect 为 true 时，agent 会被提示调用 ace_reflect，再用 ace_curate 把有价值候选写入手册。
2. 想人工沉淀：直接告诉 agent「把这条经验加进手册」，或编辑 .ace/playbook.md。
3. 下次同类任务：agent 在开始前应通过 ace_playbook 查阅相关条目。

社区目录页与源码：

• 目录：https://www.skillhub.cn/plugins/ADkun/dsh-ace
• GitHub：https://github.com/ADkun/dsh-ace

更细的架构与约定见仓库内 DESIGN.md、TESTING.md、AGENTS.md。

适用场景与注意¶

适合谁：希望在同一工作区内让 agent 逐步形成可复用操作习惯、又不想维护独立记忆服务的 DSH 用户；手册是明文 Markdown，适合需要人工审阅、订正经验的团队。

权限与安全：插件以当前 DSH 进程权限运行，会读写工作区（及 profile 下的 dsh-ace.json）。安装前应在 GitHub 查看源码与 MIT 许可证，确认符合你的合规要求。

容量：maxEntries 默认 60；手册过大时策展会被拒绝，需要合并或删减旧条目后再写入。

生态说明：DSH 奉行「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-ace 把「任务前查手册、任务后复盘、经验增量落盘」固定成三个工具和一个 Markdown 文件，在不改模型的前提下，让 agent 上下文工程可积累、可编辑。若你正在 DSH 里长期维护同一仓库或同一类任务，可以把它当作工作区内的可进化操作手册来试用。

• 插件目录：https://www.skillhub.cn/plugins/ADkun/dsh-ace
• 源码与 README：https://github.com/ADkun/dsh-ace