@hithink-tech/hithink-finance-cli 0.1.0

package/schemas/capabilities.json

@@ -0,0 +1,290 @@
+{
+  "schema_version": "1",
+  "capabilities": [
+    {
+      "id": "data.clean",
+      "command": ["data", "clean"],
+      "description": "Local capability data.clean",
+      "source": "local"
+    },
+    {
+      "id": "data.init",
+      "command": ["data", "init"],
+      "description": "Local capability data.init",
+      "source": "local"
+    },
+    {
+      "id": "data.migrate",
+      "command": ["data", "migrate"],
+      "description": "Local capability data.migrate",
+      "source": "local"
+    },
+    {
+      "id": "data.remove",
+      "command": ["data", "remove"],
+      "description": "Local capability data.remove",
+      "source": "local"
+    },
+    {
+      "id": "data.repair",
+      "command": ["data", "repair"],
+      "description": "Local capability data.repair",
+      "source": "local"
+    },
+    {
+      "id": "data.status",
+      "command": ["data", "status"],
+      "description": "Local capability data.status",
+      "source": "local"
+    },
+    {
+      "id": "data.sync",
+      "command": ["data", "sync"],
+      "description": "Local capability data.sync",
+      "source": "local"
+    },
+    {
+      "id": "data.validate",
+      "command": ["data", "validate"],
+      "description": "Local capability data.validate",
+      "source": "local"
+    },
+    {
+      "id": "db.describe",
+      "command": ["db", "describe"],
+      "description": "Local capability db.describe",
+      "source": "local"
+    },
+    {
+      "id": "db.export",
+      "command": ["db", "export"],
+      "description": "Local capability db.export",
+      "source": "local"
+    },
+    {
+      "id": "db.query",
+      "command": ["db", "query"],
+      "description": "Local capability db.query",
+      "source": "local"
+    },
+    {
+      "id": "financials.balance-sheet",
+      "command": ["financials", "balance-sheet"],
+      "endpoint": "/api/a-share/financials/balance-sheets",
+      "method": "GET",
+      "paging": "none",
+      "window": "ten-years",
+      "source": "remote"
+    },
+    {
+      "id": "financials.cash-flow",
+      "command": ["financials", "cash-flow"],
+      "endpoint": "/api/a-share/financials/cash-flow-statements",
+      "method": "GET",
+      "paging": "none",
+      "window": "ten-years",
+      "source": "remote"
+    },
+    {
+      "id": "financials.income",
+      "command": ["financials", "income"],
+      "endpoint": "/api/a-share/financials/income-statements",
+      "method": "GET",
+      "paging": "none",
+      "window": "ten-years",
+      "source": "remote"
+    },
+    {
+      "id": "financials.indicators",
+      "command": ["financials", "indicators"],
+      "endpoint": "/api/a-share/financials/indicators",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "index.catalog",
+      "command": ["index", "catalog"],
+      "endpoint": "/api/a-share-index/catalog/ths-index-list",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "index.constituents",
+      "command": ["index", "constituents"],
+      "endpoint": "/api/a-share-index/constituents/ths-stock-list",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "index.history",
+      "command": ["index", "history"],
+      "endpoint": "/api/a-share-index/prices/historical",
+      "method": "GET",
+      "paging": "none",
+      "window": "ten-years",
+      "source": "remote"
+    },
+    {
+      "id": "index.snapshot",
+      "command": ["index", "snapshot"],
+      "endpoint": "/api/a-share-index/prices/snapshot",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "market.adjustment-factors",
+      "command": ["market", "adjustment-factors"],
+      "description": "Local capability market.adjustment-factors",
+      "source": "local"
+    },
+    {
+      "id": "market.calendar",
+      "command": ["market", "calendar"],
+      "endpoint": "/api/a-share/calendar/trading-days",
+      "method": "GET",
+      "paging": "none",
+      "window": "one-year",
+      "source": "remote"
+    },
+    {
+      "id": "market.corporate-actions",
+      "command": ["market", "corporate-actions"],
+      "endpoint": "/api/a-share/corporate-actions/adjustment-factors",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "market.history",
+      "command": ["market", "history"],
+      "endpoint": "/api/a-share/prices/historical",
+      "method": "GET",
+      "paging": "none",
+      "window": "ten-years",
+      "source": "remote"
+    },
+    {
+      "id": "market.panel",
+      "command": ["market", "panel"],
+      "description": "Local capability market.panel",
+      "source": "local"
+    },
+    {
+      "id": "market.snapshot",
+      "command": ["market", "snapshot"],
+      "endpoint": "/api/a-share/prices/snapshot",
+      "method": "GET",
+      "paging": "offset",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "special.anomaly-list",
+      "command": ["special", "anomaly-list"],
+      "endpoint": "/api/a-share/special-data/anomaly-analysis-list",
+      "method": "GET",
+      "paging": "none",
+      "window": "today-only",
+      "source": "remote"
+    },
+    {
+      "id": "special.anomaly-stock",
+      "command": ["special", "anomaly-stock"],
+      "endpoint": "/api/a-share/special-data/anomaly-analysis-stock",
+      "method": "GET",
+      "paging": "none",
+      "window": "today-only",
+      "source": "remote"
+    },
+    {
+      "id": "special.dragon-tiger",
+      "command": ["special", "dragon-tiger"],
+      "endpoint": "/api/a-share/special-data/dragon-tiger-list",
+      "method": "GET",
+      "paging": "none",
+      "window": "one-year",
+      "source": "remote"
+    },
+    {
+      "id": "special.hot-stock",
+      "command": ["special", "hot-stock"],
+      "endpoint": "/api/a-share/special-data/hot-stock-list",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "special.hot-stock-history",
+      "command": ["special", "hot-stock-history"],
+      "endpoint": "/api/a-share/special-data/hot-stock-list-history",
+      "method": "GET",
+      "paging": "none",
+      "window": "one-year",
+      "source": "remote"
+    },
+    {
+      "id": "special.hot-stock-trend",
+      "command": ["special", "hot-stock-trend"],
+      "endpoint": "/api/a-share/special-data/hot-stock-rank-trend",
+      "method": "GET",
+      "paging": "none",
+      "window": "one-year",
+      "source": "remote"
+    },
+    {
+      "id": "special.limit-up-ladder",
+      "command": ["special", "limit-up-ladder"],
+      "endpoint": "/api/a-share/special-data/limit-up-ladder",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "special.limit-up-pool",
+      "command": ["special", "limit-up-pool"],
+      "endpoint": "/api/a-share/special-data/limit-up-pool",
+      "method": "GET",
+      "paging": "page",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "special.skyrocket",
+      "command": ["special", "skyrocket"],
+      "endpoint": "/api/a-share/special-data/skyrocket-list",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "symbol.list",
+      "command": ["symbol", "list"],
+      "endpoint": "/api/meta/tickers/list",
+      "method": "GET",
+      "paging": "offset",
+      "window": "none",
+      "source": "remote"
+    },
+    {
+      "id": "symbol.search",
+      "command": ["symbol", "search"],
+      "endpoint": "/api/meta/tickers/search",
+      "method": "GET",
+      "paging": "none",
+      "window": "none",
+      "source": "remote"
+    }
+  ]
+}

