@ricequant2026/rqdata-cli 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,231 @@
+# Changelog
+
+## [1.0.0] - 2026-03-27
+
+### 首次发布
+
+**核心特性**
+- Go 实现的高性能 CLI 工具
+- 支持 68 个金融数据 API 命令
+- NDJSON/JSON/CSV 多格式输出
+- 系统 Keyring 集成，安全存储凭证
+- 自动 Token 管理和刷新
+- Schema 自动生成，含中文参数描述
+
+**数据覆盖**
+- 指数数据（8 个命令）
+- A股数据（23 个命令）
+- 港股数据（8 个命令）
+- 交易日历（5 个命令）
+- 基金数据（9 个命令）
+- 期货数据（8 个命令）
+- 期权数据（7 个命令）
+- 宏观数据（6 个命令）
+
+**技术亮点**
+- 单文件可执行，静态编译
+- 跨平台支持（Linux/macOS/Windows）
+- 类型安全的参数验证
+- AI Agent 友好的 NDJSON 输出
+
+**文档**
+- 完整的快速上手指南
+- 68 个命令的详细参考文档
+- Go 构建指南
+
+
+### Added
+
+#### 核心功能
+- ✨ 完整的 RQData HTTP API 支持
+- 🚀 CURL 连接复用优化（QPS 提升 44.4%）
+- ⚡ Daemon 模式支持（长连接服务）
+- 📊 多种输出格式（NDJSON、JSON、CSV）
+- 🔒 严格的 Schema 验证
+- 🎯 字段过滤功能（`--fields` 参数）
+
+#### 数据模块
+- 📈 **Index（指数）** - 指数列表、行情、成分股、权重
+- 📊 **Stock CN（A股）** - 行情、财务、分红、融资融券、北向资金、停牌
+- 🇭🇰 **Stock HK（港股）** - 行情、财务、分红
+- 📅 **Calendar（交易日历）** - 交易日列表、前后交易日查询
+- 📉 **Macro（宏观）** - Shibor、CPI、PPI、GDP
+
+#### 认证系统
+- 🔑 环境变量认证（推荐）
+- 🔐 交互式登录
+- 💾 Token 缓存机制
+- ⏰ 自动 Token 刷新
+
+#### 性能优化
+- 🔄 CURL 连接复用
+- 🌐 TCP Keep-Alive
+- 📡 HTTP 持久连接
+- ⚡ Daemon 模式（批量查询性能提升 25%）
+
+#### 测试覆盖
+- ✅ 74 个功能测试（100% 通过率）
+- 📊 5 个性能测试场景
+- 🔬 三方性能对比（CLI vs Daemon vs Python）
+- 🧪 全模块性能验证
+
+### Performance
+
+#### 性能基准
+- **单次请求**: 0.140s（优化前 0.154s，提升 9.1%）
+- **连续请求**: 0.150s/次（优化前 0.200s/次，提升 25%）
+- **平均 QPS**: 7.22 req/s（优化前 5 req/s，提升 44.4%）
+- **大数据吞吐**: 7,652 行/秒
+
+#### 场景性能
+- **1-3次查询**: CLI 直接模式最快（比 Python 快 68-78%）
+- **3-10次查询**: CLI Daemon 模式最快（比 Python 快 60-78%）
+- **20+次高频**: Python API 最快（比 CLI 快 12倍）
+- **大数据量**: Python API 最快（比 CLI 快 2.5倍）
+
+### Documentation
+
+- 📖 完整的 README.md
+- 📚 API 文档
+- 🔧 开发指南
+- 📊 性能测试报告
+- 🤝 贡献指南
+- 📝 更新日志
+
+### Technical Details
+
+#### 架构
+- C++17 标准
+- CMake 构建系统
+- vcpkg 依赖管理
+- 模块化设计
+
+#### 依赖库
+- libcurl - HTTP 客户端
+- nlohmann-json - JSON 处理
+- CLI11 - 命令行解析
+- csv-parser - CSV 解析
+- fmt - 格式化输出
+
+#### 平台支持
+- ✅ macOS (Apple Silicon & Intel)
+- ✅ Linux (x86_64)
+- 🚧 Windows (计划中)
+
+### Testing
+
+#### 功能测试
+- Index 模块: 8/8 通过 ✅
+- Stock CN 模块: 23/23 通过 ✅
+- Stock HK 模块: 8/8 通过 ✅
+- Calendar 模块: 5/5 通过 ✅
+- Fund 模块: 9/9 通过 ✅
+- Futures 模块: 8/8 通过 ✅
+- Options 模块: 7/7 通过 ✅
+- Macro 模块: 6/6 通过 ✅
+- **总计**: 74/74 通过（100%）✅
+
+#### 性能测试
+- 单次请求性能测试 ✅
+- 连续请求性能测试 ✅
+- 大数据量性能测试 ✅
+- 高频请求性能测试 ✅
+- 三方对比测试 ✅
+
+### Known Issues
+
+- Stock HK 模块性能相对较慢（QPS 3.17）- 受 API 响应速度限制
+- 高频场景（20+次/秒）性能不如 Python API - 受进程启动开销限制
+
+### Recommendations
+
+#### 使用建议
+- **临时查询（1-3次）**: 使用 CLI 直接模式
+- **批量脚本（3-20次）**: 使用 CLI Daemon 模式
+- **高频查询（20+次）**: 使用 Python API
+- **大数据量（10K+行）**: 使用 Python API
+
+## [1.0.1] - 2026-03-10
+
+### Fixed
+
+#### 财务数据功能修复
+- 🐛 **修复 `stock cn financial` 命令 HTTP 400 错误**
+  - 问题：`get_pit_financials_ex` API 要求 `fields` 必填，但 CLI 在构建请求时把 `fields` 从 payload 中剔除
+  - 修复：针对 `get_pit_financials_ex` 方法，保留 payload 中的 `fields` 参数传给 API
+  - 影响：现在可以正常获取三大表财务数据（资产负债表、利润表、现金流量表）
+
+- 🐛 **修复 `stock cn financial-indicator` 命令 HTTP 400 错误**
+  - 问题：使用了错误的 method `get_factor`（参数格式不匹配）
+  - 修复：改用 `get_pit_financials_ex` + 衍生指标字段
+  - 影响：现在可以正常获取 ROE、毛利率、净利率等财务衍生指标
+
+#### 认证问题修复
+- 🐛 **修复 Token 过期导致的 HTTP 401 错误**
+  - 问题：缓存的 token 过期后，CLI 继续使用导致认证失败
+  - 解决方案：删除 `~/.rqdata/token.cache` 后，CLI 自动重新认证获取新 token
+  - 建议：如遇 401 错误，运行 `rm -f ~/.rqdata/token.cache` 清除过期缓存
+
+### Added
+
+#### 完整的 HALO 策略支持
+- ✅ 现在可以用纯 CLI 完成 HALO 策略筛选
+- ✅ 支持获取三大表财务数据
+- ✅ 支持获取财务衍生指标（ROE、毛利率等）
+- ✅ 支持批量查询 20 只股票的财务数据
+
+### Documentation
+
+- 📝 添加财务数据 API 使用说明
+- 📝 添加衍生指标字段名参考
+- 📝 添加 Token 过期问题排查指南
+
+### Technical Details
+
+#### 代码修改
+- `src/commands/stock_cn.cpp` 第 71-84 行：修改 `execute_stock_cn_command` 函数，针对 `get_pit_financials_ex` 保留 `fields` 参数
+- `src/commands/stock_cn.cpp` 第 426 行：`financial-indicator` 命令改用 `get_pit_financials_ex` 方法
+
+#### 测试验证
+- ✅ `stock cn financial` 命令测试通过
+- ✅ `stock cn financial-indicator` 命令测试通过
+- ✅ HALO 策略 20 只股票批量查询测试通过
+
+### Notes
+
+#### 衍生指标字段名
+- 使用完整名称：`return_on_equity_weighted_average`（不是 `roe`）
+- TTM 字段使用大写：`net_profitTTM`（不是 `net_profit_ttm`）
+- Quarter 格式使用小写：`2024q3`（不是 `2024Q3`）
+
+## [Unreleased]
+
+### Planned Features
+
+- 🚧 Windows 平台支持
+- 🚧 批量 API 支持
+- 🚧 并行请求支持
+- 🚧 MCP Server 支持
+- 🚧 更多输出格式（Parquet、Arrow）
+
+### Future Optimizations
+
+- 🔮 CSV 解析优化
+- 🔮 二进制数据格式支持
+- 🔮 内存池优化
+- 🔮 并发连接池
+
+---
+
+## Version History
+
+- **v1.0.1** (2026-03-10) - 财务数据修复
+- **v1.0.0** (2026-03-10) - 初始版本发布
+
+---
+
+## Links
+
+- [Repository](http://git.ricequant.com/projects/RQAI/repos/rqdata-cli)
+- [Documentation](http://git.ricequant.com/projects/RQAI/repos/rqdata-cli/browse/docs)
+- [Issues](https://jira.ricequant.com)（RiceQuant 内部 Jira）

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 rq-cli contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,375 @@
+# RQData CLI
+
+> 高性能的 RQData 命令行工具，为量化研究和 AI Agent 设计
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Go Version](https://img.shields.io/badge/Go-1.21%2B-blue.svg)](https://golang.org)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg)]()
+
+---
+
+## 📖 文档导航
+
+- **[🚀 快速上手指南](docs/QUICKSTART.md)** - 5分钟完成安装和第一次查询
+- **[🔧 Go 构建指南](BUILD_GO.md)** - Go 版本编译说明
+- **[📝 更新日志](CHANGELOG.md)** - 版本历史和变更记录
+
+---
+
+## ✨ 特性
+
+- 🚀 **高性能** - Go 原生实现，单文件可执行，无依赖
+- 🤖 **AI Agent 友好** - NDJSON 流式输出，JSON Payload 输入
+- 📊 **全面数据覆盖** - A股、港股、期货、期权、基金、指数、宏观数据
+- 🔒 **类型安全** - 严格的 Schema 验证，自动参数类型推断
+- 🎯 **字段过滤** - `--fields` 参数精确控制返回数据
+- 📖 **自文档化** - `--schema` 标志输出完整 API 文档（含中文描述）
+- 🔐 **安全认证** - 系统 Keyring 集成，Token 自动管理
+
+## 📦 快速安装
+
+### 通过 npm 安装（推荐）
+
+```bash
+npm install -g @ricequant2026/rqdata-cli
+```
+
+安装完成后即可直接使用：
+
+```bash
+rqdata --version
+rqdata --help
+```
+
+### 从源码编译
+
+```bash
+# 克隆仓库
+git clone http://git.ricequant.com/scm/RQAI/rqdata-cli.git
+cd rqdata-cli
+
+# 编译（需要 Go 1.21+）
+VERSION=1.0.0 ./build.sh
+
+# 安装到系统路径
+sudo mv rqdata /usr/local/bin/
+```
+
+### 跨平台构建
+
+```bash
+# Linux
+CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags="-s -w -X github.com/rqdata/rqdata-cli/cmd.Version=1.0.0" -o rqdata-linux main.go
+
+# macOS (Intel)
+CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -trimpath -ldflags="-s -w -X github.com/rqdata/rqdata-cli/cmd.Version=1.0.0" -o rqdata-macos-amd64 main.go
+
+# macOS (Apple Silicon)
+CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -trimpath -ldflags="-s -w -X github.com/rqdata/rqdata-cli/cmd.Version=1.0.0" -o rqdata-macos-arm64 main.go
+
+# Windows
+CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -trimpath -ldflags="-s -w -X github.com/rqdata/rqdata-cli/cmd.Version=1.0.0" -o rqdata.exe main.go
+```
+
+详见 [BUILD_GO.md](BUILD_GO.md)
+
+### 验证安装
+
+```bash
+rqdata --version
+rqdata --help
+```
+
+## 🔑 认证配置
+
+### 环境变量（推荐）
+
+```bash
+# 添加到 ~/.zshrc 或 ~/.bashrc
+export RQDATA_USERNAME="your_phone_or_email"
+export RQDATA_PASSWORD="your_password"
+
+# 重新加载
+source ~/.zshrc
+```
+
+### 交互式登录
+
+```bash
+rqdata auth login
+```
+
+### 验证
+
+```bash
+rqdata auth status
+```
+
+> 💡 没有账号？访问 [ricequant.com](https://www.ricequant.com) 申请试用
+
+## 🚀 快速开始
+
+### 示例 1: 获取股票行情
+
+```bash
+rqdata stock cn price --payload '{
+  "order_book_ids": ["600000.XSHG", "000001.XSHE"],
+  "start_date": "2024-01-01",
+  "end_date": "2024-01-31"
+}'
+```
+
+### 示例 2: 获取指数成分股
+
+```bash
+rqdata index constituents --payload '{
+  "order_book_id": "000300.XSHG",
+  "date": "2024-01-31"
+}'
+```
+
+### 示例 3: 获取宏观数据
+
+```bash
+rqdata macro shibor --payload '{
+  "start_date": "2024-01-01",
+  "end_date": "2024-12-31"
+}'
+```
+
+### 示例 4: 查看命令文档
+
+```bash
+# 查看所有命令
+rqdata --help
+
+# 查看特定命令的参数说明
+rqdata stock cn price --schema
+```
+
+> 📖 更多示例请查看 [快速上手指南](docs/QUICKSTART.md)
+
+## 📚 支持的命令
+
+### 🔐 认证管理
+- `rqdata auth login` - 交互式登录
+- `rqdata auth status` - 查看认证状态
+
+### ⚡ Daemon 模式
+- `rqdata daemon start` - 启动 daemon（批量查询性能提升 25%）
+- `rqdata daemon stop` - 停止 daemon
+- `rqdata daemon status` - 查看状态
+
+### 📈 指数数据（4个命令）
+- `rqdata index instruments` - 获取指数列表
+- `rqdata index price` - 获取指数行情
+- `rqdata index constituents` - 获取成分股列表
+- `rqdata index weights` - 获取成分股权重
+
+### 📊 A股数据（8个命令）
+- `rqdata stock cn instruments` - 获取股票列表
+- `rqdata stock cn price` - 获取股票行情
+- `rqdata stock cn dividends` - 获取分红数据
+- `rqdata stock cn financials` - 获取财务数据
+- `rqdata stock cn shares` - 获取股本结构
+- `rqdata stock cn margin` - 获取融资融券
+- `rqdata stock cn suspended` - 获取停牌信息
+- `rqdata stock cn northbound` - 获取北向资金
+
+### 🇭🇰 港股数据（4个命令）
+- `rqdata stock hk instruments` - 获取港股列表
+- `rqdata stock hk price` - 获取港股行情
+- `rqdata stock hk dividends` - 获取分红数据
+- `rqdata stock hk financials` - 获取财务数据
+
+### 📅 交易日历（3个命令）
+- `rqdata calendar dates` - 获取交易日列表
+- `rqdata calendar prev` - 获取前一交易日
+- `rqdata calendar next` - 获取后一交易日
+
+### 📉 宏观数据（4个命令）
+- `rqdata macro shibor` - 获取 Shibor 利率
+- `rqdata macro price-cpi` - 获取 CPI 数据
+- `rqdata macro price-ppi` - 获取 PPI 数据
+- `rqdata macro gdp` - 获取 GDP 数据
+
+> 📖 **总计 26 个命令**，完整文档请查看 [快速上手指南](docs/QUICKSTART.md)
+
+## 🎨 输出格式
+
+```bash
+# NDJSON（默认，适合流式处理）
+rqdata stock cn price --payload '{...}'
+
+# JSON（结构化数组）
+rqdata stock cn price --payload '{...}' --format json
+
+# CSV（原始格式）
+rqdata stock cn price --payload '{...}' --format csv
+```
+
+## 🎨 高级功能
+
+### Schema 自动生成
+
+使用 Python 脚本从 rqdatac 自动生成参数 schema：
+
+```bash
+# 生成 schema.json（需要 rqdatac 环境）
+/home/lhz/.miniconda3/envs/zz1000/bin/python scripts/generate_schema_json.py
+
+# 查看命令参数说明
+rqdata stock cn price --schema
+```
+
+输出包含完整的中文参数描述和类型信息。
+
+### 批量查询示例
+
+```bash
+# 批量查询多个股票
+for stock in 000001.XSHE 600000.XSHG 600519.XSHG; do
+    rqdata stock cn price --payload "{
+      \"order_book_ids\": [\"$stock\"],
+      \"start_date\": \"2024-01-01\",
+      \"end_date\": \"2024-01-31\"
+    }" > "${stock}.ndjson"
+done
+```
+
+## 🛠️ 开发
+
+### 技术栈
+
+- **语言**: Go 1.21+
+- **依赖**:
+  - `github.com/spf13/cobra` - CLI 框架
+  - `github.com/zalando/go-keyring` - 系统 Keyring 集成
+  - `golang.org/x/term` - 终端交互
+- **配置**:
+  - `internal/configs/commands.json` - 命令定义
+  - `internal/configs/schema.json` - 参数 Schema（自动生成）
+
+### 项目结构
+
+```
+rqdata-cli/
+├── main.go              # 入口文件
+├── cmd/                 # 命令定义
+├── internal/            # 内部包
+│   ├── auth/           # 认证模块
+│   ├── client/         # HTTP 客户端
+│   ├── configs/        # 配置文件（commands.json, schema.json）
+│   ├── executor/       # 命令执行器
+│   ├── formatter/      # 输出格式化
+│   └── loader/         # 配置加载器
+├── scripts/            # 工具脚本
+│   └── generate_schema_json.py  # Schema 生成脚本
+├── tests/              # 测试
+└── docs/               # 文档
+```
+
+### 构建与测试
+
+```bash
+# 编译
+VERSION=dev ./build.sh
+
+# 运行
+./rqdata --help
+
+# 测试
+./rqdata auth status
+./rqdata stock cn price --schema
+```
+
+## 📖 文档
+
+- [Go 构建指南](BUILD_GO.md)
+- [快速上手](docs/QUICKSTART.md)
+- [命令列表](docs/rqdata_cli_commands.md)
+- [更新日志](CHANGELOG.md)
+
+## 🚢 npm 发布
+
+项目现在采用“主包 + 平台包”的发布方式：
+
+- `@ricequant2026/rqdata-cli`：主包，只包含 JS wrapper 和平台依赖声明
+- `@ricequant2026/rqdata-cli-linux-x64`
+- `@ricequant2026/rqdata-cli-darwin-x64`
+- `@ricequant2026/rqdata-cli-darwin-arm64`
+- `@ricequant2026/rqdata-cli-win32-x64`
+
+发布时先发平台包，再发主包：
+
+```bash
+npm version patch
+npm run publish:all
+```
+
+`publish:all` 内部会对所有 scoped 包使用 `npm publish --access public`。
+
+如果只是先测试发布流程，建议先用预发布版本和 `next` tag：
+
+```bash
+npm version prerelease --preid rc
+npm run publish:next
+```
+
+如果只想验证发布命令本身而不真正上传：
+
+```bash
+npm run publish:dry-run
+```
+
+如果只想本地生成所有 tarball：
+
+```bash
+npm run pack:all
+```
+
+如果只想本地验证当前平台的主包执行链路：
+
+```bash
+npm run build:npm
+npm run link:platform
+node bin/rqdata.js --version
+```
+
+## 📝 更新日志
+
+### v2.0.0 (2026-03-27) - Go 重写版本
+
+- ✨ 使用 Go 完全重写，单文件可执行
+- 🔐 系统 Keyring 集成，安全存储凭证
+- 📖 Schema 自动生成，支持中文参数描述
+- 🚀 静态编译，跨平台分发
+- 🔧 修复 HTML 转义问题（`array<string>` 显示正确）
+- 📊 完整的数据覆盖（指数、A股、港股、期货、期权、基金、宏观）
+
+### v1.0.0 (2026-03-10) - C++ 版本
+
+- ✨ 初始 C++ 版本发布
+- 🚀 CURL 连接复用优化
+- 📊 完整的数据覆盖
+
+详见 [CHANGELOG.md](CHANGELOG.md)
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](LICENSE)
+
+## 🙏 致谢
+
+- [RQData](https://www.ricequant.com) - 提供数据 API
+- [CLI11](https://github.com/CLIUtils/CLI11) - 命令行解析
+- [nlohmann/json](https://github.com/nlohmann/json) - JSON 处理
+
+## 📞 支持
+
+- 🐛 Issues: [Jira](https://jira.ricequant.com)（RiceQuant 内部）
+- 📚 文档: [项目文档](http://git.ricequant.com/projects/RQAI/repos/rqdata-cli/browse/docs)
+
+---
+
+**注意**: 使用本工具需要有效的 RQData 账号。访问 [ricequant.com](https://www.ricequant.com) 申请试用或购买。

package/bin/rqdata.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require('node:child_process');
+const { findCurrentTarget } = require('../scripts/npm/platforms');
+
+function resolveBinary() {
+  const target = findCurrentTarget();
+
+  if (!target) {
+    console.error(`Unsupported platform: ${process.platform}-${process.arch}`);
+    process.exit(1);
+  }
+
+  let binary;
+
+  try {
+    ({ binary } = require(target.packageName));
+  } catch (error) {
+    console.error(`Missing platform package: ${target.packageName}`);
+    console.error('Reinstall the package on a supported platform or verify optional dependencies are enabled.');
+    process.exit(1);
+  }
+
+  if (!binary) {
+    console.error('rqdata binary is missing. Reinstall the package or rebuild release artifacts.');
+    process.exit(1);
+  }
+
+  return binary;
+}
+
+const result = spawnSync(resolveBinary(), process.argv.slice(2), {
+  stdio: 'inherit'
+});
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@ricequant2026/rqdata-cli",
+  "version": "1.0.0",
+  "description": "RQData CLI for AI agents and quantitative research",
+  "license": "MIT",
+  "bin": {
+    "rqdata": "bin/rqdata.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/npm/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "optionalDependencies": {
+    "@ricequant2026/rqdata-cli-linux-x64": "1.0.0",
+    "@ricequant2026/rqdata-cli-darwin-x64": "1.0.0",
+    "@ricequant2026/rqdata-cli-darwin-arm64": "1.0.0",
+    "@ricequant2026/rqdata-cli-win32-x64": "1.0.0"
+  },
+  "scripts": {
+    "build:npm": "node scripts/npm/build-packages.js",
+    "link:platform": "node scripts/npm/link-platform-package.js",
+    "pack:all": "node scripts/npm/pack-all.js",
+    "publish:all": "node scripts/npm/publish-all.js",
+    "publish:next": "NPM_TAG=next node scripts/npm/publish-all.js",
+    "publish:dry-run": "NPM_TAG=next NPM_DRY_RUN=1 node scripts/npm/publish-all.js",
+    "pack:dry-run": "npm pack --dry-run"
+  },
+  "keywords": [
+    "rqdata",
+    "cli",
+    "finance",
+    "quant",
+    "agent"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rqdata/rqdata-cli.git"
+  },
+  "homepage": "https://github.com/rqdata/rqdata-cli",
+  "bugs": {
+    "url": "https://github.com/rqdata/rqdata-cli/issues"
+  }
+}

package/scripts/npm/build-packages.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+const { mkdirSync, rmSync, readFileSync, writeFileSync, copyFileSync, chmodSync } = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const { DIST_DIR, PLATFORM_TARGETS, PACKAGES_DIR } = require('./platforms');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const pkg = JSON.parse(readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
+const VERSION = process.env.VERSION || pkg.version;
+const GOCACHE_DIR = process.env.GOCACHE_DIR || path.join(ROOT, '.cache', 'go-build');
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    cwd: options.cwd || ROOT,
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      ...options.env
+    }
+  });
+
+  if (result.status !== 0) {
+    process.exit(result.status === null ? 1 : result.status);
+  }
+}
+
+function buildTargets() {
+  rmSync(DIST_DIR, { recursive: true, force: true });
+  mkdirSync(DIST_DIR, { recursive: true });
+  mkdirSync(GOCACHE_DIR, { recursive: true });
+
+  for (const target of PLATFORM_TARGETS) {
+    const outputPath = path.join(DIST_DIR, target.output);
+    const ldflags = `-s -w -X github.com/rqdata/rqdata-cli/cmd.Version=${VERSION}`;
+
+    console.log(`Building ${target.key} -> ${target.output}`);
+    run('go', ['build', '-trimpath', '-ldflags', ldflags, '-o', outputPath, 'main.go'], {
+      env: {
+        CGO_ENABLED: '0',
+        GOCACHE: GOCACHE_DIR,
+        GOOS: target.goos,
+        GOARCH: target.goarch
+      }
+    });
+  }
+}
+
+function writePlatformPackage(target) {
+  const packageDir = target.packageDir;
+  const binarySource = path.join(DIST_DIR, target.output);
+  const binaryTarget = path.join(packageDir, 'bin', target.binName);
+
+  rmSync(packageDir, { recursive: true, force: true });
+  mkdirSync(path.join(packageDir, 'bin'), { recursive: true });
+
+  copyFileSync(binarySource, binaryTarget);
+  if (target.os !== 'win32') {
+    chmodSync(binaryTarget, 0o755);
+  }
+
+  writeFileSync(
+    path.join(packageDir, 'index.js'),
+    [
+      "const path = require('node:path');",
+      '',
+      `module.exports.binary = path.join(__dirname, 'bin', '${target.binName}');`,
+      ''
+    ].join('\n')
+  );
+
+  writeFileSync(
+    path.join(packageDir, 'README.md'),
+    `# ${target.packageName}\n\nPlatform binary package for @ricequant2026/rqdata-cli.\n`
+  );
+
+  writeFileSync(
+    path.join(packageDir, 'package.json'),
+    JSON.stringify(
+      {
+        name: target.packageName,
+        version: VERSION,
+        description: `Platform binary for @ricequant2026/rqdata-cli (${target.key})`,
+        license: pkg.license,
+        os: [target.os],
+        cpu: [target.cpu],
+        files: ['bin/', 'index.js', 'README.md', 'LICENSE'],
+        main: 'index.js'
+      },
+      null,
+      2
+    ) + '\n'
+  );
+
+  copyFileSync(path.join(ROOT, 'LICENSE'), path.join(packageDir, 'LICENSE'));
+}
+
+function materializePackages() {
+  rmSync(PACKAGES_DIR, { recursive: true, force: true });
+  mkdirSync(PACKAGES_DIR, { recursive: true });
+
+  for (const target of PLATFORM_TARGETS) {
+    writePlatformPackage(target);
+  }
+}
+
+buildTargets();
+materializePackages();

package/scripts/npm/link-platform-package.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+const { mkdirSync, rmSync, symlinkSync, existsSync } = require('node:fs');
+const path = require('node:path');
+const { findCurrentTarget } = require('./platforms');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const NODE_MODULES = path.join(ROOT, 'node_modules');
+
+const target = findCurrentTarget();
+
+if (!target) {
+  console.warn(`Unsupported platform for local link: ${process.platform}-${process.arch}`);
+  process.exit(0);
+}
+
+const destination = path.join(NODE_MODULES, target.packageName);
+const destinationDir = path.dirname(destination);
+
+mkdirSync(NODE_MODULES, { recursive: true });
+mkdirSync(destinationDir, { recursive: true });
+rmSync(destination, { recursive: true, force: true });
+rmSync(path.join(NODE_MODULES, target.packageName.split('/').pop()), { recursive: true, force: true });
+
+if (!existsSync(target.packageDir)) {
+  console.error(`Platform package has not been built: ${target.packageDir}`);
+  console.error('Run `npm run build:npm` first.');
+  process.exit(1);
+}
+
+symlinkSync(target.packageDir, destination, 'dir');
+console.log(`Linked ${target.packageName} -> ${target.packageDir}`);

package/scripts/npm/pack-all.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+const { readFileSync } = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const { PLATFORM_TARGETS } = require('./platforms');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const pkg = JSON.parse(readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
+
+function run(command, args, cwd = ROOT) {
+  const result = spawnSync(command, args, {
+    cwd,
+    stdio: 'inherit',
+    env: process.env
+  });
+
+  if (result.status !== 0) {
+    process.exit(result.status === null ? 1 : result.status);
+  }
+}
+
+run('node', ['scripts/npm/build-packages.js']);
+
+for (const target of PLATFORM_TARGETS) {
+  run('npm', ['pack'], target.packageDir);
+}
+
+run('npm', ['pack']);
+
+console.log(`Packed ${pkg.name}@${pkg.version} and ${PLATFORM_TARGETS.length} platform packages.`);

package/scripts/npm/platforms.js

@@ -0,0 +1,74 @@
+const path = require('node:path');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const DIST_DIR = path.join(ROOT, 'dist');
+const PACKAGES_DIR = path.join(ROOT, 'npm');
+const NPM_SCOPE = '@ricequant2026';
+
+const PLATFORM_TARGETS = [
+  {
+    key: 'linux-x64',
+    goos: 'linux',
+    goarch: 'amd64',
+    os: 'linux',
+    cpu: 'x64',
+    packageName: `${NPM_SCOPE}/rqdata-cli-linux-x64`,
+    packageDir: path.join(PACKAGES_DIR, 'rqdata-cli-linux-x64'),
+    output: 'rqdata-linux-amd64',
+    binName: 'rqdata'
+  },
+  {
+    key: 'darwin-x64',
+    goos: 'darwin',
+    goarch: 'amd64',
+    os: 'darwin',
+    cpu: 'x64',
+    packageName: `${NPM_SCOPE}/rqdata-cli-darwin-x64`,
+    packageDir: path.join(PACKAGES_DIR, 'rqdata-cli-darwin-x64'),
+    output: 'rqdata-macos-amd64',
+    binName: 'rqdata'
+  },
+  {
+    key: 'darwin-arm64',
+    goos: 'darwin',
+    goarch: 'arm64',
+    os: 'darwin',
+    cpu: 'arm64',
+    packageName: `${NPM_SCOPE}/rqdata-cli-darwin-arm64`,
+    packageDir: path.join(PACKAGES_DIR, 'rqdata-cli-darwin-arm64'),
+    output: 'rqdata-macos-arm64',
+    binName: 'rqdata'
+  },
+  {
+    key: 'win32-x64',
+    goos: 'windows',
+    goarch: 'amd64',
+    os: 'win32',
+    cpu: 'x64',
+    packageName: `${NPM_SCOPE}/rqdata-cli-win32-x64`,
+    packageDir: path.join(PACKAGES_DIR, 'rqdata-cli-win32-x64'),
+    output: 'rqdata-windows-amd64.exe',
+    binName: 'rqdata.exe'
+  }
+];
+
+function currentPlatformKey() {
+  return `${process.platform}-${process.arch}`;
+}
+
+function findCurrentTarget() {
+  return PLATFORM_TARGETS.find((target) => target.key === currentPlatformKey()) || null;
+}
+
+function findTargetByKey(key) {
+  return PLATFORM_TARGETS.find((target) => target.key === key) || null;
+}
+
+module.exports = {
+  DIST_DIR,
+  NPM_SCOPE,
+  PACKAGES_DIR,
+  PLATFORM_TARGETS,
+  findTargetByKey,
+  findCurrentTarget
+};

package/scripts/npm/publish-all.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const { PLATFORM_TARGETS } = require('./platforms');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const NPM_TAG = process.env.NPM_TAG || 'latest';
+const NPM_DRY_RUN = process.env.NPM_DRY_RUN === '1';
+
+function run(command, args, cwd = ROOT) {
+  const result = spawnSync(command, args, {
+    cwd,
+    stdio: 'inherit',
+    env: process.env
+  });
+
+  if (result.status !== 0) {
+    process.exit(result.status === null ? 1 : result.status);
+  }
+}
+
+function publishArgs() {
+  const args = ['publish', '--access', 'public', '--tag', NPM_TAG];
+
+  if (NPM_DRY_RUN) {
+    args.push('--dry-run');
+  }
+
+  return args;
+}
+
+run('node', ['scripts/npm/build-packages.js']);
+
+for (const target of PLATFORM_TARGETS) {
+  run('npm', publishArgs(), target.packageDir);
+}
+
+run('npm', publishArgs());