前言¶

DeepSeek Harness（dsh）把智能體運行時拆成插件組合：官方倉庫的定位是「一切皆插件」，日常入口則是 npx @deepseek-ai/dsh web 或源碼裏的 pnpm dsh web。對已經熟悉 Node.js 和命令行的人來說，這條路徑夠用；對更多想先把工作區、插件和會話放進一個窗口裏的人來說，門檻會集中在三件事：本機要先裝運行時，插件散落在 npm 與 GitHub 上不好找，裝完還要自己覈對版本、權限和兼容性。

社區目錄裏把 deepseek-harness-studio 收在「通知與集成」分類。倉庫由 fufankeji 維護，README 寫明出品方是賦範空間。它不是再往現有 dsh 進程裏塞一個通知通道，而是用 Electron 把 DeepSeek Harness 的 Web 工作區、本地 Host 和桌面窗口合在一起，讓插件發現、安裝、Preset 和工作區可以在桌面端完成。本文按社區目錄頁、GitHub 倉庫 README、Releases 與官方 deepseek-ai/deepseek-harness 交叉覈對後整理。

這是什麼¶

deepseek-harness-studio 是面向 DeepSeek Harness 的開源桌面端。社區目錄給出的一句話是：零代碼桌面端，一鍵啓動，支持 Windows 與 macOS；內置插件發現、熱點插件推送、一鍵安裝與管理、AI 智能推薦和視覺增強。

倉庫在 GitHub 上的地址是 fufankeji/deepseek-harness-studio，主要語言是 TypeScript，許可證爲 MIT。本次查閱時 GitHub 顯示 239 顆星。它基於官方 deepseek-ai/deepseek-harness 的 Harness 核心、Cordis 插件體系和 Web 界面繼續做桌面層：本倉庫負責 Electron 入口、本地 Host 生命週期、桌面交互和配套腳本，並不替代官方 Harness。

有兩點需要先說清楚。第一，社區插件目錄 deepseek-harness-plugin.com 是獨立站點，和 DeepSeek / 幻方沒有官方從屬關係，不能把它當成官方應用商店。第二，README 裏的「賦範官方」只表示由賦範桌面端開發團隊內置和維護，不代表 DeepSeek Harness 官方。

核心功能¶

倉庫把能力分成「已支持」和「規劃中」。下面只展開 README 標明已經可用的部分；規劃項會在注意事項裏單獨列出，避免把路線圖寫成現成功能。

桌面窗口和本地 Host¶

Studio 用 Electron 承載 DeepSeek Harness 的 Web 工作區，桌面主進程負責啓動、等待並在退出時關閉本地 dsh web 服務。窗口側提供系統托盤、單實例運行、外部鏈接處理和 preload 通信接口。Web 工作區仍然保留會話、工作區、模型、工具、Skills 和插件這些 Harness 能力，只是換了一個桌面殼。

從 GitHub Releases 安裝的開發預覽包會帶上運行所需環境，README 寫明運行桌面端無需另行安裝 Node.js 或 pnpm。需要改源碼時，仍可克隆完整倉庫在本地啓動。

插件發現、智能推薦和插件中心¶

不知道該裝什麼時，從左側進入「插件發現」。應用會讀取公開目錄，按精選、最近更新、生態熱門和場景分類展示插件，也支持按名稱、功能或作者搜索。場景分類覆蓋 Agent 與工作流、Web UI、瀏覽器與搜索、視覺與媒體、記憶與上下文、模型與服務、開發工具、集成與通知。

只知道需求、說不出包名時，可以把自然語言交給當前 Agent。應用把它作爲 /find-plugins 請求發出，Agent 只讀查詢公開 dsh-plugin 目錄，返回候選包名、版本、作者、更新時間和匹配理由。推薦結果只是目錄元數據，真正安裝仍要進「插件中心」做兼容性檢查。

插件中心面向 npm 上帶 dsh-plugin 標籤、並符合 DeepSeek Harness Bundle 規範的包。安裝前會校驗確定版本、產物完整性、Bundle 聲明和本機兼容性；確認後下載並重啓 Harness Host 做運行驗證。已安裝區域可以按系統、公開目錄和本地來源查看，通過菜單啓用、停用、更新或卸載。卸載默認保留配置與插件數據，清理數據需要再確認一次。

Preset 廣場和六套內置工作流¶

README 把能力分成三層：Skill 教 Agent「怎麼做」，Plugin / MCP 提供可執行工具，Agent Preset 則把角色、Skill、工具和運行規則打成一套可重複使用的工作方式。Preset 廣場與插件發現、插件中心平級，流程是：發現 → 查看能力組成和前置條件 → 一鍵安裝 → 在「已安裝」裏選「用於新會話」。安裝或刪除用戶 Preset 不必重啓 Host；系統 Preset 受保護。瀏覽器開發模式只用於查看界面，不會改本機 Preset。

