前言¶
做 A 股策略驗證時，常見路徑是自建腳本拉行情、再拼回測與導出，環境分散、接口不統一。若希望在 Windows、macOS 或 Linux 上集中完成研究型量化流程，並能在瀏覽器、API、命令行或容器裏同一種能力，就需要一套本地化的平臺型 Skill。下面介紹 SkillHub 社區發佈的 A股量化交易系統 V4.03（全量版）（座標 @user_a9caeb3c/a-quanttrader-pro-v2-1，版本 4.0.3），它把 OneQuant 4.0.3 的能力封裝進 Agent，便於用自然語言觸發回測、選股、風控查看與數據導出等任務。
這是什麼¶
OneQuant 4.0.3 面向 A 股 的本地量化平臺：在 SkillHub 上歸類爲 data-analysis，來源爲 community，發佈者爲 user_a9caeb3c。官方簡介將其定位爲支持 Windows / macOS / Linux（Docker） 的全平臺方案，內置 A 股量化回測策略引擎 V2.1.2，並提供 102 個 REST API 端點。數據側支持 米筐 / 聚寬 / AkShare 三源，可在運行中切換數據源（Skill 標籤爲 requires_api_key=true，使用聚寬、米筐等商業源時通常需自行準備並配置密鑰）。
與「只給一段 Python 示例腳本」不同，該 Skill 強調 五種調用方式 覆蓋同一套後端：Web、REST、CLI、批量腳本與 Docker，適合把「驗證策略」和「批量研究」放在同一套接口上，而不是爲每種場景單獨維護一套代碼。
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取官方簡介，按使用路徑歸納。
五種調用方式¶
- Web 界面：瀏覽器中完成常見操作，適合快速查看與點選式流程。
- REST API：可用 Python
requests等做程序化調用；全量 102 個 API 端點 支撐回測、數據與交易相關能力。 - CLI 命令行：適合腳本化、自動化流水線。
- 批量腳本：支持多標的並行回測等批量任務（官方簡介明確提到「多股票並行回測」）。
- Docker 容器化：跨平臺部署與隔離運行環境。
數據與引擎¶
- 三數據源：米筐、聚寬、AkShare，便於在免費源與付費專業源之間按項目切換。
- 回測引擎：標註爲 V2.1.2，與 OneQuant 4.0.3 主版本一併發佈。
在 Agent 中的觸發方式¶
向 AI 說明需求即可，Skill 側給出的示例意圖包括：回測個股策略、篩選漲停類標的、查看自選股風險概覽、導出交易記錄爲 Excel 等。具體參數與接口以安裝後 Skill 內文檔爲準。
安裝與啓用¶
安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝（CLI + 默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本 Skill¶
SkillHub 頁面提供的安裝提示爲：根據 SkillHub 安裝說明 安裝座標 @user_a9caeb3c/a-quanttrader-pro-v2-1。
通用命令形式（--dir 須指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能無法被識別）：
skillhub install @user_a9caeb3c/a-quanttrader-pro-v2-1 --dir <skills 目錄>
常見 Agent 的 skills 目錄示例（來自官方安裝文檔）：
| 環境 | 路徑 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝完成後按所用客戶端要求重啓或刷新 Skill 列表。因標籤 requires_api_key=true，啓用前請按 Skill 內說明配置數據源或平臺所需的 API Key。
典型用法¶
1、用自然語言驅動¶
在已安裝 Skill 的對話中，可直接描述任務，例如：
- 「幫我回測貴州茅臺 MA 策略」
- 「篩選今天漲停的股票」
- 「查看自選股風險概覽」
- 「導出交易記錄 Excel」
Agent 會按 Skill 指引調用 OneQuant 對應能力（Web、API 或 CLI 路徑以 Skill 文檔爲準）。
2、程序化調用（思路）¶
官方定位支持 REST API 與 Python requests。典型步驟是：先按 Skill 文檔啓動或連接本地 OneQuant 服務，再對 102 個端點中的目標接口發起 HTTP 請求。請求基址、鑑權頭與示例 payload 以安裝包內 14 個新增文檔章節 爲準，此處不臆造具體 URL。
3、批量與容器¶
需要多標的並行回測或統一交付環境時，優先按 Skill 說明使用 批量腳本 或 Docker 方式，避免在本機重複手工配置依賴。
適用場景與注意¶
更適合：
- A 股個人投資者做策略驗證、模擬與復盤類研究；
- 量化入門者希望通過 Web + API 理解完整鏈路；
- Python 分析師需要批量拉數、回測並導出結果（如 Excel）。
不適合或需自行擴展：
- 高頻交易（HFT）：本地研究與回測導向，非低延遲實盤通道；
- 實盤自動下單：需自行對接券商櫃檯，Skill 不替代券商 API；
- 期貨、期權：以 A 股爲主，不覆蓋衍生品主場景；
- 港美股深度分析：僅有限支持，不宜作爲主力工具。
其他注意：
- SkillHub 展示評分爲 100000，下載量 7322（統計隨平臺更新變化）。
- 商業數據源密鑰與合規使用責任在用戶側；免費源與付費源的字段、頻率限制以各源文檔爲準。
結尾¶
A股量化交易系統 V4.03（全量版） 把 OneQuant 4.0.3 的本地平臺、102 個 API 與五種調用方式收斂爲一個可安裝的 Agent Skill，適合把 A 股量化研究從「零散腳本」收成可重複的工作流。安裝與詳情見 SkillHub 頁面與 API 入口：
- SkillHub：https://www.skillhub.cn/skills/user_a9caeb3c/a-quanttrader-pro-v2-1
- 官方地址：https://api.skillhub.cn/user_a9caeb3c/a-quanttrader-pro-v2-1