package/schemas/command-envelope.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "hithink-finance command envelope",
+  "oneOf": [
+    {
+      "required": ["ok", "command", "data", "meta"]
+    },
+    {
+      "required": ["ok", "command", "error", "meta"]
+    }
+  ]
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,27 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+const root = path.resolve(import.meta.dirname, '..');
+const globalInstall =
+  !root.includes(`${path.sep}node_modules${path.sep}.pnpm${path.sep}`) &&
+  root.includes(`${path.sep}node_modules${path.sep}`);
+if (globalInstall && existsSync(path.join(root, 'node_modules', 'skills', 'bin', 'cli.mjs'))) {
+  const result = spawnSync(
+    process.execPath,
+    [
+      path.join(root, 'node_modules', 'skills', 'bin', 'cli.mjs'),
+      'add',
+      path.join(root, 'skills'),
+      '--global',
+      '--copy',
+      '--all',
+      '--full-depth',
+    ],
+    { stdio: 'inherit', env: { ...process.env, DISABLE_TELEMETRY: '1' }, windowsHide: true },
+  );
+  if (result.status !== 0)
+    process.stderr.write(
+      'hithink-finance: Skills sync incomplete; run `hithink-finance skills sync --repair`.\n',
+    );
+}

package/scripts/update-check.mjs

