🗂️ dsh-workspace-board
DeepSeek Harness 工作区管理面板:任意层级分组导航、原生侧边栏、LLM 整理与 AGENTS.md
工作区管理面板总览
把几十个工作区整理成清晰的分组树,从全屏面板到左侧边栏都能直接浏览、分组与跳转。
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 整理方案预览
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
- 点击左侧边栏「工作区」标题右侧的图标,打开全屏管理面板。
- 在树型模式创建分组与子分组,把工作区卡片拖入分组;点击分组磁贴进入下一层,点击面包屑返回。
- 在原生「视图选项 → 分组方式」中选择「按管理面板」,左侧边栏即按插件分组展示组、子组、工作区与会话。
- 点击「AI 整理」,选择模式并生成方案;预览确认后应用,可勾选同步原生侧边栏顺序。
- 悬停卡片查看统计,点击卡片进入工作区详情,查看会话指标、归档会话与打开工作区目录。
⚙️ 配置 / 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 桌面环境,无桌面环境时自动隐藏。
📄 License
MIT