aiconductor-cli 1.3.0 → 1.3.2

package/.codebuddy/skills/aic-web-search/references/aiconductor-skills-setup.md

@@ -1,50 +0,0 @@
-# 技能安装与配置
-
-仅当用户明确要求首次安装、初始化或配置此技能时读取本文档。正常搜索流程默认环境已经可用，不要每次使用前执行初始化。
-
-## 安装或升级 CLI
-
-使用 npm 全局安装最新版：
-
-```bash
-npm install -g aiconductor-cli@latest
-```
-
-安装后确认命令可用：
-
-```bash
-aiconductor-cli --help
-```
-
-## 配置 API Key
-
-引导用户前往 https://dev.aiconductor.fun/register 注册并获取 API Key。
-
-macOS / Linux：
-
-```bash
-echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
-```
-
-Windows PowerShell：
-
-```powershell
-[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
-```
-
-也可在当前项目目录创建 `.env` 文件：
-
-```env
-AICONDUCTOR_API_KEY=your-api-key
-```
-
-优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件。
-
-## 故障恢复
-
-- `command not found` / `aiconductor-cli` 无法识别：执行安装或升级命令后重试原命令
-- 缺少 API Key：按上方方式配置密钥后开启新的终端会话，或在当前命令中临时使用 `-k <api-key>`
-- API Key 无效或认证失败：请用户确认密钥是否正确、是否仍可用，再重试原命令
-- 版本不兼容或参数不被识别：升级到最新版后重试原命令
-
-修复后只重试原命令一次；如果仍失败，向用户展示原始错误信息和已尝试的修复步骤。

package/.codebuddy/skills/douyin-toolbox/SKILL.md

