gangtise-openapi-cli 0.10.3 → 0.10.4

package/README.md

@@ -2,18 +2,12 @@
 
 一个可直接调用 Gangtise OpenAPI 的命令行工具。
 
-## 安装
+## 首次安装
 
 ```bash
 npm install -g gangtise-openapi-cli
 ```
 
-更新到最新版：
-
-```bash
-npm update -g gangtise-openapi-cli
-```
-
 验证安装：
 
 ```bash
@@ -28,8 +22,22 @@ cd gangtise-openapi-cli
 npm install
 npm run dev -- --help
 ```
+## 版本更新
+
+查看当前版本（自动与线上版本比对）：
+
+```bash
+gangtise --version
+```
+
+手动更新到最新版：
+
+```bash
+npm update -g gangtise-openapi-cli
+```
 
-## 配置
+
+## 环境配置
 
 优先读取以下环境变量：
 
@@ -43,6 +51,51 @@ export GANGTISE_TOKEN="Bearer xxx"
 如果没有 `GANGTISE_TOKEN`，CLI 会自动调用 token 接口并缓存到本地。
 
 
+## AI Agent Skill
+
+本项目包含 Skill 定义（`gangtise-openapi/SKILL.md`），可让 AI agent 自动调用 `gangtise` CLI 完成投研数据查询。支持以下 AI 编程助手：
+
+- [Claude Code](https://claude.ai/claude-code) — `~/.claude/skills/`
+- [OpenClaw](https://github.com/openclaw/openclaw) — `~/.openclaw/skills/`
+- [Hermes](https://github.com/nicepkg/hermes) — `~/.hermes/skills/`
+
+Skill 目录结构：
+
+```
+gangtise-openapi/
+├── SKILL.md                    # 主 skill 文件（命令参考、参数枚举、使用规则）
+└── references/
+    ├── fields.md               # 字段中英文对照速查表
+    └── lookup-ids.md           # 常用 ID 速查表（行业/券商/机构/公告分类等）
+```
+
+安装：
+
+```bash
+# Claude Code
+cp -r gangtise-openapi ~/.claude/skills/gangtise-openapi
+
+# OpenClaw
+cp -r gangtise-openapi ~/.openclaw/skills/gangtise-openapi
+
+# Hermes
+cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
+```
+
+> **版本更新**：每次 CLI 发版时，`gangtise-openapi/SKILL.md` 的 `version` 字段会自动同步。更新 CLI 后，请将项目中的 `gangtise-openapi/` 目录重新复制到对应的 skills 目录覆盖更新：
+>
+> ```bash
+> # 示例：更新 Claude Code 的 skill
+> cp -r gangtise-openapi ~/.claude/skills/gangtise-openapi
+> ```
+>
+> 可通过查看 SKILL.md 头部的 `version` 字段确认当前版本。
+
+安装后，可以用自然语言触发，例如：
+- "帮我查今天所有的研报"
+- "用 gangtise 命令查一下贵州茅台的日K线"
+- "导出最近一周的首席观点到 jsonl"
+
 ## 数据接口覆盖
 
 | 模块 | 子命令 | 说明 |
@@ -83,43 +136,6 @@ export GANGTISE_TOKEN="Bearer xxx"
 | | `my-conference-list` / `my-conference-download` | 我的会议列表与下载 |
 | **Raw** | `call` | 原始接口调用（可访问任意 endpoint） |
 
-## AI Agent Skill
-
-本项目包含 SKill 定义（`gangtise-openapi/SKILL.md`），可让 AI agent 自动调用 `gangtise` CLI 完成投研数据查询。支持以下 AI 编程助手：
-
-- [Claude Code](https://claude.ai/claude-code) — `~/.claude/skills/`
-- [OpenClaw](https://github.com/openclaw/openclaw) — `~/.openclaw/skills/`
-- [Hermes](https://github.com/nicepkg/hermes) — `~/.hermes/skills/`
-
-Skill 目录结构：
-
-```
-gangtise-openapi/
-├── SKILL.md                    # 主 skill 文件（命令参考、参数枚举、使用规则）
-└── references/
-    ├── fields.md               # 字段中英文对照速查表
-    └── lookup-ids.md           # 常用 ID 速查表（行业/券商/机构/公告分类等）
-```
-
-安装：
-
-```bash
-# Claude Code
-cp -r gangtise-openapi ~/.claude/skills/gangtise-openapi
-
-# OpenClaw
-cp -r gangtise-openapi ~/.openclaw/skills/gangtise-openapi
-
-# Hermes
-cp -r gangtise-openapi ~/.hermes/skills/gangtise-openapi
-```
-
-安装后，可以用自然语言触发，例如：
-- "帮我查今天所有的研报"
-- "用 gangtise 命令查一下贵州茅台的日K线"
-- "导出最近一周的首席观点到 jsonl"
-
-
 ## 命令概览
 
 - `gangtise auth ...`
@@ -349,3 +365,5 @@ gangtise raw call insight.opinion.list --body '{"from":0,"size":120}'
 | `999999` | Gangtise 系统错误，请稍后重试 |
 | `433007` | 不支持该数据源（`knowledge-resource-download` 需正确的 `resourceType + sourceId` 组合） |
 | `430007` | 行情查询超出限制（日K线/分钟K线不传 `--security` 返回全市场，数据量过大；请指定证券代码或缩短日期范围） |
+| `410110` | 异步任务生成中（非终态，需继续轮询） |
+| `410111` | 异步任务生成失败（终态，不可重试） |

package/dist/src/cli.js

@@ -646,3 +646,23 @@ async function main() {
     }
 }
 void main();
+// Background update check on --version
+if (process.argv.includes("--version") || process.argv.includes("-V")) {
+    import("node:https").then((https) => {
+        const req = https.get("https://registry.npmjs.org/gangtise-openapi-cli/latest", (res) => {
+            let body = "";
+            res.on("data", (chunk) => { body += chunk; });
+            res.on("end", () => {
+                try {
+                    const latest = JSON.parse(body).version;
+                    if (latest && latest !== CLI_VERSION) {
+                        process.stderr.write(`\nUpdate available: ${CLI_VERSION} → ${latest}\nRun: npm update -g gangtise-openapi-cli\n`);
+                    }
+                }
+                catch { /* ignore */ }
+            });
+        });
+        req.on("error", () => { });
+        req.setTimeout(3000, () => { req.destroy(); });
+    }).catch(() => { });
+}

package/dist/src/version.js

@@ -1,2 +1,2 @@
 // Auto-generated — DO NOT EDIT
-export const CLI_VERSION = "0.10.3";
+export const CLI_VERSION = "0.10.4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gangtise-openapi-cli",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "CLI for Gangtise OpenAPI",
   "license": "MIT",
   "repository": {
@@ -23,7 +23,7 @@
     "build": "tsc -p tsconfig.json",
     "dev": "tsx src/cli.ts",
     "test": "vitest run",
-    "prepare": "node -e \"const p=JSON.parse(require('fs').readFileSync('package.json','utf8'));require('fs').writeFileSync('src/version.ts','// Auto-generated — DO NOT EDIT\\nexport const CLI_VERSION = \\\"'+p.version+'\\\"\\n')\" && npm run build"
+    "prepare": "node scripts/prepare.cjs && npm run build"
   },
   "engines": {
     "node": ">=20"