zhu1090093659/dsh-web

DeepSeek Harness（DSH）Web 插件聚合生态包 · 一切皆插件，创意工坊分发

什麼是 dsh‑web？

dsh‑web 是 DeepSeek Harness (DSH) Web 的 插件生態系，這是一個基於瀏覽器的 UI，讓您能與 DeepSeek 的 AI 代理互動。該倉儲提供一個 「一站式」套件（@linxin666/dsh-web-all），內含數十個可選的 UI 延伸功能——任務看板、行動端遠端控制、SSH 終端、影像理解工具、Git 可視化、皮膚、寵物與市場——並使其即插即用，無需修改核心 DSH 程式碼。

核心理念

概念	如何運作
一切皆為插件	每個功能皆以獨立的 npm 套件形式存在於 `@linxin666/dsh‑*` 命名空間下。聚合套件僅列出所有插件，您只需安裝一個相依性即可獲得完整的開發工作站。
可插拔皮膚	視覺主題也是插件。皮膚套件包含 `skin.json` 清單、CSS、圖片與可選的特效腳本。UI 在執行時載入皮膚，與核心程式碼完全解耦，因此無需發行即可新增外觀。
市場（dsh‑market.com）	由相同的皮膚／寵物／插件清單生成的靜態網站。使用者可瀏覽、預覽並點擊一次安裝社群製作的資源。
遠端-行動端配對	掃描 QR 碼（或複製連結）即可與手機或其他瀏覽器配對。配對的裝置將看到相同的 DSH 工作區，可傳送訊息、切換模型、執行命令。通訊使用 SSE；當 SSE 不支援時，插件會回退至輪詢。
SSH 與檔案傳輸	內建 xterm.js 終端、SFTP 上傳／下載、埠轉送與多主機批次執行功能，均以 UI 面板形式提供。
影像理解	在聊天輸入框中新增按鈕；選中的影像透過 `describe_image` 工具傳送至可設定的 OpenAI 相容視覺端點（如 GPT‑4o、Qwen‑VL、Ollama），僅生成的文本會儲存在對話中。

主要插件（包含在「一站式」套件中）

插件	功能
`dsh-client-ui-task-board`	五欄的看板，支援 DSH 代理的即時執行與 cron 風格排程。
`dsh-remote-web-ui`	用於行動端或輔助瀏覽器的 QR 碼配對；即時同步會話、模型與權限。
`dsh-ssh`	包含終端、SFTP、僅限本機埠轉送與叢集命令執行的 SSH 面板。
`dsh-tool-describe-image`	視覺工具（`describe_image`），將影像轉送至可設定的視覺模型並回傳文字描述。
`dsh-client-ui-git-graph`	分支選擇器與可視化提交歷史圖。
`dsh-client-ui-skin-center`	所有皮膚資源的載入器；皮膚按需從市場取得。
`dsh-client-ui-market`	在 DSH Web 內開啟市場的 UI 卡片。
`dsh-client-ui-plugin-manager`	直接在 UI 中安裝／啟用／停用其他 `@linxin666/*` 插件。
`dsh-better-sidebar`（外部）	右側側邊欄，可托管檔案瀏覽器、編輯器、終端、Git 視圖與瀏覽器。
…以及許多可選工具，如技能探索器、聊天恢復、桌面啟動器與「醫生」救援模式。

快速入門

先決條件 – DeepSeek Harness 已安裝且 dsh web 可執行。僅建置原始碼需要 Node ≥ 22 與 pnpm。

安裝套件

dsh plugin --profile web add @linxin666/dsh-web-all@latest

重新啟動 dsh web。左側側邊欄將出現新項目。
透過 設定 → 插件設定 啟用／停用插件或試用皮膚。

若希望本地開發，請克隆倉儲，執行 pnpm install && pnpm -r build，再使用 node scripts/link-profile.mjs 連結已建置的套件，最後重新啟動 UI。

適合誰使用？

希望擁有更豐富 UI 來建構、測試與監控 DSH 代理的 AI 代理開發者。
需要遠端 SSH 存取、定時任務或可視化 Git 歷史記錄但又不想離開瀏覽器的 進階使用者。
希望將皮膚、寵物或插件發布至 DSH 市場的 社群創作者。

限制與注意事項

定時任務在 DSH 主機程序中執行；瀏覽器關閉後仍存活，但若主機停止或機器休眠則會跳過。
SSH 憑證以明文儲存（~/.dsh/dsh-ssh.json，權限 0600）。
實時行動端更新依賴 Server-Sent Events；部分隧道服務（如 Cloudflare Quick Tunnel、Tailscale）會降級為輪詢，導致數秒延遲。
從原始碼建置需要 Node ≥ 22 與 pnpm；一般使用者可直接安裝預先發佈的 npm 套件。

社群與貢獻

透過 README 中的 QR 碼加入 QQ 群，或加入 Discord 伺服器以獲取協助與討論。
貢獻遵循標準的 CONTRIBUTING.md 流程，使用 Conventional Commits，PR 合併前必須通過 pnpm typecheck && pnpm test && pnpm docs:check。
新插件或皮膚可透過 node scripts/dsh-plugin-new <name> 或 node scripts/dsh-skin-new 產生範本。

簡而言之：dsh‑web 是一個模組化、社群驅動的擴充層，將 DeepSeek Harness Web UI 轉變為功能齊全的開發工作站，支援插件式任務看板、遠端行動端控制、SSH、視覺工具、皮膚與社群貢獻市場。