工作区分组面板 SeverusZh/dsh-workspace-board

🗂️ dsh-workspace-board

DeepSeek Harness 工作区管理面板：任意层级分组导航、原生侧边栏、LLM 整理与 AGENTS.md

把几十个工作区整理成清晰的分组树，从全屏面板到左侧边栏都能直接浏览、分组与跳转。

DeepSeek Harness 的可视化工作区面板：嵌套分组导航、原生手感的侧边栏、LLM 辅助整理，支持 AGENTS.md。

✨ 核心特性

| 能力 | 说明 |
| 🗂️ 任意层级分组 | 根组、子组、子组的子组自由嵌套，安全上限 8 层；组页下钻、面包屑一键返回首页或任意中间层 |
| 🧭 分组导航页 | 首页组磁贴展示子组、工作区与会话计数；在任意组页继续新建子组，层次关系一目了然 |
| 📚 原生侧边栏按管理面板 | 递归展示「组 → 子组 → 工作区 → 会话」，行高、图标、标题基线、行距与官方「按工作区」逐像素一致；排序方式与归档筛选跟随原生设置 |
| 🎛️ 会话动作 | 置顶、重命名、分叉、归档、取消归档、复制 Session ID；运行中的会话归档前先确认停止 |
| 🤖 LLM 智能整理 | 使用 DSH 已配置模型，可选择思考强度与上下文窗口；固定系统提示词独立于主会话；方案先预览后应用，支持一键撤销 |
| 📄 AGENTS.md | 查看、编辑、保存与 AI 生成；缺失时由内置固化 Skill 结合工作区事实起草，模板兜底 |
| 🔍 悬停统计 | 卡片悬停显示会话数、文件数、占用空间与最近活动，按需扫描并缓存 |
| 🖱️ 拖拽整理 | 扁平视图排序，树型视图拖入分组；可折叠的树形「移动到分组」菜单 |
| 🖥️ 工作区详情 | 会话轮数、步数、token 消耗，归档显示与隐藏，打开工作区目录，面板内新建会话 |
| ⚙️ 系统配置 | 所有系统配置位于插件详情页，中英双语实时切换；主会话 Agent 可读取工作区结构的只读工具 |

📸 界面预览

分组导航与子分组

组页内可继续新建子分组，面包屑可随时跳回首页或任意祖先分组。

原生侧边栏按管理面板

与官方「按工作区」一致的缩进与行距，会话直达，右键菜单与原生动作一致。

工作区详情

会话轮数、步数与 token 消耗；归档眼睛开关；一键打开工作区目录或新建会话。

AI 整理方案预览

模型给出分组方案后先预览分组、移动与顺序变化，确认后才写入。

📦 安装 / Install

npm
dsh plugin --profile web add dsh-workspace-board

或使用 GitHub Release 中的离线包
dsh plugin --profile web add "file:$PWD/dsh-workspace-board-0.1.7.tgz"

安装后重启或刷新 DSH Web 页面，即可在左侧边栏「工作区」标题右侧看到入口图标。

🚀 使用 / Usage

1. 点击左侧边栏「工作区」标题右侧的图标，打开全屏管理面板。
2. 在树型模式创建分组与子分组，把工作区卡片拖入分组；点击分组磁贴进入下一层，点击面包屑返回。
3. 在原生「视图选项 → 分组方式」中选择「按管理面板」，左侧边栏即按插件分组展示组、子组、工作区与会话。
4. 点击「AI 整理」，选择模式并生成方案；预览确认后应用，可勾选同步原生侧边栏顺序。
5. 悬停卡片查看统计，点击卡片进入工作区详情，查看会话指标、归档会话与打开工作区目录。

⚙️ 配置 / Configuration

所有系统配置位于 设置 → 插件 → 已安装 → 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 | 删除工作区是否强制勾选确认 |

🤖 AGENTS.md 与 Agent 工具

- AGENTS.md：工作区卡片底栏展示是否存在 AGENTS.md。可查看、编辑、保存；缺失时可让模型按内置 agents-md-writer Skill 生成，规则只写磁盘可验证的事实，未知项显式标记 TODO，预览后才允许保存。
- Agent 工具：主会话 Agent 可调用只读工具 workspace_manager_structure，读取工作区列表、会话数、分组树与当前模式；传入 include_stats 时附带文件数与占用空间。

🔒 数据与隐私

- 分组与顺序保存在 $DSH_HOME/storages/workspace-manager/state.json，原子写入，损坏自动备份重建。
- 不读取、不上传会话内容；LLM 整理只发送工作区元数据与用户填写的附加指令。
- 模型凭据由 DSH 凭据体系管理，插件不接触 API Key。
- 无遥测、无额外网络请求。

🧩 兼容性 / Compatibility

- 支持 DSH >=0.2.1-rc.1 <0.3.0，在 0.2.1-rc.1 与 0.2.1-rc.2 上完成安装、装载与真实浏览器验证。
- 插件版本遵循 0.1.x 修复、0.2.0 语义或配置结构变更的约定。
- 侧边栏入口与「按管理面板」视图使用受控 DOM 增强，DSH 大版本升级后需回归。
- 「打开工作区目录」依赖 Host 桌面环境，无桌面环境时自动隐藏。

🤝 贡献 / Contributing

欢迎提交 Issue 与 PR。开发环境、常用命令、分层测试与隔离规则、代码与提交约定、CI 行为见 CONTRIBUTING.md；安全问题请按 SECURITY.md 通过 GitHub 私密漏洞报告渠道反馈，请勿公开提交密钥或用户数据。

📄 License

MIT