前言¶
在 DeepSeek Harness（DSH）里长期并行多个工作区时，原生「按工作区」列表往往只能平铺展示。工作区一多，找目录、找会话、调整顺序都要在长列表里来回翻。若还需要给项目分组、在侧边栏按业务线浏览，通常只能依赖命名习惯或外部笔记，和 DSH 内的会话、归档状态脱节。
dsh-workspace-board 是社区维护的客户端插件，在 Web 端提供全屏管理面板，并增加「按管理面板」分组视图，把分组树、拖拽整理、统计信息与 LLM 辅助整理接到同一套状态里。下面按定位、能力、安装与配置说明用法与注意点。
这是什么¶
插件 npm 包名为 dsh-workspace-board，由 SeverusZh 维护，在 SkillHub 目录中归类为客户端插件。当前 package 版本为 0.1.9，许可证 MIT。
一句话定位：面向 DSH Web 的工作区管理面板——支持任意层级分组导航、与官方「按工作区」对齐的侧边栏展示、LLM 整理方案预览与应用，以及工作区级 AGENTS.md 的查看与生成。
核心功能¶
分组与导航¶
- 根组、子组可嵌套，安全上限 8 层；组页可下钻，面包屑可回到首页或任意中间层。
- 首页以组磁贴展示子组、工作区与会话数量；在任意组页可继续新建子组。
- 扁平视图支持拖拽排序；树型视图支持把工作区拖入分组；「移动到分组」为可折叠树形菜单。
原生侧边栏「按管理面板」¶
在「视图选项 → 分组方式」中选择「按管理面板」后，左侧边栏递归展示「组 → 子组 → 工作区 → 会话」。行高、图标、标题基线与行距按 README 说明与官方「按工作区」对齐；排序与归档筛选跟随原生设置。
新建工作区时，对话框内置目录浏览，选中后路径自动回填。分组与工作区的折叠状态会记忆，切换视图或刷新后仍保留。从管理面板打开某条会话时，侧边栏会展开所属分组与工作区，滚动到该会话并选中。
会话与工作区详情¶
会话动作包括：置顶、重命名、分叉、归档、取消归档、复制 Session ID；运行中的会话在归档前会先确认是否停止。
工作区详情页可查看会话轮数、步数、token 消耗，控制归档会话显示，打开工作区目录，以及在面板内新建会话。卡片悬停可查看会话数、文件数、占用空间与最近活动（按需扫描并缓存）。
LLM 智能整理¶
使用 DSH 已配置的模型，可选思考强度与上下文窗口；整理用系统提示词独立于主会话。模型输出方案后先预览分组、移动与顺序变化，确认后再写入，支持一键撤销。应用时可选择是否同步原生侧边栏顺序（与配置项 applyNativeOrder 相关）。
AGENTS.md 与 Agent 工具¶
工作区卡片底栏可查看是否已有 AGENTS.md，支持查看、编辑、保存与 AI 生成。缺失时可通过内置 agents-md-writer Skill 结合工作区事实起草，模板兜底；生成内容强调磁盘可验证事实，未知项标记 TODO，预览后才允许保存。
主会话 Agent 可调用只读工具 workspace_manager_structure，读取工作区列表、会话数、分组树与当前模式；include_stats 为真时附带文件数与占用空间。
系统配置与界面¶
插件详情页集中系统配置，支持中英双语实时切换。
安装与启用¶
环境要求：Node >=20；DSH 版本 >=0.2.1-rc.1 <0.3.0（README 写明在 0.2.1-rc.1 与 0.2.1-rc.2 上完成安装与浏览器验证）。
安装命令（来自官方 README）：
# npm
dsh plugin --profile web add dsh-workspace-board
# 或使用 GitHub Release 中的离线包
dsh plugin --profile web add "file:$PWD/dsh-workspace-board-0.1.9.tgz"
安装后重启或刷新 DSH Web 页面。入口在左侧边栏「工作区」标题右侧的图标。
插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证，确认符合你的安全与合规要求。
典型用法¶
- 点击「工作区」标题右侧图标，打开全屏管理面板。
- 在树型模式创建分组与子分组，把工作区卡片拖入分组；点分组磁贴进入下一层，用面包屑返回。
- 在「视图选项 → 分组方式」选「按管理面板」，侧边栏按插件分组展示。
- 在侧边栏分组行悬停后点「+」新建工作区，用「浏览…」选目录；折叠状态会自动记忆。
- 从管理面板经工作区详情打开会话时，「按管理面板」侧边栏会自动展开并定位到该会话。
- 使用「AI 整理」生成方案，预览确认后应用，可按需同步原生侧边栏顺序。
- 悬停卡片看统计，进入详情查看会话指标、归档与打开工作区目录。
配置说明¶
路径：设置 → 插件 → 已安装 → Workspace Board → 配置。
| 分组 | 配置项 | 说明 |
|---|---|---|
| LLM | provider / model |
取自 DSH 已配置的提供方与模型 |
| LLM | reasoningEffort |
思考强度，可留空跟随默认 |
| LLM | contextWindow |
默认 65535；0 表示跟随模型声明值 |
| LLM | maxOutputTokens / temperature |
输出上限默认 4096，温度默认 1.0 |
| 整理 | flatPrompt / treePrompt |
扁平与树型提示词，留空用内置默认值 |
| 整理 | maxGroups |
树型模式最大分组数 |
| 统计 | scanMaxFiles / scanMaxDepth |
目录扫描上限，超出显示 ≥ |
| 统计 | cacheTtlMs / exclude |
缓存时间与排除目录名 |
| 行为 | applyNativeOrder |
应用方案时是否默认同步侧边栏原生顺序 |
| 行为 | confirmDelete |
删除工作区是否强制勾选确认 |
数据、隐私与兼容性¶
- 分组与顺序保存在
$DSH_HOME/storages/workspace-manager/state.json，原子写入；损坏时自动备份重建。 - 不读取、不上传会话内容；LLM 整理仅发送工作区元数据与用户附加指令。模型凭据由 DSH 凭据体系管理，插件不接触 API Key。无遥测、无额外网络请求。
- 侧边栏入口与「按管理面板」通过受控 DOM 增强实现，DSH 大版本升级后需自行回归。
- 「打开工作区目录」依赖 Host 桌面环境，无桌面环境时入口隐藏。
适用场景与注意¶
适合在 DSH Web 中同时维护大量工作区、需要按项目或业务线分组，并希望在侧边栏与会话跳转上与分组状态一致的场景。若你主要依赖单工作区、少量会话，原生列表可能已够用。
DSH 生态强调「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。插件 GitHub 仓库当前星标为 1，功能与兼容性以 README 与 Release 为准。
结尾¶
dsh-workspace-board 把分组树、全屏面板、原生侧边栏视图、LLM 整理与 AGENTS.md 收进同一套工作区管理流程，状态落在本地 state.json，整理与生成均可预览后再落盘。
- 目录页：https://www.skillhub.cn/plugins/SeverusZh/dsh-workspace-board
- 源码与文档：https://github.com/SeverusZh/dsh-workspace-board
