aiconductor-cli 1.3.1 → 1.3.2

package/AGENTS.md

@@ -1,76 +1,67 @@
-# CLAUDE.md
+# Repository Guidelines
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+## Project Structure & Module Organization
 
-## Commands
-
-### 本地运行
-
-```bash
-node bin/aiconductor-cli.js --help                              # 查看所有命令
-node bin/aiconductor-cli.js <command> --help                    # 查看子命令选项
-node bin/aiconductor-cli.js search web "关键词" -n 3 -f text    # 真实调用示例
 ```
-
-### 发布到 npm
-
-```bash
-npm version patch|minor|major    # 升版本号
-npm pkg fix                      # 修复 package.json 格式
-npm publish                      # 发布
+bin/aiconductor-cli.js     CLI entry point (Commander.js)
+src/
+  api.js                   HTTP API client — all platform calls live here
+  lib/cli-utils.js         Shared helpers: output, error handling, key resolution
+  commands/
+    html_publish.js        `html publish` command
+    md_publish.js          `webpage publish` command (Markdown/HTML)
+    web_search.js          `search web` / `search image` commands
+    douyin.js              All `douyin` subcommands
+    xhs.js                 `xhs note-publish` command
 ```
 
-发布前须对本轮新增/修改的每个命令逐条执行真实调用，确认 exit 0 且输出格式正确。
+- Commands are thin wrappers: parse options, call `src/api.js`, format output, and exit.
+- Shared logic (key resolution, error formatting, output) goes into `src/lib/cli-utils.js`.
+- Each command file exports an async function; no side effects on load.
 
-## Architecture
+## Build, Test, and Development Commands
 
-### 分层结构
+- `node bin/aiconductor-cli.js --help` — run locally without a build step
+- `npm install` — install the single runtime dependency (`commander`)
+- No test suite currently exists
 
-```
-bin/aiconductor-cli.js          ← 入口层：commander 注册子命令树，不含业务逻辑
-src/api.js                      ← API 层：HTTPS 请求封装 + API Key 解析
-src/lib/cli-utils.js            ← 共享工具：output/outputError/key/error 统一处理
-src/commands/<topic>.js         ← 命令层：参数组装、调用 API、格式化输出
-```
+## Coding Style & Naming Conventions
 
-**`bin/aiconductor-cli.js`** — 纯聚合入口，action 回调只做参数传递。
+- 2-space indentation, no tabs
+- CommonJS (`require` / `module.exports`), no ESM
+- camelCase for JS identifiers; snake_case for API request fields
+- Every exported function gets a JSDoc block describing parameters and return type
+- Use `const` by default; `let` only when reassignment is needed
+- No formatter or linter configured — follow surrounding code style
 
-**`src/api.js`** — 所有外部 API 调用的底层封装：
-- `resolveApiKey(optionKey)` — 三级优先级：`-k` 参数 > `AICONDUCTOR_API_KEY` 环境变量 > `.env` 文件
-- `httpPost()` — 通用 HTTPS POST（端口 443），统一处理 HTTP 错误和网络错误
-- 每个 API 端点对应一个独立函数，通过 `stripBilling()` 过滤计费信息
-- 新增 API 端点只改此文件
+## Error Handling
 
-**`src/lib/cli-utils.js`** — 所有 command 文件共享的工具模块：
-- `outputResult(data, format, textFormatter?)` — 统一成功输出（JSON: `{success: true, data}`）
-- `outputError(err, format)` — 统一错误输出（JSON: `{success: false, error}` 到 stderr）
-- `resolveKeyOrExit(optionKey, format)` — 解析 API Key，失败自动输出错误并 exit(1)
-- `handleApiError(err, format)` — 统一处理 http_error / network_error / 未知错误
-- `safeParseInt(value, defaultValue)` — 安全整数解析，防 NaN
+- Never swallow errors with empty `catch`. At minimum, log and re-throw.
+- API errors carry a `.type` property (`http_error`, `network_error`, `validation_error`, `api_error`)
+- Commands exit with code 0 on success, 1 on failure
 
