前言¶

在 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