中文
在 DSH Web 会话中直接浏览和编辑 AGENTS.md(插件)
这是什么
DSH(DeepSeek Harness)Web GUI 插件:在会话「对话 / 轨迹」tab 栏新增 Agent tab,用于浏览和编辑当前项目的 AGENTS.md,让项目级 agent 指令随时可见、可改。
主要功能
会话内 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 进程
提示:修改包名 / 删除插件 / 改动组合配置后,必须重启 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路由,读写<path>/AGENTS.md - client 半(
lib/client.js):注册进conversation.view槽(id: agent,tab 文字「Agent」) - 纯 JavaScript,无构建步骤,复制即用
- dsh 的 patch 热更新语义是「只增改、不删除」:改名 = 新增 + 旧残留,必须重启清场,否则旧 bundle URL 404 会拖垮整页
与 DeepSeek Harness 的关系
本项目是基于 deepseek-ai/deepseek-harness 的 Cordis 插件机制开发的 Web UI 插件。
核心的智能体、会话、插件系统和 Web UI 都来自官方 Harness;本插件只负责:
- 在会话视图环(
conversation.view)中提供一个「Agent」视图 - 通过 host 路由读写项目根目录的 AGENTS.md
如果你需要命令行运行 Harness,或参与核心功能开发,请优先查看官方仓库。
特别感谢
感谢 DeepSeek Harness 项目和 DeepSeek AI 团队,以及 Cordis 提供的插件化基础。
同时感谢 dsh-web-ui 项目与作者 zhu1090093659,本插件的目录结构、dsh.client 声明与 patch 挂载方式沿用了 dsh-web-ui 插件家族的最佳实践。
And you.
友情链接
这里收录 DeepSeek Harness 生态项目。
| 项目 | 简介 | 链接 |
|---|---|---|
| DeepSeek Harness | 官方项目:核心智能体、插件系统与 Web UI。 | GitHub |
| dsh-web-ui | DSH Web UI 插件与皮肤合集(本插件的挂载方式参考来源)。 | GitHub |
| Awesome DSH Plugin | DeepSeek Harness 社区插件精选列表。 | GitHub |
开发
纯 JavaScript,无构建步骤。修改 lib/ 后,把包同步到 ~/.dsh/profiles/web/node_modules/@mrwoov/dsh-agent-md/ 并重启 dsh 即可。
# 本地快速语法检查
node --check lib/index.js
node --check lib/client.js
License
本项目遵循 MIT License。
本项目是 DeepSeek Harness 生态的社区插件,并非 DeepSeek 官方产品。
本项目完全开源免费。如果有人向您以任何形式出售此软件,请拒绝交易。
No comments yet. Be the first to write one.