aiconductor-cli 1.3.3 → 1.3.5

package/AGENTS.md

@@ -13,17 +13,23 @@ src/
     web_search.js          `search web` / `search image` commands
     douyin.js              All `douyin` subcommands
     xhs.js                 `xhs note-publish` command
+.codex/skills/
+  <skill-name>/
+    SKILL.md               Skill entry point and decision/execution workflow
+    references/            Documentation loaded only when its stated condition applies
+    scripts/               Optional deterministic, reusable helper scripts
 ```
 
 - 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.
+- Skills are versioned source assets that guide use of one or more real CLI workflows. They are maintained with the corresponding command surface, but are not included in the npm package unless an explicit skill distribution mechanism is added.
 
 ## 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
+- `npm test` — run the Node.js built-in test suite (`node --test`)
 
 ## Coding Style & Naming Conventions
 
@@ -42,9 +48,43 @@ src/
 
 ## 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`)
+Use the Node.js built-in test runner via `npm test`. Place tests next to the module they cover when practical (for example, `src/commands/web_search.test.js`).
+
+For changes to a CLI contract (commands, arguments, options, output, or errors), verify:
+- The affected `--help` output exposes the intended command surface.
+- A representative successful response is parsed and formatted correctly.
+- A representative validation, authentication, or upstream API failure reports a non-zero exit path with useful error output.
+
+## Skill Design & Maintenance
+
+Skills in `.codex/skills` turn the CLI's verified capabilities into agent workflows. Keep them concise and operational; do not treat them as a second, independently authored API reference.
+
+### Structure & Triggering
+
+- The skill directory name and the `name` field in `SKILL.md` frontmatter must identify the same skill.
+- The frontmatter `description` must state the capability, likely user phrasing or context, and boundaries with adjacent skills. Define one clear owner for overlapping workflows so similar skills do not compete for the same request.
+- Keep `SKILL.md` focused on routing, decisions, command invocation, response handling, and safety rules. Move long option tables, platform-specific setup, and detailed background material into `references/`, and state exactly when that reference should be read.
+- Add `scripts/` only for deterministic, reusable work that avoids repeated implementation. Do not add scripts solely to wrap a single documented CLI command.
+- Add platform-specific metadata (such as files under `agents/`) only after validating its schema and behavior in the target runtime. Remove obsolete or unverified metadata rather than preserving it by convention.
+
+### CLI Contract & Execution
+
+- Derive command names, arguments, option names, defaults, response fields, and error semantics from the local `--help` output, implementation, or tests. Do not copy stale documentation or infer unsupported behavior.
+- Default to JSON output and document stable response paths for the information the agent must return. Use text output only when the user asks for terminal-readable results.
+- A user's request for a CLI operation authorizes direct execution. Do not preflight installation, API Key availability, or environment setup on every invocation.
+- Put installation, upgrade, and API Key recovery instructions in an on-demand reference. Read it only when the user requests configuration or the command reports a missing CLI, authentication failure, or option/version incompatibility; after recovery, retry the original command at most once.
+
+### Safety & External Effects
+
+- Never write, commit, or echo API Keys, `.env` content, Base64 media, or other sensitive user material.
+- Describe externally visible effects such as paid calls, temporary links, and public publishing accurately, including their success condition. Do not expose internal billing fields in user-facing output.
+- For irreversible actions, including deletion or invalidating public links, first show the exact target and obtain explicit confirmation unless the user already supplied the unique target and explicitly requested deletion.
+
+## CLI & Skill Synchronization
+
+- When a command, argument, option, default, output shape, or error behavior is added, renamed, or removed, search for affected skills, README sections, and tests. Update all impacted artifacts in the same change.
+- New or changed skills must be added to Git with their `.codex/skills/**` files. Keep `.codex/` excluded from `.npmignore` so skills remain versioned repository assets without being included in the npm package.
+- Before finalizing a skill-related change, validate the referenced command's `--help` output and the documented JSON response path against implementation or tests.
 
 ## Commit & Pull Request Guidelines
 

