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

A visual workspace board for DeepSeek Harness: nested group navigation, a native-feeling sidebar, LLM-assisted planning and AGENTS.md support.

---

✨ 核心特性

能力	说明
🗂️ 任意层级分组	根组、子组、子组的子组自由嵌套，安全上限 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.8.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