前言¶
在 DeepSeek Harness（DSH）里做智能体时，夸克网盘往往要通过官方 CLI 一条条命令来上传、分享、搜索。CLI 输出是 NDJSON 流，每条命令还要自己拼 --session-input / --session-id，模型很容易漏步骤或猜错参数。若你已经在用 quarkclouddrive 的 quark-drive.cjs，又希望 Agent 用自然语言完成「上传并给链接」这类组合操作，可以把本插件当作 CLI 与 DSH 工具层之间的适配层。
这是什么¶
dsh-better-quark-drive 是 DSH 的 cordis 插件，由维护者 shimiei 发布，在 SkillHub 目录 中归类为联网工具。它不实现夸克 API、也不保存凭证，而是把官方 CLI 包装成 12 个面向模型的工具：上传、分享、搜索、浏览、转存、下载等均可单独或组合调用。核心价值是把「上传 → 分享 → 抄 fid」收成一步（quark_send），并把 NDJSON 与错误码整理成模型可直接用的 Markdown 与修复提示。
和裸调 CLI 的差别¶
下面几点来自插件 README 中的设计说明，便于判断是否值得多装一层：
| 裸 CLI | 本插件 |
|---|---|
| 会话参数需手动传入，模型易编造 | 按 DSH 会话自动生成并复用 |
NDJSON 里 result 常被进度淹没 |
解析为单一结果 + 表格 |
| 上传后要多次调用才拿到分享链接 | quark_send 一次完成 |
14001 upload dir blank 需人工判断目录 |
在特定错误下回落根目录并在结果中说明 |
合规类 notice.text 易被摘要丢掉 |
附在每条结果末尾 |
插件挂载时不探测网络、不读 token；凭证仍由官方 CLI 维护。
核心功能：12 个工具¶
中间变量主要是 fid：搜索、浏览、上传会返回它，分享、移动、下载等会消费它。模型照抄返回值即可，不必记格式。
| 工具 | 作用 |
|---|---|
quark_send |
上传 + 分享，返回链接、提取码、有效期 |
quark_upload |
仅上传，返回 fid |
quark_share |
对已有 fid 生成分享链接 |
quark_search |
关键词搜索 |
quark_browse |
列出目录直接子项 |
quark_mkdir |
新建文件夹 |
quark_move |
移动文件 |
quark_saveas |
转存他人分享链接（支持提取码） |
quark_download |
下载到本地目录 |
quark_whoami |
会员类型与容量占用 |
quark_setup |
环境检查、安装与登录指引 |
quark_help |
工具速查 |
分享有效期通过 expireDays 传入（如 0 永久，1 / 7 / 30 等对应 CLI 枚举）；urlType: 2 时为私密链接，插件会一并返回提取码。
安装与启用¶
前置：官方夸克 CLI¶
插件依赖本机已有的 quarkclouddrive CLI（quark-drive.cjs）。官方 skill 放在下列任一目录即可被自动发现：
$DSH_HOME/skills/quarkclouddrive/~/.agents/skills/quarkclouddrive/~/.claude/skills/quarkclouddrive/
在对应 skill 目录下执行安装与登录：
bash scripts/install.sh
找不到 CLI 时，任意工具会返回安装指引而非抛栈。环境变量 DSH_QUARK_CLI / QUARK_DRIVE_CLI 也可作为 CLI 路径候选。
安装 DSH 插件（推荐）¶
在 DSH profile 目录下安装 npm 包；package.json 已声明 dsh.install 与 cordis.patch.yml，DSH 会自动插入插件行：
pnpm add dsh-better-quark-drive
兼容说明：目标宿主 dshTarget 为 0.2.0-rc.2，需 Node ≥ 18；peer 依赖 @deepseek-ai/dsh-tools（README 写明 >=0.2.0-rc.1 且低于 0.3.0）与 @deepseek-ai/cordis。官方 CLI 建议 quarkclouddrive ≥ 1.0.x。
调整默认行为¶
已安装插件时，可改 cordis.patch.yml 中的 config 后重启 DSH，无需重装。例如默认分享 30 天、私密链接：
- insert:
- id: better-quark-drive
name: 'dsh-better-quark-drive'
config:
shareExpireDays: 30
shareUrlType: 2
常用配置项包括：enabled（默认 true）、cliPath（留空自动发现）、shareUrlType（默认 1 公开）、shareExpireDays（默认 7）、timeoutMs、uploadTimeoutMs、maxRows（列表默认最多 20 行）。
典型用法¶
对话里可以直接描述路径与有效期，由 Agent 调用 quark_send。README 中的示例如下（路径按本机实际修改）：
你：把 D:\reports\q3.pdf 传到夸克，给我个 7 天的链接
AI：quark_send({ paths: ["D:\\reports\\q3.pdf"], expireDays: 7 })
已上传并生成分享链接
- q3.pdf（2.4 MB）
链接：https://pan.quark.cn/s/xxxxxxxx
链接类型：公开链接 ｜ 有效期：7 天
fid：209a7f1e…
离线可自检工具规格（无需网盘账号）：
npm run smoke
若需验证 CLI 与授权（只读 get-user-info）：
npm run smoke:live
适用场景与注意¶
适合谁：已在 DSH 0.2.x 上跑 Agent、且本机已登录夸克官方 CLI 的开发者；需要把网盘操作交给模型编排，又不想手写 session 与解析 NDJSON 时。
权限与安全：插件以当前 DSH 进程权限执行 CLI，可读写你授权账号下的网盘与本机路径；安装前请阅读 MIT 许可 与仓库源码。插件不缓存凭证；日志不打印账号标识与 token。除非显式使用私密链接类型，生成的分享默认为公开链接，不宜贴到公开场合。
生态说明：DSH 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；本仓库仅封装命令行调用，须遵守夸克网盘服务条款。
结尾¶
dsh-better-quark-drive 把夸克官方 CLI 的 12 类操作收成模型友好的工具，重点解决会话参数、输出格式与「上传+分享」多步调用问题。查阅目录与源码：
- 目录页：https://www.skillhub.cn/plugins/shimiei/dsh-better-quark-drive
- GitHub：https://github.com/shimiei/dsh-better-quark-drive
