dsh-liya-workspace-plugin · 工作区档案速览插件
在 DeepSeek Harness WebUI 设置里新增「莉娅工作区」子设置页,实时展示工作区档案速览:
FILE-MAP 摘要、memory / records / diary 目录统计、最近日记列表。
结构
| 文件 | 作用 |
|---|
index.js | Host 半:注册 webServer 路由 /dsh-liya-workspace/summary,实时读工作区档案统计 |
client.js | Client 半(手写 bundle):设置页 settings.section 注册 + fetch 展示 + 极简 markdown 渲染 |
cordis.patch.yml | 插件挂载行(insert 进配置树) |
安装
# 方式一:本地目录(开发期,改源码重启即生效)
dsh plugin --profile web add <本目录>
# 方式二:tgz 包(交付/分发,可移植)
pnpm pack
dsh plugin --profile web add <本目录>/dsh-liya-workspace-plugin-<版本号>.tgz
dsh 请替换为你自己安装的 DSH CLI 调用方式。
装完重启 WebUI(完全退出再打开)生效。卸载:
dsh plugin --profile web remove dsh-liya-workspace-plugin
配置工作区根目录
插件需要知道工作区根目录(其下应包含 workspace/、diary/ 等目录),解析优先级:
- 设置页:设置 → 莉娅工作区 →
workspaceRoot 字段,填写绝对路径,保存即时生效(推荐)
- cordis.yml:插件条目
config.workspaceRoot 作为启动兜底
- 进程工作目录:两者都为空时使用 DSH host 进程的当前工作目录
数据链路
host(ctx.webServer 路由)→ JSON → client(fetch('/dsh-liya-workspace/summary'))→ 渲染。
验证
- 路由:
Invoke-WebRequest http://127.0.0.1:<port>/dsh-liya-workspace/summary → 200 + JSON
- 设置页:设置 → 莉娅工作区 → 档案速览 + FILE-MAP markdown 渲染
姊妹仓库
同族的其它 DSH 插件(各一个独立仓库):
许可
双许可——文档与代码分开:
- 代码(
index.js、client.js 与其它源文件):MIT —— 拿去用、改、再发,保留版权声明即可。
- 文档(本 README 的正文):CC BY 4.0 —— 可以自由使用、改编、连商用都行,但要署名(莉娅 / @feverZHONG)并注明来源。
两份许可的全文:LICENSE(MIT)/LICENSE-DOCS(CC BY 4.0)。
莉娅(@feverZHONG)· 宇宙美好记录官