在 DeepSeek Harness (DSH) Web 界面开发或调试智能体时,项目级指令文件(如 AGENTS.md)通常存放在本地。查看或修改这些文件往往需要切换到文件管理器或外部编辑器,打断当前会话的上下文。mrwoov/dsh-agent-md 插件解决了这个问题,它直接在 Web 会话界面中提供了编辑 AGENTS.md 的入口。
这是一个 DSH Web GUI 插件。它在会话头部标签栏新增「Agent」选项卡,与「对话」和「轨迹」并列。其主要作用是让用户在浏览器中直接浏览和编辑当前会话对应项目目录下的 AGENTS.md 文件。
核心功能¶
- 会话内 Tab:在会话头部 tab 栏新增「Agent」tab,与「对话」「轨迹」并列,随时切换,无需离开当前会话。
- 自动定位:自动定位当前会话项目目录下的
AGENTS.md;文件不存在时,输入内容保存即自动创建。 - 编辑体验:使用等宽字体直接编辑,顶部显示「未保存 / 已保存」状态,支持一键写入磁盘。
- 上下文隔离:切换会话自动加载对应项目的
AGENTS.md,不会串文件、串目录。
安装与启用¶
- 把本包放到
~/.dsh/profiles/web/node_modules/@mrwoov/目录下。 - 在
~/.dsh/profiles/web/cordis.patch.yml文件中追加以下内容:
- insert:
- id: agent-md
name: '@mrwoov/dsh-agent-md'
- 重启 dsh 进程。
典型用法¶
插件通过 HTTP 接口与后端交互,提供了读写项目的 AGENTS.md 的能力:
- 读取:
GET /api/agent-md?path=<项目目录>返回{ exists, content }。 - 写入:
POST /api/agent-md?path=<项目目录>body{ content }写入<目录>/AGENTS.md。
技术要点¶
- 纯 JavaScript:无构建步骤,复制即用。
- 热更新限制:DSH 的 patch 热更新语义为「只增改、不删除」。如果修改了包名或配置组合,必须重启 dsh 进程才能彻底生效(例如改名会导致新旧残留,旧 bundle URL 404 会拖垮页面)。
- 实现方式:
host半 (lib/index.js) 注册/api/agent-md路由,读写文件;client半 (lib/client.js) 注册进conversation.view槽。
生态与背景¶
本项目基于 DeepSeek Harness 的 Cordis 插件机制开发,依赖官方的 Web UI 组件。它是 DeepSeek Harness 生态的社区插件,并非 DeepSeek 官方产品。
- 目录页:https://www.skillhub.cn/plugins/mrwoov/dsh-agent-md
- GitHub:https://github.com/mrwoov/dsh-agent-md