EvoMap 出品 · English · 简体中文
**越用越聪明的 harness。** 大多数 agent 都是金鱼记忆：上一个会话刚踩过的坑，下一个会话照样踩；昨天已经调通的方案，今天又从头推导一遍，token 就这样一遍遍烧在同样的弯路上。 Evolver 让你的 dsh 智能体自己进化。每一次成功都会变成下一次的捷径，每一次失败都会变成下一次的避坑指南。 - **每条 prompt 前，带一条验证过的策略上场。** Evolver 从你的本地经验和 [EvoMap 网络](https://evomap.ai)里召回最贴合当前任务的一条，注入给智能体，不用你手动翻历史。 - **用证据打分，而不是凭感觉。** 回合结束后，Evolver 会看智能体有没有跑测试、构建、lint 或类型检查，最后一次检查是通过还是失败；下一次会话里，这一轮的改动是被保留还是被撤回；你的下一句话是在推翻它还是认可它。 - **优胜劣汰。** 每份复用结论都带着证据等级回报 EvoMap 网络，网络按证据为它加权。有效的策略越来越常被召回，被证伪的策略逐渐沉下去。 - **一个智能体踩过的坑，整个网络都绕开。** 经验在你的每个会话之间流转，也在所有接入 EvoMap 的智能体之间流转。 不注册账号也能用本地记忆；接入网络后，你的 harness 就和整个网络一起进化。插件还提供 `evolver_*` 工具和 `/evolver-*` 命令，用来提炼、固化、审阅和回滚学到的经验。 ## 安装 插件已发布到 npm：[`@evomap/dsh-evolver`](https://www.npmjs.com/package/@evomap/dsh-evolver)。每个 dsh profile 各自加载自己的插件，用到哪个 profile 就装到哪个（`dst` 用的是 `dsh-tui`）： ```bash dsh plugin --profile dsh-tui add -w @evomap/dsh-evolver@latest dsh plugin --profile web add -w @evomap/dsh-evolver@latest dsh plugin --profile headless add -w @evomap/dsh-evolver@latest ``` 装完后重启 dsh。升级时重新执行同一条命令即可：`@latest` 会让 pnpm 越过 profile 锁文件里已有的版本，装上最新版。 ### DSH Desktop 在应用的插件市场里安装，所有平台通用： 1. 打开 DSH Desktop 的插件市场，进入 **来源**。 2. 点击 **添加来源**，填入 `https://evomap.ai/dsh/catalog-source.json`，并选中这个来源。 3. 在 **可安装** 里找到 **Evolver**，点击 **安装**。 插件市场会安装 npm 上的最新版本。升级时，先在 **已安装** 里卸载，再重新安装一次。 #### 用命令行安装 `desktop` profile 由应用自己管理，npm 安装的 `dsh` 不会操作它。 **Windows**：打开 DSH Desktop 内置的终端，执行 ```bash dsh plugin add -w @evomap/dsh-evolver@latest ``` **macOS**：用应用自带的命令行入口和它自带的 pnpm 安装，并加上应用自己使用的 `minimumReleaseAge=0`，避免刚发布的版本被拦下： ```bash APP="/Applications/DSH Desktop.app/Contents" SHIM=$(mktemp -d) printf '#!/bin/sh\nexec node "%s/Resources/app/node_modules/pnpm/bin/pnpm.cjs" --config.minimumReleaseAge=0 "$@"\n' "$APP" > "$SHIM/pnpm" chmod +x "$SHIM/pnpm" PATH="$SHIM:$PATH" CI=true ELECTRON_RUN_AS_NODE=1 "$APP/MacOS/DSH Desktop" \ "$APP/Resources/app/lib/desktop-cli.js" \ plugin --profile desktop add -w @evomap/dsh-evolver@latest :<回合>` | 本回合跑过测试、构建、lint 或类型检查时 `tier` 为 `L1`，否则为 `none`；`applied`；最后一次检查的 `check` `{kind, passed, fail_then_pass}`；`aborted`；`stage: immediate` | | 追问补报 | 下一条提示词表示结果不对，或表示认可 | `…:correction` | `tier: L3`、`applied`、`stage: correction` | | 留存回访 | 同一项目的下一个会话发现本回合的改动被保留或被撤销 | `…:retention` | `tier: L2`、`applied`、`stage: retention` | | `evolver_asset_reuse_result` | 模型自己上报 | 模型自带 | `tier: L5`、`applied`、`stage: immediate` | - **`applied`** 把策略的编号步骤与本回合的 shell 命令、涉及的路径、编辑写入的代码（每回合最多 20 万字符，只留在内存里）和最终回答比对：半数以上步骤出现记 `used`，少于半数记 `partial`，一条都没有记 `unused`。回合没留下可比对的内容，或策略没有编号步骤时，按 tier `none` 加 `applied: partial` 上报，两边都不计权重，reason 里写 `applied: unknown`。 - **检查**指运行测试、构建、lint 或类型检查的 `bash` 命令。结果报错或输出里有失败信息都算失败，因为经 `tail` 管道的失败运行退出码仍是 0。判断 `fail_then_pass` 时会先去掉输出管道（`| tail -9`）和重定向（`2>&1`）再比较命令。 - **outcome** 跟随最后一次检查；没有检查时跟随回合的结束方式。 - **投递**：上报先存进 `~/.evolver/state/reports-outbox.json`，在每次回合结束、追问和会话开始时重试，保留 8 天。Hub 只要给出答复就算送达，包括 `duplicate_report` 和不计分的回执（`same_owner`、`daily_cap`）。Hub 判为无效的（`terminal: true`，或旧版 Proxy 返回的 `hub 400` / `hub 422`）记为被拒，不再重发。`hub 404`、`hub 5xx` 和网络失败会重试。 - `/evolver-status` 会列出最近上报的 Hub 判定（`eligible`、`counted`、`weight`）以及每条被拒上报的原因。带证据的上报还会在本地 root event 日志里记一次。 - reason 只写回合、采用判定和检查类型，不含提示词、命令、代码或 diff；召回前会先去掉提示词里的密钥和令牌。 ## 环境要求 Node.js 22.13+、dsh 0.1.5+。 配置项及默认值见 [`src/config.js`](src/config.js)。 ## 开发 ```bash npm ci npm test ``` ## 许可证 MIT © EvoMap.