@mrwoov/dsh-agent-md

中文

在 DSH Web 会话中直接浏览和编辑 AGENTS.md(插件)

这是什么

DSH(DeepSeek Harness)Web GUI 插件:在会话「对话 / 轨迹」tab 栏新增 Agent tab,用于浏览和编辑当前项目的 AGENTS.md,让项目级 agent 指令随时可见、可改。

主要功能

会话内 Tab

在会话头部 tab 栏新增「Agent」tab,与「对话」「轨迹」并列,随时切换,无需离开当前会话。

项目 AGENTS.md

自动定位当前会话项目目录下的 AGENTS.md;文件不存在时,输入内容保存即自动创建。

浏览 + 编辑

等宽字体直接编辑,顶部显示「未保存 / 已保存」状态,一键写回磁盘。

随会话切换

切换会话自动加载对应项目的 AGENTS.md,不会串文件、串目录。

安装

1. 把本包放到 ~/.dsh/profiles/web/node_modules/@mrwoov/ 下
2. 在 ~/.dsh/profiles/web/cordis.patch.yml 追加:

- insert:
    - id: agent-md
      name: '@mrwoov/dsh-agent-md'

3. 重启 dsh 进程

提示:修改包名 / 删除插件 / 改动组合配置后,必须重启 dsh 才彻底生效(热更新只增不删,见技术要点)。

HTTP 接口

方法	路径	说明
GET	/api/agent-md?path=	返回 { exists, content }
POST	/api/agent-md?path= body { content }	写入 /AGENTS.md

技术要点

• host 半(lib/index.js):注册 /api/agent-md 路由,读写 /AGENTS.md
• client 半(lib/client.js):注册进 conversation.view 槽(id: agent,tab 文字「Agent」)
• 纯 JavaScript,无构建步骤,复制即用
• dsh 的 patch 热更新语义是「只增改、不删除」:改名 = 新增 + 旧残留,必须重启清场,否则旧 bundle URL 404 会拖垮整页

与 DeepSeek Harness 的关系