package/README.md

@@ -157,6 +157,32 @@ aiconductor-cli search image <关键词> [选项]
 aiconductor-cli search image "长城风景" -n 3 --image-width-min 1200 --image-shapes "横长方形|方形" -f text
 ```
 
+### 热点选题简报
+
+聚合多个平台的热点条目，为内容选题提供带来源链接的原料。默认查询知乎、微博、抖音和 AIHOT，每个来源返回 30 条。
+
+```bash
+aiconductor-cli content briefing [选项]
+```
+
+| 选项 | 说明 | 默认值 |
+|------|------|--------|
+| `--sources <ids>` | 来源 ID，逗号分隔；例如 `zhihu,weibo,aihot` | `zhihu,weibo,douyin,aihot` |
+| `--limit <n>` | 每个来源返回条数，范围 1 到 30 | 30 |
+| `-k, --api-key <key>` | API Key（可选） | 环境变量 |
+| `-f, --format <format>` | 输出格式：`json` 或 `text` | json |
+
+示例：
+```bash
+# 默认综合热点简报
+aiconductor-cli content briefing -f text
+
+# 只查看技术与产品来源
+aiconductor-cli content briefing --sources aihot,hackernews,producthunt,juejin --limit 15 -f text
+```
+
+默认 JSON 输出会保留成功来源、缓存状态和失败来源，便于后续选题处理。部分来源失败时仍返回其他成功来源；仅成功返回数据的来源会计费。
+
 ### 抖音数据工具箱
 
 ```bash

package/api_docs/aic_web_search.md

@@ -0,0 +1,84 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/aic_web_search`
+- **方法**: `POST` / `GET`
+- **Content-Type**: `application/json`
+
+## 功能说明
+基于火山引擎融合信息搜索，支持网页搜索和图片搜索，按次计费（0.03元/次）。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| api_key | string | 是 | - | 计费系统API密钥 |
+| query | string | 是 | - | 搜索关键词，1~100字符 |
+| search_type | string | 是 | - | 搜索类型：`web`（网页搜索）/ `image`（图片搜索） |
+| count | integer | 否 | 5 | 返回条数。web最多50，image最多5 |
+| time_range | string | 否 | - | 时间范围过滤，可选值见下方说明 |
+| need_summary | boolean | 否 | true | 是否返回摘要（仅web类型有效） |
+| content_formats | string | 否 | Text | 内容格式：`Text` / `Markdown` |
+
+### time_range 可选值
+
+| 值 | 说明 |
+|----|------|
+| OneDay | 最近一天 |
+| OneWeek | 最近一周 |
+| OneMonth | 最近一月 |
+| OneYear | 最近一年 |
+| YYYY-MM-DD..YYYY-MM-DD | 自定义日期区间，如 `2025-01-01..2025-04-18` |
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| data | object | 搜索结果数据 |
+| data.ResultCount | integer | 结果数量 |
+| data.TimeCost | integer | 搜索耗时（毫秒） |
+| data.WebResults | array | 网页搜索结果（search_type=web时） |
+| data.WebResults[].SortId | integer | 排序序号 |
+| data.WebResults[].Title | string | 页面标题 |
+| data.WebResults[].SiteName | string | 站点名称 |
+| data.WebResults[].Url | string | 页面链接 |
+| data.WebResults[].Snippet | string | 摘要片段 |
+| data.WebResults[].Summary | string | 内容摘要（需need_summary=true） |
+| data.WebResults[].Content | string | 页面正文内容 |
+| data.WebResults[].PublishTime | string | 发布时间 |
+| data.WebResults[].RankScore | float | 相关度评分 |
+| data.ImageResults | array | 图片搜索结果（search_type=image时） |
+| data.ImageResults[].SortId | integer | 排序序号 |
+| data.ImageResults[].Title | string | 图片标题 |
+| data.ImageResults[].SiteName | string | 来源站点 |
+| data.ImageResults[].Url | string | 来源页面链接 |
+| data.ImageResults[].Image.Url | string | 图片直链 |
+| data.ImageResults[].Image.Width | integer | 图片宽度（px） |
+| data.ImageResults[].Image.Height | integer | 图片高度（px） |
+| billing | object | 计费信息 |
+| billing.service_fee | float | 服务费 |
+| billing.discount_applied | boolean | 是否应用折扣 |
+| billing.balance_before | float | 扣费前余额 |
+| billing.balance_after | float | 扣费后余额 |
+| billing.currency | string | 货币类型（CNY） |
+| billing.transaction_id | string | 交易ID |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/aic_web_search" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "api_key": "your_api_key_here",
+    "query": "北京今日天气",
+    "search_type": "web",
+    "count": 5,
+    "need_summary": true
+  }'
+```
+
+## 注意事项
+1. query为必填参数，长度1~100字符
+2. search_type只支持web和image两种类型
+3. need_summary仅对web搜索有效
+4. 搜索失败不扣费，仅成功时计费

