前言¶
在 DeepSeek Harness（DSH）裏開發智能體時，模型通常來自官方 API 或已接入的 provider。若你日常用的是 Windows 版「千問辦公」（QwenWork）桌面客戶端，並在本機已登錄，Harness 默認並不能直接選用該客戶端背後的對話模型。
dsh-qwenwork-models 由社區維護者 sanmumu-325 發佈，歸類爲「模型推理」。它把本機已安裝且由你本人登錄的千問辦公桌面端對話模型註冊爲 Harness 的一個 LLM provider，使模型選擇器裏出現「千問辦公」分組。這是非官方的本地集成，與千問辦公/阿里無隸屬關係，也未獲其認可或授權，僅供本人賬號在自擔風險的前提下自用。
這是什麼¶
插件在 Harness 側註冊 provider 名稱 qwenwork，讀取千問辦公客戶端自行生成的訪問憑證，代替你在 Harness 裏調用該賬號的模型。它不代爲登錄、不僞造身份、不分享或導出賬號；憑證過期或授權失效時只提示你自己去恢復。若你需要官方支持、條款明確的接入方式，應使用廠商正式 API，而不是本插件。
運行環境要求 DSH >=0.2.1-rc.2（見 package.json 的 engines.dsh）。當前包版本爲 1.6.0，許可證 MIT。
核心功能¶
下列能力均來自項目 README，安裝前請自行對照源碼與許可證。
- 將千問辦公對話模型註冊爲 Harness provider
qwenwork。 - 多賬號池：賬號啓用/停用/刪除、會話粘性、故障切換、當前使用賬號固定。
- 憑證續簽：到期前自動續簽（使用服務端 exchange 接口，不自動發聊天、不僞造登錄）。
- 看護式保活：定時巡檢，失效只標記並提示，不自動登錄。
- 按模型配置：每個模型可單獨開關、設置上下文窗口、設置輸入類型。
- 狀態展示：賬號狀態與積分餘額（餘額需該賬號有查詢授權）。
- 流式與用量：流式轉換覆蓋文本、推理、工具調用，並回傳 usage。
README 記載的可用模型如下。
| 模型 | 說明 | 圖片輸入 |
|---|---|---|
qwen3.8-max |
Qwen 3.8 Max | 實測支持 |
qwen3.7-plus |
Qwen 3.7 Plus | 實測支持 |
glm-5.2 |
GLM 5.2 | 不支持（上游 400） |
安裝與啓用¶
DSH 插件通過社區目錄站點展示，與 DeepSeek / 幻方無官方從屬關係；安裝方式以倉庫 README 爲準，不要用倉庫名自行拼接未在文檔中出現的命令。
本地包安裝：
plugin_manager install_bundle target=<本包目錄或已安裝位置>
若插件已在市場上架，也可通過插件市場安裝。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與 MIT 許可證。
Harness 側可選配置示例（README 原文）：
- id: qwenwork-models
name: '@qwenwork-tools/dsh-qwenwork-models'
config:
contextWindow: 200000 # 默認上下文窗口兜底
maxOutputTokens: 8192
說明：name 字段以你實際安裝包名爲準；package.json 中發佈名爲 @sanmumu/dsh-qwenwork-models，與 README 示例中的 @qwenwork-tools/... 可能因發佈渠道不同而異，以你安裝的 bundle 元數據爲準。
典型用法¶
經過上面的安裝與配置，按 README 給出的步驟使用：
- 啓動並登錄千問辦公桌面端（Windows）。
- 打開任意對話 → 點右下角模型名 → 選「千問辦公」→ 選具體模型（如
qwen3.8-max）。 - 打開 設置 → 千問辦公模型，管理賬號池、保活看護與模型設置。
對 glm-5.2，請保持輸入類型只勾選文本；誤勾「圖片」時上游會報錯。
憑證、隱私與已知限制¶
憑證與存儲：
- 客戶端模式：憑證僅在進程內存中使用。
- 加入賬號池後：憑證與續簽結果使用 Windows CurrentUser DPAPI 加密落盤，目錄爲
%LOCALAPPDATA%/dsh-qwenwork-models/，原子寫入。 - 不打印、不導出密鑰；管理接口限制本機、同源、JSON 與自定義管理頭。
- 卸載插件不會自動刪除賬號池文件。
使用前提與風險（務必閱讀 README）：
- 僅限本機已安裝並由你本人登錄的千問辦公桌面端。
- 使用客戶端憑證訪問服務可能違反廠商服務條款，可能導致賬號受限，賬號風險自負。
- 客戶端更新可能導致集成失效；廠商若改變協議或增加原生安全校驗，插件會明確報錯而不是繞過。
已知限制：
- 憑證有效期由服務端決定（約 2 小時），插件靠持續續簽維持可用；關閉 Harness 超過有效期後需重新登錄/導入。
- 網頁登錄鏈路有模擬流程與安全迴歸測試，尚未覆蓋所有真實環境。
實現上插件不 import @deepseek-ai/dsh-llm（link: 安裝解析不到 app.asar 內包），採用同構適配器對象對接 Harness。
結尾¶
dsh-qwenwork-models 的價值在於：在合規自擔的前提下，把已登錄的千問辦公桌面對話模型納入 DSH 模型選擇器，並支持多賬號池、續簽與看護等運維向能力。查閱概覽與安裝說明可訪問插件目錄頁 skillhub.cn/plugins/sanmumu-325/dsh-qwenwork-models；源碼與完整文檔見 GitHub 倉庫。