-**`src/commands/<topic>.js`** — 命令编排层，每个文件对应一个子命令组：
-- 导入 `cli-utils` 的 4 个共享函数，消除重复代码
-- 业务逻辑函数接收 argument + options，组装参数 → 调 API → `outputResult`
-- 成功 `exit(0)`，失败 `exit(1)`
+## Testing Guidelines
 
-### 输出格式约定
+No test framework is wired up yet. If adding tests:
+- Use a standard Node.js test runner or Jest
+- Place test files next to the module they cover (`src/commands/web_search.test.js`)
 
-所有命令支持 `-f json|text`：
-- **JSON（默认）**：成功 stdout `{ success: true, data: {...} }`，失败 stderr `{ success: false, error: "..." }`
-- **text**：人类可读格式，成功以 `✓` 开头
+## Commit & Pull Request Guidelines
 
-### API Key 鉴权
+From the existing history:
 
-两种模式共存（由 API 端决定，不要自行统一）：
-- Body 模式：`api_key` 放入请求 body（多数端点）
-- Bearer 模式：`Authorization: Bearer <api_key>` HTTP 头（web_search、douyin_video_search）
+- Messages are in English, often prefixed with conventional commit tags: `feat:`, `fix:`, `refactor:`, `chore:`, `style:`, `ci:`
+- Agent-authored commits include `[Agent]` before the description
+- PRs should describe the change, note API surface impacts, and keep diffs focused
 
-### 扩展新 API 的标准流程
+## Adding a New Command
 
-1. `src/api.js`：添加 API 端点常量和调用函数（~10 行）
-2. `src/commands/<新主题>.js`：新建文件，导入 `cli-utils`，写命令函数（~10 行/命令）
-3. `bin/aiconductor-cli.js`：引入模块并注册子命令组
+1. Create `src/commands/<name>.js` with an async handler that calls `src/api.js`
+2. Add the API function to `src/api.js` if it calls a new endpoint
+3. Register the subcommand in `bin/aiconductor-cli.js`
+4. Update `README.md` — command synopsis, option table, and example
 
-### Skills 依赖
+## Security & Configuration
 
-`.codebuddy/skills/` 下 3 个 skills（`aic-web-search`、`webpage-publish`、`douyin-toolbox`）依赖此 CLI。修改命令签名或输出格式会破坏它们。`.codebuddy/` 已被 `.npmignore` 排除。
+- API Key is read from three sources in order: `-k` CLI argument → `AICONDUCTOR_API_KEY` env var → `.env` file
+- Never commit `.env` files or hardcoded credentials

package/README.md

