4.7 KiB
4.7 KiB
dsh-worktable 🖥️
English · 简体中文
DeepSeek Harness 的 agent 项目工作台——侧边栏「应用抽屉」把每个项目变成可停靠的窗口，再加一个实时监控所有项目的内置「控制室」。
✨ 功能导览
🧩 侧边栏应用抽屉
- 收纳你的自建项目（以及 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 — 常驻的余额/用量面板