前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。在智能体开发与运行过程中，工作区内的档案管理往往分散在 memory、records、diary 等目录中，且 FILE-MAP 的状态需要手动查阅。直接在 WebUI 中获取工作区状态的概览，能减少切换窗口的频率，提升调试效率。
插件简介¶
dsh-liya-workspace-plugin 是一个客户端插件，由 feverZHONG 维护。它通过在 DeepSeek Harness WebUI 的设置页中新增「莉娅工作区」子设置页，实现对工作区档案的实时读取与展示。
核心能力¶
该插件主要解决工作区档案不可视的问题，提供以下功能：
1. 新增设置页：在 WebUI 设置中增加「莉娅工作区」子设置页。
2. 实时速览：展示 FILE-MAP 的摘要信息、memory/records/diary 目录的统计数量，以及最近日记的列表。
3. 根目录配置：支持在工作区根目录的配置，修改后即时生效。
4. 接口路由：提供 /dsh-liya-workspace/summary 路由，供 Client 端读取摘要数据。
安装与启用¶
安装该插件需要通过本地目录方式。安装完成后必须重启 WebUI 才能生效。
# 安装插件
dsh plugin --profile web add <本目录>
# 卸载插件
dsh plugin --profile web remove dsh-liya-workspace-plugin
配置与使用¶
插件运行依赖于工作区根目录下包含特定的子目录（如 workspace/、diary/）。配置优先级遵循以下顺序：设置页 > cordis.yml > 进程工作目录。
使用步骤如下：
- 打开 WebUI 设置页，进入「莉娅工作区」子设置页。
- 在
workspaceRoot字段中填写工作区根目录的绝对路径。 - 保存配置（即时生效）。
- 重启 WebUI 进程。
- 在设置页即可看到档案速览内容。若需验证接口，可在终端执行：
Invoke-WebRequest http://127.0.0.1:<port>/dsh-liya-workspace/summary
注意事项¶
- 目录结构：插件需要工作区根目录包含
workspace/、diary/等目录才能正确统计。 - 许可证：代码部分采用 MIT 许可证，文档部分采用 CC BY 4.0 许可证。
- 权限要求：插件以当前 DSH host 进程的权限运行，请确保配置路径对进程可见。
总结¶
该插件为 DSH 用户提供了一个轻量级的工具，用于在 WebUI 界面内快速掌握工作区状态。通过可视化的概览，可以更方便地进行档案管理和调试。更多细节与源码可参考其 GitHub 仓库。
