前言¶
DeepSeek Harness(dsh)把模型適配、工具、會話、沙箱和 UI 都做成可替換插件,官方口號是「一切皆插件」。npx @deepseek-ai/dsh web 能拉起網頁界面,默認在 http://127.0.0.1:3080。開發者預覽階段的界面偏裸:沒有任務看板,沒有 Git 泳道,文件預覽和遠程盯任務也要另開窗口。
社區目錄 DeepSeek Harness 插件庫 把這類擴展按功能分類收錄。需要說明:該站點是獨立社區目錄,與 DeepSeek / 幻方沒有官方從屬關係,不是官方應用商店。目錄裏「界面增強」分類下,精選條目 dsh-web-ui 把任務看板、Git 圖譜、右側面板、移動端遠程、圖像理解和皮膚中心收成一套,可以逐個裝,也可以一次裝齊。
本文按目錄詳情頁、GitHub 倉庫 README、npm 聚合包說明和 DeepSeek Harness 官方倉庫交叉覈對後整理。
這是什麼¶
dsh-web-ui 是給 DeepSeek Harness Web GUI 用的插件與皮膚集合,由 GitHub 用戶 zhu1090093659 維護,許可證 Apache-2.0,主要語言 TypeScript。倉庫地址是 zhu1090093659/dsh-web-ui。本稿覈對時 GitHub API 顯示 3448 星;社區目錄頁當時列出 2271 星,目錄數據可能滯後。
它解決的是「dsh web 能跑智能體,但界面還不夠當工作臺」這件事:任務要排隊和定時跑、倉庫變更要可視化、文件要在聊天旁邊預覽、手機要能盯長任務、皮膚要能換。所有能力走官方 profile 機制掛到 dsh web,不改 DSH 源碼。
社區目錄把它歸在「界面增強」,2026-08-14 收錄,並標爲精選。npm 上的聚合包是 @linxin666/dsh-web-ui-all,本稿覈對時版本爲 0.1.19。
核心功能¶
倉庫 README 用一張對照表說明:原生 dsh web 沒有任務看板、Git 可視化、右側文件預覽、移動端遠程和皮膚中心;裝上全家桶後這些入口會出現在側邊欄和設置裏。下面只寫兩端資料能對上的能力。
任務看板¶
側邊欄點「任務看板」。任務按五列擺:待規劃、待辦、進行中、已完成、已失敗。卡片上的「執行」會交給真實的 DSH 智能體會話去跑,跑完狀態回寫;需要覆盤時跳回執行會話看完整過程。
詳情裏可以配 cron。倉庫舉例:每天 23:00 自動升級 DSH、每週一 09:00 生成周報。調度在瀏覽器端完成,dsh web 標籤頁要一直開着;關掉期間錯過的觸發點按「錯過即跳過」處理,不排隊補跑。任務正在運行時到點,會順延到下一個匹配點。
Git 圖譜與右側面板¶
輸入框上方有分支選擇器,可以切分支、翻提交歷史。Git 圖譜把分支泳道和提交歷史畫出來。
項目會話打開時,聊天區右側出現「預覽」和「文件/變更」:
- 文件樹:瀏覽工作目錄,點文件名在預覽面板打開,支持按文件名搜索
- 預覽:多標籤查看 markdown、HTML、代碼、diff、CSV、PDF、Office、圖片與文本,可切換源碼 / 預覽、分屏編輯、保存
- 變更(SCM):stage / unstage / discard
- 面板寬度可拖,摺疊狀態和寬度按項目記住;皮膚會跟着換
移動端遠程與 SSH 運維¶
側邊欄底部的手機圖標打開配對面板。掃碼或複製鏈接後,手機進獨立移動端界面,遠程操作當前 dsh web 工作區:看會話、開新會話、收發消息、切模型和思考強度、調權限預設。配對令牌一次性、限時,「停止」可吊銷全部設備。二維碼默認走局域網;開 cloudflared 公網隧道後,手機在其他網絡也能配對。
即時消息走 SSE。倉庫寫明:Cloudflare quick tunnel(trycloudflare.com)和 Tailscale Serve 不透傳 SSE,這種網絡下插件會降級輪詢,收發仍可用,新消息可能晚幾秒。要即時推送需改用支持 SSE 的隧道。
側邊欄「SSH」入口打開遠程運維面板。主機支持密鑰 / 密碼,可從 ~/.ssh/config 導入,配置寫在 ~/.dsh/dsh-ssh.json。已配置主機可以:
- Web 終端(xterm.js)
- SFTP 上傳 / 下載
- 本地端口轉發(只監聽 127.0.0.1)
- 多主機集羣執行
- 與 Agent 共用同一份主機配置,對話裏讓智能體執行遠程命令
密碼與 passphrase 以明文保存在上述 JSON 裏(文件權限 0600)。斷線重連可能重放非冪等命令,遠程輸出原樣返回、不脫敏。生產環境使用前應閱讀倉庫裏的 dsh-ssh 說明。
圖像理解與即時吞吐¶
對話裏出現圖片(本地路徑、http(s) URL、會話附件)時,工具 describe_image 把圖片發給配置好的 OpenAI 兼容視覺端點(README 列舉 Qwen-VL、GLM-4V、GPT-4o、本地 Ollama),進會話的只有返回文本,圖片本身不進會話記錄。純文本模型沒有圖片入口時,插件會在輸入框加圖片按鈕。自定義指令用工具的 prompt 參數(OCR、UI 診斷、翻譯)。端點、模型、密鑰、默認指令在「設置 > 插件配置 > Image understanding」裏改,即時生效。該工具移植自 whitelonng/dsh-plugin-describe-image。
會話狀態行會補即時吞吐:流式響應時更新輸入 / 輸出 token 估算(~ 表示啓發式估算),TPS 跟在步驟計數後面;provider 用量到達後,估算換成真實值。
梁神模式與皮膚中心¶
「梁神模式」是面向 DeepSeek V4 Pro 的兩階段 agent 預設。倉庫說明:V4 Pro 對首輪工具目錄敏感;該預設新建會話時先按 Minimal 開局(只暴露持久 bash 與 str_replace_editor),軌跡錨定後再切到 Code Mode(PTC),完整工具註冊表隨後恢復。README 引用社區評測倉庫 xiaobright/modeltest,並給出作者在 Windows 原生環境的實測分數。這些數字來自插件文檔,不是第三方復現結果,採用前應自己對照當前 DSH 版本驗證。梁神模式需要 DSH 0.1.0-rc.5 及以上(preset 機制與 system-prompt/assemble 鉤子)。不要在已經產生內容的會話中途切換 preset。
皮膚中心有 10 款皮膚,支持先試穿再應用:試穿即時生效、退出完全還原,沒點「應用」不落盤。README 點名的主題包括 Windows XP(Luna)、Blue Fantasy、鯨吟、夕港;另有「龍的傳人」「初音未來 · 電子歌姬」和同花順風格等條目,部分截圖倉庫標註待補充。
另外還有常駐界面的鯨魚娘寵物:按智能體狀態切換動畫,可改名、拖位置、隱藏。這是體驗向功能,不影響任務執行。
目錄頁建議:若還需要文件 / 終端工作臺,可搭配側邊欄類插件(例如 dsh-better-sidebar)。兩者是否同時安裝,按自己的界面需求決定。
安裝與啓用¶
先確認本機已經能啓動 dsh web。
社區目錄頁給出的安裝命令原文如下,在 DeepSeek Harness 終端中運行:
dsh plugin add github:zhu1090093659/dsh-web-ui
需要可復現安裝時,目錄頁要求固定 commit 哈希:
dsh plugin add github:zhu1090093659/dsh-web-ui#<commit>
把 <commit> 換成倉庫裏實際的提交哈希,不要照抄佔位符。
倉庫 README 把 npm 聚合包標成日常使用方式,並且必須裝進 web profile:
dsh plugin --profile web add @linxin666/dsh-web-ui-all
只要皮膚:
dsh plugin --profile web add @linxin666/dsh-skins
不想裝全家桶時,可按包名單裝(npm 已發佈):
dsh plugin --profile web add @linxin666/dsh-liangshen
dsh plugin --profile web add @linxin666/dsh-client-ui-task-board
dsh plugin --profile web add @linxin666/dsh-ssh
dsh plugin --profile web add @linxin666/dsh-tool-describe-image
dsh plugin --profile web add @linxin666/dsh-pet
聚合包與同名獨立包不要並行安裝。例如已經裝了 @linxin666/dsh-liangshen,再裝全家桶前要先 dsh plugin --profile web remove 掉獨立包。
裝完必須重啓 dsh web 進程,只刷新頁面不夠。側邊欄出現對應入口即生效;也可以用下面命令確認配置層已掛載:
dsh --profile web --dump-config
卸載全家桶:
dsh plugin --profile web remove @linxin666/dsh-web-ui-all
然後再次重啓 dsh web。
從 GitHub 克隆源碼安裝是開發調試路徑,需要 Node.js >= 22 與 pnpm,步驟以倉庫 README 爲準,這裏不展開。
典型用法¶
1. 三步把全家桶掛上¶
- 執行上一節的 npm 聚合包命令(或目錄頁的 GitHub 安裝命令)
- 重啓
dsh web,側邊欄應出現任務看板、SSH、皮膚中心等入口 - 打開「設置 > 插件配置」按需開關;皮膚在皮膚中心試穿,滿意再點應用
設置側邊欄會把 Web UI 插件組在一起(task-board / live-stats / remote-web-ui / describe-image),以及皮膚中心、社區插件與寵物。
2. 用看板跑定時任務¶
打開任務看板,把卡片移到「待辦」或「進行中」,點「執行」。智能體會話開始跑,完成後列狀態更新。
需要定時時,在任務詳情填寫 cron。記住調度依賴瀏覽器標籤頁,關頁等於調度暫停。
3. 手機盯長任務¶
側邊欄點手機圖標 → 掃碼配對 → 在手機上看會話、發消息、切模型。公網訪問時優先選支持 SSE 的隧道;quick tunnel 場景下接受輪詢延遲即可。
4. 給純文本模型看圖¶
在「設置 > 插件配置 > Image understanding」填視覺端點。之後在對話裏引用圖片,或用輸入框的圖片按鈕插入附件。模型通過 describe_image 拿到文本描述,而不是把原圖寫進會話。
5. 新建會話選梁神模式¶
裝好並完整重啓後,新建空 session,在預設選擇器裏選「梁神模式」。插件啓動時會把 preset 同步到 ~/.dsh/.agent-presets。已有內容的會話不要中途切換。
適用場景與注意事項¶
比較適合:長時間停在 dsh web 裏寫代碼、盯智能體、看 Git 變更的人;需要手機遠程看會話的人;演示或截圖時想換皮膚的人。
不適合把它當成「改完 DSH 源碼的官方發行版」。它是社區插件包,掛在當前 profile 上。DSH 本身仍處於開發者預覽,官方倉庫寫明會有破壞性變更;聚合包對 @deepseek-ai/* SDK 有版本釘死,兼容性跟倉庫發版節奏走。
安裝前注意這些限制:
- 權限:目錄頁寫明,插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。安裝前應檢查源代碼倉庫和許可證。
- pnpm 11 發佈年齡門禁:
minimumReleaseAge可能把約 10 天內的新版本靜默隔離,實際裝到舊版。舊版皮膚中心在應用皮膚後,可能因找不到dsh-client-ui-skin-*而讓dsh web崩潰。處理辦法見倉庫 README 與 issue #71:在 profile 的pnpm-workspace.yaml把@linxin666/*加入minimumReleaseAgeExclude,再dsh plugin --profile web update @linxin666/dsh-web-ui-all。 - 嚴格佈局:pnpm isolated 佈局下,子包可能解析失敗。可在 profile 的
pnpm-workspace.yaml設置nodeLinker: hoisted後重裝。 - 構建腳本:首次安裝若出現
ERR_PNPM_IGNORED_BUILDS,按提示把cloudflared/cpu-features/ssh2寫入allowBuilds。 - SSH 憑據:明文寫在
~/.dsh/dsh-ssh.json,不要把該文件提交進倉庫或同步到不受控環境。
小結¶
dsh-web-ui 把看板、Git 圖譜、右側預覽、移動端遠程、SSH、圖像工具和皮膚收進同一套 Web UI 插件。社區目錄提供 github:zhu1090093659/dsh-web-ui 安裝入口,作者推薦的日常路徑是把 @linxin666/dsh-web-ui-all 裝進 web profile,然後重啓 dsh web。
目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-web-ui/
GitHub:https://github.com/zhu1090093659/dsh-web-ui