@@ -77,6 +77,36 @@ aiconductor-cli webpage publish index.html -t my-page
 aiconductor-cli webpage publish "# Hello\n\nThis is **markdown**" -t hello
 ```
 
+### 管理已发布网页
+
+查询当前 API Key 所属用户的网页发布记录：
+
+```bash
+aiconductor-cli webpage list [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--page` | 页码，最小为 1 | 1 |
+| `--page-size` | 每页条数，范围为 1 到 100 | 20 |
+| `-k, --api-key` | API Key（可选） | 环境变量 |
+| `-f, --format` | 输出格式：`json` 或 `text` | json |
+
+删除指定的已发布网页及其公开 HTML 对象：
+
+```bash
+aiconductor-cli webpage delete <webpage_id> [选项]
+```
+
+示例：
+```bash
+# 查看第 2 页，每页 50 条
+aiconductor-cli webpage list --page 2 --page-size 50 -f text
+
+# 删除 ID 为 123 的网页
+aiconductor-cli webpage delete 123
+```
+
 ### 网页搜索
 
 ```bash
@@ -299,6 +329,8 @@ cd aiconductor-cli
 npm install
 node bin/aiconductor-cli.js --help    # 本地运行
 ```
+
+贡献前请阅读 [AGENTS.md](./AGENTS.md) 了解项目结构、编码风格与提交流程。
 
 ## License
 

package/bin/aiconductor-cli.js

@@ -2,7 +2,11 @@
 
 const { Command } = require("commander");
 const { publishCommand } = require("../src/commands/html_publish");
-const { publishCommand: webpagePublishCommand } = require("../src/commands/md_publish");
+const {
+  publishCommand: webpagePublishCommand,
+  listCommand: webpageListCommand,
+  deleteCommand: webpageDeleteCommand,
+} = require("../src/commands/md_publish");
 const { searchCommand } = require("../src/commands/web_search");
 const {
   videoInfoCommand,
@@ -47,8 +51,8 @@ const webpageCmd = program
   .command("webpage")
   .description("网页发布（支持 Markdown 和 HTML）");
 
-webpageCmd
-  .command("publish")
+webpageCmd
+  .command("publish")
   .description("将 Markdown 或 HTML 发布为在线网页（自动识别类型）")
   .argument("<input>", "Markdown/HTML 文本字符串或文件路径")
   .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
@@ -56,9 +60,30 @@ webpageCmd
   .option("--type <type>", "强制指定类型：md 或 html（默认自动识别）")
   .option("--copy-button", "添加代码复制按钮（仅 Markdown 类型生效）")
   .option("-f, --format <format>", "输出格式：json 或 text", "json")
-  .action((input, options) => {
-    webpagePublishCommand(input, options);
-  });
+  .action((input, options) => {
+    webpagePublishCommand(input, options);
+  });
+
+webpageCmd
+  .command("list")
+  .description("查询当前用户已发布的网页")
+  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
+  .option("--page <page>", "页码，最小为 1", "1")
+  .option("--page-size <size>", "每页条数，范围为 1 到 100", "20")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((options) => {
+    webpageListCommand(options);
+  });
+
+webpageCmd
+  .command("delete")
+  .description("删除当前用户指定的已发布网页")
+  .argument("<webpage_id>", "网页记录 ID，可通过 webpage list 获取")
+  .option("-k, --api-key <key>", "AIConductor API Key（也可通过 AICONDUCTOR_API_KEY 环境变量或 .env 文件提供）")
+  .option("-f, --format <format>", "输出格式：json 或 text", "json")
+  .action((webpageId, options) => {
+    webpageDeleteCommand(webpageId, options);
+  });
 
 // search 子命令组
 const searchCmd = program

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiconductor-cli",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "AIConductor CLI 工具箱",
   "keywords": [
     "aiconductor",

package/src/api.js

@@ -3,9 +3,11 @@ const fs = require("fs");
 const path = require("path");
 
 const API_HOST = "plugin.aiconductor.fun";
-const API_PATH = "/api/html_publish";
-const MD_TO_HTML_API_PATH = "/api/md_to_html";
-const SEARCH_API_PATH = "/api/aic_web_search";
+const API_PATH = "/api/html_publish";
+const MD_TO_HTML_API_PATH = "/api/md_to_html";
+const PUBLISHED_WEBPAGES_API_PATH = "/api/published_webpages";
+const DELETE_PUBLISHED_WEBPAGE_API_PATH = "/api/delete_published_webpage";
+const SEARCH_API_PATH = "/api/aic_web_search";
 const DOUYIN_VIDEO_INFO_PATH = "/api/douyin_video_info";
 const DOUYIN_VIDEO_COMMENTS_PATH = "/api/douyin_video_comments";
 const DOUYIN_USER_VIDEOS_PATH = "/api/douyin_user_videos";
@@ -60,7 +62,7 @@ function stripBilling(resp) {
  * @param {*} value
  * @param {string} name
  */
-function validateInt(value, name) {
+function validateInt(value, name) {
   if (value === undefined || value === null) return;
   const n = Number(value);
   if (!Number.isInteger(n) || n < 0) {
@@ -124,6 +126,22 @@ function httpPost(host, requestPath, body, headers = {}) {
   });
 }
 
+/**
+ * 校验正整数参数
+ * @param {*} value
+ * @param {string} name
+ * @param {number} [max]
+ * @returns {number}
+ */
+function validatePositiveInt(value, name, max) {
+  const n = Number(value);
+  if (!Number.isInteger(n) || n < 1 || (max !== undefined && n > max)) {
+    const range = max === undefined ? "大于等于 1" : `1 到 ${max}`;
+    throw Object.assign(new Error(`${name} 须为 ${range} 的整数，收到: ${value}`), { type: "validation_error" });
+  }
+  return n;
+}
+
 function contentTypeForFilename(filename) {
   const types = {
     ".avif": "image/avif",
@@ -291,7 +309,7 @@ async function webSearch(apiKey, params) {
  * @param {boolean} [addCopyButton=true]
  * @returns {Promise<{success: boolean, message: string, file_url: string, online_url: string}>}
  */
-async function publishMdToHtml(apiKey, mdText, filename, addCopyButton = false) {
+async function publishMdToHtml(apiKey, mdText, filename, addCopyButton = false) {
   const reqBody = {
     api_key: apiKey,
     md_text: mdText,
@@ -301,8 +319,44 @@ async function publishMdToHtml(apiKey, mdText, filename, addCopyButton = false)
 
   const resp = await httpPost(API_HOST, MD_TO_HTML_API_PATH, reqBody);
 
-  return stripBilling(resp);
-}
+  return stripBilling(resp);
+}
+
+/**
+ * 查询当前用户已发布的网页列表
+ * @param {string} apiKey
+ * @param {{page?: number|string, pageSize?: number|string}} [params]
+ * @returns {Promise<{success: boolean, webpages: Array, total: number, page: number, page_size: number}>}
+ */
+async function getPublishedWebpages(apiKey, params = {}) {
+  const page = validatePositiveInt(params.page === undefined ? 1 : params.page, "page");
+  const pageSize = validatePositiveInt(params.pageSize === undefined ? 20 : params.pageSize, "page_size", 100);
+  const resp = await httpPost(API_HOST, PUBLISHED_WEBPAGES_API_PATH, {
+    page,
+    page_size: pageSize,
+  }, {
+    Authorization: `Bearer ${apiKey}`,
+  });
+
+  return stripBilling(resp);
+}
+
+/**
+ * 删除当前用户指定的已发布网页
+ * @param {string} apiKey
+ * @param {number|string} webpageId
+ * @returns {Promise<{success: boolean, message: string, webpage_id: number|null}>}
+ */
+async function deletePublishedWebpage(apiKey, webpageId) {
+  const id = validatePositiveInt(webpageId, "webpage_id");
+  const resp = await httpPost(API_HOST, DELETE_PUBLISHED_WEBPAGE_API_PATH, {
+    webpage_id: id,
+  }, {
+    Authorization: `Bearer ${apiKey}`,
+  });
+
+  return stripBilling(resp);
+}
 
 /**
  * 获取抖音作品详情
@@ -436,8 +490,10 @@ async function xhsNotePublish(apiKey, params) {
 
 module.exports = {
   resolveApiKey,
-  publishHtml,
-  publishMdToHtml,
+  publishHtml,
+  publishMdToHtml,
+  getPublishedWebpages,
+  deletePublishedWebpage,
   webSearch,
   douyinVideoInfo,
   douyinVideoComments,

package/src/commands/md_publish.js

@@ -1,6 +1,11 @@
 const fs = require("fs");
 const path = require("path");
-const { publishHtml, publishMdToHtml } = require("../api");
+const {
+  publishHtml,
+  publishMdToHtml,
+  getPublishedWebpages,
+  deletePublishedWebpage,
+} = require("../api");
 const { outputResult, outputError, resolveKeyOrExit, handleApiError } = require("../lib/cli-utils");
 
 /**
@@ -51,6 +56,47 @@ function formatPublishText(data) {
   return out.trimEnd();
 }
 
+/**
+ * text 模式的网页列表格式化
+ * @param {{webpages?: Array, page?: number, page_size?: number, total?: number}} data
+ * @returns {string}
+ */
+function formatWebpageListText(data) {
+  const webpages = data.webpages || [];
+  if (!webpages.length) return "没有已发布网页。";
+
+  const header = `已发布网页（第 ${data.page} 页，每页 ${data.page_size} 条，共 ${data.total} 条）`;
+  const entries = webpages.map((webpage) => {
+    const lines = [`[${webpage.id}] ${webpage.title || "未命名网页"}`];
+    if (webpage.online_url) lines.push(`  URL: ${webpage.online_url}`);
+    if (webpage.source) lines.push(`  来源: ${webpage.source}`);
+    if (webpage.created_at) lines.push(`  发布时间: ${webpage.created_at}`);
+    return lines.join("\n");
+  });
+  return [header, ...entries].join("\n");
+}
+
+/**
+ * text 模式的网页删除格式化
+ * @param {{webpage_id?: number|null, message?: string}} data
+ * @returns {string}
+ */
+function formatWebpageDeleteText(data) {
+  let output = `已删除网页 ID: ${data.webpage_id}`;
+  if (data.message) output += `\n信息: ${data.message}`;
+  return output;
+}
+
+/**
+ * API 业务失败时抛出统一错误
+ * @param {{success?: boolean, message?: string}} result
+ */
+function throwOnApiFailure(result) {
+  if (result && result.success === false) {
+    throw Object.assign(new Error(result.message || "API 请求失败"), { type: "api_error" });
+  }
+}
+
 /**
  * webpage publish 命令 — 统一发布 Markdown 或 HTML 为在线网页
  * @param {string} input - Markdown/HTML 代码或文件路径
@@ -84,4 +130,46 @@ async function publishCommand(input, options = {}) {
   }
 }
 
-module.exports = { publishCommand };
+/**
+ * webpage list 命令 — 查询当前用户已发布的网页
+ * @param {{ apiKey?: string, format?: string, page?: string, pageSize?: string }} options
+ */
+async function listCommand(options = {}) {
+  const format = options.format || "json";
+  const apiKey = resolveKeyOrExit(options.apiKey, format);
+
+  try {
+    const result = await getPublishedWebpages(apiKey, {
+      page: options.page,
+      pageSize: options.pageSize,
+    });
+    throwOnApiFailure(result);
+    outputResult(result, format, formatWebpageListText);
+    process.exit(0);
+  } catch (err) {
+    handleApiError(err, format);
+    process.exit(1);
+  }
+}
+
+/**
+ * webpage delete 命令 — 删除指定的已发布网页
+ * @param {string} webpageId
+ * @param {{ apiKey?: string, format?: string }} options
+ */
+async function deleteCommand(webpageId, options = {}) {
+  const format = options.format || "json";
+  const apiKey = resolveKeyOrExit(options.apiKey, format);
+
+  try {
+    const result = await deletePublishedWebpage(apiKey, webpageId);
+    throwOnApiFailure(result);
+    outputResult(result, format, formatWebpageDeleteText);
+    process.exit(0);
+  } catch (err) {
+    handleApiError(err, format);
+    process.exit(1);
+  }
+}
+
+module.exports = { publishCommand, listCommand, deleteCommand };

package/.codebuddy/skills/aic-web-search/SKILL.md

@@ -1,141 +0,0 @@
----
-name: aic-web-search
-description: 通过 AIConductor CLI 进行网页搜索和图片搜索。当用户需要搜索网络信息、查找网页内容、搜索图片时应使用此 Skill。触发词包括：搜索/搜一下/查一下/网页搜索/图片搜索/联网搜索/web search/image search。
----
-
-## 概述
-
-此 Skill 通过全局安装的 `aiconductor-cli` 命令行工具，调用融合信息搜索 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` 文件。
-
-## 搜索流程
-
-### 网页搜索
-
-使用 JSON 格式（默认，AI 友好）。
-
-```bash
-aiconductor-cli search web <搜索关键词> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `-n, --count <n>` | 返回条数（最多50） | 5 |
-| `--time-range <range>` | 时间范围过滤 | 无 |
-| `--no-summary` | 不返回内容摘要 | 默认返回摘要 |
-| `--content-format <format>` | 内容格式：`Text` 或 `Markdown` | `Text` |
-| `--auth-level <level>` | 权威来源过滤：`0`=不过滤，`1`=优先权威来源 | `0` |
-| `--query-rewrite` | 开启 Query 改写（口语化/长问题推荐） | 关闭 |
-| `-k, --api-key <key>` | API Key | 环境变量或 .env |
-| `-f, --format <format>` | 输出格式：`json` 或 `text` | `json` |
-
-**time_range 可选值：**
-- `OneDay` - 最近一天
-- `OneWeek` - 最近一周
-- `OneMonth` - 最近一月
-- `OneYear` - 最近一年
-- `YYYY-MM-DD..YYYY-MM-DD` - 自定义日期区间，如 `2025-01-01..2025-04-18`
-
-**示例：**
-
-```bash
-aiconductor-cli search web "北京今日天气" -n 5 --auth-level 1
-```
-
-若用户需要人类可读输出：
-
-```bash
-aiconductor-cli search web "北京今日天气" -f text
-```
-
-### 图片搜索
-
-```bash
-aiconductor-cli search image <搜索关键词> [选项]
-```
-
-**选项：**
-
-| 选项 | 说明 | 默认值 |
-|------|------|--------|
-| `-n, --count <n>` | 返回条数（最多5） | 5 |
-| `--time-range <range>` | 时间范围过滤 | 无 |
-| `-k, --api-key <key>` | API Key | 环境变量或 .env |
-| `-f, --format <format>` | 输出格式：`json` 或 `text` | `json` |
-
-**示例：**
-
-```bash
-aiconductor-cli search image "长城风景" -n 3
-```
-
-### 解析输出
-
-JSON 格式输出示例（网页搜索）：
-```json
-{
-  "success": true,
-  "data": {
-    "success": true,
-    "message": "搜索成功",
-    "data": {
-      "ResultCount": 5,
-      "TimeCost": 234,
-      "WebResults": [
-        {
-          "SortId": 1,
-          "Title": "北京今日天气",
-          "SiteName": "中国天气网",
-          "Url": "https://...",
-          "Snippet": "摘要片段...",
-          "Summary": "内容摘要...",
-          "Content": "页面正文...",
-          "PublishTime": "2025-06-23",
-          "RankScore": 0.95
-        }
-      ]
-    }
-  }
-}
-```
-
-从中提取 `data.data.WebResults`（网页搜索）或 `data.data.ImageResults`（图片搜索）作为搜索结果返回给用户。
-
-### 错误处理
-
-- 缺少 API Key → 提示用户前往 https://dev.aiconductor.fun/register 注册获取
-- CLI 未安装 / command not found → 执行 `npm install -g aiconductor-cli`，安装后重试原命令
-- API 返回错误 → 展示错误信息给用户
-- 搜索失败不扣费，仅成功时计费
-
-## 注意事项
-
-1. 搜索关键词长度限制 1~100 字符
-2. `need_summary`（摘要）仅对网页搜索有效，图片搜索忽略此参数
-3. `auth_level=1` 适用于医疗、政策、金融等高可信度场景，仅在网页搜索时生效
-4. `query_rewrite=true` 适用于口语化提问或长问题，开启后上游会先改写 query 再搜索
-5. API 按次计费（0.03 元/次），计费信息不会暴露给终端用户
-6. 默认使用 JSON 输出格式，便于 AI Agent 解析

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 无效或认证失败：请用户确认密钥是否正确、是否仍可用，再重试原命令
-- 版本不兼容或参数不被识别：升级到最新版后重试原命令
-
-修复后只重试原命令一次；如果仍失败，向用户展示原始错误信息和已尝试的修复步骤。