gangtise-openapi-cli 0.6.0 → 0.7.1

package/README.md

@@ -44,6 +44,7 @@ export GANGTISE_TOKEN="Bearer xxx"
 - `gangtise quote ...`
 - `gangtise fundamental ...`
 - `gangtise ai ...`
+- `gangtise vault ...`
 - `gangtise raw call ...`
 
 其中 `lookup` 下的研究方向、机构、行业枚举已内置在项目中，无需额外本地文档文件。
@@ -84,7 +85,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 - `insight foreign-report list`
 - `insight announcement list`
 - `ai security-clue`
-- `ai cloud-disk-list`
+- `vault drive-list`
 
 规则：
 - **有时间范围时**（传了 `--start-time/--end-time` 或 `--start-date/--end-date`）：**省略 `--size`**，CLI 自动翻页查全
@@ -93,7 +94,7 @@ gangtise ai knowledge-batch --query 比亚迪 --query 最近热门概念
 
 ## 智能文件命名
 
-下载命令（`summary download`、`research download`、`foreign-report download`、`announcement download`、`cloud-disk-download`）省略 `--output` 时，自动使用真实标题作为文件名：
+下载命令（`summary download`、`research download`、`foreign-report download`、`announcement download`、`vault drive-download`）省略 `--output` 时，自动使用真实标题作为文件名：
 
 1. **缓存优先** — 如果之前执行过对应的 `list` 命令，标题已缓存在 `~/.config/gangtise/title-cache.json`，直接使用，无额外 API 调用
 2. **API 回查** — 缓存未命中时，自动查询最近 200 条记录匹配标题
@@ -146,6 +147,10 @@ gangtise insight roadshow list --institution C100000017
 
 ```bash
 gangtise quote day-kline --security 600519.SH --start-date 2026-03-01 --end-date 2026-03-31
+# 不传 --security 默认返回全市场，不传 --start-date 默认往前一年，不传 --end-date 默认最新
+gangtise quote day-kline --format json
+# 港股日K线
+gangtise quote day-kline-hk --security 00700.HK --start-date 2026-03-01 --end-date 2026-03-31
 ```
 
 ### Fundamental
@@ -179,14 +184,19 @@ gangtise ai peer-comparison --security-code 600519.SH
 gangtise ai earnings-review --security-code 600519.SH --period 2025q3
 gangtise ai theme-tracking --theme-id 121000131 --date 2026-03-01 --type morning
 gangtise ai research-outline --security-code 600519.SH
-gangtise ai cloud-disk-list --keyword 部门文档 --space-type 1 --file-type 1
+```
+
+### Vault
+
+```bash
+gangtise vault drive-list --keyword 部门文档 --space-type 1 --file-type 1
 
 # 云盘下载：自动使用文件标题命名
-gangtise ai cloud-disk-download --file-id 62130
+gangtise vault drive-download --file-id 62130
 # → 2028 全球智能危机  一份来自未来的金融史思想实验  .pdf
+```
 
 gangtise ai knowledge-resource-download --resource-type 60 --source-id 3052524 --output ./resource.txt
-# 若接口返回外链 URL，也会直接输出 URL 或按 --output 保存
 ```
 
 ### Raw
@@ -203,9 +213,10 @@ gangtise raw call insight.opinion.list --body '{"from":0,"size":120}'
 - auth: `login` / `status`
 - lookup: `research-area list` / `broker-org list` / `meeting-org list` / `industry list` / `industry-code list` / `region list` / `announcement-category list`
 - insight: `opinion list` / `summary list` / `summary download` / `roadshow list` / `site-visit list` / `strategy list` / `forum list` / `research list` / `research download` / `foreign-report list` / `foreign-report download` / `announcement list` / `announcement download`
-- quote: `day-kline`
+- quote: `day-kline` / `day-kline-hk`
 - fundamental: `income-statement` / `main-business` / `valuation-analysis`
