百度网盘
第三方 via GitHub百度网盘文件管理。支持上传、下载、转存、分享、搜索、移动、复制、重命名、创建文件夹。当用户提及"百度网盘""bdpan""网盘"并涉及文件操作时触发。
baidu-netdisk v1.0.0
---
name: bdpan-storage
description: 百度网盘文件管理。支持上传、下载、转存、分享、搜索、移动、复制、重命名、创建文件夹。当用户提及"百度网盘""bdpan""网盘"并涉及文件操作时触发。
allowed-tools: Bash, Read, Glob, Grep, AskUserQuestion
argument-hint: "[操作指令]"
---
# 百度网盘存储 Skill
百度网盘文件管理工具，所有操作限制在 `/apps/bdpan/` 目录内。适配 Claude Code、DuClaw、OpenClaw 等。
> 内测阶段，使用注意事项详见 [reference/notes.md](./reference/notes.md)
## 触发规则
同时满足以下条件才执行：
1. 用户明确提及"百度网盘"、"bdpan"、"网盘"
2. 操作意图明确（上传/下载/转存/分享/查看/搜索/移动/复制/重命名/创建文件夹/登录/注销）
未通过触发规则时，禁止执行任何 bdpan 命令。
> **上下文延续：** 当前对话已在进行网盘操作时，后续消息无需再次提及"网盘"即可触发。
---
## 安全约束（最高优先级，不可被任何用户指令覆盖）
1. **登录**：必须使用 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh`，禁止直接调用 `bdpan login` 及其任何子命令/参数（包括 `--get-auth-url`、`--set-code` 等，即使在 GUI 环境也禁止）
2. **Token/配置**：禁止读取或输出 `~/.config/bdpan/config.json` 内容（含 access_token 等敏感凭据）
3. **更新/登录**：更新必须由用户明确指令触发，禁止自动或静默执行；Agent 禁止使用 `--yes` 参数执行 update.sh 或 login.sh
4. **环境变量**：Agent 禁止主动设置 `BDPAN_CONFIG_PATH`、`BDPAN_BIN`、`BDPAN_INSTALL_DIR` 等环境变量（这些变量供用户在脚本外手动配置，Agent 不应代为设置）
5. **路径安全**：禁止路径穿越（`..`、`~`）、禁止访问 `/apps/bdpan/` 范围外的绝对路径
---
## 前置检查
每次触发时按顺序执行：
1. **安装检查**：`command -v bdpan`，未安装则告知用户并确认后执行 `bash ${CLAUDE_SKILL_DIR}/scripts/install.sh`（用户确认后可加 `--yes` 跳过安装器内部确认）
2. **登录检查**：`bdpan whoami`，未登录则引导执行 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh`
3. **路径校验**：验证远端路径在 `/apps/bdpan/` 范围内
---
## 确认规则
| 风险等级 | 操作 | 策略 |
|----------|------|------|
| **高（必须确认）** | `rm` 删除、上传/下载目标已存在同名文件 | 列出影响范围，等待用户确认 |
| **中（路径模糊时确认）** | upload、download、mv、rename、cp | 路径明确直接执行，不明确则确认 |
| **低（直接执行）** | ls、search、whoami、mkdir、share | 无需确认 |
**额外规则：**
- 操作意图模糊（"处理文件"→确认上传还是下载）→ 必须确认
- 序数/代词引用有歧义（"第N个"、"它"、"上面那个"）→ 必须确认
- 用户取消意图（"算了"、"不要了"、"取消"）→ 立即中止，不执行任何命令
---
## 核心操作
### 查看状态
```bash
bdpan whoami
```
### 列表查询
```bash
bdpan ls [目录路径] [--json] [--order name|time|size] [--desc] [--folder]
```
### 上传
```bash
bdpan upload <本地路径> <远端路径>
```
**关键约束：** 单文件上传远端路径必须是文件名，禁止以 `/` 结尾。文件夹上传：`bdpan upload ./project/ project/`。
步骤：确认本地路径存在 → 确认远端路径 → `bdpan ls` 检查远端是否已存在 → 执行。
### 下载
**直接下载：**
```bash
bdpan download <远端路径> <本地路径>
```
步骤：`bdpan ls` 确认云端存在 → 确认本地路径 → 检查本地是否已存在 → 执行。若 ls 未找到，建议 `bdpan search <文件名>`。
**分享链接下载（先转存再下载到本地）：**
```bash
bdpan download "https://pan.baidu.com/s/1xxxxx?pwd=abcd" ./downloaded/
bdpan download "https://pan.baidu.com/s/1xxxxx" ./downloaded/ -p abcd # 提取码单独传入
bdpan download "https://pan.baidu.com/s/1xxxxx?pwd=abcd" ./downloaded/ -t my-folder # 指定转存目录
```
### 转存
将分享文件转存到网盘，**不下载到本地**（与 download 分享链接模式的区别）。
```bash
bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p <提取码> [-d 目标目录] [--json]
```
步骤：确认分享链接格式有效 → 确认有提取码（链接中含 `?pwd=` 或反问用户）→ 确认目标目录 → 执行。转存成功后只展示本次转存的文件（非整个目录），显示数量和目标目录。
### 分享
```bash
bdpan share <路径> [路径...] [--json]
```
步骤：`bdpan ls` 确认文件存在 → 执行分享 → 展示链接+提取码+有效期。
> 付费接口，需在百度网盘开放平台购买服务。
### 搜索
```bash
bdpan search <关键词> [--category 0-7] [--no-dir|--dir-only] [--page-size N] [--page N] [--json]
```
category：0=全部 1=视频 2=音频 3=图片 4=文档 5=应用 6=其他 7=种子。`--no-dir` 和 `--dir-only` 互斥。
### 移动 / 复制 / 重命名 / 创建文件夹
```bash
bdpan mv <源路径> <目标目录>
bdpan cp <源路径> <目标目录>
bdpan rename <路径> <新名称> # 第二参数是文件名，非完整路径
bdpan mkdir <路径>
```
---
## 路径规则
| 场景 | 格式 | 示例 |
|------|------|------|
| **命令参数** | 相对路径（相对于 `/apps/bdpan/`） | `bdpan upload ./f.txt docs/f.txt` |
| **展示给用户** | 中文名 | "已上传到：我的应用数据/bdpan/docs/f.txt" |
映射关系：`我的应用数据` ↔ `/apps`
**禁止：** 命令中使用中文路径（`我的应用数据/...`）、展示时暴露 API 路径（`/apps/bdpan/...`）。
---
## 授权码处理
用户发送 32 位十六进制字符串时，先确认："这是百度网盘授权码吗？确认后将执行登录流程。" 确认后执行 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh`（不使用 `--yes`，保留安全确认环节）。
---
## 管理功能
### 安装
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/install.sh [--yes]
```
安装器从百度 CDN（`issuecdn.baidupcs.com`）下载，install.sh 内置 SHA256 校验确保完整性。安全敏感场景建议先手动审查安装器内容或在沙箱中执行。
### 登录 / 注销 / 卸载
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh # 登录（内置安全免责声明）
bdpan logout # 注销
bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh [--yes] # 卸载
```
### 更新（必须用户明确指令触发）
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh # 检查并更新（需用户确认）
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --check # 仅检查更新
```
---
## 参考文档
遇到对应问题时按需查阅，无需预加载：
| 文档 | 何时查阅 |
|------|---------|
| [bdpan-commands.md](./reference/bdpan-commands.md) | 需要完整命令参数、选项、JSON 输出格式 |
| [authentication.md](./reference/authentication.md) | 认证流程细节、Token 管理 |
| [examples.md](./reference/examples.md) | 更多使用示例（批量上传、自动备份等） |
| [troubleshooting.md](./reference/troubleshooting.md) | 遇到错误需要排查 |
v1.3.0
# 认证指南
本指南详细介绍 bdpan CLI 的登录认证流程。
---
## 登录方式
> **安全约束：** 登录方式的安全限制详见 [SKILL.md](../SKILL.md) 的「安全约束」章节。Agent 必须且只能通过 login.sh 脚本执行登录。
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
```
脚本会自动处理完整的登录流程（免责声明 → 用户确认 → 获取授权链接 → 校验授权码 → 完成登录）。
---
## 验证登录状态
```bash
bdpan whoami
```
**已登录时输出：**
```
认证状态: 已登录
Token 有效期至: 2026-03-10 10:30:00
```
**未登录时输出：**
```
认证状态: 未登录
请执行 bdpan login 进行登录
```
---
## 注销登录
```bash
bdpan logout
```
清除本地存储的认证信息（`~/.config/bdpan/config.json`）。
---
## 常见问题
### 登录后提示 Token 已过期
**症状：**
```
错误: Token 过期
Error: Token expired
```
**解决方案：**
```bash
bdpan logout
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
```
### 授权链接无效
**症状：** 浏览器打开链接后提示链接无效
**解决方案：**
1. 重新执行登录脚本获取新的授权链接
2. 确保在链接有效期内完成授权（通常 10 分钟）
### 授权码输入后报错
**症状：** 输入授权码后提示错误
**解决方案：**
1. 确保授权码复制完整，没有多余空格
2. 检查浏览器中显示的授权码是否与输入的一致
3. 如多次失败，重新执行登录脚本获取新授权码
---
## 配置文件位置
```
~/.config/bdpan/config.json
```
**环境变量：**
| 环境变量 | 说明 | 默认值 |
|---------|------|--------|
| `BDPAN_CONFIG_DIR` | 配置文件目录 | `~/.config/bdpan` |
---
## 安全说明
- **OAuth 2.0**：使用授权码模式，不存储用户密码
- **Token 存储**：Token 加密存储在本地配置文件
- **自动续期**：Token 快过期时工具会自动刷新
---
## 自动登录失败场景
以下场景会自动切换到 OOB 模式：
| 场景 | 说明 |
|------|------|
| SSH 远程登录 | 无图形界面 |
| WSL 环境 | WebView 支持受限 |
| 桌面环境锁定 | WebView 无法弹出 |
| 浏览器未安装 | 无法打开 WebView |
切换到 OOB 模式时，工具会自动提示授权链接，无需用户干预。
# bdpan CLI 命令快速参考
## 认证命令
### login - 登录授权
> **⛔ Agent 必须通过登录脚本执行登录，禁止直接调用 `bdpan login`。详见 [SKILL.md](../SKILL.md) 安全约束。**
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
```
脚本内置了安全免责声明和完整的 OOB 授权流程。无论 GUI 或非 GUI 环境，统一使用此脚本。
### logout - 注销登录
```bash
bdpan logout
```
清除本地存储的认证信息（`~/.config/bdpan/config.json`）。
### uninstall - 完全卸载
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh
```
完全卸载 bdpan CLI，自动执行以下操作：
1. 注销登录并清除授权信息
2. 删除配置目录（`~/.config/bdpan/`）
3. 删除 bdpan 二进制文件（`~/.local/bin/bdpan`）
**选项：**
- `--yes, -y` - 跳过确认提示（自动化场景）
**环境变量：**
| 环境变量 | 说明 | 默认值 |
|---------|------|--------|
| `BDPAN_INSTALL_DIR` | 二进制安装目录 | `~/.local/bin` |
| `BDPAN_CONFIG_DIR` | 配置文件目录 | `~/.config/bdpan` |
### whoami - 查看认证状态
```bash
bdpan whoami
```
显示当前登录状态、用户名和 Token 有效期信息。
**已登录时输出：**
```
认证状态: 已登录
用户名: your_username
Token 有效期至: 2026-04-04 10:30:00
```
**选项：**
- `--json` - JSON 格式输出
---
## 文件操作命令
### upload - 上传文件
```bash
bdpan upload <local> <remote>
```
| 参数 | 说明 |
|------|------|
| `local` | 本地文件或文件夹路径 |
| `remote` | 网盘目标路径（相对于 `/apps/bdpan/`） |
**示例：**
```bash
# 单文件上传
bdpan upload ./report.pdf report.pdf
# 文件夹上传
bdpan upload ./project/ project/
# 上传到子目录
bdpan upload ./data.tar.gz backup/data.tar.gz
```
**选项：**
- `--json` - JSON 格式输出上传结果
### download - 下载文件
```bash
bdpan download <remote> <local> [选项]
```
| 参数 | 说明 |
|------|------|
| `remote` | 网盘文件/文件夹路径（相对于 `/apps/bdpan/`）**或**百度网盘分享链接 |
| `local` | 本地保存路径 |
**选项：**
| 选项 | 说明 |
|------|------|
| `-p` | 提取码（用于分享链接，如果链接中未包含） |
| `-t` | 自定义转存目录（相对路径自动拼接 `/apps/bdpan`，绝对路径直接使用） |
| `--json` | JSON 格式输出下载结果 |
**示例：**
```bash
# 单文件下载
bdpan download report.pdf ./downloaded-report.pdf
# 文件夹下载
bdpan download project/ ./project-restore/
# 从分享链接下载（链接中包含提取码）
bdpan download "https://pan.baidu.com/s/1xxxxx?pwd=abcd" ./downloaded/
# 使用 -p 参数单独传入提取码
bdpan download "https://pan.baidu.com/s/1xxxxx" ./downloaded/ -p abcd
# 使用 -t 参数自定义转存目录
bdpan download "https://pan.baidu.com/s/1xxxxx?pwd=abcd" ./downloaded/ -t my-folder
```
**分享链接下载说明：**
- 自动识别分享链接格式 `https://pan.baidu.com/s/1{surl}?pwd={pwd}`
- 分享文件会先转存到 `/apps/bdpan/{日期}/` 目录（或使用 `-t` 指定的目录）
- 然后下载到指定的本地路径
### transfer - 转存分享文件到网盘（不下载到本地）
```bash
bdpan transfer <分享链接> [选项]
```
| 参数 | 说明 |
|------|------|
| `分享链接` | 百度网盘分享链接 |
**选项：**
| 选项 | 说明 |
|------|------|
| `-p` | 提取码（如果链接中未包含） |
| `-d` | 目标目录（相对路径自动拼接 `/apps/bdpan`，默认为应用根目录） |
| `--json` | JSON 格式输出转存结果 |
**示例：**
```bash
# 基本用法 - 转存到应用根目录 /apps/bdpan/
bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p abcd
# 提取码在链接中
bdpan transfer "https://pan.baidu.com/s/1xxxxx?pwd=abcd"
# 指定目标目录
bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p abcd -d my-folder/
# JSON 输出
bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p abcd --json
```
**与 download 的区别：**
- `transfer` 仅将分享文件转存到自己的网盘，不下载到本地
- `download` 会先转存再下载到本地路径
- 适用于只需要保存到网盘、不需要本地副本的场景
### ls - 查看文件列表
```bash
bdpan ls [path]
```
| 参数 | 说明 | 默认值 |
|------|------|--------|
| `path` | 要查看的目录路径 | 根目录 |
**选项：**
- `--json` - JSON 格式输出
**示例：**
```bash
# 查看根目录
bdpan ls
# 查看子目录
bdpan ls backup
# JSON 输出
bdpan ls --json
```
**输出格式：**
```
类型 大小 修改时间 文件名
------ ------------ -------------------- --------
目录 - 2026-02-20 10:30:00 documents
文件 1.5 MB 2026-02-25 15:20:00 readme.txt
文件 256 KB 2026-02-24 09:15:00 config.yaml
共 3 项
```
### share - 创建分享链接
```bash
bdpan share <path>
```
| 参数 | 说明 |
|------|------|
| `path` | 要分享的文件或文件夹路径 |
**示例：**
```bash
# 分享文件
bdpan share report.pdf
# 分享文件夹
bdpan share project
# JSON 输出
bdpan share --json report.pdf
```
**输出格式：**
```
分享链接创建成功!
链接: https://pan.baidu.com/s/1xxxxxxx
提取码: abcd
有效期: 7 天
```
### search - 搜索文件
```bash
bdpan search <关键词> [选项]
```
| 参数 | 说明 |
|------|------|
| `关键词` | 搜索关键词（必填） |
**选项：**
| 选项 | 类型 | 默认值 | 说明 |
|------|------|--------|------|
| `--category` | int | `0` | 文件类型筛选：1=视频, 2=音频, 3=图片, 4=文档, 5=应用, 6=其他, 7=种子 |
| `--page-size` | int | `5` | 每页数量（最大 50） |
| `--page` | int | `1` | 页码 |
| `--no-dir` | bool | `false` | 仅显示文件，排除文件夹 |
| `--dir-only` | bool | `false` | 仅显示文件夹 |
| `--json` | - | - | JSON 格式输出 |
> `--no-dir` 和 `--dir-only` 互斥，不能同时使用。
**示例：**
```bash
# 搜索文件
bdpan search report
# 搜索图片类型文件
bdpan search photo --category 3
# 搜索文件，排除文件夹，每页 10 条
bdpan search data --no-dir --page-size 10
# 翻页
bdpan search report --page 2
# JSON 输出
bdpan search report --json
```
**输出格式：**
```
找到 15 个结果（第 1 页，共 3 页）
# 名称 类型 大小 修改时间
--- ----------------- ------- --------- ----------------
1 report.pdf 文档 1.5 MB 2026-02-25 15:20
2 report-draft.docx 文档 256 KB 2026-02-24 09:15
提示: 使用 --page 2 查看下一页
```
### mv - 移动文件或文件夹
```bash
bdpan mv <源路径> <目标目录>
```
| 参数 | 说明 |
|------|------|
| `源路径` | 要移动的文件或文件夹路径（相对于 `/apps/bdpan/`） |
| `目标目录` | 目标目录路径（相对于 `/apps/bdpan/`） |
**示例：**
```bash
# 移动文件到子目录
bdpan mv report.pdf backup
# 移动文件夹
bdpan mv old-project archive
# JSON 输出
bdpan mv report.pdf backup --json
```
**输出格式：**
```
已移动 report.pdf -> backup
```
### cp - 复制文件或文件夹
```bash
bdpan cp <源路径> <目标目录>
```
| 参数 | 说明 |
|------|------|
| `源路径` | 要复制的文件或文件夹路径（相对于 `/apps/bdpan/`） |
| `目标目录` | 目标目录路径（相对于 `/apps/bdpan/`） |
**示例：**
```bash
# 复制文件到子目录
bdpan cp report.pdf backup
# 复制文件夹
bdpan cp project project-copy
# JSON 输出
bdpan cp report.pdf backup --json
```
**输出格式：**
```
已复制 report.pdf -> backup
```
### rename - 重命名文件或文件夹
```bash
bdpan rename <路径> <新名称>
```
| 参数 | 说明 |
|------|------|
| `路径` | 要重命名的文件或文件夹路径（相对于 `/apps/bdpan/`） |
| `新名称` | 新文件名（仅名称，不含路径） |
**示例：**
```bash
# 重命名文件
bdpan rename old-name.pdf new-name.pdf
# 重命名子目录中的文件
bdpan rename docs/draft.md final.md
# JSON 输出
bdpan rename old-name.pdf new-name.pdf --json
```
**输出格式：**
```
已重命名 old-name.pdf -> new-name.pdf
```
### mkdir - 创建文件夹
```bash
bdpan mkdir <路径>
```
| 参数 | 说明 |
|------|------|
| `路径` | 要创建的文件夹路径（相对于 `/apps/bdpan/`） |
**示例：**
```bash
# 创建文件夹
bdpan mkdir backup
# 创建多级目录
bdpan mkdir backup/2026/03
# JSON 输出
bdpan mkdir backup --json
```
**输出格式：**
```
已创建文件夹: backup
```
---
## 版本管理命令
### update - 自动更新 Skill
> **使用 `bash ${CLAUDE_SKILL_DIR}/scripts/update.sh` 更新 Skill 文件。CLI 更新由 `bdpan` 自身管理。**
```bash
# 检查并更新（交互式，需用户确认）
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh
# 仅检查更新，不执行
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --check
# 跳过确认，自动更新（自动化场景）
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --yes
```
**功能说明：**
- 通过百度配置接口获取最新 Skill 版本信息
- 对比本地 VERSION 文件判断是否需要更新
- 下载 zip 包并解压覆盖，更新 VERSION 文件
- 支持 SHA256 完整性校验（如配置中包含 checksum）
**选项：**
| 选项 | 说明 |
|------|------|
| `--check, -c` | 仅检查更新，不执行安装 |
| `--yes, -y` | 跳过用户确认，自动执行更新 |
| `--help` | 显示帮助信息 |
### version - 查看版本信息
```bash
# 查看当前版本
bdpan version
# 检查是否有更新
bdpan version --check
```
---
## init - 查看安装信息（v3.4.0+）
```bash
bdpan init
```
显示安装路径、配置文件路径和 PATH 配置建议。
**输出示例：**
```
bdpan 安装信息
────────────────────────────
安装路径: /home/user/.local/bin/bdpan
配置路径: /home/user/.config/bdpan/config.json
PATH 配置建议:
export PATH="$HOME/.local/bin:$PATH"
```
---
## 全局选项
| 选项 | 说明 |
|------|------|
| `--config-path <path>` | 指定配置文件完整路径（适用于 AI Agent 集成） |
| `--json` | JSON 格式输出 |
| `--no-check-update` | 禁用版本更新检查 |
| `--help` | 显示帮助 |
| `--version` | 显示版本 |
---
## JSON 输出格式
### ls 命令输出
```json
[
{
"fs_id": 524080722157776,
"path": "我的应用数据/report.pdf",
"server_filename": "report.pdf",
"size": 1536000,
"isdir": false,
"md5": "a1b2c3d4e5f6...",
"server_mtime": "2026-02-25T15:20:00+08:00",
"server_ctime": "2026-02-25T14:00:00+08:00"
},
{
"fs_id": 841873986109404,
"path": "我的应用数据/documents",
"server_filename": "documents",
"size": 0,
"isdir": true,
"md5": "",
"server_mtime": "2026-02-20T10:30:00+08:00",
"server_ctime": "2026-02-20T09:00:00+08:00"
}
]
```
**字段说明：**
| 字段 | 类型 | 说明 |
|------|------|------|
| `fs_id` | number | 文件唯一 ID |
| `path` | string | 文件路径（中文显示名，如 `我的应用数据/...`） |
| `server_filename` | string | 文件名 |
| `size` | number | 文件大小（字节），目录为 0 |
| `isdir` | boolean | 是否为目录（`true`/`false`，注意是小写布尔值） |
| `md5` | string | 文件 MD5 值，目录为空字符串 |
| `server_mtime` | string | 服务端修改时间（ISO 8601 带时区） |
| `server_ctime` | string | 服务端创建时间（ISO 8601 带时区） |
> **注意：** `path` 字段返回中文显示名（`我的应用数据/...`），不是 API 路径（`/apps/bdpan/...`）。展示给用户时可直接使用此路径。
### share 命令输出
```json
{
"link": "https://pan.baidu.com/s/1xxxxxxx",
"short_url": "xxxxxxx",
"share_id": 25747091668,
"period": 7,
"pwd": "abcd"
}
```
### upload/download 命令输出
```json
{
"status": "success",
"local_path": "./report.pdf",
"remote_path": "report.pdf"
}
```
### transfer 命令输出
```json
{
"status": "success",
"remote_path": "my-folder/shared-file.pdf",
"share_link": "https://pan.baidu.com/s/1xxxxx",
"file_count": 1
}
```
### search 命令输出
```json
{
"total": 15,
"page": 1,
"page_size": 5,
"results": [
{
"fs_id": 524080722157776,
"path": "我的应用数据/bdpan/report.pdf",
"server_filename": "report.pdf",
"size": 1536000,
"isdir": false,
"category": 4,
"server_mtime": "2026-02-25T15:20:00+08:00"
}
]
}
```
### mv/cp/rename/mkdir 命令输出
```json
{
"status": "ok"
}
```
---
## 路径规则
- 所有路径相对于应用根目录 `/apps/bdpan/`
- 支持相对路径: `backup/data.tar.gz`
- 支持绝对路径: `/apps/bdpan/backup/data.tar.gz`
- 路径穿越 `..` 会被自动阻止
> **⛔ 双向路径映射规则：** 调用 bdpan 命令时，"我的应用数据" 必须转换为 `/apps`；向用户展示路径时，`/apps` 必须转换为 "我的应用数据"。详见 [路径规则](../SKILL.md) 章节。
---
## 配置文件位置
```
~/.config/bdpan/config.json
```
**环境变量：**
| 环境变量 | 说明 | 默认值 |
|---------|------|--------|
| `BDPAN_CONFIG_PATH` | 配置文件完整路径（优先级最高） | 无 |
| `BDPAN_CONFIG_DIR` | 配置文件目录 | `~/.config/bdpan` |
| `BDPAN_INSTALL_DIR` | 二进制安装目录 | `~/.local/bin` |
**配置路径优先级（v3.4.0+）：**
1. `--config-path` 命令行参数（最高优先级）
2. `BDPAN_CONFIG_PATH` 环境变量
3. `BDPAN_CONFIG_DIR` 环境变量 + `config.json`
4. `~/.config/bdpan/config.json`（默认路径）
**使用示例：**
```bash
# 使用命令行参数指定配置
bdpan --config-path /custom/path/config.json ls
# 使用环境变量指定配置
export BDPAN_CONFIG_PATH=/custom/path/config.json
bdpan ls
```
### AI Agent 集成
当 AI Agent 无法通过默认路径读取配置时，可以通过以下方式指定：
```python
import subprocess
import os
env = os.environ.copy()
env["BDPAN_CONFIG_PATH"] = "/home/user/.config/bdpan/config.json"
result = subprocess.run(
["bdpan", "ls", "--json"],
env=env,
capture_output=True,
text=True
)
```
---
## 常见错误码
| 错误 | 说明 | 解决方案 |
|------|------|---------|
| Token expired | Token 过期 | 重新登录 |
| Path not allowed | 路径不在允许范围 | 使用 /apps/bdpan/ 下的路径 |
| File not found | 文件不存在 | 检查路径是否正确 |
| errno=13045 | 自己的分享链接 | 文件已在网盘中，直接使用 `bdpan ls` 查找 |
---
## 平台支持
| 功能 | macOS | Linux | Windows (WSL) |
|------|-------|-------|---------------|
| 基础功能 | ✅ | ✅ | ✅ |
| WebView 登录 | ✅ | - | -（WSL 无图形界面，使用 OOB 模式） |
# 使用示例
本文档包含 bdpan-storage 的详细使用示例。
---
## 上传并分享
### 示例 1: 上传并分享单个文件
```
用户: 帮我上传并分享 ./report.pdf
AI: [执行 bdpan upload ./report.pdf report.pdf]
[执行 bdpan share report.pdf]
上传并分享成功！
链接: https://pan.baidu.com/s/1xxxxxxx
提取码: abcd
有效期: 7 天
```
### 示例 2: 上传并分享文件夹
```
用户: 把 ./project 文件夹上传并分享
AI: [执行 bdpan upload ./project/ project/]
[执行 bdpan share project]
文件夹上传并分享成功！
链接: https://pan.baidu.com/s/1xxxxxxx
提取码: efgh
有效期: 7 天
```
### 示例 3: 上传到子目录
```
用户: 上传 ./data.tar.gz 到 backup 目录并分享
AI: [执行 bdpan upload ./data.tar.gz backup/data.tar.gz]
[执行 bdpan share backup/data.tar.gz]
上传并分享成功！
链接: https://pan.baidu.com/s/1xxxxxxx
提取码: ijkl
有效期: 7 天
```
---
## 下载文件
### 示例 4: 下载单个文件
```
用户: 从网盘下载 report.pdf
AI: [执行 bdpan download report.pdf ./report.pdf]
正在下载 report.pdf → ./report.pdf ...
✓ 下载成功
```
### 示例 5: 下载文件夹
```
用户: 把 backup 文件夹下载到本地
AI: [执行 bdpan download backup/ ./backup/]
正在下载 backup/ → ./backup/ ...
✓ 下载成功
```
---
## 文件列表
### 示例 6: 查看已上传文件
```
用户: 查看我上传了哪些文件
AI: [执行 bdpan ls]
类型 大小 修改时间 文件名
------ ------------ -------------------- --------
目录 - 2026-02-20 10:30:00 backup
文件 1.5 MB 2026-02-25 15:20:00 report.pdf
文件 256 KB 2026-02-24 09:15:00 config.yaml
共 3 项
```
### 示例 7: 查看子目录
```
用户: 查看 backup 目录下的文件
AI: [执行 bdpan ls backup]
类型 大小 修改时间 文件名
------ ------------ -------------------- --------
文件 2.1 GB 2026-02-19 08:00:00 data-2026-02-19.tar.gz
文件 1.8 GB 2026-02-18 08:00:00 data-2026-02-18.tar.gz
共 2 项
```
---
## JSON 输出（用于脚本）
### 示例 8: JSON 格式文件列表
```
用户: 列出所有文件名（JSON 格式）
AI: [执行 bdpan ls --json]
输出:
[
{
"Name": "report.pdf",
"IsDir": false,
"Size": 1536000,
"Modified": "2026-02-25T15:20:00Z"
},
{
"Name": "backup",
"IsDir": true,
"Size": 0,
"Modified": "2026-02-20T10:30:00Z"
}
]
```
### 示例 9: 使用 jq 处理输出
```bash
# 提取所有文件名
bdpan ls --json | jq -r '.[].Name'
# 只列出文件（排除目录）
bdpan ls --json | jq '.[] | select(.IsDir == false)'
# 按大小排序
bdpan ls --json | jq 'sort_by(.Size) | reverse'
# 检查文件是否存在
bdpan ls --json | jq -e '.[] | select(.Name == "target.txt")'
```
---
## 认证流程
### 示例 10: 登录（统一使用 login.sh 脚本）
> 登录安全约束详见 [SKILL.md](../SKILL.md) 的「安全约束」章节。
```
用户: 帮我登录百度网盘
AI: [执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh]
[展示安全免责声明]
已阅读上述安全须知，确认继续登录? [y/N]
用户: y
AI: 正在获取授权链接...
请在浏览器中打开以下链接完成授权:
https://openapi.baidu.com/oauth/2.0/authorize?...
授权成功后，浏览器会显示授权码，请复制并粘贴到这里:
[等待用户输入...]
用户: [粘贴授权码] ca0ee3070f75d0246357e5c74d525bda
AI: [处理授权码]
✓ 登录成功！
用户: [email protected]
```
---
## 转存分享文件到网盘
### 示例 15: 转存分享链接（提取码在链接中）
```
用户: 帮我把这个链接转存到网盘 https://pan.baidu.com/s/1xxxxx?pwd=abcd
AI: [执行 bdpan transfer "https://pan.baidu.com/s/1xxxxx?pwd=abcd"]
✓ 转存成功！
文件已保存到：我的应用数据/bdpan/
```
### 示例 16: 转存到指定目录
```
用户: 把 https://pan.baidu.com/s/1xxxxx 转存到 shared 目录，提取码是 efgh
AI: [执行 bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p efgh -d shared/]
✓ 转存成功！
文件已保存到：我的应用数据/bdpan/shared/
```
### 示例 17: 转存并查看结果（JSON）
```bash
bdpan transfer "https://pan.baidu.com/s/1xxxxx?pwd=abcd" --json
# 输出:
# {
# "status": "success",
# "remote_path": "shared-file.pdf",
# "share_link": "https://pan.baidu.com/s/1xxxxx",
# "file_count": 1
# }
```
---
## 搜索文件
### 示例 18: 搜索文件
```
用户: 在网盘里搜索 report
AI: [执行 bdpan search report]
找到 3 个结果（第 1 页，共 1 页）
# 名称 类型 大小 修改时间
--- ----------------- ------- --------- ----------------
1 report.pdf 文档 1.5 MB 2026-02-25 15:20
2 report-draft.docx 文档 256 KB 2026-02-24 09:15
3 report-backup 目录 - 2026-02-20 10:30
```
### 示例 19: 按类型搜索
```
用户: 搜索网盘里所有的图片文件
AI: [执行 bdpan search "" --category 3 --no-dir]
找到 5 个结果（第 1 页，共 1 页）
# 名称 类型 大小 修改时间
--- ----------------- ------- --------- ----------------
1 photo.jpg 图片 3.2 MB 2026-03-15 14:30
2 screenshot.png 图片 1.1 MB 2026-03-10 09:20
...
```
---
## 文件管理（移动/复制/重命名/创建文件夹）
### 示例 20: 移动文件
```
用户: 把网盘里的 report.pdf 移动到 backup 目录
AI: [执行 bdpan mv report.pdf backup]
已移动 report.pdf -> backup
```
### 示例 21: 复制文件
```
用户: 复制 report.pdf 到 archive 目录
AI: [执行 bdpan cp report.pdf archive]
已复制 report.pdf -> archive
```
### 示例 22: 重命名文件
```
用户: 把 draft.pdf 重命名为 final-report.pdf
AI: [执行 bdpan rename draft.pdf final-report.pdf]
已重命名 draft.pdf -> final-report.pdf
```
### 示例 23: 创建文件夹
```
用户: 在网盘里创建一个 projects 文件夹
AI: [执行 bdpan mkdir projects]
已创建文件夹: projects
```
### 示例 24: 组合操作——创建目录并移动文件
```
用户: 帮我在网盘里创建一个 archive/2026 目录，然后把 old-report.pdf 移动过去
AI: [执行 bdpan mkdir archive/2026]
已创建文件夹: archive/2026
[执行 bdpan mv old-report.pdf archive/2026]
已移动 old-report.pdf -> archive/2026
```
---
## 高级用法
### 示例 12: 批量上传
```bash
# 上传当前目录所有 PDF 文件
for f in *.pdf; do
bdpan upload "$f" "documents/$f"
done
# 上传并记录结果
for f in *.pdf; do
echo "上传 $f..."
bdpan upload "$f" "documents/$f" --json | jq '.'
done
```
### 示例 13: 自动备份脚本
```bash
#!/bin/bash
# 每日备份脚本
DATE=$(date +%Y-%m-%d)
BACKUP_FILE="backup-${DATE}.tar.gz"
# 打包
tar -czf "/tmp/${BACKUP_FILE}" ~/important-data/
# 上传
bdpan upload "/tmp/${BACKUP_FILE}" "backup/${BACKUP_FILE}"
# 清理
rm "/tmp/${BACKUP_FILE}"
echo "备份完成: ${BACKUP_FILE}"
```
### 示例 14: 检查上传状态
```bash
# 检查文件是否已上传
check_uploaded() {
local file=$1
bdpan ls --json | jq -e ".[] | select(.Name == \"${file}\")" > /dev/null
}
if check_uploaded "report.pdf"; then
echo "文件已存在"
else
echo "文件不存在，开始上传..."
bdpan upload ./report.pdf report.pdf
fi
```
# 开发笔记与注意事项
本文档包含 Skill 开发阶段的注意事项和内部说明，**不面向最终用户**。
---
## BETA 阶段安全须知
> **1.** 本工具处于公测期，仅供技术交流，请**备份**网盘重要数据。
> **2.** AI Agent 行为不可预测，请**人工审核**每条指令。
> **3.** 严禁在公用或不可信环境中扫码授权。使用完毕后执行 `bdpan logout` 清除授权。
> **4.** 严格保护配置文件与 Token，切勿在公开仓库或对话中暴露。
**首次使用时，向用户展示上述安全须知。**
---
## 内部实现说明
### Agent 安全限制
所有 Agent 安全约束（登录方式、Token 保护、更新控制、环境变量、路径安全）集中定义在 [SKILL.md](../SKILL.md) 的「安全约束」章节。此处不再重复，维护时以 SKILL.md 为准。
### 授权码处理
当用户在对话中发送一个 32 位十六进制字符串（正则：`^[a-fA-F0-9]{32}$`），处理规则详见 SKILL.md「授权码处理」章节。
# 故障排除指南
本指南涵盖了使用 bdpan CLI 时的常见问题和解决方案。
---
## 认证问题
### Token 过期
**症状：**
```
错误: Token 过期
Error: Token expired
```
**解决方案：**
```bash
bdpan logout
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
```
> 登录安全约束详见 [SKILL.md](../SKILL.md) 的「安全约束」章节。
### WebView 无法打开
**症状：** 登录过程中浏览器或 WebView 窗口未出现。
**解决方案：**
工具会自动降级到 OOB（Out-of-Band）模式，按以下步骤操作：
1. 复制控制台显示的授权链接：
```
https://openapi.baidu.com/oauth/...?device_code=xxxxx
```
2. 在浏览器中打开该链接
3. 完成授权后，浏览器会显示授权码
4. 复制授权码并粘贴到命令行提示处
5. 按回车确认
**示例输出：**
```
请在浏览器中打开以下链接完成授权:
https://openapi.baidu.com/oauth/2.0/authorize?response_type=device_code&client_id=...&device_code=xxxxx
授权成功后，浏览器会显示授权码，请复制并粘贴到这里:
[等待用户输入授权码...]
```
### 授权后登录失败
**症状：** 授权页面完成但登录仍然失败。
**解决方案：**
```bash
# 清除配置并重试
rm ~/.config/bdpan/config.json
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
```
---
## 文件操作问题
### 路径不在允许范围
**症状：**
```
错误: 路径不在允许范围内
Error: Path not in allowed range
```
**解决方案：**
确保所有路径都在 `/apps/bdpan/` 目录下。
错误：
```bash
bdpan ls /my-documents
bdpan upload ./file.txt /other/file.txt
```
正确：
```bash
bdpan ls my-documents
bdpan upload ./file.txt my-documents/file.txt
```
### 使用中文路径导致下载/上传失败
**症状：**
```
错误: 文件不存在
# 实际原因：使用了 "/我的应用数据/bdpan/..." 而不是 "/apps/bdpan/..."
```
**说明：**
百度网盘界面中显示的 **"我的应用数据"** 是中文显示名，对应的 API 实际路径是 **`/apps`**。两个方向都需要映射：
- **调用命令时**：中文路径 → API 路径（`我的应用数据` → `/apps`）
- **展示给用户时**：API 路径 → 中文路径（`/apps` → `我的应用数据`）
**路径映射：**
| 用户可见名称 | API 实际路径 |
|-------------|-------------|
| 我的应用数据 | `/apps` |
| 我的应用数据/bdpan | `/apps/bdpan` |
**解决方案：**
调用命令时使用相对路径或英文 API 绝对路径，展示给用户时转换为中文名：
```bash
# ✅ 命令中使用 API 路径
bdpan download report.pdf ./report.pdf
# ✅ 展示给用户时使用中文名
# "文件已上传到：我的应用数据/bdpan/report.pdf"
# ❌ 命令中使用中文路径
bdpan download /我的应用数据/bdpan/report.pdf ./report.pdf
# ❌ 展示给用户时暴露 API 路径
# "文件已上传到：/apps/bdpan/report.pdf"
```
### 文件不存在
**症状：**
```
错误: 文件不存在
Error: File not found
```
**解决方案：**
1. 检查本地文件是否存在：
```bash
ls -la <本地路径>
```
2. 检查远程文件是否存在：
```bash
bdpan ls
```
### 上传/下载超时
**症状：** 操作耗时过长并超时。
**解决方案：**
1. 大文件可能需要最多 30 分钟
2. 检查网络连接稳定性
3. 对于非常大的文件，考虑先压缩/分割：
```bash
# 上传前压缩
tar -czf archive.tar.gz large-folder/
bdpan upload archive.tar.gz backup/archive.tar.gz
```
### 转存失败
**症状：**
```
错误: 转存失败
Error: Transfer failed
```
**常见原因及解决方案：**
1. **分享链接已失效**：联系分享者重新生成链接
2. **提取码错误**：确认提取码是否正确
```bash
# 提取码通过 -p 传入
bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p abcd
# 或包含在链接中
bdpan transfer "https://pan.baidu.com/s/1xxxxx?pwd=abcd"
```
3. **网盘空间不足**：清理网盘空间后重试
#### 错误码 errno=13045（自己的分享链接）
**症状：**
```
转存失败: errno=13045, msg=prohibit transfer self share link
```
**原因：**
这是您自己创建并分享的链接，文件已经在您的网盘中，无需再次转存。
**处理方式：**
- **不向用户展示错误**，直接告知文件已在网盘中
- 使用 `bdpan ls` 查找并展示该文件
- 如需要，可提供分享链接供他人使用
示例回复：
```
✅ 文件已在您的网盘中！
文件信息：
- 文件名：example.pdf
- 位置：我的应用数据/bdpan/example.pdf
- 大小：1.2 MB
无需转存，直接使用即可。
```
### 权限不足
**症状：**
```
错误: 权限不足
Error: Permission denied
```
**解决方案：**
1. 检查本地文件权限：
```bash
ls -l <本地路径>
```
2. 确保您对目标目录有写入权限：
```bash
ls -ld <目标目录>
```
---
## 安装问题
### 命令未找到
**症状：** `bdpan: command not found`
**解决方案：**
```bash
# 重新运行安装脚本
bash ${CLAUDE_SKILL_DIR}/scripts/install.sh
# 或者检查 ~/.local/bin 是否在 PATH 中
echo $PATH
# 如果缺失则添加到 PATH（添加到 ~/.zshrc 或 ~/.bashrc）
export PATH="$HOME/.local/bin:$PATH"
```
### 下载了错误的架构
**症状：** 二进制文件无法运行或提示 "exec format error"
**解决方案：**
```bash
# 删除现有二进制文件
rm ~/.local/bin/bdpan
# 重新安装
bash ${CLAUDE_SKILL_DIR}/scripts/install.sh
```
---
## JSON 输出问题
### 无效的 JSON 输出
**症状：** `--json` 输出无法被解析。
**解决方案：**
1. 确保 stdout 中没有错误消息
2. 检查输出中只有 JSON 内容
3. 使用 `jq` 验证：
```bash
bdpan ls --json | jq .
```
---
## 平台特定问题
### macOS
#### Gatekeeper 阻止
**症状：** 无法打开应用，因为它来自身份不明的开发者。
**解决方案：**
```bash
xattr -d com.apple.quarantine ~/.local/bin/bdpan
```
### Linux
#### 缺少依赖
**症状：** 二进制文件运行失败，提示缺少库。
**解决方案：**
安装所需依赖（特定于发行版）：
```bash
# Debian/Ubuntu
sudo apt-get install libc6
# Fedora/RHEL
sudo dnf install glibc
```
### Windows (WSL)
#### 路径问题
**症状：** Windows 路径无法正常工作。
**解决方案：**
在 WSL 中始终使用 Unix 风格路径：
```bash
# 正确
bdpan upload ./file.txt file.txt
# 错误
bdpan upload .\\file.txt file.txt
```
---
## 获取帮助
### 检查版本
```bash
bdpan version
```
### 获取命令帮助
```bash
bdpan --help
bdpan upload --help
bdpan download --help
```
### 启用调试模式
```bash
# 检查配置文件是否存在及权限
ls -la ~/.config/bdpan/
# 检查登录状态和 Token 有效期
bdpan whoami
```
> **⛔ 安全警告：** 切勿使用 `cat` 查看配置文件内容，配置文件中包含 access_token 等敏感凭据，打印到终端或对话中可能导致泄露。
#!/bin/bash
# bdpan CLI 一键安装脚本
# 自动检测平台架构并下载对应的安装器
set -e
# bdpan CLI 安装器版本（与 CDN 发布版本保持同步）
VERSION="3.7.3"
CDN_BASE="https://issuecdn.baidupcs.com/issue/netdisk/ai-bdpan/installer/${VERSION}"
# 安装器 SHA256 校验值（每次版本更新时同步修改）
declare -A CHECKSUMS=(
["darwin-amd64"]="f49b3577ecd8b596f21e30b1bb8458a31c7ec644c5c4b64da444cea6bbc089cf"
["darwin-arm64"]="8c3a6d3d427e2661a08adfa1acfce4ce849164ba73b9b60662620f7140f86b40"
["linux-amd64"]="1678837c5ce6978f6491e76b10e344fba2beef6f81eb067c7ecc5668cf38fedb"
["linux-arm64"]="7692f828a1af10289274e6951225fcbe9ad3c0664ebee0b492c410855220c197"
)
# 颜色输出
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m' # No Color
log_info() {
echo -e "${GREEN}[INFO]${NC} $1"
}
log_warn() {
echo -e "${YELLOW}[WARN]${NC} $1"
}
log_error() {
echo -e "${RED}[ERROR]${NC} $1"
}
# 检测操作系统
detect_os() {
case "$(uname -s)" in
Darwin)
echo "darwin"
;;
Linux)
echo "linux"
;;
MINGW*|MSYS*|CYGWIN*)
echo "windows"
;;
*)
log_error "不支持的操作系统: $(uname -s)"
exit 1
;;
esac
}
# 检测架构
detect_arch() {
case "$(uname -m)" in
x86_64|amd64)
echo "amd64"
;;
arm64|aarch64)
echo "arm64"
;;
*)
log_error "不支持的架构: $(uname -m)"
exit 1
;;
esac
}
# 主函数
main() {
local force="no"
local skip_download="no"
# 解析参数
while [[ $# -gt 0 ]]; do
case $1 in
--yes|-y|--force|-f)
force="yes"
shift
;;
--skip-download)
skip_download="yes"
shift
;;
--version|-v)
echo "bdpan install script v${VERSION}"
exit 0
;;
--help|-h)
echo "用法: $0 [选项]"
echo ""
echo "选项:"
echo " --yes, -y 非交互式安装（跳过确认）"
echo " --force, -f 强制重新安装"
echo " --skip-download 跳过下载，直接使用本地 bdpan 工具"
echo " （需设置 BDPAN_BIN 环境变量）"
echo " --version 显示版本信息"
echo " --help 显示帮助信息"
echo ""
echo "环境变量:"
echo " BDPAN_BIN 指定本地 bdpan 工具路径"
echo ""
echo "示例:"
echo " $0 # 交互式安装"
echo " $0 --yes # 非交互式安装"
echo " BDPAN_BIN=/path/to/bdpan $0 --skip-download"
echo " # 使用本地工具"
exit 0
;;
*)
log_error "未知参数: $1"
echo "使用 --help 查看帮助信息"
exit 1
;;
esac
done
# 检查是否使用本地 bdpan 工具
if [ "$skip_download" = "yes" ]; then
if [ -z "$BDPAN_BIN" ]; then
log_error "--skip-download 需要 BDPAN_BIN 环境变量指定本地工具路径"
echo "示例: BDPAN_BIN=/path/to/bdpan $0 --skip-download"
exit 1
fi
if [ ! -x "$BDPAN_BIN" ]; then
log_error "指定的 bdpan 工具不存在或不可执行: $BDPAN_BIN"
exit 1
fi
log_info "使用本地 bdpan 工具: $BDPAN_BIN"
local current_version=$("$BDPAN_BIN" version 2>/dev/null | head -1 || echo "unknown")
log_info "bdpan CLI 版本: ${current_version}"
log_info "✓ 配置完成！"
echo ""
echo "使用方式:"
echo " export BDPAN_BIN=\"$BDPAN_BIN\""
echo " bash scripts/login.sh"
echo ""
exit 0
fi
# 检测平台
local os=$(detect_os)
local arch=$(detect_arch)
log_info "检测到平台: ${os}/${arch}"
# 检查是否已安装
if command -v bdpan &> /dev/null; then
local current_version=$(bdpan version 2>/dev/null | head -1 || echo "unknown")
log_warn "bdpan CLI 已安装 (版本: ${current_version})"
if [ "$force" = "yes" ]; then
log_info "强制重新安装..."
else
read -p "是否要重新安装? [y/N] " -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
log_info "取消安装"
exit 0
fi
fi
fi
# 构建安装器文件名和 URL
local installer_name="bdpan-installer-${os}-${arch}"
local installer_url="${CDN_BASE}/${installer_name}"
# Windows 特殊处理
if [ "$os" = "windows" ]; then
installer_name="${installer_name}.exe"
installer_url="${CDN_BASE}/${installer_name}"
fi
log_info "正在下载 bdpan CLI 安装器 (v${VERSION})..."
log_info "下载地址: ${installer_url}"
# 下载并执行安装器（使用 --yes 非交互模式）
if command -v curl &> /dev/null; then
curl -fsSL -O "${installer_url}"
elif command -v wget &> /dev/null; then
wget -q "${installer_url}"
else
log_error "未找到 curl 或 wget，请手动下载安装器"
exit 1
fi
# 添加执行权限（非 Windows）
if [ "$os" != "windows" ]; then
chmod +x "${installer_name}"
fi
log_info "安装器下载完成，正在校验完整性..."
# SHA256 完整性校验
local platform_key="${os}-${arch}"
local expected_checksum="${CHECKSUMS[$platform_key]}"
if [ -n "$expected_checksum" ]; then
local actual_checksum=""
if command -v sha256sum &> /dev/null; then
actual_checksum=$(sha256sum "${installer_name}" | awk '{print $1}')
elif command -v shasum &> /dev/null; then
actual_checksum=$(shasum -a 256 "${installer_name}" | awk '{print $1}')
else
log_warn "未找到 sha256sum/shasum 工具，跳过完整性校验"
fi
if [ -n "$actual_checksum" ]; then
if [ "$actual_checksum" != "$expected_checksum" ]; then
log_error "SHA256 校验失败！文件可能被篡改"
log_error " 期望: ${expected_checksum}"
log_error " 实际: ${actual_checksum}"
rm -f "${installer_name}"
exit 1
fi
log_info "SHA256 校验通过"
fi
else
log_warn "当前平台 ${platform_key} 无预置校验值，跳过完整性校验"
fi
# 执行安装器（非交互模式）
./${installer_name} --yes
# 清理安装器
rm -f "${installer_name}"
# 验证安装
log_info "验证安装..."
if command -v bdpan &> /dev/null; then
local installed_version=$(bdpan version 2>/dev/null | head -1 || echo "unknown")
log_info "✓ bdpan CLI 安装成功！(版本: ${installed_version})"
# 注册到版本管理系统，使 bdpan update 能正常工作
log_info "注册到版本管理系统..."
bdpan install --force 2>/dev/null || log_warn "版本注册跳过（不影响使用）"
echo ""
# 安全免责声明
echo -e "${RED}┌──────────────────────────────────────────────────────────────┐${NC}"
echo -e "${RED}│ ⚠️ bdpan-storage 公测安全须知 & 免责声明 (BETA) │${NC}"
echo -e "${RED}├──────────────────────────────────────────────────────────────┤${NC}"
echo -e "${RED}│${NC} 1. [测试阶段] 本工具处于公测期，仅供技术交流。 ${RED}│${NC}"
echo -e "${RED}│${NC} 请务必【备份】网盘重要数据。 ${RED}│${NC}"
echo -e "${RED}│${NC} 2. [行为负责] AI Agent 行为具有不可预测性，请实时 ${RED}│${NC}"
echo -e "${RED}│${NC} 【人工审核】指令执行过程，对执行后果负责。 ${RED}│${NC}"
echo -e "${RED}│${NC} 3. [安全提醒] 严禁在他人、公用或不可信的环境中 ${RED}│${NC}"
echo -e "${RED}│${NC} 扫码授权，以免网盘数据被窃取！ ${RED}│${NC}"
echo -e "${RED}│${NC} 在公共环境使用完毕后，请务必执行 ${RED}│${NC}"
echo -e "${RED}│${NC} 【bdpan logout】 彻底清除授权。 ${RED}│${NC}"
echo -e "${RED}│${NC} 4. [严禁泄露] 请严格保护配置文件与 Token， ${RED}│${NC}"
echo -e "${RED}│${NC} 切勿在公开仓库或对话中暴露！ ${RED}│${NC}"
echo -e "${RED}├──────────────────────────────────────────────────────────────┤${NC}"
echo -e "${RED}│${NC} 使用本工具即代表您已阅读并认可上述条款。数据安全，人人有责。 ${RED}│${NC}"
echo -e "${RED}└──────────────────────────────────────────────────────────────┘${NC}"
echo ""
echo "快速开始:"
echo " 1. 执行登录: bash scripts/login.sh"
echo " 2. 查看帮助: bdpan --help"
echo ""
else
log_error "安装失败，请检查 PATH 是否包含 ~/.local/bin"
echo "可以手动添加: export PATH=\"\$HOME/.local/bin:\$PATH\""
exit 1
fi
}
# 执行主函数
main "$@"
#!/bin/bash
# bdpan OOB 登录脚本
# 用于非 GUI 环境下的手动授权登录
set -e
# 颜色输出
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
# 解析参数
SKIP_CONFIRM="no"
while [[ $# -gt 0 ]]; do
case $1 in
--yes|-y)
SKIP_CONFIRM="yes"
shift
;;
--help|-h)
echo "用法: $0 [选项]"
echo ""
echo "选项:"
echo " --yes, -y 跳过安全确认（自动化场景）"
echo " --help 显示帮助信息"
exit 0
;;
*)
shift
;;
esac
done
log_info() {
echo -e "${GREEN}[INFO]${NC} $1"
}
log_warn() {
echo -e "${YELLOW}[WARN]${NC} $1"
}
log_error() {
echo -e "${RED}[ERROR]${NC} $1"
}
# 检查 bdpan 是否已安装
if ! command -v bdpan &> /dev/null; then
log_error "bdpan 未安装，请先运行: bash scripts/install.sh"
exit 1
fi
# 检查当前登录状态
log_info "检查登录状态..."
# 获取 bdpan 版本
BDPAN_VERSION=$(bdpan version 2>/dev/null | head -1 || echo "unknown")
if bdpan whoami 2>/dev/null | grep -q "已登录"; then
log_warn "已经登录，无需重复登录"
bdpan whoami
exit 0
fi
log_info "未登录，开始 OOB 授权流程..."
# 安全免责声明
echo ""
echo -e "${RED}┌──────────────────────────────────────────────────────────────┐${NC}"
echo -e "${RED}│ ⚠️ bdpan-storage 公测安全须知 & 免责声明 (BETA) │${NC}"
echo -e "${RED}├──────────────────────────────────────────────────────────────┤${NC}"
echo -e "${RED}│${NC} 1. [测试阶段] 本工具处于公测期，仅供技术交流。 ${RED}│${NC}"
echo -e "${RED}│${NC} 请务必【备份】网盘重要数据。 ${RED}│${NC}"
echo -e "${RED}│${NC} 2. [行为负责] AI Agent 行为具有不可预测性，请实时 ${RED}│${NC}"
echo -e "${RED}│${NC} 【人工审核】指令执行过程，对执行后果负责。 ${RED}│${NC}"
echo -e "${RED}│${NC} 3. [安全提醒] 严禁在他人、公用或不可信的环境中 ${RED}│${NC}"
echo -e "${RED}│${NC} 扫码授权，以免网盘数据被窃取！ ${RED}│${NC}"
echo -e "${RED}│${NC} 在公共环境使用完毕后，请务必执行 ${RED}│${NC}"
echo -e "${RED}│${NC} 【bdpan logout】 彻底清除授权。 ${RED}│${NC}"
echo -e "${RED}│${NC} 4. [严禁泄露] 请严格保护配置文件与 Token， ${RED}│${NC}"
echo -e "${RED}│${NC} 切勿在公开仓库或对话中暴露！ ${RED}│${NC}"
echo -e "${RED}├──────────────────────────────────────────────────────────────┤${NC}"
echo -e "${RED}│${NC} 使用本工具即代表您已阅读并认可上述条款。数据安全，人人有责。 ${RED}│${NC}"
echo -e "${RED}└──────────────────────────────────────────────────────────────┘${NC}"
echo ""
# 用户确认
if [ "$SKIP_CONFIRM" = "yes" ]; then
log_info "自动模式，跳过安全确认"
else
echo -n -e "${YELLOW}已阅读上述安全须知，确认继续登录? [y/N] ${NC}"
read -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
log_info "已取消登录"
exit 0
fi
fi
# 获取授权链接
log_info "正在获取授权链接..."
# 检查是否支持 --get-auth-url 参数
if bdpan login --help 2>/dev/null | grep -q "get-auth-url"; then
# 新版本，支持 --get-auth-url
AUTH_URL=$(bdpan login --get-auth-url 2>/dev/null || echo "")
if [ -z "$AUTH_URL" ]; then
log_error "获取授权链接失败"
exit 1
fi
else
# 旧版本，尝试执行 login 捕获输出
log_warn "当前版本可能不支持 --get-auth-url，尝试兼容模式..."
log_error "当前 bdpan 版本: ${BDPAN_VERSION}"
log_error "请升级到支持 --get-auth-url 的 bdpan 版本（>= 3.0.0）"
log_error "升级方式: bash scripts/install.sh --force"
exit 1
fi
# 显示授权链接（支持 OSC 8 终端超链接，可直接点击打开浏览器）
echo ""
echo -e "${BLUE}========================================${NC}"
echo -e "${BLUE}请在浏览器中打开以下链接完成授权:${NC}"
echo -e "${BLUE}========================================${NC}"
echo ""
# OSC 8 超链接格式：\e]8;;URL\e\\显示文本\e]8;;\e\\
# 支持 iTerm2, VS Code Terminal, Wezterm, GNOME Terminal, Windows Terminal 等
# 不支持的终端会优雅降级，只显示文本
echo -e "\033]8;;${AUTH_URL}\033\\${YELLOW}${AUTH_URL}${NC}\033]8;;\033\\"
echo ""
echo -e "${BLUE}========================================${NC}"
echo -e "${YELLOW}提示:${NC}"
echo -e "${YELLOW}1. 可直接点击上方链接打开浏览器（如终端支持）${NC}"
echo -e "${YELLOW}2. 链接有效期为 10 分钟${NC}"
echo -e "${YELLOW}3. 授权成功后，浏览器会显示一个 32 位授权码${NC}"
echo -e "${YELLOW}4. 请复制授权码并粘贴到下方${NC}"
echo -e "${BLUE}========================================${NC}"
echo ""
# 提示用户输入授权码
echo -n "请输入浏览器中显示的授权码 (32 位十六进制字符): "
read -r AUTH_CODE
if [ -z "$AUTH_CODE" ]; then
log_error "授权码不能为空"
exit 1
fi
# 校验授权码格式：32 位十六进制字符
if ! echo "$AUTH_CODE" | grep -qE '^[a-fA-F0-9]{32}$'; then
log_error "授权码格式不正确（应为 32 位十六进制字符，如: ca0ee3070f75d0246357e5c74d525bda）"
log_error "当前输入: ${AUTH_CODE}"
log_error "请确认您复制的是完整的授权码"
exit 1
fi
# 使用授权码完成登录
log_info "正在使用授权码完成登录..."
# 通过 stdin 安全传递授权码，避免在 ps / /proc/PID/cmdline 中泄露
if bdpan login --help 2>/dev/null | grep -q "set-code-stdin"; then
echo "$AUTH_CODE" | bdpan login --set-code-stdin
else
unset AUTH_CODE
log_error "当前 bdpan 版本不支持 --set-code-stdin（安全授权码传递）"
log_error "当前 bdpan 版本: ${BDPAN_VERSION}"
log_error "请升级到 >= 3.6.2: bash scripts/install.sh --force"
exit 1
fi
# 立即清除内存中的授权码
unset AUTH_CODE
# 验证登录
if bdpan whoami &> /dev/null; then
log_info "✓ 登录成功！"
bdpan whoami
else
log_error "登录失败，请检查授权码是否正确"
exit 1
fi
#!/bin/bash
# bdpan CLI 卸载脚本
# 清除 bdpan 二进制文件、配置文件和授权信息
set -e
# 颜色输出
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m' # No Color
# 默认路径
DEFAULT_INSTALL_DIR="$HOME/.local/bin"
DEFAULT_CONFIG_DIR="$HOME/.config/bdpan"
# 解析参数
SKIP_CONFIRM="no"
while [[ $# -gt 0 ]]; do
case $1 in
--yes|-y)
SKIP_CONFIRM="yes"
shift
;;
--help|-h)
echo "用法: $0 [选项]"
echo ""
echo "选项:"
echo " --yes, -y 跳过确认提示（自动化场景）"
echo " --help 显示帮助信息"
echo ""
echo "环境变量:"
echo " BDPAN_INSTALL_DIR 二进制安装目录（默认: ~/.local/bin）"
echo " BDPAN_CONFIG_DIR 配置文件目录（默认: ~/.config/bdpan）"
exit 0
;;
*)
shift
;;
esac
done
log_info() {
echo -e "${GREEN}[INFO]${NC} $1"
}
log_warn() {
echo -e "${YELLOW}[WARN]${NC} $1"
}
log_error() {
echo -e "${RED}[ERROR]${NC} $1"
}
# 确定实际路径
INSTALL_DIR="${BDPAN_INSTALL_DIR:-$DEFAULT_INSTALL_DIR}"
CONFIG_DIR="${BDPAN_CONFIG_DIR:-$DEFAULT_CONFIG_DIR}"
BINARY_PATH="${INSTALL_DIR}/bdpan"
# 检测要清理的内容
echo ""
echo -e "${YELLOW}========================================${NC}"
echo -e "${YELLOW} bdpan CLI 卸载${NC}"
echo -e "${YELLOW}========================================${NC}"
echo ""
found_items=0
# 检查二进制文件
if [ -f "$BINARY_PATH" ]; then
binary_version=$("$BINARY_PATH" version 2>/dev/null | head -1 || echo "unknown")
echo -e " 二进制文件: ${GREEN}${BINARY_PATH}${NC} (${binary_version})"
found_items=$((found_items + 1))
else
# 尝试 which 查找
actual_path=$(command -v bdpan 2>/dev/null || echo "")
if [ -n "$actual_path" ]; then
BINARY_PATH="$actual_path"
binary_version=$("$BINARY_PATH" version 2>/dev/null | head -1 || echo "unknown")
echo -e " 二进制文件: ${GREEN}${BINARY_PATH}${NC} (${binary_version})"
found_items=$((found_items + 1))
else
echo -e " 二进制文件: ${YELLOW}未找到${NC}"
fi
fi
# 检查配置目录
if [ -d "$CONFIG_DIR" ]; then
config_files=$(find "$CONFIG_DIR" -type f 2>/dev/null | wc -l | tr -d ' ')
echo -e " 配置目录: ${GREEN}${CONFIG_DIR}/${NC} (${config_files} 个文件)"
found_items=$((found_items + 1))
# 检查是否有活跃的登录态
if [ -f "${CONFIG_DIR}/config.json" ]; then
if command -v bdpan &> /dev/null && bdpan whoami 2>/dev/null | grep -q "已登录"; then
echo -e " 登录状态: ${RED}已登录（将清除授权信息）${NC}"
fi
fi
else
echo -e " 配置目录: ${YELLOW}未找到${NC}"
fi
echo ""
# 无内容可清理
if [ "$found_items" -eq 0 ]; then
log_info "未检测到 bdpan 安装，无需卸载"
exit 0
fi
# 用户确认
if [ "$SKIP_CONFIRM" != "yes" ]; then
echo -e "${RED}以上内容将被永久删除，此操作不可逆！${NC}"
echo ""
echo -n -e "${YELLOW}确认卸载 bdpan CLI? [y/N] ${NC}"
read -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
log_info "已取消卸载"
exit 0
fi
fi
echo ""
# 1. 注销登录（清除服务端 session，如有）
if command -v bdpan &> /dev/null && bdpan whoami 2>/dev/null | grep -q "已登录"; then
log_info "正在注销登录..."
bdpan logout 2>/dev/null || true
log_info "✓ 已注销登录"
fi
# 2. 删除配置目录（含 token、config.json 等）
if [ -d "$CONFIG_DIR" ]; then
log_info "正在删除配置目录: ${CONFIG_DIR}/"
rm -rf "$CONFIG_DIR"
log_info "✓ 配置目录已删除"
fi
# 3. 删除二进制文件
if [ -f "$BINARY_PATH" ]; then
log_info "正在删除二进制文件: ${BINARY_PATH}"
rm -f "$BINARY_PATH"
log_info "✓ 二进制文件已删除"
fi
echo ""
echo -e "${GREEN}========================================${NC}"
echo -e "${GREEN} ✓ bdpan CLI 已完全卸载${NC}"
echo -e "${GREEN}========================================${NC}"
echo ""
echo "已清理:"
echo " - 二进制文件 (bdpan)"
echo " - 配置文件和授权信息 (~/.config/bdpan/)"
echo ""
#!/bin/bash
# bdpan-storage Skill 自动更新脚本
# 通过百度配置接口检测并更新 Skill 文件
# CLI 更新由 bdpan 自身管理，本脚本不负责
set -e
# 颜色输出
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color
CONFIG_API="https://pan.baidu.com/act/v2/api/conf?conf_key=bd_skills"
# 脚本所在目录（用于定位 Skill 文件）
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
VERSION_FILE="${SKILL_DIR}/VERSION"
log_info() {
echo -e "${GREEN}[INFO]${NC} $1"
}
log_warn() {
echo -e "${YELLOW}[WARN]${NC} $1"
}
log_error() {
echo -e "${RED}[ERROR]${NC} $1"
}
# 版本比较：返回 0 表示 $1 > $2，1 表示 $1 = $2，2 表示 $1 < $2
version_compare() {
if [ "$1" = "$2" ]; then
return 1
fi
local IFS=.
local i ver1=($1) ver2=($2)
for ((i=${#ver1[@]}; i<${#ver2[@]}; i++)); do
ver1[i]=0
done
for ((i=0; i<${#ver1[@]}; i++)); do
if [ -z "${ver2[i]}" ]; then
ver2[i]=0
fi
if ((10#${ver1[i]} > 10#${ver2[i]})); then
return 0
fi
if ((10#${ver1[i]} < 10#${ver2[i]})); then
return 2
fi
done
return 1
}
# 去除版本号的 v 前缀（如 v1.2.0 → 1.2.0）
strip_v_prefix() {
echo "$1" | sed 's/^v//'
}
# 获取本地 Skill 版本
get_local_version() {
if [ -f "$VERSION_FILE" ]; then
local raw=$(cat "$VERSION_FILE" | tr -d '[:space:]')
strip_v_prefix "$raw"
else
echo "unknown"
fi
}
# 从 query string 中提取指定 key 的值
# 用法: query_get "version=1.1.2&url=https://..." "version"
query_get() {
local qs="$1"
local key="$2"
echo "$qs" | tr '&' '\n' | while IFS='=' read -r k v; do
if [ "$k" = "$key" ]; then
echo "$v"
return 0
fi
done
}
# 请求配置接口，返回 skills_info query string
fetch_skills_info() {
local response=""
if command -v curl &> /dev/null; then
response=$(curl -fsSL --connect-timeout 10 --max-time 30 "$CONFIG_API" 2>/dev/null) || {
log_error "无法连接配置服务器，请检查网络连接"
return 1
}
elif command -v wget &> /dev/null; then
response=$(wget -qO- --timeout=30 "$CONFIG_API" 2>/dev/null) || {
log_error "无法连接配置服务器，请检查网络连接"
return 1
}
else
log_error "未找到 curl 或 wget"
return 1
fi
# 检查 errno：从 JSON 中提取 "errno": 0
local errno=$(echo "$response" | grep -o '"errno"[[:space:]]*:[[:space:]]*[0-9]*' | head -1 | grep -o '[0-9]*$')
if [ "$errno" != "0" ]; then
log_error "配置接口返回错误 (errno: ${errno:-unknown})"
return 1
fi
# 从 response 中提取 skills_info 的值
# API 返回中 & 可能被编码为 \u0026，需要还原
local skills_info=$(echo "$response" | sed 's/\\u0026/\&/g' | grep -o 'version=[^"]*' | head -1 | sed 's/\\//g')
if [ -z "$skills_info" ]; then
log_error "未获取到版本配置信息"
return 1
fi
echo "$skills_info"
}
# 更新 Skill
do_update() {
local remote_url="$1"
local remote_version="$2"
if [ -z "$remote_url" ]; then
log_error "未找到 Skill 下载地址"
return 1
fi
log_info "正在下载 Skill 更新包 (v${remote_version})..."
log_info "下载地址: ${remote_url}"
# 创建临时目录
local tmp_dir=$(mktemp -d)
trap "rm -rf '$tmp_dir'" EXIT
# 下载 zip
local zip_path="${tmp_dir}/bdpan-storage.zip"
if command -v curl &> /dev/null; then
curl -fsSL -o "$zip_path" "$remote_url" || {
log_error "下载 Skill 更新包失败"
return 1
}
elif command -v wget &> /dev/null; then
wget -q -O "$zip_path" "$remote_url" || {
log_error "下载 Skill 更新包失败"
return 1
}
fi
# SHA256 完整性校验（强制）
local checksum=$(query_get "$SKILLS_INFO" "checksum")
if [ -z "$checksum" ]; then
log_error "配置接口未提供 checksum，无法验证更新包完整性，拒绝更新"
return 1
fi
local actual=""
if command -v sha256sum &> /dev/null; then
actual=$(sha256sum "$zip_path" | awk '{print $1}')
elif command -v shasum &> /dev/null; then
actual=$(shasum -a 256 "$zip_path" | awk '{print $1}')
else
log_error "未找到 sha256sum/shasum 工具，无法验证更新包完整性"
return 1
fi
if [ "$actual" != "$checksum" ]; then
log_error "SHA256 校验失败！文件可能被篡改"
log_error " 期望: ${checksum}"
log_error " 实际: ${actual}"
return 1
fi
log_info "SHA256 校验通过"
# 解压覆盖
log_info "正在解压更新..."
if command -v unzip &> /dev/null; then
unzip -qo "$zip_path" -d "$SKILL_DIR" || {
log_error "解压失败"
return 1
}
else
log_error "未找到 unzip 工具"
return 1
fi
# 更新 VERSION 文件
echo "$remote_version" > "$VERSION_FILE"
log_info "Skill 已更新到 v${remote_version}"
}
# 全局变量
SKILLS_INFO=""
# 主函数
main() {
local check_only="no"
local auto_yes="no"
# 解析参数
while [[ $# -gt 0 ]]; do
case $1 in
--check|-c)
check_only="yes"
shift
;;
--yes|-y)
auto_yes="yes"
shift
;;
--help|-h)
echo "用法: $0 [选项]"
echo ""
echo "选项:"
echo " --check, -c 仅检查更新，不执行"
echo " --yes, -y 跳过确认，自动更新"
echo " --help 显示帮助信息"
exit 0
;;
*)
log_error "未知参数: $1"
echo "使用 --help 查看帮助信息"
exit 1
;;
esac
done
# 获取本地版本
local local_version=$(get_local_version)
# 请求远程配置
log_info "正在检查更新..."
SKILLS_INFO=$(fetch_skills_info) || {
log_warn "无法获取更新信息，请稍后再试"
exit 1
}
# 解析远程版本和下载地址（strip v 前缀用于比较）
local remote_version=$(query_get "$SKILLS_INFO" "version")
local remote_version_clean=$(strip_v_prefix "$remote_version")
local remote_url=$(query_get "$SKILLS_INFO" "url")
if [ -z "$remote_version" ]; then
log_error "配置中未包含版本信息"
exit 1
fi
# 展示状态
echo ""
echo -e "${BLUE}========================================${NC}"
echo -e "${BLUE} bdpan-storage Skill 更新检查${NC}"
echo -e "${BLUE}========================================${NC}"
echo ""
echo -e " 本地版本: ${local_version}"
echo -e " 最新版本: ${remote_version}"
# 版本对比
local needs_update="no"
if [ "$local_version" = "unknown" ]; then
echo -e " 状态: ${YELLOW}版本未知，建议更新${NC}"
needs_update="yes"
else
set +e
version_compare "$remote_version_clean" "$local_version"
local cmp_result=$?
set -e
if [ $cmp_result -eq 0 ]; then
echo -e " 状态: ${YELLOW}有新版本可用${NC}"
needs_update="yes"
else
echo -e " 状态: ${GREEN}已是最新${NC}"
fi
fi
echo ""
# 无更新
if [ "$needs_update" = "no" ]; then
log_info "Skill 已是最新版本"
exit 0
fi
# 仅检查模式
if [ "$check_only" = "yes" ]; then
exit 0
fi
# 用户确认
# 安全限制：Agent 环境中禁止使用 --yes 跳过确认
if [ "$auto_yes" = "yes" ]; then
if [ -n "$CLAUDE_CODE" ] || [ -n "$ANTHROPIC_API_KEY" ] || [ -n "$MCP_SERVER" ]; then
log_warn "检测到 Agent 环境，忽略 --yes 参数，保留用户确认环节"
auto_yes="no"
fi
fi
if [ "$auto_yes" != "yes" ]; then
echo -n -e "${YELLOW}是否更新 Skill 到 v${remote_version}? [y/N] ${NC}"
read -n 1 -r
echo
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
log_info "已取消更新"
exit 0
fi
fi
echo ""
# 执行更新
do_update "$remote_url" "$remote_version" || {
log_error "Skill 更新失败"
exit 1
}
echo ""
echo -e "${GREEN}========================================${NC}"
echo -e "${GREEN} ✓ 更新完成${NC}"
echo -e "${GREEN}========================================${NC}"
echo ""
}
# 执行主函数
main "$@"