前言¶

在 DeepSeek Harness（DSH）会话中，模型请求、工具执行和回合结束通常以事件形式出现。对单条事件来说，聊天流可以查看；对多个智能体、子会话或连续工具调用来说，需要一种更直观的方式确认当前状态、计划任务和最近公开工具事件。

下面介绍 DSH 插件 lhwu1/dsh-lookseek。它在 DSH 会话的“工作间”标签页展示真实智能体状态、计划任务、最近工具事件和一个可互动的 3D 办公区。它不是第二个聊天窗口，也不会猜测模型的内部推理；机器人只根据 Harness 会话状态和可信活动事件移动、显示状态。

这是什么¶

lhwu1/dsh-lookseek 是 DeepSeek Harness 的可视化工作间插件。仓库路径为：

lhwu1/dsh-lookseek

插件代码使用 MIT License。它解决的核心问题是：在 DSH 会话之外，用工作间页面展示当前会话及子会话中的真实状态，而不是虚构额外团队或额外聊天窗口。

核心功能¶

工作间展示¶

插件在“工作间”标签页展示三类内容：

• 左侧成员栏：显示当前会话及子会话的智能体、预设、中文状态、当前工位与本轮耗时。
• 中央 3D 场景：显示机器人、工作工位、状态标签、对话气泡和路线动画。
• 右侧看板：显示计划任务与最近公开工具事件。

不同智能体使用不同颜色，并且绑定到真实 agentId、会话预设和状态。

真实事件映射¶

插件会监听当前会话中的以下事件：

• 会话开始
• 模型请求
• 工具执行
• 回合结束

这些事件会被映射到固定工位。页面显示的是安全摘要，不展示完整命令、绝对路径、密钥、令牌、密码或原始工具参数。

自定义 GLB 场景¶

插件支持导入不超过 30MB 的 .glb 文件作为待编排场景。导入后不会立即替换当前工作间，需要完成工作点校准和路线绘制，并点击“保存并启用路线”后才会替换。

待编排场景文件保存在：

DSH_HOME/lookseek/scene-draft.glb

如果默认 DSH_HOME 未设置，通常位于用户目录的 .dsh/lookseek/ 下。

路线编排¶

插件支持校准工作点，并按顺序绘制直线或曲线路线。路线编辑可用按键包括：

• 左键选中高亮点
• W / A / S / D 调整平面位置
• Space 上移
• Shift 下移
• 按住 Alt 细调

直线模式按起点、终点绘制；曲线模式按起点、弯曲点、终点绘制。

每个场景布局保存为：

DSH_HOME/lookseek/layout.json

更换场景后需要重新校准工作点，因为旧坐标不一定适用于新模型。

内置机器人与预设上报¶

当前版本内置一个具有金属材质和工作姿态的机器人角色，并根据真实活动显示状态。

自定义智能体预设可以调用 lookseek_report 上报一行公开摘要。可传入的字段包括：

agentId
agentName
role
activity
target
summary

上报内容应保持简短、可公开，并且不包含敏感信息。

安装与启用¶

前提：已安装可用的 DeepSeek Harness，并能使用 dsh 命令。以下示例使用 web 配置档；如果使用其他配置档，请把命令中的 web 改为实际名称。

安装插件：

dsh plugin --profile web add github:lhwu1/dsh-lookseek

如果首次从 GitHub 安装时提示需要允许构建，在命令输出指定的 pnpm-workspace.yaml 中加入：

allowBuilds:
  dsh-lookseek: true

然后再次执行安装命令。只应对自己信任的仓库授予构建权限。

启动 Harness：

dsh web --port 3080

在浏览器打开：

http://127.0.0.1:3080/

进入任意会话后选择“工作间”标签页。

典型用法¶

查看工作间¶

进入 DSH 会话后，切换到“工作间”标签页。页面会展示当前会话及子会话的成员、状态、计划任务和最近公开工具事件。

导入自定义 GLB 场景¶

导入场景时按下面步骤操作：

1. 导入不超过 30MB 的 .glb 文件。
2. 确认该文件作为“待编排场景”出现。
3. 点击“进入编排”。
4. 使用“步骤 0 / 2”的比例滑条调整模型大小，范围为 25% 到 300%。
5. 校准所有工作点。
6. 绘制路线。
7. 点击“保存并启用路线”。

只有完成保存并启用后，新模型和路线才会正式替换当前工作间。未保存前关闭编排器，当前工作间会保留原来的模型和路线。

编辑路线¶

路线编辑分为两个阶段：

1. 校准工作点。
2. 绘制路线。

校准工作点时，可以先左键选中高亮点，再使用按键调整位置。绘制路线时：

• 直线模式：左键点击起点，再左键点击终点。
• 曲线模式：左键点击起点，右键添加弯曲点，最后左键点击终点。

为预设上报状态¶

自定义智能体预设可以调用 lookseek_report，传入公开摘要字段。字段示例：

{
  "agentId": "",
  "agentName": "",
  "role": "",
  "activity": "",
  "target": "",
  "summary": ""
}

summary 应是一行简短、可公开、不含敏感信息的摘要。

更新插件¶

更新已安装插件：

dsh plugin --profile web update dsh-lookseek

从源码开发¶

从源码获取并构建：

git clone https://github.com/lhwu1/dsh-lookseek.git
cd dsh-lookseek
npm install
npm run typecheck
npm run test
npm run bundle

排查“工作间”标签缺失¶

如果看不到“工作间”标签，运行：

dsh --profile web --dump-config

确认输出中包含：

dsh-lookseek
dsh-lookseek-web

适用场景与注意¶

适合什么¶

这个插件适合以下使用方式：

• 想在 DSH 对话之外确认智能体当前状态。
• 会话中存在子会话或子智能体，希望在成员栏查看真实成员。
• 想导入自己的 .glb 办公场景作为待编排工作区。
• 想为工作区校准工作点并绘制路线。

当前限制¶

当前版本不支持导入独立的机器人或人物 .glb，也不支持为每个智能体上传自定义 3D 外观。robotAsset 配置字段不应视为已开放的导入功能。

当前可定制的是工作场景、比例、工作点和路线。人物模型导入属于后续能力。

场景与布局¶

上传 .glb 后不会立即替换当前工作间。需要完成工作点、路线并点击“保存并启用路线”。

待编排场景保存在：

DSH_HOME/lookseek/scene-draft.glb

每个场景布局保存在：

DSH_HOME/lookseek/layout.json

更换场景后必须重新校准。

展示边界¶

插件显示安全摘要，不展示：

• 完整命令
• 绝对路径
• 密钥
• 令牌
• 密码
• 原始工具参数

它也不会猜测模型的内部推理。机器人只根据 Harness 会话状态和可信活动事件移动、显示状态。

资产与权限¶

插件代码使用 MIT License。内置办公模型由仓库所有者单独提供，许可说明见 ATTRIBUTIONS.md。Fork 或重新发布前，需要确认拥有模型与截图的再分发权限，或替换为有权使用的资产。

作为 DSH 插件，安装前应先检查仓库源码、许可证和构建提示；启用后它随 DSH 运行，请仅对信任的仓库授予构建或安装权限。

结尾¶

lhwu1/dsh-lookseek 的价值在于把 DSH 会话中的真实状态、计划任务和公开工具事件放到一个工作间页面里查看，同时允许导入自定义 .glb 场景并编排路线。它不替代聊天，也不虚构模型内部状态，只展示可信会话事件对应的安全摘要。

仓库地址：

https://github.com/lhwu1/dsh-lookseek