package/api_docs/audio_converter.md

@@ -0,0 +1,51 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/audio_converter`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+将视频 URL 转换为音频文件，支持多种输出格式（默认 mp3），包含 API 密钥验证与按秒计费（基础费率 × 音频时长秒数，向上取整），具体费率以 api_services 表配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| video_url | string | 是 | - | 待转换的视频文件 URL |
+| output_format | string | 否 | mp3 | 输出音频格式，如 mp3、wav 等 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| data | object | 转换结果数据 |
+| data.duration | number | 音频时长（秒） |
+| data.* | any | 转换后音频文件信息（URL 等），结构取决于底层转换服务 |
+| billing | object | 计费信息 |
+| billing.service_fee | number | 本次服务费用 |
+| billing.discount_applied | boolean | 是否应用折扣/计费 |
+| billing.balance_before | number | 扣费前余额 |
+| billing.balance_after | number | 扣费后余额 |
+| billing.currency | string | 货币单位（CNY） |
+| billing.transaction_id | string | 交易流水号（失败为 null） |
+| billing.base_fee | number | 基础费率（成功及余额不足分支返回） |
+| billing.duration_seconds | number | 计费时长（秒，向上取整，成功及余额不足分支返回） |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/audio_converter" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{"video_url": "https://example.com/video.mp4", "output_format": "mp3"}'
+```
+
+## 注意事项
+1. 采用后扣费模式：转换失败、API 密钥无效、余额不足以外的其他异常均不扣费（service_fee 为 0）。
+2. 费用 = 基础费率 × 音频时长（向上取整秒数）；余额不足时返回失败且预置计费信息（discount_applied 为 true 但 transaction_id 为 null）。
+3. API 密钥无效或无权限时返回对应错误且不计费。
+4. data 字段具体结构依赖底层音频转换服务，duration 为可靠返回字段。

package/api_docs/balance_query.md

@@ -0,0 +1,38 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/balance_query`
+- **方法**: `POST` / `GET`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+通过 API 密钥查询当前账户余额。查询功能，不计费。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| （无业务参数） | - | - | - | 仅需通过请求头鉴权，无需业务参数 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| balance | float | 账户余额 |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/balance_query" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{}'
+```
+
+## 注意事项
+1. 仅依赖请求头中的 `api_key` 鉴权，无需任何业务参数。
+2. API 密钥无效返回 `success=false` 且 `balance=0`；账户被禁用（status≠1）同样返回 `success=false`。
+3. 该接口为只读查询，不触发任何扣费或交易记录。

package/api_docs/bing_search.md