@@ -0,0 +1,23 @@
+import { mkdir, rename, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+
+const [packageName, cacheFile] = process.argv.slice(2);
+if (packageName === undefined || cacheFile === undefined) process.exit(2);
+const state = { checkedAt: Date.now(), status: 'failure' };
+try {
+  const response = await fetch(
+    `https://registry.npmjs.org/${packageName.replace('/', '%2f')}/latest`,
+    { signal: AbortSignal.timeout(15_000) },
+  );
+  if (!response.ok) throw new Error(`HTTP ${response.status}`);
+  const body = await response.json();
+  if (typeof body.version !== 'string') throw new Error('missing version');
+  state.status = 'success';
+  state.latestVersion = body.version;
+} catch {
+  // Update checks are advisory; failure is represented only in the cache.
+}
+await mkdir(path.dirname(cacheFile), { recursive: true });
+const temporary = `${cacheFile}.${process.pid}.tmp`;
+await writeFile(temporary, `${JSON.stringify(state)}\n`, { mode: 0o600 });
+await rename(temporary, cacheFile);

package/skills/hithink-finance-data/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: hithink-finance-data
+description: '用于 Agent 通过 hithink-finance CLI 管理本地 DuckDB：初始化、同步、状态、校验、迁移、修复、清理、删除、只读 SQL、导出；远端实时数据转对应业务 skill。'
+---
+
+# hithink-finance-data
+
+本地数据生命周期和 SQL 入口。负责让数据可用、可校验、可导出，而不是解释所有研究结论。
+
+## 前置条件表
+
+| 条件                                   | 操作                                                                                                  |
+| -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| 开始任何 CLI 调用                      | 先读取并遵循 [hithink-finance-shared](../hithink-finance-shared/SKILL.md)                             |
+| 不确定命令是否存在或参数是否变化       | 运行 `hithink-finance capabilities --format json`，再运行 `hithink-finance schema <id> --format json` |
+| 需要执行下表某个命令                   | 先读取对应 reference 文件，不要只凭命令名猜参数                                                       |
+| 结果可能是全市场、分页、多标的或长区间 | 使用命令声明的 `--output <path>` 落盘；远端 stdout 只返回摘要                                         |
+
+## 快速决策
+
+| 用户意图               | 首选命令 / 路由                         |
+| ---------------------- | --------------------------------------- |
+| 首次建库或从 dump 导入 | `data init`                             |
+| 增量/重新同步本地数据  | `data sync`                             |
+| 查看库路径和 schema    | `data status`                           |
+| 质量校验               | `data validate`                         |
+| 迁移计划或应用         | `data migrate`                          |
+| 重建复权等派生数据     | `data repair`                           |
+| 清理下载缓存           | `data clean`                            |
+| 删除本地库             | `data remove --plan` 先预览             |
+| 查看表/视图            | `db describe`                           |
+| 只读 SQL 查询          | `db query --sql <sql>`                  |
+| 大结果导出             | `db export --sql <sql> --output <file>` |
+
+## Shortcuts
+
+| 命令                                         | 何时使用                                                                                                                                                                       |
+| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| [data clean](references/data-clean.md)       | 只清理 CLI 管理的下载缓存，不删除数据库。                                                                                                                                      |
+| [data init](references/data-init.md)         | 远端初始化需要 API Key；执行前先运行 `hithink-finance auth status --format json`，未登录时到 https://fuyao.aicubes.cn/admin 获取 API Key 并运行 `hithink-finance auth login`。 |
+| [data migrate](references/data-migrate.md)   | 默认只输出迁移计划；应用迁移前让用户确认。                                                                                                                                     |
+| [data remove](references/data-remove.md)     | 高风险操作；先运行 `--plan` 报告路径和大小。                                                                                                                                   |
+| [data repair](references/data-repair.md)     | 用于重建派生复权因子等本地派生数据。                                                                                                                                           |
+| [data status](references/data-status.md)     | 本地库不存在时用于确认默认路径和 schema 状态。                                                                                                                                 |
+| [data sync](references/data-sync.md)         | 需要 API Key；执行前先运行 `hithink-finance auth status --format json`，未登录时到 https://fuyao.aicubes.cn/admin 获取 API Key 并运行 `hithink-finance auth login`。           |
+| [data validate](references/data-validate.md) | 用于同步、迁移、研究导出前的质量门禁。                                                                                                                                         |
+| [db describe](references/db-describe.md)     | 查询本地 DuckDB 表和视图清单。                                                                                                                                                 |
+| [db export](references/db-export.md)         | 用于大结果或下游 pandas/notebook 消费。                                                                                                                                        |
+| [db query](references/db-query.md)           | 只读 SQL；小结果才可直接读取 JSON。                                                                                                                                            |
+
+## 原生命令与 schema
+
+```bash
+hithink-finance capabilities --format json
+hithink-finance schema <capability-id> --format json
+hithink-finance data <command> --help
+hithink-finance db <command> --help
+```
+
+使用原生命令前必须先看 schema；schema 是当前 CLI 参数契约，reference 是决策和边界补充。
+
+## 权限表
+
+| 命令类型                       | 要求                                                                   |
+| ------------------------------ | ---------------------------------------------------------------------- |
+| 远端服务查询                   | API Key 来自系统凭据库、`HITHINK_FINANCE_API_KEY` 或 `--api-key-stdin` |
+| 本地 DuckDB 查询/导出          | 本地库存在且 schema 兼容；可用全局 `--db <path>` 指定                  |
+| 删除、迁移、修复等有副作用操作 | 先预览或说明影响；需要用户明确确认时才加 `--yes`                       |
+
+## 边界声明
+
+- SQL 必须只读；写入、DDL、删除或外部副作用不属于 `db query`。
+- 删除数据库或清除数据前先用 plan/状态输出让用户确认，真正删除需要显式 `--yes`。
+- 查询结果很多时用 `db export --output <file>`，不要回显全表。

package/skills/hithink-finance-data/references/data-clean.md

@@ -0,0 +1,33 @@
+# `hithink-finance data clean`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema data.clean --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 只清理 CLI 管理的下载缓存，不删除数据库。
+
+## 命令
+
+```bash
+hithink-finance schema data.clean --format json
+hithink-finance data clean --format json
+```
+
+## 参数选择策略
+
+- 当前实现清理 cache；仍使用 `--format json` 读取结果。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 不要把 cache 清理当作数据库删除。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/data-init.md

@@ -0,0 +1,35 @@
+# `hithink-finance data init`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema data.init --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 远端初始化需要 API Key；执行前先运行 `hithink-finance auth status --format json`，未登录时到 https://fuyao.aicubes.cn/admin 获取 API Key 并运行 `hithink-finance auth login`。
+- 本地文件导入必须同时提供 `--kline` 和 `--events`。
+
+## 命令
+
+```bash
+hithink-finance schema data.init --format json
+hithink-finance data init --kline <kline.parquet> --events <events.parquet> --format json
+```
+
+## 参数选择策略
+
+- `--kline <path>` 与 `--events <path>` 成对出现；可选 `--symbols <path>`。
+- 省略本地文件时从远端 Market Dump 初始化，使用全局 `--profile` / `--api-key-stdin`。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 只给 `--kline` 或只给 `--events` 会失败；两者必须成对。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/data-migrate.md

@@ -0,0 +1,33 @@
+# `hithink-finance data migrate`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema data.migrate --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 默认只输出迁移计划；应用迁移前让用户确认。
+
+## 命令
+
+```bash
+hithink-finance schema data.migrate --format json
+hithink-finance data migrate --apply --format json
+```
+
+## 参数选择策略
+
+- `--apply` 应用迁移；重型迁移需要 `--allow-heavy`。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 看到重型迁移提示时不要自动加 `--allow-heavy`。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/data-remove.md

@@ -0,0 +1,33 @@
+# `hithink-finance data remove`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema data.remove --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 高风险操作；先运行 `--plan` 报告路径和大小。
+
+## 命令
+
+```bash
+hithink-finance schema data.remove --format json
+hithink-finance data remove --plan --format json
+```
+
+## 参数选择策略
+
+- 真正删除需要全局 `--yes`；可用全局 `--db <path>` 指定目标。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 没有用户明确确认时不要追加 `--yes`。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/data-repair.md

@@ -0,0 +1,33 @@
+# `hithink-finance data repair`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema data.repair --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 用于重建派生复权因子等本地派生数据。
+
+## 命令
+
+```bash
+hithink-finance schema data.repair --format json
+hithink-finance data repair --format json
+```
+
+## 参数选择策略
+
+- 可用全局 `--db <path>` 指定库。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 修复前后建议跑 `data validate` 复核。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/data-status.md

@@ -0,0 +1,33 @@
+# `hithink-finance data status`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema data.status --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 本地库不存在时用于确认默认路径和 schema 状态。
+
+## 命令
+
+```bash
+hithink-finance schema data.status --format json
+hithink-finance data status --format json
+```
+
+## 参数选择策略
+
+- 可用全局 `--db <path>` 指定库。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- schema 过新时升级 CLI；schema 过旧时看 `data migrate`。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/data-sync.md

@@ -0,0 +1,34 @@
+# `hithink-finance data sync`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema data.sync --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 需要 API Key；执行前先运行 `hithink-finance auth status --format json`，未登录时到 https://fuyao.aicubes.cn/admin 获取 API Key 并运行 `hithink-finance auth login`。
+- 命令会持有数据锁，避免并发写库。
+
+## 命令
+
+```bash
+hithink-finance schema data.sync --format json
+hithink-finance data sync --format json
+```
+
+## 参数选择策略
+
+- 使用全局 `--db` 指定库路径；默认路径来自平台数据目录。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 认证失败时先回到 shared skill 的 auth 流程。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。