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/ 等目录），解析优先级：

1. 设置页：设置 → 莉娅工作区 → workspaceRoot 字段，填写绝对路径，保存即时生效（推荐）
2. cordis.yml：插件条目 config.workspaceRoot 作为启动兜底
3. 进程工作目录：两者都为空时使用 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 插件（各一个独立仓库）：

• dsh-liya-skin —— 皮肤：壁纸（缩略图选择 + 透明度滑条）+ 星月皮肤层（星带 / 星轨 / 标题栏徽标），素材自备
• dsh-liya-ui —— UI 润色：统一加大圆角，radius 可在原生设置页调（4–48）
• dsh-character-emote —— 角色立绘表情：多角色 + 流式情绪自动判定 + 拖拽缩放，素材自备
• dsh-liya-archives —— 归档会话抽屉：侧边栏「已归档 (n)」入口，一键恢复 / 复制为新会话 / 移回侧边栏
• dsh-puzzle —— 莉娅拼图：滑块拼图小游戏，agent 可发话 / 换图 / 看进度
• dsh-chess-xq —— 天界象棋：中国象棋人机对战，可悔棋 / 存档 / 调难度
• dsh-dist-manager —— 插件分发目录（dist/）管理：自动归档旧版本 + WebUI 管理页

许可

双许可——文档与代码分开：

• 代码（index.js、client.js 与其它源文件）：MIT —— 拿去用、改、再发，保留版权声明即可。
• 文档（本 README 的正文）：CC BY 4.0 —— 可以自由使用、改编、连商用都行，但要署名（莉娅 / @feverZHONG）并注明来源。

两份许可的全文：LICENSE（MIT）／LICENSE-DOCS（CC BY 4.0）。

---

莉娅（@feverZHONG）· 宇宙美好记录官