42 lines
1.9 KiB
Markdown
42 lines
1.9 KiB
Markdown
|
# dsh-worktable（工作台）
|
|||
|
|
|
|||
|
|
> DeepSeek Harness 侧边栏的 agent 级项目容器（应用抽屉）。纯增量插件，不替换、不禁用任何官方插件。
|
|||
|
|
|
|||
|
|
## 是什么
|
|||
|
|
|
|||
|
|
- **侧边栏「工作台」区块**：收纳用户自建项目与入驻插件项目，支持改名/图标/排序/显示隐藏、项目 × 对话绑定、项目文件夹。
|
|||
|
|
- **分栏工作区引擎（自研）**：声明式布局预设（左栏/顶行/主行 + 右侧对话窗），窗格可拖拽分割、标签页模型；内置 资源管理器 / 终端 / 浏览器 / 动画 / 自定义窗口。
|
|||
|
|
- **控制室**：默认自带项目（固定首位、不可删除），项目卡片网格实时监控所有项目的状态（工作中/待你决定/已完成），零轮询零 Token。
|
|||
|
|
- **自动挂载握手**：项目内 agent 完成窗口任务后写 widget-result.json，产物自动挂进对应窗口。
|
|||
|
|
|
|||
|
|
## 技术底座
|
|||
|
|
|
|||
|
|
- Cordis 插件协议（客户端 bundle + 服务端路由 /api/worktable/*、终端 WebSocket）。
|
|||
|
|
- 界面经 slot 座位协议注入侧边栏与 shell.overlay；对话窗复用宿主会话服务（sessions.open）。
|
|||
|
|
- 状态监控为宿主会话运行时快照的事件订阅镜像；视图/项目/绑定状态存 localStorage。
|
|||
|
|
- 客户端：TypeScript + React（host externals）+ 原生 CSS；服务端：Node。
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
|
|||
|
|
cd 01_content
|
|||
|
|
npm install
|
|||
|
|
npm run build # lib/index.js + lib/client.js
|
|||
|
|
node --check lib/index.js
|
|||
|
|
|
|||
|
|
注册到 DSH：`dsh plugin --profile web add "link:<repo>/01_content"`
|
|||
|
|
|
|||
|
|
## 构建注意事项
|
|||
|
|
|
|||
|
|
- **必须在 01_content 目录下构建**：误在仓库根跑会把 lib 写到仓库根，宿主仍加载 01_content/lib 旧 bundle（「改完不生效」假象）。
|
|||
|
|
- 客户端 bundle 保持 window.__ModuleLoader__.load 握手，react/@deepseek-ai/* 全部 external。
|
|||
|
|
|
|||
|
|
## 相关文档
|
|||
|
|
|
|||
|
|
- 项目规则：仓库根 AGENTS.md
|
|||
|
|
- 需求与协议：02_process/PRD.md
|
|||
|
|
- 工作日志：02_process/worklogs/
|
|||
|
|
|
|||
|
|
## License
|
|||
|
|
|
|||
|
|
MIT
|