5.1 KiB
5.1 KiB
dsh-worktable 🖥️
English · 简体中文
DeepSeek Harness 的 agent 项目工作台——侧边栏「应用抽屉」把每个项目变成可停靠的窗口,再加一个实时监控所有项目的内置「控制室」。
📸 截图
![]() |
🖥️ 控制室主界面 —— 内置默认项目:实时卡片网格监控每个项目(工作中 / 待你决定 / 已完成),蓝图网格上的玻璃拟态卡片 |
![]() |
🧩 工作台侧边栏 —— 应用抽屉:项目、快捷方式与固定首位的控制室入口 |
![]() |
🪟 我们的项目 —— 每个项目打开为可停靠的分栏工作区(含旅行 Atlas 等入驻应用) |
✨ 功能导览
🧩 侧边栏应用抽屉
- 收纳你的自建项目(以及 dsh-travelatlas 等入驻插件项目)
- 项目支持改名 / 图标 / 排序 / 隐藏;每个项目有专属文件夹;项目 ↔ 对话绑定——打开项目时右侧对话窗自动切到其绑定对话
- 收起侧边栏后,每个项目变成可点击的方形小贴片(只留 emoji)
🪟 可停靠的分栏工作区
- 声明式布局预设(左栏 / 顶行 / 主网格 + 右侧对话窗)
- 可拖拽分割线、窗格标签页、按布局持久化的宽度记忆
- 内置窗格:文件资源管理器、终端、浏览器、动画站点、自定义窗口
- 自定义窗口:把需求发给新建或已有对话,agent 完成后产物自动挂载进对应窗口(锁死)
🖥️ 控制室(内置默认项目)
- 固定在首位的不可删除项目——首次打开绑定一条管理对话即可
- 三列卡片网格实时镜像每一个项目的状态:工作中 / 待你决定 / 已完成,附带运行时长与清洗后的最近消息预览
- 宿主会话快照的事件订阅镜像——零轮询、零 Token
- 玻璃拟态卡片、深色/白色/跟随系统主题、霓虹状态光效与工作中卡片的旋转彗星光点
一览
| 🧩 插件类型 | Cordis 插件——服务端路由 + Web 客户端,纯增量(不替换任何官方插件) |
| 🪟 工作区引擎 | 自研分栏引擎,渲染进宿主的 shell overlay 座位 |
| 💬 对话窗 | 复用宿主对话——插件只做会话选择(sessions.open) |
| 📡 状态数据 | 宿主会话运行时快照的镜像(订阅驱动) |
| 💾 状态存储 | 仅 localStorage(dsh.worktable.*),不碰工作区文件 |
| 🎨 界面 | TypeScript + React(宿主 external)+ 原生 CSS,暗色优先 + 浅色主题 |
快速开始
- 安装:
dsh plugin --profile web add "link:<repo>/01_content",并把dsh-worktable注册进 profile 的 bundle 列表 - 重启 DSH web 进程并刷新界面
- 打开控制室:点击固定首位的 🖥️ 控制室卡片 → 绑定一条对话(加入现有或新建)→ 得到实时卡片网格
- 创建项目:侧边栏 + → 选布局预设、填项目文件夹
架构
一个包同时包含宿主 Cordis 插件与 Web 客户端:
- 宿主:
/api/worktable/*路由——健康检查、文件系统、git、文件读写、站点托管、mkdir、工作区、原生皮肤模板;WebSocket/api/worktable/term提供终端窗格(Windows 下为 PowerShell) - 客户端:经 slot 协议注入侧边栏与 shell overlay;分栏引擎、标签模型、拖拽与持久化均为自研
- 控制室:读取宿主会话列表快照(运行中/待决/已完成、后台任务、子代理目录)——事件驱动镜像,模型不参与
- 窗口任务:agent 完成后在项目文件夹写
widget-result.json,客户端把产物挂载进指定窗口并锁死
开发与测试
cd 01_content
npm install
npm run build # lib/index.js + lib/client.js
node --check lib/index.js
- 构建必须在 01_content 内执行——在仓库根构建会把 lib 写到错误位置,宿主仍加载旧 bundle
- 客户端 bundle 保持
window.__ModuleLoader__.load握手;react 与 @deepseek-ai/* 全部 external - 回归:
04_test/functional-diag.cjs(20 步)+ 专项探测(控制室、绑定弹窗、收起态贴片、模型继承)
已知限制
- 状态在浏览器本地(localStorage)——项目、绑定与视图不跨设备同步
- 终端窗格在 Windows 上是朴素的 PowerShell 宿主(与原生终端应用无 PTY 对等)
- 自动挂载要求 agent 确实在项目文件夹写出
widget-result.json - 控制室只监控已绑定对话的项目;未绑定的项目显示为空闲
隐私
无遥测;除宿主 API 与插件自身路由外无任何网络请求。用户状态全部留在 localStorage。
License
MIT
相关项目
- dsh-reminder — 跨窗口的任务完成与审批提醒
- dsh-usage — 常驻的余额/用量面板


