前言¶
在 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 插件页。