@@ -0,0 +1,55 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/bing_search`
+- **方法**: `POST`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+通过 Coze 工作流调用 Bing 搜索 API，支持关键词搜索、结果数量、时间范围和偏移量参数，包含 API 密钥验证与按次计费，费用以 api_services 表配置为准。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| query | string | 是 | - | 搜索关键词 |
+| count | int | 否 | 10 | 返回结果数量，范围 1~50 |
+| freshness | string | 否 | 空字符串 | 时间范围，格式 YYYY-MM-DD..YYYY-MM-DD |
+| offset | int | 否 | 0 | 结果偏移量 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| data | object | 搜索结果数据 |
+| data.results | array | 搜索结果列表 |
+| data.results[].name | string | 结果标题 |
+| data.results[].url | string | 结果链接 |
+| data.results[].snippet | string | 结果摘要 |
+| billing | object | 计费信息 |
+| billing.service_fee | number | 本次服务费用 |
+| billing.discount_applied | boolean | 是否应用折扣/计费 |
+| billing.balance_before | number | 扣费前余额 |
+| billing.balance_after | number | 扣费后余额 |
+| billing.currency | string | 货币单位（CNY） |
+| billing.transaction_id | string | 交易流水号（失败为 null） |
+| billing.error | string | 错误描述（失败时返回，成功时无此字段） |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/bing_search" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{"query": "人工智能 最新进展", "count": 10, "freshness": "2024-01-01..2024-12-31", "offset": 0}'
+```
+
+## 注意事项
+1. 采用后扣费模式：搜索失败、参数错误、余额不足、上游异常均不扣费（service_fee 为 0）。
+2. query 为必填；count 须在 1~50 之间，否则返回参数错误且不扣费。
+3. 上游 Coze 工作流请求超时 60 秒，超时视为服务异常且不扣费。
+4. 按次计费：搜索成功即扣费。
+5. billing.error 仅在失败分支返回，用于说明失败原因。

package/api_docs/china_stock_data.md