當前內置六套真實場景工作流，合計 6 套 Agent Preset、8 個 Skills、1 個圖像生成 Plugin。飛書數字員工另外接入飛書 MCP 與時間解析 MCP，PPT Office 使用內置動效運行適配器：

安裝包交付的是運行所需的精簡 Preset、Skills 與工具適配，不會把案例源碼、輸入數據或生成成品寫進用戶環境。

應用中心和視覺增強¶

應用中心用來啓動擁有獨立界面、專屬數據和自己運行流程的完整 AI 應用，而不是在插件列表裏辨認技術包。首個內置應用是 FF–LLM Wiki：把文檔解析、Wiki 編譯、知識圖譜、向量化和可追溯問答串成流水線，由 Desktop 管理本地運行環境，在系統瀏覽器中打開。數據寫入 DSH Home 下的應用專屬目錄，不混入當前項目工作區。應用不會攜帶賦範團隊的 API Key；知識編譯、瀏覽和本地檢索可以先跑，使用 DeepSeek 生成式 RAG 前需要在 Harness 憑證中心配置自己的 DEEPSEEK_API_KEY。

DeepSeek 文本模型本身不能直接理解圖片。打開「視覺增強」後，內置的百鍊 qwen3.8-max 會先讀取對話附件或工作區裏的 PNG、JPEG、WebP、GIF，再把可追溯的識別結果交給 Agent，不替換當前 DeepSeek 主模型、權限和會話流程。首次啓用要用一張真實圖片驗證百鍊 API Key，憑證只保存在本機受保護的憑證文件中。

另外，輸入區提供中文權限檔位（只讀、工作區寫入、完全訪問）和思考模式（關閉思考、深度思考、最大思考）。通用設置只決定後續新會話的默認權限；啓用完全訪問前必須確認風險。外觀可在「設置 → 背景」切換「官方原版」「大肥魚擬人」「雲端貓咪」，也可選用本地圖片；自定義圖片在本機裁切爲 1920×1080 WebP 並適配配色，不上傳原圖。

安裝與啓用¶

社區目錄給出的安裝命令如下，在已經可用的 DeepSeek Harness 終端裏運行：

dsh plugin add github:fufankeji/deepseek-harness-studio

如需可復現安裝，目錄頁建議固定 commit 哈希：

dsh plugin add github:fufankeji/deepseek-harness-studio#commit

把 #commit 換成實際提交哈希。這條命令走的是 dsh 的 GitHub 插件安裝路徑：CLI 會解析倉庫並寫入當前 profile。倉庫本身是一份完整的桌面開發環境，日常使用路徑以 GitHub Releases 裏的安裝包爲主，不要和下文的桌面預覽包混成同一步。

下載桌面預覽包¶

README 寫明：桌面安裝包只通過本倉庫的 GitHub Releases 發佈，不使用第三方下載站。本次查閱時，最新預覽是 DeepSeek Harness Studio 0.1.0-rc.9（Pre-release），提供 macOS Apple Silicon 的 ZIP 和 Windows x64 的 Setup.exe。當前均爲未簽名開發預覽；正式版本計劃提供完成平臺簽名的 macOS .dmg 和 Windows x64 .exe。

macOS arm64¶

1. 從 Releases 下載並解壓預覽 ZIP。
2. 把 DeepSeek Harness.app 拖入「應用程序」目錄。
3. 當前預覽包尚未經過 Apple 公證，首次打開前在終端執行：

xattr -dr com.apple.quarantine "/Applications/DeepSeek Harness.app"
open "/Applications/DeepSeek Harness.app"

如果應用沒有放在「應用程序」目錄，把路徑換成實際位置。這條命令只應用於從本倉庫 Releases 下載並覈驗過 SHA-256 的預覽包。Release 說明還寫了：不要下載 GitHub 自動生成的 Source code.zip / Source code.tar.gz，那是源碼不是安裝包。當前 macOS 包僅支持 Apple Silicon（arm64）。

Windows x64¶

下載 DeepSeek-Harness-Desktop-Windows-x64-0.1.0-rc.9-Setup.exe 後直接運行安裝程序。預覽安裝程序未經 Authenticode 簽名，Windows 可能彈出 SmartScreen，按「更多信息 → 仍要運行」處理；不要爲此關閉 Defender。0.1.0-rc.9 的說明提到：本版修復了 FF–LLM Wiki 首次啓動時內容目錄尚未創建導致的啓動失敗。

從源碼啓動（開發）¶

下載源碼、安裝依賴和啓動桌面開發環境不需要預先填寫 API 密鑰。真正調用模型時，再在設置裏配置所選服務與憑證，不要把密鑰提交到 Git。

