前言¶

DeepSeek Harness（DSH）的插件化架構讓很多模型接入方式變得靈活，但依賴官方 API Key 往往意味着需要管理多套憑證或受限於調用配額。如果你已經在使用 Loomy 桌面應用，並且希望直接用 Loomy 內置的模型來驅動 DSH，那麼 DSH Loomy Connect 就是一個可以減少配置的中間層。這個插件以只讀方式讀取 Loomy 落盤的登錄態與模型清單，不復制、不上傳、不改寫任何文件，只做必要的發現與透傳。

是什麼¶

DSH Loomy Connect 是一個模型推理類插件，由維護者 2239058652 在上游基線 0.2.0（gdrpzym/dsh-loomy-connect）基礎上適配到 DSH 0.2.1。它的核心作用是將 Loomy 桌面應用內置的文本模型註冊爲 DSH 的一個 Provider，讓模型列表與登錄態從 Loomy 本地發現，從而在 DSH 中使用這些模型而無需提供 API Key。插件本身是 MIT 許可，僅供個人學習與研究使用。

核心功能¶

• 零配置：安裝並啓用後，Loomy 的模型會直接出現在 DSH 的模型選擇器中。
• 模型自動發現：啓動時從 Loomy 獲取當前賬號可用的模型清單，只納入支持文本輸出的模型。
• 倍率與優惠展示：插件頁的「模型」標籤頁列出全部模型及各自的積分倍率（如 x3.0、限時免費），數據隨 Loomy 側調整而變化。
• 賬號與積分：插件頁頂部狀態行顯示當前登錄賬號（脫敏手機號）與積分餘額；「積分」標籤頁顯示永久積分與每日贈送積分——數值取自 Loomy 自身展示所依賴的同一份數據。
• 模型明細：以三列表格列出每個模型的名稱、上下文窗口大小（若 Loomy 的清單提供了該字段）與積分倍率，圖像模型排在文本模型之後。
• 模型頁狀態條：在「設置 → 模型」的 Loomy 卡片內直接顯示登錄態與永久積分。
• 中英雙語：界面文案跟隨 DSH 界面語言。

安裝與啓用¶

前置條件：

• Loomy 桌面應用已安裝，且至少登錄過一次。
• DSH 版本 >= 0.2.1-rc.2 且 < 0.3.0。
• Node.js >= 22.19。
• pnpm 必需（dsh plugin 內部通過 pnpm 管理 profile 依賴）。

從 GitHub 安裝（推薦）：

dsh plugin --profile web add github:2239058652/dsh-loomy-connect
dsh web

如果沒有全局 dsh，可使用以下任一命令（兩者都只下載 dsh 本身，插件安裝仍走 pnpm）：

npx @deepseek-ai/dsh plugin --profile web add github:2239058652/dsh-loomy-connect
pnpm dlx @deepseek-ai/dsh plugin --profile web add github:2239058652/dsh-loomy-connect

從本地目錄安裝（改代碼時）：

git clone https://github.com/2239058652/dsh-loomy-connect.git
cd dsh-loomy-connect
pnpm install
pnpm run build          # 僅改了 src/ 時需要，產物在 lib/
dsh plugin --profile web add /絕對路徑/dsh-loomy-connect
dsh web

驗證：

dsh --profile web --dump-config     # 應出現 llm-loomy 條目

--dump-config 只組合配置樹，不實例化插件。確認插件能否真正啓動，需運行 dsh web 後檢查模型選擇器中是否出現 Loomy。

配置¶

路徑按平臺自動探測，一般無需配置。以下覆蓋項面向非標準安裝。

環境變量：

• LOOMY_AUTH_FILE：登錄態 auth-session.json 路徑。
• LOOMY_CONFIG_FILE：模型清單 opencode.json 路徑。
• LOOMY_LOCAL_STORAGE_DIR：積分緩存 Local Storage/leveldb 目錄。

優先級：插件配置（authFile / configFile）→ 環境變量 → 探測到的默認值。

默認路徑按 macOS / Windows 順序探測，取第一個存在的：

安全邊界¶

威脅模型：防禦本機其他進程與瀏覽器中運行的網頁；不防禦以同一用戶身份運行的代碼——其可讀取插件所讀的同樣文件。

已知限制¶

• 依賴 Loomy 的客戶端接口（非官方開放 API），Loomy 更新後插件可能需要隨之調整。
• 模型清單與倍率取自 Loomy 的接口；接口不可達時回落到 Loomy 生成的配置文件，兩者都不可用時才使用內置快照。
• 積分讀自 Loomy 的本地緩存，Loomy 未公開積分接口；緩存不存在時卡片不顯示積分，而非顯示 0。
• 模型清單在啓動時讀取，Loomy 側增刪模型後需重啓 DSH 纔會同步。
• Windows 下若登錄態路徑未被探測到，需通過 LOOMY_AUTH_FILE 手動指定。

適用場景與注意¶

適合希望在 DSH 中使用 Loomy 桌面應用內置模型、且希望減少 API Key 管理的開發者與使用者。使用前應：

• 確認 Loomy 已登錄，且已至少使用過一次。
• 檢查 DSH 版本是否在 >= 0.2.1-rc.2 < 0.3.0 範圍內。
• 閱讀 LICENSE 與免責聲明：本項目僅供個人學習和研究使用，僅驅動使用者本人的 Loomy 賬號在本機調用，請勿用於商業用途或超出個人合理使用的場景；使用者須遵守 Loomy 服務條款；本項目與 Loomy、訊飛、DeepSeek 均無關聯，未獲其授權或認可。

結語¶

DSH Loomy Connect 在不觸碰 Loomy 文件的前提下，把桌面應用的模型能力引入 DSH 的工作流，適合習慣在 Loomy 中使用、又希望在 DSH 中統一調度的場景。更多細節與實現記錄可參考 README 與相關文檔。

• 插件目錄頁：https://www.skillhub.cn/plugins/2239058652/dsh-loomy-connect
• GitHub 倉庫：https://github.com/2239058652/dsh-loomy-connect