前言¶
在 DeepSeek Harness（DSH）裏做智能體，經常要處理網盤上的資料：列目錄、搜文件、下載到本機再分析，或把某個 fid 寫進對話。若只依賴命令行或臨時腳本，授權、限流和官方接口變更都要自己扛。夸克網盤官方發佈了 quarkclouddrive Skill，內含 quark-drive.cjs CLI；Bennie96 的 dsh-quark 插件不復制該 SDK，而是把同一套 CLI 包成左側主面板、會話右側欄，並註冊 15 個 quark_* agent 工具。下面介紹它解決什麼問題、如何安裝官方 Skill 與插件，以及典型用法與限制。
這是什麼¶
dsh-quark（npm 包名 dsh-quark，當前資料中的版本爲 0.1.1）是 DeepSeek Harness 的客戶端類插件：基於夸克官方 quarkclouddrive Skill 的圖形化文件管理面板。維護者爲 Bennie96；源碼與說明見 GitHub，社區目錄頁爲 SkillHub 上的 dsh-quark。授權、簽名、限流由官方 CLI 處理，插件負責界面與 agent 可調用工具。
裝上之後長什麼樣¶
| 位置 | 內容 |
|---|---|
| 左側欄 → 夸克網盤 | 主面板：賬號容量、逐級瀏覽、搜索、底欄 9 個操作 |
| 會話右側欄 → 夸克網盤 | 同一面板的窄版，聊天時翻文件、把文件引用進對話 |
agent 工具 quark_* |
15 個工具，查環境、列目錄、搜文件、下載、整理等 |
兩個入口各有顯示開關，在插件詳情頁配置；關掉左側欄入口會從界面摘掉，不只是隱藏。右側欄標籤頁需要帶右側欄的 DSH 版本，老版本可能只有左側主面板。
核心能力¶
瀏覽、搜索與引用¶
- 進文件夾：點文件夾名；回上一級：點頂部路徑 breadcrumb。
- 搜索：面板頂部按文件名搜，結果在「搜索結果」頁籤；不是正文檢索。
- 「引用到會話」：把文件名和
fid寫入對話框；讀內容仍須 agent 自行下載或調用夸克 AI 接口。
文件操作（底欄）¶
上傳（本機絕對路徑，一行一個）、下載（默認系統下載目錄）、分享（默認私密鏈接帶提取碼）、移動、批量重命名、相冊整理、整批歸類等，均通過包裝官方 CLI 完成。文件瀏覽、上傳下載、移動、分享、重命名不限制會員等級；quark_summary / quark_qa、智能相冊整理等依賴夸克 AI，需要 SVIP+。
解析內容的兩種路線¶
| 路線 | 做法 | 限制 |
|---|---|---|
| 夸克 AI 助手 | quark_summary、quark_qa，fid_list 單次不超過 100 |
SVIP+；可能遇到 -1501 / -1507 超時 |
| 下載後本地讀 | quark_download 或面板下載，再由 agent 讀本機文件 |
佔本地空間；會員等級不限 |
插件本身不解析 PDF / Word 等格式。資料註明官方 CLI v1.0.25 尚無 read-file 子命令，插件也未包裝該命令。
使用要求¶
- DeepSeek Harness（Web 或 desktop）。
- Node.js 18 或更高（
package.json中engines.node爲>=18.0.0；官方 Skill 的install.sh要求 Node 16+，用 18+ 可同時滿足）。 - 已安裝夸克網盤官方 Skill（插件調用其中的
scripts/quark-drive.cjs）。 - 夸克賬號；未授權時 CLI 可能返回未登錄類錯誤，需
login或按官方流程授權。
安裝官方 Skill（插件不會代裝）¶
官方頁面：https://b.quark.cn/apps/quarkcloud_skill_info/routes/V-sc7gOBT。Skill 裝好後插件會自動探測複用，升級或重裝插件一般不必重裝 Skill。
方式一：在對話裏讓 agent 按官方提示詞安裝並授權（頁面提供的技能地址與授權碼）。
方式二：手動安裝
- 從官方頁面下載 zip，或使用資料中的直鏈（示例版本 1.0.25）：
https://pdds.quark.cn/download/stfile/eekkigineefiegmgo/quarkclouddrive-1.0.25.zip
-
解壓到
<DSH_HOME>/skills/quarkclouddrive/，應包含SKILL.md、references/、scripts/quark-drive.cjs等。 -
在 Git Bash 或 WSL 中執行（不要用 PowerShell，需
curl、unzip、node）：
cd <DSH_HOME>/skills/quarkclouddrive
bash scripts/install.sh
成功時返回形如 {"type":"install_result","success":true,...}。驗證：
node <DSH_HOME>/skills/quarkclouddrive/scripts/quark-drive.cjs -V
node <DSH_HOME>/skills/quarkclouddrive/scripts/quark-drive.cjs get-user-info
若 Skill 裝在非默認路徑，可設環境變量 DSH_QUARK_SKILL_DIR（指向 skill 根目錄）或 DSH_QUARK_CLI（指向 quark-drive.cjs）。狀態可用 agent 調 quark_check_env 或看面板頂部提示。
安裝 dsh-quark 插件¶
推薦：從 npm 安裝
在 DSH 中通過插件管理安裝包名 dsh-quark，例如：
plugin_manager({ action: 'install_bundle', target: 'dsh-quark' })
或在插件頁「添加插件」的「包名或地址」中填寫 dsh-quark。
備選：安裝 GitHub Release 的 tgz
plugin_manager({
action: 'install_bundle',
target: 'https://github.com/Bennie96/dsh-quark/releases/latest/download/dsh-quark.tgz',
})
釘版本可將 latest 換成標籤，例如：
https://github.com/Bennie96/dsh-quark/releases/download/v0.1.0/dsh-quark.tgz
裝完若左側欄未出現雲朵圖標，可重掛插件：
plugin_manager({ action: 'set_plugin', target: 'include:dsh-quark', enabled: false })
plugin_manager({ action: 'set_plugin', target: 'include:dsh-quark', enabled: true })
注意 set_plugin 的 target 爲 include:dsh-quark，不是包名 dsh-quark。卸載：
plugin_manager({ action: 'remove_bundle', target: 'dsh-quark' })
卸載插件不刪除官方 Skill，也不撤銷夸克賬號授權。
典型用法¶
在界面裏¶
打開左側欄夸克網盤，從根目錄逐級進入；在文件行使用「引用到會話」或「AI 總結」（後者會向當前會話寫入請求，由 agent 決定是否調用 quark_summary）。右側欄需在已有會話中打開，否則可能提示打不開。
對 agent 說人話¶
資料中的示例意圖包括：
- 看看夸克網盤根目錄有什麼
- 把網盤裏的某個 zip 下載下來
- 總結網盤裏某篇 PDF
- 對搜索結果批量重命名
agent 會從下表工具中選取合適項。
| 工具 | 用途 |
|---|---|
quark_check_env |
Skill、版本、CLI 路徑、授權狀態 |
quark_get_user_info |
暱稱、會員、容量 |
quark_list_files |
列目錄，parent_fid="0" 爲根 |
quark_search |
關鍵詞搜文件名 |
quark_create_folder |
新建文件夾 |
quark_upload / quark_download |
上傳、下載 |
quark_move / quark_share / quark_rename |
移動、分享、批量重命名 |
quark_organize_album / quark_organize_files |
相冊整理、整批歸類 |
quark_summary / quark_qa |
AI 總結與問答（SVIP+） |
quark_login |
登錄授權 |
適用場景與注意¶
適合誰： 已在 DSH 中開發或使用 agent，需要把夸克網盤當作統一文件源，既要點點即用的主面板，又要穩定的 quark_* 工具集。
務必注意：
- 插件以後臺方式包裝 CLI，在 DSH Host 進程權限下運行；安裝前應查看 倉庫源碼 與 MIT 許可證，自行評估風險。
- 搜索僅限文件名；按內容找需 SVIP+ 的
quark_qa或下載後本地分析。 - 在插件外手動跑
quark-drive.cjs若缺DSH_HOME/DSH_SESSION_ID，可能報無法識別 Agent 環境；經插件調用時會補齊環境。 - DSH 插件生態以「一切皆插件」爲理念；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-quark 把夸克官方 quarkclouddrive CLI 接到 DSH 的側欄與 agent 工具層：先裝官方 Skill 並授權，再用 dsh-quark 接入 Harness，即可在同一環境裏瀏覽、操作網盤並讓對話中的 agent 調用 15 個 quark_* 工具。進一步瞭解能力與故障排除見 GitHub README；從社區目錄進入見 SkillHub 插件頁。
