一個同時支援 Claude Code 與 Codex 的 plugin,依 XQ全球贏家 的 XScript(XS) 語言規範,協助你撰寫自動化腳本、回答 XS 用法問題。
xs_helper 是一個 Claude Code 與 Codex plugin。在 Claude Code 輸入 /xs,或在 Codex 使用 $xs,即可載入「XS 專家模式」後再作答,協助你:
- 撰寫 / 修改 XS 腳本 —— 自動交易、函數、指標、選股、警示五大類型;
- 回答規範性問題 —— 某個 XS 函數 / 欄位 / 關鍵字怎麼用。
XS 是 XQ全球贏家專屬、繁體中文、小眾的 DSL,沒有公開的編譯器或 LSP,通用模型本身不具備完整 XS 知識。本 plugin 把 XS 的語法、內建函數、欄位、各腳本類型慣例,以蒸餾後的 reference 形式內建進 skill,讓 AI agent 被呼叫時載入正確知識再回答,避免幻覺出不存在的函數。
| 功能 | 說明 |
|---|---|
XS Skill(/xs / $xs) |
判定腳本類型 → 載入對應 reference → 產出 XS 程式碼或規範解說 |
| 內建 XS Reference | 語法、內建函數、系統函數、欄位、腳本類型慣例,皆內建為 markdown |
| 官方文件 Fallback | 冷門函數 / 欄位以環境可用的網頁查詢工具查 XS 線上說明 後作答 |
本 plugin 只生成與解說,不執行。明確不做:
- XS 腳本的實際執行 / 回測(不含 XS runtime)
- 完整語法分析 / LSP / grammar(不重建編譯器級驗證)
- 即時同步官方文件全量(reference 為人工蒸餾快照)
- XQ 平台帳號 / API 整合(不連帳號、不下單、不取報價)
本 plugin 透過 marketplace xs-tools 散佈;Claude Code 與 Codex 共用同一份 XS skill 與 reference。
在 Claude Code 中執行:
/plugin marketplace add Benjamin-Teng/xs_helper
/plugin install xs-helper@xs-tools
/reload-plugins
/reload-plugins讓剛裝好的 plugin 立即生效,不必重開 Claude Code。安裝後以/xs <需求>明確觸發。
Codex IDE extension 目前不支援完整 plugin,但支援獨立 skill。xs-helper 現階段沒有 MCP、connector 或 hook,因此用這條路可取得目前全部功能。在 Codex 對話框貼上:
$skill-installer 請從 https://github.com/Benjamin-Teng/xs_helper/tree/main/skills/xs 安裝 xs skill
同意下載後開啟新對話,以 $xs Average 怎麼用? 驗證;若 $xs 未出現,重新載入 VS Code。
先在終端機註冊一次 marketplace:
codex plugin marketplace add Benjamin-Teng/xs_helper接著啟動 codex,在對話介面輸入 /plugins,切換到 xs-tools marketplace、開啟 xs-helper 並選擇安裝。安裝後開始新 session。
若偏好完全使用命令列,執行:
codex plugin marketplace add Benjamin-Teng/xs_helper
codex plugin add xs-helper@xs-tools安裝後開啟新的 Codex session,輸入 $xs <需求> 明確觸發。完整 plugin 流程適用於 Codex CLI 與支援 Plugins Directory 的桌面介面,不會把 plugin 安裝進 VS Code IDE extension。
- 自動觸發(主要):不必打任何指令——只要對話講到 XS / 選股條件 / 某個函數怎麼用,Claude Code 或 Codex 會依 skill 的
description自動載入 XS 知識再作答。 - Claude Code 手動觸發:輸入
/xs <需求>(依環境亦可能顯示為命名空間形式/xs-helper:xs)。 - Codex 手動觸發:輸入
$xs <需求>。
⚠️ /xs與$xs都是把 XS 規範載入目前請求或對話脈絡,不是另一個 XS runtime;要徹底脫離 XS 脈絡,請開新對話或使用所在環境的清除對話功能。
✅ v0.7.1 —— 本版重點(修正版):
- xshelp 名稱索引補收官方別名:索引檔末新增「別名對照」(1120 組:英文名、中文短名、舊名與報價欄位
q_變數名)。GetField("Close")、GetField("最新股本")這類寫法不再被當成查無;F3 改為依出現位置查找(函數呼叫只認名稱段、欄位名字串才查別名),名稱與別名都查不到才算查無。 - 依 xshelp 原文更正:
StandardDev樣本參數是2;xf_*也支援AD/AW/AM(xfMin_*的2、3分鐘兩份官方來源不一致,已標註以實機為準);SetTotalBar是資料讀取範圍,回看深度由SetBackBar設定;資料欄位用於指標/警示/交易腳本,選股腳本用選股欄位。 xshelp_mirror.py fetch的防縮水檢查改以「名稱+分組」比對,不再因官方重編 id 而誤擋。- XQ 編譯器相容性實編回饋(#3):
LinearReg用完整七參數呼叫、輸出變數避用獨立的slope/angle名稱;明確標示非 xshelp 官方定義。
v0.7.0 重點(節錄):新增 xshelp 名稱索引與本機鏡像腳本 scripts/xshelp_mirror.py、F3 fallback 改走索引 API、fields.md 完整名稱清單改由索引提供、xs_lint.py 補齊 15 個漏收的系統函數名稱。v0.6.0 重點(節錄):Plot/OutputField 命名參數與多載、流程控制官方寫法、Rank/inputkind 補齊、補收 42 個漏收函數與第 9 分類 SDTFUNC。v0.5.1/v0.5.0 重點(節錄):xs_lint.py 不再誤報宣告名稱(#2)、GitHub Pages 新增投入功夫統計、新增 AGENTS.md、關鍵字與保留字總表、xs_lint.py 白名單校正。
沿用先前版本:skill 目錄採 Agent Skills 規範的 references/(扁平、單層,v0.4.0 起),Shioaji Pro 等只索引固定目錄名的技能安裝器也讀得到;Claude Code 與 Codex 各有原生 manifest / marketplace,兩端共用同一份 skill。v0.2.0 移除的 .xs 編輯驗證 Hook 維持不掛載,xs_lint.py 保留為獨立腳本。功能仍在迭代。
📊 成效:skill 助益量化報表 —— 8 個真實 XS 任務「載 skill vs 未載」對照,通過率 100% vs 75%、零幻覺 token。
reference 進度(共 11 份:5 份規範 + 1 份 xshelp 名稱索引 + 5 份範例):
| reference | 狀態 |
|---|---|
language.md(語法基礎) |
✅ 已蒸餾(grammar token × Preset 真實語法校對) |
xs_lint.py 已知 token 清單 |
✅ 內建(644 個 token:grammar 2023 快照 ∪ Preset 215 sysfnc ∪ xshelp 9 群組 bif);供 benchmark 幻覺掃描與手動檢查的獨立腳本 |
system-functions.md(sysfnc) |
✅ 已蒸餾(Preset 224 函數 × 14 分類) |
builtin-functions.md(bif) |
✅ 已蒸餾(xshelp 9 分類,v0.6.0 起新增 SDTFUNC) |
fields.md(三類欄位) |
✅ 已蒸餾(xshelp Q*/T*/F* × XQStrategy GetField 交叉驗證) |
xshelp-index.md(名稱索引) |
✅ 已產生(1621 個名稱、10 大類 54 分組,另收 1120 組別名對照;只含名稱、別名與分組;scripts/xshelp_mirror.py 決定性產出) |
script-types.md + example-*.md ×5 |
✅ 已蒸餾(5 類 {@type:} 結構/邊界 + 各一份精選範例) |
完整規格與交接見 docs/SPEC.md,版本變動見 CHANGELOG.md。
reference 蒸餾自 XQ 官方範例庫與說明站:XScript_Preset、XQStrategy、vscode-xs、xshelp 官方站。
測試與 lint 指令、內容以 xshelp 為準等貢獻規則見 AGENTS.md。送 PR 前至少跑過 python -B -m unittest discover -s tests。重生 xshelp 名稱索引用 python -B scripts/xshelp_mirror.py fetch 再 index(fetch 需網路)。
MIT。本 plugin 只散佈自己撰寫的程式碼與「蒸餾後的 DSL 事實」,不含任何來源庫的原始 .xs(XScript_Preset / XQStrategy 無授權檔,故未 bundle;見 docs/SPEC.md Open Q5)。