dsh-agent-md

PROJECT TOPICS

项目标签

dsh-plugin

PROJECT README

README

_中文

在 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,不会串文件、串目录。

安装

把本包放到 ~/.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 官方产品。

本项目完全开源免费。如果有人向您以任何形式出售此软件,请拒绝交易。

CLASSIFICATION EVIDENCE

分类依据

项目类型待识别

功能分类其他

规则置信度低

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中：无有效分类标签。