DSH Loomy Connect：零配置接入 Loomy 內置模型

前言¶

DeepSeek Harness（DSH）採用“一切皆插件”的架構。開發者在對接本地桌面應用或特定模型時，常面臨配置繁瑣或缺乏 API Key 的問題。DSH Loomy Connect 解決了這一痛點，它允許你直接使用 Loomy 桌面應用內置的文本模型，無需額外申請 API Key。

是什麼¶

DSH Loomy Connect 是一個插件，由 gdrpzym 維護。它以只讀方式讀取 Loomy 落盤的登錄態與模型清單，將其註冊爲 DSH 的一個模型 Provider。

核心功能¶

1. 零配置
   安裝並啓用後，Loomy 的模型會直接出現在 DSH 的模型選擇器中，無需手動配置參數。

2. 模型自動發現
   插件在啓動時會拉取當前 Loomy 賬號可用的模型清單，並自動過濾出支持文本輸出的模型。

3. 賬號與積分管理
   在 DSH 的設置卡片中，頂部狀態行顯示當前登錄賬號（脫敏手機號）。
   「積分」標籤頁顯示永久積分與每日贈送積分，數據取自 Loomy 自身展示的數據源。

4. 模型明細
   在設置卡片的「模型」標籤頁，以三列表格展示每個模型的名稱、上下文窗口大小（若清單提供）與積分倍率（如 x3.0、限時免費）。

5. 中英雙語
   卡片文案跟隨 DSH 界面語言自動切換。

安裝與啓用¶

在使用前，請確保環境滿足以下條件：
* 已安裝並登錄過 Loomy 桌面應用。
* DeepSeek Harness 版本需 >= 0.1.5-rc.1。

執行以下命令進行安裝：

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

安裝完成後，啓動 DSH Web 服務：

dsh web

驗證插件是否生效，可以運行配置導出命令：

dsh --profile web --dump-config

在輸出中找到 llm-loomy 條目即表示註冊成功。隨後在模型選擇器中查找 Loomy 即可。

配置與注意事項¶

路徑配置¶

插件默認會自動探測 Loomy 的數據路徑，一般情況下無需手動配置。若遇到路徑探測失敗（例如 Windows 下登錄態未探測到），可通過環境變量覆蓋：

• LOOMY_AUTH_FILE：登錄態文件路徑
• LOOMY_CONFIG_FILE：模型清單文件路徑
• LOOMY_LOCAL_STORAGE_DIR：積分緩存目錄

安全邊界¶

該插件以當前 DSH 進程的權限運行，設計上具有以下安全特性：
* 只讀操作：僅讀取 Loomy 落盤的文件，不復制、不上傳、不改寫任何文件。
* 本地網關：內部網關僅綁定 127.0.0.1。
* 鑑權機制：客戶端鑑權使用 timingSafeEqual 比較。

限制與注意事項¶

1. 依賴 Loomy：必須依賴 Loomy 的客戶端接口，若 Loomy 更新導致接口變化，插件可能需要調整。
2. 數據同步：模型列表僅在啓動時拉取。Loomy 側增刪模型後，需重啓 DSH 纔會同步。
3. 積分緩存：積分讀自 Loomy 的本地緩存。若緩存不存在，卡片將不顯示積分，而非顯示 0。
4. 使用範圍：僅供個人學習和研究使用，請勿用於商業用途。

結語¶

DSH Loomy Connect 實現了從本地桌面應用到 DSH 的無縫接入。對於已經在使用 Loomy 的開發者，這是一個無需額外 API Key 即可利用現有資源的便捷方案。

• GitHub 倉庫
• 社區目錄