-- ai: `knowledge-batch` / `knowledge-resource-download` / `security-clue` / `cloud-disk-list` / `cloud-disk-download` / `one-pager` / `investment-logic` / `peer-comparison` / `earnings-review` / `theme-tracking` / `research-outline`
+- ai: `knowledge-batch` / `knowledge-resource-download` / `security-clue` / `one-pager` / `investment-logic` / `peer-comparison` / `earnings-review` / `theme-tracking` / `research-outline`
+- vault: `drive-list` / `drive-download`
 
 注意：`knowledge-resource-download` 依赖正确的 `resourceType + sourceId` 组合；错误组合会返回 `433007 不支持该数据源`。
 
@@ -221,17 +232,22 @@ gangtise raw call insight.opinion.list --body '{"from":0,"size":120}'
 
 ## Claude Code Skill
 
-本项目包含一个 [Claude Code](https://claude.ai/claude-code) skill 定义（`SKILL.md`），可让 AI agent 自动调用 `gangtise` CLI 完成投研数据查询。
+本项目包含一个 [Claude Code](https://claude.ai/claude-code) skill 定义（`gangtise-openapi/SKILL.md`），可让 AI agent 自动调用 `gangtise` CLI 完成投研数据查询。
+
+Skill 目录结构：
+
+```
+gangtise-openapi/
+├── SKILL.md                    # 主 skill 文件（命令参考、参数枚举、使用规则）
+└── references/
+    └── lookup-ids.md           # 常用 ID 速查表（行业/券商/机构/公告分类等）
+```
 
 安装到 Claude Code：
 
 ```bash
-# 方式一：从本地项目安装
-cp SKILL.md ~/.claude/skills/gangtise-openapi/SKILL.md
-
-# 方式二：手动创建目录并复制
-mkdir -p ~/.claude/skills/gangtise-openapi
-cp SKILL.md ~/.claude/skills/gangtise-openapi/
+# 从项目根目录复制整个 skill 目录
+cp -r gangtise-openapi ~/.claude/skills/gangtise-openapi
 ```
 
 安装后，在 Claude Code 中可以用自然语言触发，例如：

package/dist/src/cli.js

@@ -348,10 +348,14 @@ insight.addCommand(foreignReport);
 insight.addCommand(announcement);
 program.addCommand(insight);
 const quote = new Command("quote").description("Quote APIs");
-quote.command("day-kline").option("--security <code>", "Security code", collectList, []).option("--start-date <date>").option("--end-date <date>").option("--limit <number>").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+quote.command("day-kline").option("--security <code>", "Security code (A-share only: .SH/.SZ/.BJ)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").option("--limit <number>", "Max rows per request (default: 5000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
     const client = await createClient();
     await printData(await client.call("quote.day-kline", { securityList: maybeArray(options.security), startDate: options.startDate, endDate: options.endDate, limit: options.limit ? Number(options.limit) : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
 });
+quote.command("day-kline-hk").option("--security <code>", "Security code (HK stock only: .HK)", collectList, []).option("--start-date <date>", "Start date (default: 1 year before end-date)").option("--end-date <date>", "End date (default: latest)").option("--limit <number>", "Max rows per request (default: 5000, max: 10000)").option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+    const client = await createClient();
+    await printData(await client.call("quote.day-kline-hk", { securityList: maybeArray(options.security), startDate: options.startDate, endDate: options.endDate, limit: options.limit ? Number(options.limit) : undefined, fieldList: maybeArray(options.field) }), parseFormat(options.format), options.output);
+});
 program.addCommand(quote);
 const fundamental = new Command("fundamental").description("Fundamental APIs");
 fundamental.command("income-statement").requiredOption("--security-code <code>").option("--start-date <date>").option("--end-date <date>").option("--fiscal-year <year>", "Fiscal year", collectList, []).option("--period <period>", "Period", collectList, []).option("--report-type <type>", "Report type", collectList, []).option("--field <field>", "Field", collectList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
@@ -463,16 +467,18 @@ ai.command("research-outline").requiredOption("--security-code <code>").option("
     const client = await createClient();
     await printData(await client.call("ai.research-outline", { securityCode: options.securityCode }), parseFormat(options.format), options.output);
 });
-ai.command("cloud-disk-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-time <datetime>").option("--end-time <datetime>").option("--keyword <text>").option("--file-type <number>", "File type", collectNumberList, []).option("--space-type <number>", "Space type", collectNumberList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
+const vault = new Command("vault").description("Vault APIs");
+vault.command("drive-list").option("--from <number>", "Starting offset", "0").option("--size <number>", "Total rows to return; omit to fetch all").option("--start-time <datetime>").option("--end-time <datetime>").option("--keyword <text>").option("--file-type <number>", "File type", collectNumberList, []).option("--space-type <number>", "Space type", collectNumberList, []).option("--format <format>", "Output format", "table").option("--output <path>").action(async (options) => {
     const client = await createClient();
-    await printData(await client.call("ai.cloud-disk.list", { from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword, fileTypeList: options.fileType.length ? options.fileType : undefined, spaceTypeList: options.spaceType.length ? options.spaceType : undefined }), parseFormat(options.format), options.output, { endpointKey: "ai.cloud-disk.list", idField: "fileId" });
+    await printData(await client.call("vault.drive.list", { from: Number(options.from), size: options.size === undefined ? undefined : Number(options.size), startTime: options.startTime, endTime: options.endTime, keyword: options.keyword, fileTypeList: options.fileType.length ? options.fileType : undefined, spaceTypeList: options.spaceType.length ? options.spaceType : undefined }), parseFormat(options.format), options.output, { endpointKey: "vault.drive.list", idField: "fileId" });
 });
-ai.command("cloud-disk-download").requiredOption("--file-id <id>").option("--output <path>").action(async (options) => {
+vault.command("drive-download").requiredOption("--file-id <id>").option("--output <path>").action(async (options) => {
     const client = await createClient();
-    const result = await client.call("ai.cloud-disk.download", undefined, { fileId: options.fileId });
-    const title = options.output ? undefined : await resolveTitle(client, result, "ai.cloud-disk.list", "fileId", options.fileId);
+    const result = await client.call("vault.drive.download", undefined, { fileId: options.fileId });
+    const title = options.output ? undefined : await resolveTitle(client, result, "vault.drive.list", "fileId", options.fileId);
     await saveDownloadResult(result, `file-${options.fileId}`, options.output ?? title);
 });
+program.addCommand(vault);
 program.addCommand(ai);
 program.command("raw").description("Raw API calls").addCommand(new Command("call").argument("<endpointKey>").option("--body <json>").option("--query <key=value>", "Query string pair", collectKeyValue, {}).option("--format <format>", "Output format", "json").option("--output <path>").action(async (endpointKey, options) => {
     const client = await createClient();

package/dist/src/core/endpoints.js

@@ -167,7 +167,14 @@ export const ENDPOINTS = {
         method: "POST",
         path: "/application/open-quote/kline/daily",
         kind: "json",
-        description: "Query daily kline",
+        description: "Query A-share daily kline (SH/SZ/BJ)",
+    },
+    quoteDayKlineHk: {
+        key: "quote.day-kline-hk",
+        method: "POST",
+        path: "/application/open-quote/kline-hk/daily",
+        kind: "json",
+        description: "Query HK stock daily kline (HK)",
     },
     fundamentalIncomeStatement: {
         key: "fundamental.income-statement",
@@ -275,20 +282,20 @@ export const ENDPOINTS = {
         kind: "json",
         description: "Get company research outline",
     },
-    aiCloudDiskList: {
-        key: "ai.cloud-disk.list",
+    vaultDriveList: {
+        key: "vault.drive.list",
         method: "POST",
-        path: "/application/open-ai/drive/getList",
+        path: "/application/open-vault/drive/getList",
         kind: "json",
-        description: "List AI cloud disk files",
+        description: "List vault drive files",
         pagination: { enabled: true, maxPageSize: 50 },
     },
-    aiCloudDiskDownload: {
-        key: "ai.cloud-disk.download",
+    vaultDriveDownload: {
+        key: "vault.drive.download",
         method: "GET",
-        path: "/application/open-ai/drive/download/file",
+        path: "/application/open-vault/drive/download/file",
         kind: "download",
-        description: "Download AI cloud disk file",
+        description: "Download vault drive file",
     },
 };
 export const ENDPOINT_REGISTRY = Object.values(ENDPOINTS).reduce((accumulator, endpoint) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "CLI for Gangtise OpenAPI",
   "license": "MIT",
   "repository": {