AGENTS.md 设置入口 dongfangxy/dsh-agents-md-settings

AGENTS.md 设置行 — DeepSeek Harness

DeepSeek Harness 每次新建会话都会读取 AGENTS.md，但界面上没有入口能打开这个文件。这个小插件包在设置 → 通用里加一行，把文件交给你的编辑器打开。

设置 → 通用里的这一行

中文说明见文末。

它做什么

点击用记事本打开 / Open in editor，会用系统编辑器打开 ~/.dsh/AGENTS.md。仅此而已：没有遥测，没有网络请求，也不会改动文件本身。

在 Windows 上，插件包直接启动记事本。.md 文件通常没有 shell 关联，如果依赖「用默认应用打开」，会弹出选择框；通过 cmd /c start 启动时甚至什么都不发生。

工作原理

一个 cordis 插件包，分宿主端和客户端两半：

| 文件 | 作用 |
| cordis.patch.yml | 往配置档里插入一行，名为 agents-md-settings |
| index.js | 宿主端：注册 POST /agents-md/open，解析路径，启动编辑器 |
| client.js | 客户端：把这一行注册到 settings.general.item 插槽 |
| package.json | 声明 dsh.bundle.patch 和 dsh.client |

客户端只向 /agents-md/open 发 POST 请求。宿主端自己解析 os.homedir()/.dsh/AGENTS.md，然后启动编辑器——Windows 用 notepad.exe，macOS 用 open，其他平台用 xdg-open。在 Windows 上，宿主端随后会等待记事本窗口出现，恢复它、调整到 900×640 并置顶，因为保存过的旧窗口位置会让打开的文件看起来像什么都没发生。

这个路由不接收请求体，也不接收调用方传入的路径，所以它唯一能打开的文件就是当前用户自己的 AGENTS.md。

安装

这是本地插件包，不是 npm 包。请使用应用实际运行的配置档——Windows 桌面版默认是 %ProgramData%\dsh-data\profiles\desktop；确切路径在应用的 DSH_PROFILE_DIR 里。

1. 把这个文件夹复制到：

<profile>/node_modules/@local/agents-md-settings

2. 往 <profile>/cordis.patch.yml 加一行，缩进与现有内容保持一致：

- insert:
- id: agents-md-settings
name: "@local/agents-md-settings"

3. 重启 DeepSeek Harness。这一行会出现在设置 → 通用的底部。

如果你的构建暴露了 plugin_manager 工具，用 install_bundle 并指定 target: "<absolute path to this folder>"，就能完成第 1–2 步。

卸载

从 cordis.patch.yml 删掉这一行，删除 <profile>/node_modules/@local/agents-md-settings，然后重启。

说明与限制

- 修改在下一个会话生效。 AGENTS.md 只在会话的第一次请求时读取一次，不会监听外部改动。
- 目前仅支持 Windows，在 Windows 11 桌面版上测试过。macOS 和 Linux 走 open / xdg-open，但未测试。
- 这个路由监听应用自己的本地源。它只打开一个固定文件，不接受任何参数，不是通用的「执行这个」端点。
- 如果这一行没有出现，先确认包是否解析成功，再看 cordis.patch.yml 是否还能正常解析；YAML 里一个拼写错误就会让整个补丁层加载失败。

版本历史

| 版本 | 变更 |
| 1.0.0 | 在 Windows 上端到端跑通。客户端向路由发 POST 请求；宿主启动记事本并把窗口提到前台。 |
| 0.7.0 | 去掉 detached: true —— 在 Windows 上，分离的 PowerShell 根本启动不了编辑器，于是路由返回 200，界面上却什么都没出现。 |
| 0.6.0 | 改回 fetch(POST)：桌面外壳拒绝 target="_blank"，所以 0.4.0 里那行基于锚点的链接点了没反应。 |
| 0.5.0 | 按标题找到记事本窗口，再还原、调整尺寸并提到前台。 |
| 0.4.0 | 这一行渲染成普通链接（后来回退了）。 |
| 0.3.0 | Windows 上直接启动记事本，不再走 cmd /c start。 |
| 0.2.0 | 宿主解析 ~/.dsh/AGENTS.md，并提供 POST /agents-md/open；客户端不再发送路径。 |
| 0.1.0 | 第一次尝试：客户端调用 session/openWorkspacePath 并传入 ~/.dsh/AGENTS.md；有些宿主会在 Documents 下展开 ~，结果打开了错误的文件夹。 |

如果你要做类似的东西，这三个坑值得记住：

1. 不是每个宿主入口都会展开 ~ —— 改在宿主进程里解析主目录。
2. 桌面外壳里的 可能永远不会跳转。
3. 在 Windows 上，spawn(..., { detached: true }) 可能悄无声息地启动不了子进程的 GUI 应用。

中文说明

DSH 每个新会话都会读 AGENTS.md，但界面上没有入口能打开它。这个 bundle 在 设置 → 通用 里加一行，点一下就用系统编辑器打开 ~/.dsh/AGENTS.md。

- 前端只负责 POST /agents-md/open；路径由宿主用 os.homedir() 解析，包里不写死任何人的路径。
- Windows 上直接拉起记事本，并且会把窗口还原成 900×640 提到前台（记事本可能记住了一个极小的窗口尺寸，看起来就像"没反应"）。
- 安装：把目录拷到 <profile>/node_modules/@local/agents-md-settings，在 <profile>/cordis.patch.yml 里加一条 insert 行，重启应用即可。卸载反过来做。
- 改完保存后，下一个会话才生效；当前会话不会重载。

License

MIT © Chengxi Zhang