@@ -1,219 +0,0 @@
----
-name: douyin-toolbox
-description: 抖音数据获取与处理工具箱，支持视频详情、评论抓取、用户主页、视频搜索、语音转文字等功能。当用户需要操作抖音数据时使用，例如：(1) 查看某个视频的详细信息或评论，(2) 获取用户主页视频列表或用户资料，(3) 按关键词搜索抖音用户或视频，(4) 将抖音视频语音转为文字，(5) 任何涉及抖音数据提取或分析的任务。
----
-
-## 概述
-
-此 Skill 通过全局安装的 `aiconductor-cli` 命令行工具，调用 AIC 抖音系列 API，支持视频详情、评论抓取、用户视频、用户详情、用户搜索、视频搜索、链接转文字共 7 个功能。
-
-适用环境默认已配置好 CLI 和 API Key。当遇到安装或配置问题时，读取 [references/aiconductor-skills-setup.md](references/aiconductor-skills-setup.md)。仅当用户明确要求初始化或配置 Skill 时才主动读取该文件。
-
-## 使用流程
-
-### 获取视频详情
-
-根据抖音视频分享链接获取视频详细信息，包括作者信息、统计数据、音乐信息等。
-
-```bash
-aiconductor-cli douyin video-info <分享链接> [选项]
-```
-
-**示例：**
-
-```bash
-aiconductor-cli douyin video-info "https://v.douyin.com/xxx/"
-```
-
-### 获取视频评论
-
-根据抖音视频URL获取该视频的评论列表。
-
-```bash
-aiconductor-cli douyin video-comments <视频URL> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-count <n>` | 获取评论数量 | 50 |
-
-**示例：**
-
-```bash
-aiconductor-cli douyin video-comments "https://v.douyin.com/xxx/" --max-count 20
-```
-
-### 获取用户视频列表
-
-根据抖音用户主页URL获取该用户发布的视频列表，支持分页和时间限制。
-
-```bash
-aiconductor-cli douyin user-videos <主页URL> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages <n>` | 最大页数 | 1 |
-| `--max-seconds <n>` | 最长运行时间（秒），最大180 | 50 |
-
-**示例：**
-
-```bash
-aiconductor-cli douyin user-videos "https://www.douyin.com/user/xxx" --max-pages 3
-```
-
-### 获取用户详情
-
-根据抖音用户主页URL获取用户详细信息，包括基本信息、统计数据、直播状态等。
-
-```bash
-aiconductor-cli douyin user-detail <主页URL>
-```
-
-**示例：**
-
-```bash
-aiconductor-cli douyin user-detail "https://www.douyin.com/user/xxx"
-```
-
-### 搜索用户
-
-根据关键词搜索抖音用户，支持按粉丝数量和用户类型筛选。
-
-```bash
-aiconductor-cli douyin user-search <关键词> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages <n>` | 最大页数，0=不限制 | 1 |
-| `--max-seconds <n>` | 最长运行时间（秒），最大180 | 50 |
-| `--fans-range <范围>` | 粉丝数筛选 | 不限 |
-| `--user-type <类型>` | 用户类型筛选 | 不限 |
-
-**粉丝数范围 `--fans-range`：**
-
-| 值 | 说明 |
-|----|------|
-| `0_1k` | 1000以下 |
-| `1k_1w` | 1000到1万 |
-| `1w_10w` | 1万到10万 |
-| `10w_100w` | 10万到100万 |
-| `100w_` | 100万以上 |
-
-**用户类型 `--user-type`：**
-
-| 值 | 说明 |
-|----|------|
-| `common_user` | 普通用户 |
-| `enterprise_user` | 企业认证用户 |
-| `personal_user` | 个人认证用户 |
-
-**示例：**
-
-```bash
-aiconductor-cli douyin user-search "美食博主" --fans-range 1w_10w --user-type personal_user --max-pages 2
-```
-
-### 搜索视频
-
-根据关键词搜索抖音视频，支持排序方式、发布时间、视频时长、内容类型等筛选。
-
-```bash
-aiconductor-cli douyin video-search <关键词> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `--max-pages <n>` | 最大页数，0=不限制 | 1 |
-| `--max-seconds <n>` | 最长运行时间（秒），最大50 | 50 |
-| `--sort-type <类型>` | 排序方式 | 0 |
-| `--publish-time <时间>` | 发布时间筛选 | 0 |
-| `--filter-duration <时长>` | 视频时长筛选 | 0 |
-| `--content-type <类型>` | 内容类型筛选 | 0 |
-
-**排序方式 `--sort-type`：**
-
-| 值 | 说明 |
-|----|------|
-| `0` | 综合排序 |
-| `1` | 最多点赞 |
-| `2` | 最新发布 |
-
-**发布时间 `--publish-time`：**
-
-| 值 | 说明 |
-|----|------|
-| `0` | 不限 |
-| `1` | 最近一天 |
-| `7` | 最近一周 |
-| `180` | 最近半年 |
-
-**视频时长 `--filter-duration`：**
-
-| 值 | 说明 |
-|----|------|
-| `0` | 不限 |
-| `0-1` | 1分钟以内 |
-| `1-5` | 1-5分钟 |
-| `5-10000` | 5分钟以上 |
-
-**内容类型 `--content-type`：**
-
-| 值 | 说明 |
-|----|------|
-| `0` | 不限 |
-| `1` | 视频 |
-| `2` | 图片 |
-| `3` | 文章 |
-
-**示例：**
-
-```bash
-aiconductor-cli douyin video-search "北京旅游" --sort-type 2 --publish-time 7 --max-pages 2
-```
-
-### 链接转文字
-
-将抖音视频链接中的语音转换为文字。支持两套语音识别策略，自动检测转写准确度。
-
-```bash
-aiconductor-cli douyin link-to-text <视频URL>
-```
-
-**示例：**
-
-```bash
-aiconductor-cli douyin link-to-text "https://v.douyin.com/xxx/"
-```
-
-### 通用选项
-
-所有子命令均支持：
-
-| 选项 | 说明 |
-|------|------|
-| `-k, --api-key <key>` | AIConductor API Key（优先于环境变量和 .env） |
-| `-f, --format <format>` | 输出格式：`json` 或 `text`，默认 `json` |
-
-### 错误处理
-
-- 缺少 API Key / CLI 未安装 / command not found → 读取 [references/aiconductor-skills-setup.md](references/aiconductor-skills-setup.md) 并按其步骤处理
-- API 返回错误 → 展示错误信息给用户
-
-## 注意事项
-
-1. 接口支持 POST 和 GET 两种请求方式
-2. 所有接口均自动解析抖音短链接
-3. 翻页接口（用户搜索/视频搜索/用户视频）按页计费，达到时间或页数限制时自动停止
-4. API 按次或按页计费，计费信息不会暴露给终端用户
-5. 默认使用 JSON 输出格式，便于 AI Agent 解析
-6. 获取用户详情按次计费（0.03元/次）而非按秒

package/.codebuddy/skills/douyin-toolbox/references/aiconductor-skills-setup.md

@@ -1,50 +0,0 @@
-# 技能安装与配置
-
-仅当用户明确要求首次安装、初始化或配置此技能时读取本文档。正常操作流程默认环境已经可用，不要每次使用前执行初始化。
-
-## 安装或升级 CLI
-
-使用 npm 全局安装最新版：
-
-```bash
-npm install -g aiconductor-cli@latest
-```
-
-安装后确认命令可用：
-
-```bash
-aiconductor-cli --help
-```
-
-## 配置 API Key
-
-引导用户前往 https://dev.aiconductor.fun/register 注册并获取 API Key。
-
-macOS / Linux：
-
-```bash
-echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
-```
-
-Windows PowerShell：
-
-```powershell
-[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
-```
-
-也可在当前项目目录创建 `.env` 文件：
-
-```env
-AICONDUCTOR_API_KEY=your-api-key
-```
-
-优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件。
-
-## 故障恢复
-
-- `command not found` / `aiconductor-cli` 无法识别：执行安装或升级命令后重试原命令
-- 缺少 API Key：按上方方式配置密钥后开启新的终端会话，或在当前命令中临时使用 `-k <api-key>`
-- API Key 无效或认证失败：请用户确认密钥是否正确、是否仍可用，再重试原命令
-- 版本不兼容或参数不被识别：升级到最新版后重试原命令
-
-修复后只重试原命令一次；如果仍失败，向用户展示原始错误信息和已尝试的修复步骤。

package/.codebuddy/skills/npm-cli-publisher/SKILL.md

@@ -1,166 +0,0 @@
----
-name: "npm-cli-publisher"
-description: "引导构建 Node.js CLI 工具并发布到 npm，包含项目结构、bin 配置、.npmignore、AI Agent 友好输出等最佳实践。当用户想创建、封装或发布 CLI 工具到 npm 时调用。"
----
-
-# npm CLI 工具封装 & 发布指南
-
-## 开始前：先向用户收集信息
-
-在动手之前，确认以下内容（未提供的需主动询问）：
-
-- npm 包名 & 终端命令名
-- 工具功能描述
-- 逻辑来源：调用外部 API 接口，还是自己实现业务逻辑，或两者混合
-- 是否需要 API Key 鉴权
-- 是否已有 npm 账号
-
----
-
-## 流程总览
-
-**初始化** → **项目结构** → **入口配置** → **核心逻辑** → **安全配置** → **发布前检查** → **发布** → **验证**
-
----
-
-## 推荐项目结构
-
-适用于功能较多的 CLI 工具，按主题分类组织：
-
-```
-<project>/
-├── bin/
-│   └── <cli-name>.js        # CLI 入口，聚合所有命令，不含业务逻辑
-├── src/
-│   ├── api.js               # 外部 API 渠道的底层调用封装（仅调用外部接口时需要）
-│   ├── lib/                 # 自实现的业务逻辑模块（仅有自写逻辑时需要）
-│   │   ├── <module-a>.js
-│   │   └── <module-b>.js
-│   └── commands/            # 按主题分类的命令模块，每个文件对应一个子命令分组
-│       ├── <topic-a>.js
-│       ├── <topic-b>.js
-│       └── <topic-c>.js
-├── .npmignore
-└── package.json
-```
-
-> 根据实际情况灵活裁剪：纯 API 封装型不需要 `lib/`，纯自实现型不需要 `api.js`，混合型两者都保留。
-
----
-
-## 分层设计原则
-
-### 逻辑来源的两种模式
-
-**模式一：外部 API 封装型**
-命令的核心逻辑是调用第三方 HTTP 接口，`commands/` 中的函数负责组装参数、调用 `api.js`、过滤响应字段、格式化输出。
-
-**模式二：自实现逻辑型**
-命令的核心逻辑是自己编写的，放在 `src/lib/` 中按功能模块拆分，`commands/` 中的函数负责调用 `lib/` 模块、处理异常、格式化输出。
-
-**混合型**：同一个项目中两种模式可以共存，不同的 topic 文件分别依赖 `api.js` 或 `lib/` 中的模块。
-
-### 各层职责
-
-- **`src/api.js`**：仅负责 HTTP 请求的底层封装，每个外部 API 渠道对应一个调用函数，不含业务判断。新增外部接口渠道只改这里。
-- **`src/lib/<module>.js`**：自实现的业务逻辑，按功能拆分模块，不依赖 CLI 框架，可独立测试。
-- **`src/commands/<topic>.js`**：命令的编排层，调用 `api.js` 或 `lib/` 完成功能，统一处理输出格式和错误。新增命令分类只需新建文件。
-- **`bin/<cli-name>.js`**：纯聚合入口，用 commander 将所有 commands 注册为子命令树，不含任何业务逻辑。
-
-### 扩展方式
-
-- **新增外部 API 渠道**：在 `src/api.js` 添加新的调用函数
-- **新增自实现功能模块**：在 `src/lib/` 新建模块文件
-- **新增命令分类**：在 `src/commands/` 新建 `<topic>.js`，在 `bin/<cli-name>.js` 中引入并注册为新的子命令
-- **新增某分类下的命令**：在对应的 `src/commands/<topic>.js` 中添加新函数，并在 `bin/<cli-name>.js` 对应的子命令中注册
-
----
-
-## 各阶段要点
-
-### 初始化
-`npm init` 创建项目，按需安装依赖（commander 处理命令、axios 发 HTTP 请求等，仅在需要时引入）。
-
-### package.json 关键配置
-- `bin` 字段：命令名 → 入口文件路径（命令名只能用小写字母、数字、连字符）
-- `main` 字段：模块导出入口
-- 填写 `description`、`keywords`、`author`、`engines`
-
-### src/api.js 编写规范（外部 API 封装型适用）
-
-- 每个外部 API 渠道对应一个独立的异步函数，统一处理三种错误类型：有响应体的 HTTP 错误、无响应的网络错误、请求构造错误
-- 需要 API Key 的接口，提供 `resolveApiKey` 函数实现三级优先级查找：命令行参数 > 系统环境变量 > 当前目录 `.env` 文件中的环境变量，找不到时返回 null；环境变量名应与项目名保持一致（如 `AICONDUCTOR_API_KEY`）
-
-### src/lib/\<module\>.js 编写规范（自实现逻辑型适用）
-
-- 每个模块专注单一功能，导出纯函数或类，不依赖 commander 等 CLI 框架
-- 异常向上抛出，由 `commands/` 层统一捕获处理
-- 可独立单元测试
-
-### src/commands/\<topic\>.js 编写规范
-
-- 每个命令对应一个异步函数，接收业务参数、apiKey（可选）、format 参数
-- 需要 API Key 时，调用 `resolveApiKey` 解析，解析失败则抛出明确的错误提示
-- 按需过滤响应中不应暴露给用户的字段（如计费信息、内部 token 等）
-- 统一通过 `outputResult` / `outputError` 两个函数处理输出，成功 `exit(0)`，失败 `exit(1)`
-- `outputResult` 根据 format 参数决定输出格式：json 模式包裹为 `{ success: true, data }` 结构，text 模式直接输出数据
-
-### bin/\<cli-name\>.js 编写规范
-
-- 顶部必须有 `#!/usr/bin/env node` shebang
-- 用 commander 的 `.command().addCommand()` 结构将各 topic 模块聚合为子命令树
-- 每个子命令定义参数（argument）和选项（option），需要 API Key 的命令提供 `-k, --api-key` 选项，所有命令提供 `-f, --format` 选项（默认 json）
-- action 回调只做参数传递，不含业务逻辑
-
-### AI Agent 友好输出
-- 默认输出 JSON（`{ success: true, data: {...} }` / `{ success: false, error: "..." }`）
-- 成功 `exit(0)`，失败 `exit(1)`
-- 提供 `-f text` 选项供人类阅读
-
-### 安全配置（.npmignore）
-排除 `.env`、`node_modules`、开发脚本、本地配置等敏感或无关文件。
-
-### 发布前检查
-
-**第一步：基础配置检查**
-- `#!/usr/bin/env node` shebang 存在
-- bin 路径正确且文件存在
-- `.env` 已被 `.npmignore` 排除
-- 版本号已更新
-- 运行 `npm pkg fix` 修复潜在格式问题
-
-**第二步：逐一运行本轮开发的每个命令行（必须全部通过才能继续）**
-
-在本地通过 `node bin/<cli-name>.js` 或 `npx .` 的方式，对本轮新增或修改的每一个命令逐一执行真实调用，验证标准：
-- 命令能正常执行，无 crash、无未捕获异常
-- 成功场景：exit code 为 0，输出符合预期的 JSON 或 text 格式
-- 失败场景（如缺少参数、API Key 无效）：exit code 为 1，输出包含明确错误信息
-- `--help` 输出包含所有参数和选项说明
-
-**验证流程：**
-1. 列出本轮涉及的所有命令（新增 + 修改），逐条记录
-2. 对每条命令至少执行一次成功场景的真实调用
-3. 对有参数校验或鉴权逻辑的命令，额外执行一次失败场景验证
-4. 全部通过后，在终端输出验证摘要（命令名 + 状态），再进入发布步骤
-5. 任何一条命令验证失败，必须修复后重新验证，不得跳过直接发布
-
-### 发布
-`npm login` → `npm publish`
-- 开启 2FA：加 `--otp=<验证码>`
-- 作用域包：加 `--access public`
-- 更新版本：先 `npm version patch/minor/major`
-
-### 验证
-全局安装后测试命令是否可用，确认 npm 包页面正常显示。
-
----
-
-## 常见问题
-
-| 问题 | 解决方向 |
-|------|----------|
-| bin 名称警告 | 运行 `npm pkg fix` |
-| 403 发布失败 | 2FA 开启，加 `--otp` |
-| 安装后命令找不到 | 检查 shebang 和 bin 路径 |
-| 包名被占用 | 改名或用 `@scope/name` |
-| 版本冲突 | 先升级版本号再发布 |

package/.codebuddy/skills/webpage-publish/SKILL.md

@@ -1,119 +0,0 @@
----
-name: webpage-publish
-description: 将 Markdown 文本/文件或 HTML 代码发布为在线网页。当用户要求将 Markdown 或 HTML 内容发布到网上、部署网页、把内容变成在线链接时应使用此 Skill。触发词包括：发布/部署/上线网页/页面、把 MD/HTML 转成在线链接、生成在线文档、Markdown 转 HTML 发布。
----
-
-## 概述
-
-此 Skill 通过全局安装的 `aiconductor-cli` 命令行工具，将 Markdown 或 HTML 内容发布为在线网页。CLI 自动识别输入类型（Markdown 或 HTML），调用对应 API 获取可公开访问的 URL。
-
-- **Markdown 输入**：自动转换为美观 HTML 页面，调用 `md_to_html` API
-- **HTML 输入**：直接发布原始 HTML，调用 `html_publish` API
-
-## 准备工作
-
-### API Key 配置
-
-引导用户前往 https://dev.aiconductor.fun/register 注册并获取 API Key。
-
-获取后配置环境变量：
-
-**macOS / Linux：**
-```bash
-echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
-```
-
-**Windows PowerShell：**
-```powershell
-[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
-```
-
-> 也可使用 `.env` 文件（项目目录下写入 `AICONDUCTOR_API_KEY=your-api-key`）。
-
-优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件。
-
-## 发布流程
-
-### 输入形式与自动识别
-
-CLI 自动识别输入类型：
-- **文件路径**：根据扩展名判断 — `.md`/`.markdown` → Markdown，`.html`/`.htm` → HTML
-- **文本字符串**：根据内容特征判断 — 含 `<html>`/`<!DOCTYPE>` 等标签 → HTML，否则 → Markdown
-
-如果自动识别不准确，可用 `--type md` 或 `--type html` 强制指定。
-
-### 执行发布
-
-使用 JSON 格式（默认，AI 友好）。
-
-**必须携带 `-t` 参数指定英文文件名**（中文标题会导致 URL 编码问题，部分浏览器无法打开）：
-
-```bash
-# 发布 Markdown 文件
-aiconductor-cli webpage publish ./README.md -t my-docs
-
-# 发布 HTML 文件
-aiconductor-cli webpage publish ./page.html -t my-page
-
-# 发布 Markdown 字符串
-aiconductor-cli webpage publish "# Hello" -t hello
-
-# 发布 HTML 字符串
-aiconductor-cli webpage publish "<h1>Hello</h1>" -t hello
-
-# 强制指定类型（当自动识别不准时）
-aiconductor-cli webpage publish <输入> -t <文件名> --type html
-```
-
-> `-t` 参数仅影响文件名（不含 .html 后缀），不影响页面标题。
-> 命名规则：小写英文 + 连字符，如 `api-docs`、`project-readme`、`meeting-notes`。
-
-若用户需要人类可读输出：
-
-```bash
-aiconductor-cli webpage publish <输入> -t <文件名> -f text
-```
-
-若 Markdown 内容需要代码复制按钮：
-
-```bash
-aiconductor-cli webpage publish <输入> -t <文件名> --copy-button
-```
-
-### 解析输出
-
-JSON 格式输出示例：
-```json
-{
-  "success": true,
-  "data": {
-    "success": true,
-    "message": "HTML网页发布成功",
-    "online_url": "https://oss.aiconductor.fun/online/xxx.html"
-  }
-}
-```
-
-从中提取 `data.online_url` 作为最终可访问链接返回给用户。
-
-### 错误处理
-
-- 缺少 API Key → 提示用户前往 https://dev.aiconductor.fun/register 注册获取
-- CLI 未安装 / command not found → 执行 `npm install -g aiconductor-cli@latest`，安装后重试原命令
-- API 返回错误 → 展示错误信息给用户
-
-### 可选项
-
-- `-t, --title <title>`：指定文件名（不含 .html 后缀）
-- `--type <type>`：强制指定类型：`md` 或 `html`（默认自动识别）
-- `--copy-button`：添加代码复制按钮（仅 Markdown 类型生效，默认不添加）
-- `-f, --format <format>`：输出格式（`json` 或 `text`），默认 `json`
-
-## 注意事项
-
-1. **文件名必须用英文**：`-t` 参数只能传入英文（小写+连字符），禁止中文、空格、特殊字符
-2. 发布前确保内容完整有效
-3. Markdown 类型默认不添加代码块复制按钮，使用 `--copy-button` 可开启；HTML 类型无此选项
-4. API 按次计费（0.01 元/次），计费信息不会暴露给终端用户
-5. 默认使用 JSON 输出格式，便于 AI Agent 解析
-6. 与 `html publish` 命令的区别：`html publish` 是专门发布 HTML 的子命令，`webpage publish` 是统一入口，自动识别 Markdown/HTML

package/.codebuddy/skills/webpage-publish/references/aiconductor-skills-setup.md

@@ -1,50 +0,0 @@
-# 技能安装与配置
-
-仅当用户明确要求首次安装、初始化或配置此技能时读取本文档。正常搜索流程默认环境已经可用，不要每次使用前执行初始化。
-
-## 安装或升级 CLI
-
-使用 npm 全局安装最新版：
-
-```bash
-npm install -g aiconductor-cli@latest
-```
-
-安装后确认命令可用：
-
-```bash
-aiconductor-cli --help
-```
-
-## 配置 API Key
-
-引导用户前往 https://dev.aiconductor.fun/register 注册并获取 API Key。
-
-macOS / Linux：
-
-```bash
-echo 'export AICONDUCTOR_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc
-```
-
-Windows PowerShell：
-
-```powershell
-[Environment]::SetEnvironmentVariable("AICONDUCTOR_API_KEY", "your-api-key", "User")
-```
-
-也可在当前项目目录创建 `.env` 文件：
-
-```env
-AICONDUCTOR_API_KEY=your-api-key
-```
-
-优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件。
-
-## 故障恢复
-
-- `command not found` / `aiconductor-cli` 无法识别：执行安装或升级命令后重试原命令
-- 缺少 API Key：按上方方式配置密钥后开启新的终端会话，或在当前命令中临时使用 `-k <api-key>`
-- API Key 无效或认证失败：请用户确认密钥是否正确、是否仍可用，再重试原命令
-- 版本不兼容或参数不被识别：升级到最新版后重试原命令
-
-修复后只重试原命令一次；如果仍失败，向用户展示原始错误信息和已尝试的修复步骤。