@@ -0,0 +1,221 @@
+# 中国股票数据 API 文档（统一 params 结构）
+
+- **Base URL**：`https://plugin.aiconductor.fun`
+- **统一入口**：`POST /api/china_stock_data`
+- **请求结构**：
+
+```json
+{
+  "api_key": "",
+  "tool_name": "",
+  "params": {}
+}
+```
+
+- **示例股票**：贵州茅台 `600519`
+
+## output_format（点到即可）
+
+多数工具支持 `params.output_format` 指定输出格式：`json | markdown | csv | html | xml | excel`，不传通常默认 `markdown`。
+
+---
+
+## 通用 curl 模板
+
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "api_key": "sk_ece2677ec2137c37bab9df9f56a2b2",
+    "tool_name": "<TOOL_NAME>",
+    "params": {
+      
+    }
+  }'
+```
+
+---
+
+## 接口列表（30 个 tool_name）
+
+下面每个“接口”都给一个可直接用的 curl 示例（统一用 `600519`）。
+
+### 1) get_time_info（时间信息）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_time_info","params":{}}'
+```
+
+### 2) get_realtime_data（实时行情）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_realtime_data","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 3) get_hist_data（历史行情）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_hist_data","params":{"symbol":"600519","interval":"day","interval_multiplier":1,"start_date":"2026-01-01","end_date":"2026-03-18","adjust":"none","indicators_list":null,"output_format":"json"}}'
+```
+
+### 4) get_news_data（相关新闻）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_news_data","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 5) get_stock_basic_info（股票概要）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_basic_info","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 6) get_financial_metrics（关键财务指标）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_financial_metrics","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 7) get_balance_sheet（资产负债表）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_balance_sheet","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 8) get_income_statement（利润表）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_income_statement","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 9) get_cash_flow（现金流量表）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_cash_flow","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 10) get_fund_flow（资金流向）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_fund_flow","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 11) get_inner_trade_data（内部股东交易）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_inner_trade_data","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 12) get_investor_sentiment（投资情绪）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_investor_sentiment","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 13) get_shareholder_info（股东情况）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_shareholder_info","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 14) get_product_info（主营构成/产品情况）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_product_info","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 15) get_profit_forecast（业绩预测）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_profit_forecast","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 16) get_stock_fhps_detail（分红送股详情）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_fhps_detail","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 17) get_stock_cyq（筹码分布）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_cyq","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 18) get_stock_research_report（研究报告）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_research_report","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 19) get_stock_circulate_stock_holder（流通股东）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_circulate_stock_holder","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 20) get_stock_management_change（高管变动）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_management_change","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 21) get_stock_restricted_release_queue（限售解禁）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_restricted_release_queue","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 22) get_stock_value（估值/价值指标）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_value","params":{"symbol":"600519","output_format":"json"}}'
+```
+
+### 23) get_macro_data（宏观指标）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_macro_data","params":{"indicator":"gdp","output_format":"json"}}'
+```
+
+### 24) get_stock_a_code_name（A股代码-名称表）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_a_code_name","params":{"output_format":"json"}}'
+```
+
+### 25) get_stock_technical_rank（技术形态榜单）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_technical_rank","params":{"indicator_name":"连续上涨","output_format":"json"}}'
+```
+
+### 26) get_stock_board_industry_summary（板块行业概览）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_board_industry_summary","params":{"output_format":"json"}}'
+```
+
+### 27) get_all_cni_indices（全部中证指数列表）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_all_cni_indices","params":{"output_format":"json"}}'
+```
+
+### 28) get_cni_index_hist（中证指数历史）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_cni_index_hist","params":{"symbol":"399300","start_date":"20260101","end_date":"20260318","output_format":"json"}}'
+```
+
+### 29) get_cni_index_detail（中证指数成分）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_cni_index_detail","params":{"symbol":"399300","date":"202603","output_format":"json"}}'
+```
+
+### 30) get_stock_volatility（分钟级波动率）
+```bash
+curl -X POST 'https://plugin.aiconductor.fun/api/china_stock_data' -H 'Content-Type: application/json' \
+  -d '{"api_key":"sk_ece2677ec2137c37bab9df9f56a2b2","tool_name":"get_stock_volatility","params":{"symbol":"600519","start_date":"2026-03-18 09:30:00","end_date":"2026-03-18 15:00:00","period":"1","adjust":"none","output_format":"json"}}'
+```

package/api_docs/delete_published_webpage.md

@@ -0,0 +1,38 @@
+## 接口信息
+- **URL**: `http://plugin.aiconductor.fun/api/delete_published_webpage`
+- **方法**: `POST` / `GET`
+- **Content-Type**: `application/json`
+- **鉴权**: 请求头 `Authorization: Bearer <api_key>`（兼容 body/query 中 `api_key` 参数）
+
+## 功能说明
+删除当前用户指定的已发布网页，同时删除 OSS 上的 HTML 对象使公开链接失效，免费。
+
+## 请求参数
+
+| 参数名 | 类型 | 必填 | 默认值 | 说明 |
+|--------|------|------|--------|------|
+| webpage_id | integer | 是 | - | 已发布网页的记录 ID，从网页列表接口的 `webpages[].id` 获取 |
+
+> **鉴权参数**：api_key 通过请求头 `Authorization: Bearer <api_key>` 传递，不再列入请求参数表。
+
+## 响应参数
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| success | boolean | 是否成功 |
+| message | string | 响应消息 |
+| webpage_id | integer / null | 删除成功时返回已删除的记录 ID；失败时为 null |
+
+## 请求示例
+
+```bash
+curl -X POST "http://plugin.aiconductor.fun/api/delete_published_webpage" \
+  -H "Authorization: Bearer your_api_key" \
+  -H "Content-Type: application/json" \
+  -d '{"webpage_id": 123}'
+```
+
+## 注意事项
+1. 只能删除当前 API 密钥所属用户的记录；不存在或无权的记录会返回同一提示。
+2. 删除会同时移除 OSS 对象，原公开链接将无法再访问。
+3. OSS 删除或数据库删除失败时，接口会返回失败，可重试。