前言¶
DeepSeek Harness（DSH）裏 Agent 常用內置瀏覽器工具操作頁面：導航、讀 DOM、截圖、多標籤等。默認側欄由 @deepseek-ai/dsh-client-ui-sidebar-browser 渲染，工具欄高度與視覺與 Kimi Code 桌面版的工作臺並不一致；對話流裏瀏覽器步驟的展示方式也偏「工具日誌」，不如工作臺那種卡片化、可展開輸入輸出、一鍵在側欄查看的體驗。
若你已經在 DSH Desktop 上跑瀏覽器自動化，又希望側欄 chrome、接管狀態和人機交還流程對齊 Kimi Code 桌面版（3.2.21）的設計語言，社區插件 dsh-kimi-control（維護者 lswang9，目錄分類爲客戶端）做的是交互層與桌面輸入事件橋，而不是替換瀏覽器運行時本身。
這是什麼¶
dsh-kimi-control 爲 DeepSeek Harness 增加 Kimi Code 桌面版風格的瀏覽器接管 UI：右側欄使用 Kimi 工作臺的瀏覽器 chrome（52px 標籤條、瀏覽器工具欄、居中域名地址欄、更多菜單），並把 Agent / 用戶接管狀態收進工具欄狀態芯片；對話內提供 Kimi 工具卡片。
運行時仍基於 MIT 許可的 dsh-builtin-browser，保留其 32 個 dsh_browser_* 工具以及 DOM / 無障礙樹、截圖、登錄態、下載和多標籤頁能力。本倉庫不是 Kimi 或 DeepSeek 的官方插件。
核心功能¶
Kimi 工作臺瀏覽器 chrome¶
側欄瀏覽器面板頂部爲 52px 工作臺標籤條 + 52px 工具欄。工具欄從左到右爲返回、前進、刷新（加載中變爲停止）、居中域名地址欄（聚焦後顯示完整 URL，回車導航）、更多菜單（刷新 / 複製鏈接 / 關閉標籤頁）。
實現上，插件隱藏 DSH 內置側欄瀏覽器原有的 38px 原生工具欄，按現有 DOM 結構注入 Kimi chrome，並複用同一 <webview> 與導航能力。DSH 升級後若內部 DOM 結構變化，chrome 可能需要重新適配。
接管狀態與真實頁面¶
工具欄右側的狀態芯片區分：
- Agent 控制：「正在操作瀏覽器」，藍色呼吸點；
- 用戶接管：「你已接管」及「交還給 Agent」；
- 短暫完成反饋：「已完成」。
桌面端使用 DSH 原生 <webview>；點擊頁面內任意位置或按鍵即視爲接管，交還後 Agent 繼續。狀態芯片只負責展示，不暫停 Agent，也不構成權限邊界；瀏覽器動作權限仍由上游設置與 DSH 審批機制控制。
對話流中的 Kimi 工具卡片¶
瀏覽器工具在對話裏以 Kimi 工具卡片呈現：動作、目標、運行狀態、可展開的輸入 / 輸出，以及「在側欄中查看」。
設計規格與可及性¶
交互層按 Kimi Code 桌面版瀏覽器工作臺的設計語言重做（規格來自對已安裝應用的靜態逆向），例如強調色亮色 #1783ff、深色 #1a88ff，動效 120–180ms、cubic-bezier(.2, 0, 0, 1)，並跟隨系統「減少動態效果」設置。
環境要求¶
- DSH：
>=0.2.0-rc.2且<0.3.0（package.json 中engines.dsh與此一致）。 - Node.js：
>=22.19。 - 完整側欄接管體驗需要 DSH Desktop；
dsh web仍有對話卡片和瀏覽器工具，但瀏覽器由獨立窗口承載。 - 上游運行時首次使用自託管瀏覽器時，若提示缺少 Electron 二進制，按提示運行
npx install-electron。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議閱讀倉庫源碼與 MIT 許可證，並理解桌面橋對應用入口的修改方式（見下文安全說明）。
DSH Desktop¶
先添加插件，再運行桌面橋安裝器：
dsh plugin --profile desktop add git+https://github.com/lswang9/dsh-kimi-control.git
node ~/.dsh/profiles/desktop/node_modules/dsh-kimi-control/desktop-bridge/install.mjs
安裝器會自動探測標準 macOS / Windows 應用目錄，也可顯式傳入 DSH Desktop 應用路徑，例如：
node ~/.dsh/profiles/desktop/node_modules/dsh-kimi-control/desktop-bridge/install.mjs "/Applications/DeepSeek Harness.app/Contents"
完全退出並重新打開 DSH Desktop。桌面應用升級會替換應用文件，需要重新執行安裝器。
桌面橋必須在 Electron 主進程中運行，因此安裝器會備份並修改 DSH Desktop 的應用入口；提供 --revert 回滾。不安裝橋時，瀏覽器工具退化爲獨立窗口，原生側欄交互不可用。
DSH Web¶
dsh plugin --profile web add git+https://github.com/lswang9/dsh-kimi-control.git
重啓 dsh web 並新建會話。
典型用法¶
直接對 Agent 用自然語言描述瀏覽器任務即可，例如：
打開 example.com，讀取主要內容，然後點擊登錄按鈕。
對話卡片出現「執行中」時，側欄會同步顯示接管狀態。你可以用側欄工具欄導航，或在頁面裏登錄、完成人機驗證、修正輸入，然後點「交還給 Agent」。
卸載¶
Desktop 需先回滾桌面橋，再移除插件；Web profile 單獨移除：
node ~/.dsh/profiles/desktop/node_modules/dsh-kimi-control/desktop-bridge/install.mjs --revert
dsh plugin --profile desktop remove dsh-kimi-control
dsh plugin --profile web remove dsh-kimi-control
適用場景與注意¶
適合誰： 在 DSH Desktop 上頻繁使用瀏覽器工具、希望側欄視覺與 Kimi 工作臺一致，並需要「Agent 操作 ↔ 用戶點頁面接管 ↔ 交還」清晰反饋的開發者或智能體使用者。
隱私與安全（README 原文要點）：
- 桌面輸入橋只上報操作類型（
mouseDown或keyDown）及所屬會話，不上傳按鍵、文本、密碼或頁面內容。 - 瀏覽器可能持有真實登錄態；不要允許不受信任的頁面或指令誘導 Agent 發佈內容、付款或修改賬號設置。
DSH 生態理念是「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係。
