dsh工作进程3D实时可视化

English

DeepSeek Harness（DSH）插件。它在会话视图里新增「3D 工作进程」标签页，把智能体的工作过程渲染成一座写实的 3D 精密工厂：token 是燃料，工具调用在各个工位上加工，每一轮对话的成果作为一个批次入库。

当前版本 0.1.0 是开发中的原型：场景由内置的演示会话驱动，还没有接入真实会话数据；美术和镜头仍在迭代。

场景里有什么

工厂位于一座约 420 米高的摩天楼顶层的白色中庭里：四周是落地玻璃，朝向夕阳的一侧有阳台，脚下是开阔的未来城市（黄昏或白昼），远处的云端算力塔用一道光束给燃料罐供能；后方的弧形大屏实时显示 token 流量、工作概况和花费。设备立在几座悬浮平台上，平台之间有发光的数据通道，地面抛光到接近镜面，能映出设备和城市灯光。

设备	对应的数据
燃料罐	DeepSeek 账户余额，按当前模型价格折算可用 token；指示灯区分高峰（全价）与低谷（半价）时段
主引擎	转子转速跟随生成速率；核心颜色表示阶段（蓝 生成、紫 推理、橙 工具）
仪表台	上下文压力表（接近上限时泄压阀冒汽）、转速表、机械计数轮：未命中输入、缓存命中、输出、推理、花费
晶圆供料器 → 装载锁	每次工具调用投放一片晶圆，经装载锁进入工位区
中央机械臂	在装载锁、工位和卸载锁之间搬运晶圆，排队越多动作越快；侧面的灯条和底座上的小屏显示当前动作、路线和手上的晶圆
10 个工位	档案检索站（read/grep/glob）、激光雕刻机（write/edit）、终端控制台（pwsh/bash）、卫星天线（联网搜索/抓取）、协作机械臂（子代理/工作流）、液压压缩机（上下文压缩）、任务看板（todo/目标）、呼叫信标（向用户提问）、贴标包装机（交付文件）、通用模块（其他与 MCP 工具）
卸载锁 → 装载端口 → 天车 → 成品库	加工完的晶圆装进当前批次的 FOUP；一轮对话结束后天车把它运到成品库，标签显示「合格」或「返工」

金色晶圆表示这次调用写入或交付了文件，红色表示调用失败。

操作

• 视角模式「环绕」：拖动旋转，滚轮向光标处缩放，右键平移。
• 视角模式「漫游」：拖动转动视线（可以抬头看天窗），滚轮前进后退，右键平移，双击地面走过去；先点一下画面，再用 WASD 或方向键移动，Q/E 升降，按住 Shift 加速。可以从敞开的玻璃门走到阳台上。
• 右上角：视角「总览」「燃料」「引擎」「工位」「成品」「阳台」；「跟随」（镜头跟着正在工作的工位）、「标签」（机器名称）、「面板」（底部数据面板）、「显示」、「全屏」。
• 「显示」里可以切换场景（黄昏/白昼）、调亮度，选画质（自动/低/中/高/极致）和帧率上限（自动/30/60/120/不限），打开性能统计。
• 鼠标悬停在设备或批次上会高亮并显示详情，点击设备飞到对应视角。
• 底部指标卡：余额、上下文、输入（缓存命中率与未命中量）、输出（含推理）、花费（高峰/低谷）、工具调用、产出（文件与增删行数）、效率（每千输出 token 改动行数、每个文件的花费）。把鼠标停在卡片上可以看到完整说明。
• 画质默认按显卡自动选择，帧率持续偏低时先降低渲染分辨率，仍不够再临时降一档；手动选择的画质会被记住，不再自动调整。

系统要求

• DeepSeek Harness 0.2.0 及以上（开发时使用 0.2.2-rc.3）。
• 支持 WebGL 2 的浏览器或 DSH 桌面端，并开启硬件加速。

开发

pnpm install
pnpm build   # 生成 dist/client.js（three.js 打包在内，React 使用宿主提供的版本）
pnpm test    # 数据模型测试 + 无 WebGL 的场景冒烟测试

dist/client.js 随源码一起提交，这样可以直接从仓库安装。要在 DSH 里试用本地副本，让 DSH 智能体用 plugin_manager 的 install_bundle 安装仓库所在的目录即可。

改动流程

main 分支受保护，所有改动都通过拉取请求（PR）合并：

1. 从 main 新建分支，例如 feat/…、fix/…、docs/…。
2. 提交并推送分支，开 PR。CI 会运行测试和构建，并检查提交的 dist/client.js 与源码一致。
3. 审核通过后压缩合并（squash）到 main，然后删除分支。

目录结构：

• index.js：Host 端入口（M0 为空，M1 将注册会话投影）。
• src/model/：与渲染无关的数据模型：计价与峰谷时段、工具到工位的映射、会话事件 reducer、演示会话。
• src/client/scene/：three.js 场景，全部程序化建模（无外部模型和贴图文件）。
• src/client/view/：React 视图与 HUD。
• scripts/build.mjs：用 esbuild 打包成 DSH Client 模块格式。

路线图

1. M0 风格原型（进行中）：建模、材质、灯光、镜头和动画，演示数据驱动。
2. M1 真实数据：Host 端会话投影，接入真实 token、上下文、工具调用、轮次与文件改动，余额来自 DeepSeek 账户。
3. M2 打磨：后期效果、材质细节、镜头、批次回放、时间线与投入产出报表。
4. M3 可选扩展：DeepSeek 工具 API（语音播报等），默认关闭并标明费用。
5. M4 发布：npm 发布并提交到 DSH 插件市场。

许可证

MIT。打包的 three.js 同样使用 MIT 许可证。