Taiwan Market Open Data (Unofficial) changelog

https://raw.githubusercontent.com/taux-io/twse-mcp/HEAD/AGENTS.md

− 預設不打正式環境：它跑在 Workers 免費方案，每個請求都在消耗 CPU 的寬容額度（#104）。− 例外是每天排程裡的正式環境存活檢查（`SMOKE_LIST_ONLY=1`）：只看工具清單、快捷指令與首頁，不呼叫工具。− `EVAL_ONLY=<題目> EVAL_REPEAT=10 npm run eval:ab`。另一個理由是正式環境跑在 Workers 免費方案，− eval 的大量請求會吃掉每個請求 10ms CPU 的寬容額度（#104）。+ 預設不打正式環境：測試請求會混進真實流量，付費方案也依用量計費。（#104 當時跑在 Workers 免費方案，每個請求都在消耗 10ms CPU 的寬容額度；2026-10-31 已升級付費。）+ 例外是每天排程裡的正式環境存活檢查（`SMOKE_LIST_ONLY=1`）：看工具清單、快捷指令與首頁，外加 modern 的 `dataset.get` 一次（證明工具真的查得到資料），其餘工具不呼叫。+ `EVAL_ONLY=<題目> EVAL_REPEAT=10 npm run eval:ab`。另一個理由是 eval 的大量請求會混進真實流量，並產生用量費用。+ （#104 當時正式環境在 Workers 免費方案，會吃掉每個請求 10ms CPU 的寬容額度；2026-10-31 已升級付費。）

https://raw.githubusercontent.com/taux-io/twse-mcp/HEAD/AGENTS.md

− `npm run smoke` 對本機 `wrangler dev`（8787）的每支工具發一個真實查詢，兩代協定各一遍。改到工具回應的形狀或+ ## 分支保護+ `main` 要 PR 才能合併，required check 只有 `test`（`test.yml` 的 job）。設定在 GitHub，現況用+ `gh api repos/taux-io/twse-mcp/branches/main/protection` 查。+ - `upstream health` 的 job 叫 `check`，只在排程時跑；把它加進 required，每個 PR 都會永遠卡住。+ - 改 `test` 這個 job 的名稱、或給它的 `pull_request` 觸發加 `paths` 篩選，PR 一樣會卡住。+   `scripts/check-required-checks.mjs` 在 CI 擋這兩件事；改了 GitHub 上的設定要同步它的 `REQUIRED_CHECKS`，+   再跑 `npm run check-required-checks -- --remote` 對一次。+ ## 依賴升級+ Dependabot 的 PR 都改 `package-lock.json`，合併一個後其他的會衝突：留言 `@dependabot rebase`，一次重建一個。+ `smoke` 在 push 到 `main` 時不跑，合併後要驗就 `gh workflow run smoke.yml`。+ 驗證做法與新舊回應比對的結果見 [docs/dependency-upgrade-2026-10-17.md](docs/dependency-upgrade-2026-10-17.md)。+ `npm run smoke` 對本機 `wrangler dev`（8787）的每支工具發一個真實查詢，兩代協定各一遍；8787 沒人用就自己起、跑完關掉。改到工具回應的形狀或+ ### 查正式環境+ 打正式環境的工具呼叫用 `npm run call -- <工具> '<JSON 參數>' --prod`（不加 `--prod` 打本機 8787）；+ 查正式 D1 的筆數與日期、看排程 log，見 `docs/adr/0003-d1-daily-archive.md` 的「維運查詢」。

• + snapshot.movers

• + dataset.search
• + dataset.describe
• + dataset.get
• + snapshot.etf
• + quote.lookup
• + snapshot.stock
• + snapshot.market
• + snapshot.futures
• + quote.realtime
• − twse_search_datasets
• − twse_describe_dataset
• − twse_get_dataset
• − twse_etf_snapshot
• − twse_realtime_quote