LookSeek

LookSeek 是 DeepSeek Harness 的可视化工作区插件。它会为每个会话添加一个 工作间 标签页，其中包含等距办公场景、基于真实会话的智能体列表和清晰的中文活动状态。

工作间与聊天输入区分开。正常对话时无需打开它；需要查看哪些智能体正在活动以及其最近上报的公开工作状态时，再进入 工作间。

功能

• 左侧列表来自当前会话及其子智能体会话，不会虚构预览成员。
• 固定中文状态：进行中、已完成、未完成、出错。
• 可交互 3D 办公区：拖动可旋转，点击智能体或其列表项可聚焦并查看详情。
• 每个智能体上方有清晰的浮动标签，展示名称、当前活动和状态。
• 安全的摘要展示：插件会拒绝绝对路径、密钥、令牌、密码及原始工具参数。
• 智能体可通过 lookseek_report 工具上报可信的活动更新。

准备

你需要已经可用的 DeepSeek Harness 和 dsh 命令。本插件是一个 bundle，不是独立应用；它安装到一个 Harness 配置档后，会随该配置档一同启动。

下面统一以 web 作为示例配置档名称，因为 LookSeek 会添加浏览器标签页。若你使用其他配置档，请将命令中的 web 全部替换为实际名称。

从 GitHub 安装

在 PowerShell、终端或命令提示符中运行：

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

该命令会从 GitHub 安装插件源码。首次安装通常会请求构建权限，因为 GitHub 包需要在你的电脑上编译 TypeScript。这是正常现象：Harness 官方要求在 pnpm 运行包的 prepare 脚本前显式配置 allowBuilds。

当命令输出 pnpm-workspace.yaml 的路径后，打开该文件并加入：

allowBuilds:
  dsh-lookseek: true

然后再次运行安装命令：

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

仅对你信任的仓库授予此权限。它允许包的构建脚本在智能体沙箱外运行。

验证安装

让 Harness 输出最终合并后的配置：

dsh --profile web --dump-config

输出中必须包含标题为 # == dsh-lookseek 的区块，以及 dsh-lookseek 和 dsh-lookseek-web 两条插件记录。

使用同一配置档启动 Harness：

dsh --profile web

在浏览器中打开会话，选择 对话 和 轨迹 旁边的 工作间 标签。当前会话会显示主智能体；存在子智能体会话时也会显示。

工作间说明

区域	含义
左侧成员列表	当前会话树中的真实智能体、其预设标识、最近公开活动和已耗时。
进行中	会话正在运行。
已完成	Harness 已将会话标记为完成，或最近公开事件上报了完成。
已完成	会话当前未运行且没有报错，或最近公开事件上报了完成。
出错	最近公开事件上报了维修或错误。
3D 办公区	智能体最近上报活动的可视化位置；它是状态视图，不是第二个聊天窗口。

智能体列表始终以会话为依据。对话中只有一个智能体时，LookSeek 只显示一个智能体，不会添加装饰性的队友。

智能体状态上报

LookSeek 提供 lookseek_report 工具。智能体预设可在发生有效状态变化后调用它；调用方需提供稳定的智能体 ID、角色、活动和一条面向用户的短摘要。

请求示例：

{
  "agentId": "worker-1",
  "agentName": "工程师",
  "role": "engineer",
  "activity": "verify",
  "target": "validation",
  "summary": "正在验证变更"
}

只使用一条简短公开摘要。不要提交完整命令、绝对路径、API 密钥、令牌、密码或原始工具输入。LookSeek 会过滤常见敏感值，但预设本身也不应发送这些内容。

支持的活动为 receive、plan、read、edit、shell、web、verify、approval、repair、handoff、complete、idle 和 external-wait。

修改缓存条数

LookSeek 默认保留最新 80 条可视化事件。可在配置档的 cordis.patch.yml 中修改，允许范围为 10 到 500。

- replace:
    id: dsh-lookseek
    config:
      maxIntents: 160

修改配置档补丁后需重启 Harness。补丁行会替换整个 config 值，因此请保留你仍要使用的全部配置项。

更新与卸载

更新已安装的本地检出或包记录：

dsh plugin --profile web update dsh-lookseek

更新后重启 Harness 并刷新浏览器标签。LookSeek 会为 GLB 地址加入版本号，新插件构建会加载新场景，而非浏览器缓存的旧场景。

卸载插件：

dsh plugin --profile web remove dsh-lookseek

本地开发

克隆仓库、安装开发依赖并运行检查：

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

将本地文件夹安装到 DeepSeek Harness 源码检出中：

pnpm dsh plugin --profile web add D:/path/to/dsh-lookseek
pnpm dsh --profile web

修改源码后，先运行 npm run bundle，再在 Harness 源码检出中更新插件：

pnpm dsh plugin --profile web update dsh-lookseek

许可证与资产

插件代码采用 MIT 许可证。内嵌办公模型由仓库所有者单独提供。重新分发 fork 前请阅读 ATTRIBUTIONS.md；若你没有模型的再分发许可，请替换该模型。

故障排查

现象	处理方式
找不到 dsh 命令	先安装或启动 DeepSeek Harness，再按其官方说明配置 CLI。
GitHub 安装提示构建受阻	在命令输出的准确 pnpm-workspace.yaml 路径下的 allowBuilds 加入 dsh-lookseek: true，然后重试。
没有 工作间 标签	运行 dsh --profile web --dump-config，确认存在两条 LookSeek 插件记录，并确认启动的是接收安装的同一 web 配置档。
更新后场景仍是旧的	重启 Harness，执行浏览器强制刷新，并确认更新命令已成功结束。
成员显示“未完成”	该会话当前未运行且尚未被 Harness 标记为已完成。会话结束后，工作间会优先显示 Harness 的真实“已完成”状态。
模型没有移动到新的工作区域	让对应智能体预设在状态变化后，以受支持的活动调用 lookseek_report。