環境要求：

• Node.js ^22.19.0 || >=24.0.0
• pnpm 11.7.0

git clone https://github.com/fufankeji/deepseek-harness-studio.git
cd deepseek-harness-studio
pnpm install
pnpm run dev:desktop

需要強制完整重建時使用 pnpm run dev:desktop:rebuild。

典型用法¶

下面幾條都來自倉庫 README 寫明的桌面操作路徑，可以按界面復現，不是額外編出來的案例。

1. 找插件並安裝。 打開桌面端，從左側進入「插件發現」，按精選 / 最近更新 / 場景瀏覽，或直接搜索名稱和作者。未安裝的插件進入安全安裝流程；已安裝的轉到插件中心管理。也可以在發現頁用自然語言描述需求（README 裏的驗收例子是「找一個桌面寵物插件」），看完候選和匹配理由後，再回插件中心確認安裝。
2. 用 Preset 開新會話。 進入 Preset 廣場，按用途或作者搜索，打開詳情覈對角色、Skill、工具和外部依賴，點擊安裝。Desktop 會校驗來源、大小、摘要和歸檔路徑，再寫入本地用戶 Preset 目錄。到「已安裝」裏點「用於新會話」，即可帶着這套工作方式開始任務。
3. 打開 FF–LLM Wiki。 應用中心 → 選擇 FF–LLM Wiki →「打開應用」→ 導入資料、構建 Wiki 與知識圖譜 → 在智能問答裏覈對帶來源的答案。左側快捷入口默認關閉，可在「顯示在側邊欄」裏打開。
4. 給當前會話補上讀圖。 在輸入框左側打開「視覺增強」，按提示用一張真實圖片驗證百鍊 API Key。之後可以把截圖、報錯界面、圖表或工作區圖片交給 Agent；主模型仍是當前 DeepSeek 文本模型。
5. 改權限和思考深度。 在輸入區選擇 只讀 / 工作區寫入 / 完全訪問，以及 關閉思考 / 深度思考 / 最大思考。完全訪問會作用於當前會話，啓用前先看風險提示。

適用場景與注意事項¶

更適合這幾類使用方式：

• 希望少碰 Node.js 和命令行，直接用窗口管理 DSH 工作區、會話和插件。
• 需要從公開 dsh-plugin 目錄裏搜索、校驗後再安裝，而不是自己拼 GitHub 地址。
• 想用現成 Preset（Web 產品、HTML 演示、視頻、圖文卡片、Excel 報告、飛書任務）開新會話。
• 主模型仍用 DeepSeek 文本模型，但偶爾要把截圖或工作區圖片變成可追溯的視覺觀察。

使用前注意這些邊界：

• 平臺。 當前預覽包是 macOS arm64 和 Windows x64。README 沒有把 Linux 桌面安裝包列爲已發佈資產。
• 預覽狀態。 0.1.0-rc.9 是未簽名 Pre-release。macOS 可能被隔離機制攔截，Windows 可能出現 SmartScreen。正式簽名安裝包尚未作爲當前下載物提供。
• 規劃中、尚未作爲可用功能寫出的能力包括：獨立 MCP / Skills / 工具管理，自定義 Agent 與多 Agent 協作，任務規劃、後臺運行與會話恢復，項目規則、Hooks 與長期記憶，Git / Worktree 與代碼審查，瀏覽器與桌面自動化，以及手機遠程與消息通道。這些項在 README 裏標記爲規劃中，本文不把它們當成已經能用的功能。
• 外部依賴。 視頻生成需要本機 FFmpeg 與 ffprobe；內容工廠生圖需要已登錄且具備 ImageGen 的 Codex CLI；飛書數字員工需要飛書應用憑據；視覺增強需要百鍊 API Key；FF–LLM Wiki 的生成式 RAG 需要用戶自己的 DEEPSEEK_API_KEY。
• 權限與來源。 社區目錄寫明：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。無論走 dsh plugin add 還是裝桌面預覽包，安裝前都應檢查源代碼倉庫和許可證；桌面包只從本倉庫 Releases 獲取，並覈驗 SHA-256。不要把來源不明的安裝包拿來跑 xattr 解除隔離。

小結¶

deepseek-harness-studio 把 DeepSeek Harness 的 Web 工作區和本地 Host 收進 Electron 窗口，並在桌面端補上插件發現、插件中心、Preset 廣場、應用中心和視覺增強。它由 fufankeji / 賦範空間維護，MIT 許可，基於官方 Harness 繼續做桌面層，但不是 DeepSeek 官方發行版。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/deepseek-harness-studio/

GitHub：https://github.com/fufankeji/deepseek-harness-studio