请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求： 1. 这个插件是什么，解决什么问题； 2. 适合哪些用户和典型使用场景； 3. 安装后如何使用，并给出一个最小使用示例； 4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险； 5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。 GitHub：https://github.com/king-bcolor/dsh-aliyundrive-plugin 插件名：dsh-aliyundrive-plugin 作者：king-bcolor

dsh-aliyundrive-plugin

> 中文文档：README.zh-CN.md

A DeepSeek Harness plugin that wraps the aliyunpan Alibaba Cloud Drive CLI as model-callable tools and a built-in web UI tab.

What it is

dsh-aliyundrive-plugin exposes Alibaba Cloud Drive operations to DSH agents: account status, drive switching, directory browsing, file management, upload/download with progress, sharing, albums, and sync backup — through structured tools.

Features

Account: login guidance, current user, account list.
Drive: switch backup/resource drive, quota.
Files: ls/ll, cd, pwd, mkdir, mv, cp, rename, rm (confirm-gated).
Transfer: upload/download with concurrency, retry, regex exclusions, progress.
Share: create shares and rapid-transfer links (share set; list/cancel are not exposed by aliyunpan v0.3.x).
Albums: list, show, batch download.
Sync: upload/download modes with exclusive/increment policies.
Long transfers run in background: poll with aliyunpan_task_status, list with aliyunpan_task_list, stop with aliyunpan_task_stop.
Web UI: an 阿里云盘 conversation tab exposes every tool as a dynamic form with quick account/quota/pwd actions, JSON results, and a live task panel. A standalone page is also available at /aliyundrive after the web profile starts.
Dangerous operations require explicit confirmation.

Use cases

Ask the agent to list files in a cloud directory.
Upload a local folder to Alibaba Cloud Drive.
Download files with progress and retry.
Manage shares and albums.
Set up incremental sync between local and cloud directories.

See [docs/用例目录/README.md](./docs/用例目录/README.md) for the full command/use-case/parameter catalog (Chinese).

Installation

Preconditions

Node.js 22+, dsh CLI installed.
aliyunpan CLI installed (see https://github.com/tickstep/aliyunpan).

Install from GitHub

dsh plugin --profile default add github:king-bcolor/dsh-aliyundrive-plugin
# allowlist build in $DSH_HOME/profiles/default/pnpm-workspace.yaml if requested

Install locally

git clone https://github.com/king-bcolor/dsh-aliyundrive-plugin.git
cd dsh-aliyundrive-plugin
dsh plugin --profile default add .

Usage

dsh --profile default
# or the web profile
dsh web

Open a conversation and switch to the 阿里云盘 tab for the UI. Example prompts:

List files in the root of my backup drive.
Upload ~/Documents to /我的文档.
Start sync from ~/Documents to /备份盘/我的文档 using increment policy.

Configuration

- id: aliyundrive
  name: dsh-aliyundrive-plugin
  config:
    aliyunpanBin: /usr/local/bin/aliyunpan
    timeoutMs: 60000
    longRunningTimeoutMs: 3600000
    confirmDangerous: true

Development

TDD is mandatory:

npm test

License

MIT

来源信息

安装

检查来源文件