dowafu 0.4.0 → 0.5.0

package/README_zh-tw.md

@@ -4,20 +4,31 @@
 
 **一支唯讀審查用的 spoke harness**：把文件段落派給外部模型，限定它讀什麼、記下它做了什麼、機械稽核它的回報格式。
 
-講具體一點——你(與AI agent協同)寫一份工單，`dowafu` 呼叫各家 provider 的 API；每個審查者（*spoke*）**只讀你列進白名單的檔案**，回傳帶依據的觀察，全部落檔供你查核。
+講具體一點——你(與AI agent協同)寫一份工單，`dowafu` 呼叫各家 provider 的 API；每個審查者（*spoke*）**只讀你列進白名單的檔案**，回傳帶依據的觀察，做過的事全部記錄下來供你查核。
 
 相容於各種支援標準SKILL的AI Agent程式與VS Code擴充套件包含以下，但還有更多:
 
 - Claude Code
-- VS Code Codepilot 
+- VS Code Copilot(內建)
+- Codex(擴充套件)
+- Google Antigravity IDE
 
 **spoke 產出的是意見，不是裁決。** 那些意見要怎麼處理，仍然由你決定。
 
 > ### 英文與繁體中文都是完整支援的語言。
 >
-> 整次執行的語言由一個旗標決定：`--lang en` 或 `--lang zh-tw`。沒帶旗標時看 `DISPATCH_LANG`，兩者都沒有時**預設為英文**。旗標優先於環境變數；任一方填了無法辨識的值都會直接中止，不會猜。
+> 有兩個設定各自決定不同範圍的語言。
 >
-> 語言涵蓋所有地方：審查者收到的 Prompt 與報告範本、稽核用來檢查報告的範本，以及 CLI 自己的輸出——`--help`、錯誤訊息、dry-run 報告、`summary.md`。Dry run 會針對每個審查者印出判定的語言，送出前就看得到。
+> `--lang en`／`--lang zh-tw` 決定**一次派工**的語言：審查者收到的 Prompt 與報告範本、
+> 稽核用來檢查報告的範本、dry-run 報告，以及隨結果一起存下來的執行摘要。
+>
+> `DISPATCH_LANG` 決定 **CLI 自己的介面**語言——`--help`、`--doctor`、解析期的錯誤訊息，
+> 以及各個子指令（`key`、`providers`、`token`、`approve`、`serve`）。
+> **`--lang` 管不到這些。** 那些訊息在旗標通過驗證之前就要印出來了；而 `--doctor` 更是
+> 「語言設定本身壞掉時你會拿來查的那個工具」。
+>
+> 兩者都沒有時**預設為英文**；任一方填了無法辨識的值都會直接中止，不會猜。
+> Dry run 會針對每個審查者印出判定的語言，送出前就看得到。
 >
 > 工單的段落標題兩種語言都可以寫，與語言選擇無關——它們是欄位名稱，不是語言開關。見[工單格式](#工單格式)。
 >
@@ -33,39 +44,32 @@ npm install -g dowafu
 
 ## API Keys
 
-API Key 會從 `$DISPATCH_HOME/.env` 讀取，預設位置為：
+API Key 存在資料庫裡。請在你自己的終端機設定：
 
-`~/.config/dowafu/.env`
+```bash
+dowafu key
+```
 
-可以透過 `DISPATCH_HOME` 或 `XDG_CONFIG_HOME` 覆寫這個位置。
+它會列出各家 provider，接收你貼上的 key（**不會回顯**），存起來之後只印出末四碼，並詢問要不要立刻對該家 API 驗證一次。
 
-如果環境變數中已經存在相同的變數，環境變數會優先於檔案中的值。因此在 CI 或臨時覆寫設定時，完全不需要建立 `.env` 檔案。
+- `dowafu key list`：列出哪幾家已設定——只顯示有沒有，永遠不顯示內容
+- `dowafu key rm <provider>`：移除某一家
+- `dowafu key test <provider>`：對真實 API 驗證一次（**這個呼叫會花錢**，執行前會再問一次）
 
-```bash
-mkdir -p ~/.config/dowafu
-cat > ~/.config/dowafu/.env <<'EOF'
-DEEPSEEK_API_KEY=
-GEMINI_API_KEY=
-OPENAI_API_KEY=
-ANTHROPIC_API_KEY=
-EOF
-chmod 600 ~/.config/dowafu/.env
-```
+`dowafu key` 需要互動式終端機；stdin 被導向管道時它會直接拒絕，不會把管道內容當成 key 讀進去。
 
 只需要為實際要執行 Dispatch 的 Provider 設定 Key 即可。
 
-這個檔案是純文字檔——它唯一的保護機制就是檔案權限。
-
-**永遠不會讀取目前工作目錄的 `.env`。**
+**本版不讀取任何 `.env` 檔，也不讀取 `*_API_KEY` 環境變數。** 來源只有一個，因此沒有優先序要推敲，也不會有環境裡殘留的舊值悄悄蓋過你剛設好的 key。從 0.4.x 升上來：把 `~/.config/dowafu/.env` 刪掉，改用 `dowafu key` 重設一次。
 
-那個目錄是你下指令的地方，通常就是被審查的專案；它的 secrets 不該被一個正對外部 API 發請求的行程讀進去。
+資料庫位於 `$DISPATCH_HOME/dowafu.db`，預設是 `~/.config/dowafu/dowafu.db`，可透過 `DISPATCH_HOME` 或 `XDG_CONFIG_HOME` 覆寫。**Key 在裡面是明文存放**——跟先前那個檔案一樣，它唯一的保護機制就是檔案權限。
 
 ## 使用方式
 
 ```bash
-dowafu <ticket-dir> --dry-run   # 解析、驗證、估算。不呼叫 API，也不產生成本。
-dowafu <ticket-dir> --yes       # 執行審查。這個操作會產生成本。
-dowafu --help                   # 查看所有旗標
+dowafu <ticket-id> --dry-run   # 解析、驗證、估算。不呼叫 API，也不產生成本。
+dowafu <ticket-id> --yes       # 執行審查。這個操作會產生成本。
+dowafu --help                  # 查看所有旗標
 ```
 
 沒有指定 `--yes` 時，指令會要求使用者確認。
@@ -74,9 +78,43 @@ dowafu --help                   # 查看所有旗標
 
 ## 工單
 
-工單是一個目錄，其中包含三種檔案。
+工單存在資料庫裡，不落到磁碟。用 CLI 建立：
+
+```bash
+dowafu ticket create <ticket-id> <shared-file>
+dowafu ticket add-spoke <ticket-id> <agent> <provider> <model> <body-file> [effort]
+dowafu ticket add-allow <ticket-id> <agent> <repo-relative-path> --repo-root .
+```
+
+`create` 與 `add-spoke` 的本文參數可以是路徑，也可以是 `-`（從 stdin 讀）——所以用 heredoc
+就能把整張工單寫完，不必先落一個暫存檔：
+
+```bash
+dowafu ticket create auth-review - <<'EOF'
+# 前提（不受審）
+- 無
+
+# 待審段落
+...
+EOF
+
+dowafu ticket add-spoke auth-review hole-finder-safety deepseek deepseek-v4-flash - <<'EOF'
+# 具體問題
+1. 這裡描述的權限檢查在併發請求下還成立嗎？
+
+# 允許讀取
+- lib/auth-guard.ts
+- prisma/schema.prisma
+EOF
+```
+
+`add-allow` 會立刻驗證路徑、拒絕 `_docs/`，並把該檔案**當下的內容**存起來——派工時不會再讀一次，
+所以審查者看到的是那一刻的快照。用 `dowafu ticket show <ticket-id>` 檢視 Model、允許清單與估算。
 
-其中的標題是**字面標記（literal markers）**，Parser 會直接比對這些標記——必須完全使用以下兩組標題之一。
+### 段落標題
+
+上面本文裡的標題是**字面標記（literal markers）**，Parser 會直接比對——必須完全使用以下兩組
+標題之一。
 
 | English | 中文 |
 | --- | --- |
@@ -85,37 +123,19 @@ dowafu --help                   # 查看所有旗標
 | `# Under review` | `# 待審段落` |
 | `# Premises` | `# 前提（不受審）` |
 
-| 檔案 | 內容 |
-| --- | --- |
-| `_dispatch.md` | 要執行哪些審查者，以及各自使用哪個 Provider 與 Model |
-| `_shared.md` | 前提與正在審查的段落，以原始內容直接貼入 |
-| `<agent>.md` | 每個審查者一份：包含它的問題，以及允許讀取的檔案 |
+兩組標題都收，而且**與審查者使用的語言無關**——語言由 `--lang`／`DISPATCH_LANG` 決定（見上方）。兩組只是同一批欄位的別名，所以英文工單可以用中文跑，反之亦然。
 
-```markdown
-<!-- _dispatch.md -->
-<!-- format: v1 -->
-# dispatch auth-review
+不支援在同一個審查者本文中混用兩組標題——第一個符合的標題會決定用哪一組欄位名，不是決定語言。
 
-| agent | provider | model | effort |
-| --- | --- | --- | --- |
-| hole-finder-safety | deepseek | deepseek-v4-flash | |
-| hole-finder-feasibility | openai | gpt-5.6-luna | |
-```
+### 匯入舊的工單目錄
 
-```markdown
-<!-- hole-finder-safety.md -->
-# Questions
-1. Does the permission check described here hold under concurrent requests?
+0.5.0 之前，工單是一個目錄，內含三種檔案——`_dispatch.md`、`_shared.md`，以及每個審查者一份的
+`<agent>.md`。那個形態仍然讀得進來，作為一次性的搬遷：
 
-# Allowed reads
-- lib/auth-guard.ts
-- prisma/schema.prisma
+```bash
+dowafu ticket import <dir> [ticket-id] --repo-root .
 ```
 
-兩組標題都收，而且**與審查者使用的語言無關**——語言由 `--lang`／`DISPATCH_LANG` 決定（見上方）。兩組只是同一批欄位的別名，所以英文工單可以用中文跑，反之亦然。
-
-不支援在同一個審查者檔案中混用兩組標題——第一個符合的標題會決定用哪一組欄位名，不是決定語言。
-
 審查者定義放在 Repository 根目錄下的：
 
 ```text
@@ -124,25 +144,24 @@ dowafu --help                   # 查看所有旗標
 
 它們是每個 spoke 的 System Prompt 來源，CLI 會直接讀取這些檔案。
 
-結果會寫入：
+結果不會落到磁碟上，而是存進 SQLite 資料庫（預設 `$DISPATCH_HOME/dowafu.db`），其中包含：
 
-```text
-tmp/spoke/<ticket-id>/
-```
+- 每個 spoke 的審查報告
+- 稽核表格與該次的實際花費
+- 每一次呼叫實際送出的 Request 與收到的 Response
 
-其中包含：
+讀回某一次派工的結果：
 
-- 每個 spoke 的審查報告
-- `summary.md`：包含稽核表格與預估成本
-- `run.jsonl`：每個事件一行
-- `raw/`：精確保存實際送出的 Request 與收到的 Response
+```bash
+dowafu result <id>
+```
 
 ## 工具保證的事項
 
 - **每次呼叫的讀取範圍都有白名單限制。** 如果 spoke 要求讀取白名單以外的檔案，會被拒絕，而且拒絕事件會被記錄。
 - **`_docs/` 永遠禁止讀取。** 不論白名單如何設定。
-- **在你確認之前不會產生任何費用。** Dry run 會列出解析後的 repo 根目錄、每個 spoke 的模型與語言、token 預估值與輸出路徑，而且不會呼叫任何 API。
-- **Secrets 會被遮罩。** `run.jsonl`、`raw/*.json` 以及 stdout 中都會遮罩 Secrets。
+- **在你確認之前不會產生任何費用。** Dry run 會列出解析後的 repo 根目錄、每個 spoke 的模型與語言、token 預估值與硬上限金額，而且不會呼叫任何 API。
+- **Secrets 會被遮罩。** 存進資料庫的所有內容以及 stdout 中都會遮罩 Secrets。
 - **發生錯誤就停止整個執行流程。** 例如缺少 API Key、未知的 Model、指定的檔案不存在等，都會在產生任何費用之前中止，並指出造成問題的路徑或名稱。
 
 ## Models
@@ -154,9 +173,16 @@ tmp/spoke/<ticket-id>/
 | `gemini` | `gemini-3.1-flash-lite`、`gemini-3.5-flash-lite`、`gemini-3.6-flash` |
 | `anthropic` | `claude-opus-5`、`claude-sonnet-5` |
 
-這份清單會隨套件以 `providers.json` 一起提供。
+這份清單會隨套件以 `providers.json` 一起提供，並在第一次開啟資料庫時播種進去。
+之後**資料庫就是唯一來源**：
 
-如果想使用其他 Model，可以透過 `--providers` 指定自己的 Provider 設定檔。
+```bash
+dowafu providers list                      # 白名單，以及哪些 Model 是啟用的
+dowafu providers enable|disable <model>    # 開關其中一個
+dowafu providers import <path>             # 匯入自己的設定檔
+```
+
+**沒有 `--providers` 旗標**——0.5.0 把白名單搬進資料庫時已移除，帶了會被當成未知選項拒絕。
 
 ## 從 Agent 驅動
 
@@ -173,7 +199,7 @@ tmp/spoke/<ticket-id>/
 `publish/` 提供兩種語言：`publish/en/` 與 `publish/zh-tw/`。**擇一複製，不可混裝**——審查者的固定收尾句必須與稽核檢查用的範本是同一種語言。
 
 ```bash
-npx degit eyesofkids/dowafu/publish/zh-tw#v0.4.0 .claude-pack   # 或 publish/en
+npx degit eyesofkids/dowafu/publish/zh-tw#v0.5.0 .claude-pack   # 或 publish/en
 
 cd .claude-pack
 TARGET=<your project>
@@ -195,6 +221,130 @@ publish/zh-tw/README.md   （或 publish/en/README.md）
 
 兩份各自以該語言撰寫。
 
+## 接成 MCP server
+
+Agent 可以不走 shell，改用 MCP 驅動 `dowafu`。露出五個 tool：`dispatch_tickets`、
+`dispatch_submit`、`dispatch_status`、`dispatch_result`、`dispatch_approve`。
+
+有兩條路，差別在**誰啟動誰**。
+
+| | stdio | HTTP |
+| --- | --- | --- |
+| 指令 | `dowafu mcp` | `dowafu serve` |
+| 誰啟動 | client 自己 spawn | 你，在自己的終端機 |
+| Token | 沒有，也不需要 | 必要（`x-api-key`） |
+| 會跑 reviewer 嗎 | **不會** | 會 |
+
+### 兩條路都需要 `dowafu serve`
+
+`dowafu mcp` 只回應 tool 呼叫，**它不執行任何 reviewer**。真正花錢的 worker 在
+`dowafu serve` 裡。沒有它，核准過的 job 會永遠留在佇列裡，而且沒有任何東西會告訴 agent
+為什麼。
+
+```
+stdio：  你的 client ──spawn──→ dowafu mcp ──┐
+                                             ├─ 同一個 SQLite 資料庫
+         你的終端機 ─────────→ dowafu serve ─┘  （worker 在這邊）
+
+HTTP：   你的 client ──x-api-key──→ dowafu serve  （端點與 worker 同一個行程）
+```
+
+所以走 stdio 時，要在 client 旁邊另開一個終端機讓 `dowafu serve` 跑著。這條路的順序很寬鬆
+——核准之前或之後才起都可以，daemon 下一個 tick 就會把它撿走。
+
+### stdio
+
+把 client 指到那條指令。以 Claude Code 為例：
+
+```bash
+claude mcp add dowafu -- dowafu mcp
+```
+
+不涉及 token：client 直接 spawn 那個行程，信任邊界是作業系統，中間沒有網路可攔。
+
+### HTTP
+
+`dowafu serve` 綁 `127.0.0.1:7391/mcp`——**只綁 loopback，沒有 `--host` 旗標**。要不要對外
+是 tunnel 的事，不是 server 的事。改埠用 `--http-port <port>` 或環境變數 `DOWAFU_HTTP_PORT`。
+
+每個請求都要帶 token：
+
+```bash
+dowafu token issue --label laptop   # 明文只印這一次，不會存下來
+```
+
+資料庫只存它的 SHA-256 hash，比對是常數時間。把明文填進 client 的 MCP 設定，header 名稱是
+`x-api-key`。`dowafu token list` 看有哪幾把（不顯示明文）、`dowafu token revoke <id>` 撤銷。
+限流是**以 token 計，不是以 IP 計**——tunnel 後面每個請求的來源位址都一樣。
+
+> **daemon 要先起，client 才起。** 反過來的話 client 會把 server 標成失敗、那個對話完全沒有
+> tool——**症狀跟設定寫錯一模一樣**。
+
+### 讓 daemon 一直跑著
+
+沒有東西會在需要時把 `dowafu serve` 喚醒——client 是連上一個**已經在監聽**的 socket，
+沒有行程在聽就沒有東西可被喚醒。交給作業系統讓它保持啟動。
+
+**macOS**——`~/Library/LaunchAgents/dowafu.plist`：
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>dowafu</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/absolute/path/to/dowafu</string>
+    <string>serve</string>
+  </array>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>StandardOutPath</key><string>/Users/you/Library/Logs/dowafu.log</string>
+  <key>StandardErrorPath</key><string>/Users/you/Library/Logs/dowafu.err</string>
+</dict>
+</plist>
+```
+
+用 `launchctl load -w ~/Library/LaunchAgents/dowafu.plist` 載入。
+
+**Linux**——`~/.config/systemd/user/dowafu.service`：
+
+```ini
+[Unit]
+Description=dowafu dispatch daemon
+
+[Service]
+ExecStart=/absolute/path/to/dowafu serve
+Restart=always
+
+[Install]
+WantedBy=default.target
+```
+
+用 `systemctl --user enable --now dowafu` 啟用。
+
+三個會咬人的地方：
+
+- **路徑要寫絕對路徑。** launchd 與 systemd 都看不到你 shell 的 `PATH`。跑 `which dowafu`，
+  把它印出來的東西原樣貼進去。
+- **環境變數同樣不會繼承。** 如果你的 shell 設了 `DISPATCH_HOME` 或 `XDG_CONFIG_HOME`，
+  daemon 看不到它們，會解析到**另一個資料庫**——裡面沒有你的 key，也沒有你的工單。
+  要用就寫進 unit 裡。
+- **輸出要導到檔案。** 變成背景服務之後就沒有終端機可以看了，而埠被占用、或某支審查者死掉，
+  訊息都出現在那裡。把 stdout 與 stderr 指到你找得到的檔案。
+
+daemon 常駐之後，stdio 那條路不需要任何額外動作——`dowafu mcp` 會找到已經在跑的 worker。
+這時自己再打 `dowafu serve` 會被擋下並回報 `daemon already running (pid N)`：
+**那是守衛在運作，不是故障。**
+
+### 核准仍然是獨立的一步
+
+`dispatch_submit` 只把 job 排進佇列就停下，核准之前不會計費。兩種核准方式：在自己的終端機下
+`dowafu approve <id>`，或用 `dispatch_approve` tool——後者要求帶上這張 job 的硬上限金額，且
+必須與資料庫自己算出來的相符，所以 agent 沒辦法核准一張它沒有把成本攤給你看過的 job。
+
 ## License
 
 MIT

package/dist/adapters/anthropic-messages.js

@@ -19,15 +19,17 @@
 // 確認過（tool calling、tool_result 合併、usage 欄位名、effort 生效方向、cache_control
 // 生效、thinking.type:"enabled" 確實 400），結果見 facts_dispatch.md。
 import { normalizeAnthropicUsage, normalizeFinishReason } from "../usage.js";
+import { OUTPUT_TOKEN_CAP } from "../cost.js";
 import { ProviderHttpError } from "../mask.js";
 import { checkRawObjectIntegrity } from "../raw-integrity.js";
 import { readFileToolDescription } from "./read-file-tool-description.js";
 const ANTHROPIC_VERSION = "2023-06-01";
 // §29 規格四：max_tokens 是 Anthropic 專屬必要參數，SendOptions 沒有這個概念（openai／gemini
 // 都不需要）。寫死在 adapter，不提升到 SendOptions——那會逼另外兩個 adapter 處理用不到的欄位。
-// 初始值推導見規格四：十次派工單支最高 40,970 output token，32k 有 20% 餘裕；本版預設 effort
-// 不會用到官方建議 64k 起跳的 xhigh／max。撞到 stop_reason:"max_tokens" 再調，不在此臆測。
-const ANTHROPIC_MAX_TOKENS = 32768;
+// 票 cost-cap §A-1：原本 32,768 是「必填欄位的填充值，不是算過的」（舊註解原話）。現在改引用
+// cost.ts 的 OUTPUT_TOKEN_CAP（65,536）——四家 adapter 共用同一個常數，見 facts_output_cap.md
+// §六：高於三家實測單輪 output max（53,391）約 22% 餘裕，遠高於官方建議 25,000 下限。
+const ANTHROPIC_MAX_TOKENS = OUTPUT_TOKEN_CAP;
 function buildReadFileTool(lang) {
     return {
         name: "read_file",

package/dist/adapters/gemini-native.js

@@ -6,6 +6,7 @@
 // 續接時原樣放回 contents（§8）——gemini-3.x 系列的 thoughtSignature 掛在 part 上，
 // 隨 raw 一起帶回，不需另闢欄位承接。
 import { normalizeFinishReason, normalizeGeminiUsage } from "../usage.js";
+import { OUTPUT_TOKEN_CAP } from "../cost.js";
 import { ProviderHttpError } from "../mask.js";
 import { checkRawObjectIntegrity } from "../raw-integrity.js";
 import { readFileToolDescription } from "./read-file-tool-description.js";
@@ -48,10 +49,17 @@ function turnToContent(turn) {
 // plan_dispatch_v1.8.md §5「reasoning.style 的三種轉換」（實測確認）：位置與大小寫都關鍵——
 // 頂層 thinking_level 會 400；巢狀內 snake_case（thinking_level）會 200 但 Google 對未知
 // 欄位靜默忽略、不生效。正確路徑是 generationConfig.thinkingConfig.thinkingLevel（camelCase）。
-function buildReasoningParams(effort) {
-    if (!effort)
-        return {};
-    return { generationConfig: { thinkingConfig: { thinkingLevel: effort } } };
+//
+// 票 cost-cap §A-1：maxOutputTokens 先前完全沒送（無界），現在與 thinkingConfig 同層送出，
+// 值一律無條件送（不像 thinkingConfig 那樣依 effort 留白與否決定），故 generationConfig
+// 不再可能整個缺席——effort 留白時只是少了 thinkingConfig 這個子欄位。
+function buildGenerationConfig(effort) {
+    return {
+        generationConfig: {
+            maxOutputTokens: OUTPUT_TOKEN_CAP,
+            ...(effort ? { thinkingConfig: { thinkingLevel: effort } } : {}),
+        },
+    };
 }
 // 純函式：組出實際會送出的 request body，並執行 §8 的 raw 完整性自我檢查（違反即拋
 // RawIntegrityError，不需打 API 就能測試——見 raw-integrity.test.ts）。
@@ -62,7 +70,7 @@ export function buildGeminiRequest(conv, opts, lang) {
         contents,
         system_instruction: { parts: [{ text: conv.systemPrompt }] },
         ...(opts.enableTools === false ? {} : { tools: [buildGeminiTool(lang)] }),
-        ...buildReasoningParams(opts.effort),
+        ...buildGenerationConfig(opts.effort),
     };
     return { contents, body };
 }

package/dist/adapters/responses.js

@@ -4,6 +4,7 @@
 // 不用 toolCalls 重建——這是 v1.3 犯錯、v1.4 §8 明訂修正的地方。
 import OpenAI from "openai";
 import { normalizeFinishReason, normalizeResponsesUsage } from "../usage.js";
+import { OUTPUT_TOKEN_CAP } from "../cost.js";
 import { ProviderHttpError } from "../mask.js";
 import { checkRawArrayIntegrity } from "../raw-integrity.js";
 import { readFileToolDescription } from "./read-file-tool-description.js";
@@ -57,6 +58,9 @@ export function buildResponsesRequest(conv, opts, config) {
         model: opts.model,
         instructions: conv.systemPrompt,
         input,
+        // 票 cost-cap §A-1：openai／deepseek 共用此 adapter，先前完全沒送這個參數（無界）。
+        // 值的出處見 cost.ts 的 OUTPUT_TOKEN_CAP，三家 adapter 共用同一個常數。
+        max_output_tokens: OUTPUT_TOKEN_CAP,
         ...(opts.enableTools === false ? {} : { tools: [buildReadFileTool(config.lang)] }),
         ...(config.store === false ? { store: false } : {}),
         include: ["reasoning.encrypted_content"],
@@ -64,7 +68,7 @@ export function buildResponsesRequest(conv, opts, config) {
     };
 }
 export function createResponsesAdapter(config) {
-    const client = new OpenAI({ apiKey: config.apiKey, baseURL: config.baseURL });
+    const client = new OpenAI({ apiKey: config.apiKey, baseURL: config.baseURL, ...(config.fetch ? { fetch: config.fetch } : {}) });
     return {
         async send(conv, opts) {
             const params = buildResponsesRequest(conv, opts, config);

package/dist/api-token.js

@@ -0,0 +1,54 @@
+// 工單 C §B：入站 HTTP 憑證的發／驗／撤銷。DB 只存 hash（見 db.ts 的 tokens 表註解），
+// 明文只在 issueToken 呼叫當下回傳一次，之後任何地方都拿不回來。
+//
+// 與 provider API key（E12，下階段）刻意不共用任何機制：那把是要原樣交給廠商的，
+// 這把只會被比對、不會被重放，兩者的儲存與比對語意相反。
+// 具名匯入的 timingSafeEqual 在測試裡「換成 === 有沒有真的被鎖住」這件事上會失真——
+// ESM 具名綁定在連結時就固定，t.mock.method 對 crypto 這個物件的屬性替換影響不到它。
+// 改用 namespace import、呼叫端每次都經物件屬性查找，F-2 變異的偵測才踩得到。
+import crypto from "node:crypto";
+import { now } from "./db.js";
+import { m } from "./messages.js";
+import { DispatchError } from "./types.js";
+function hashToken(plaintext) {
+    return crypto.createHash("sha256").update(plaintext, "utf8").digest("hex");
+}
+// B-1 #3：常數時間比對，長度不同直接回假（timingSafeEqual 對長度不同的 buffer 會拋）。
+// 兩邊都是 sha256 hex（固定 64 字），這裡的長度守衛是防禦性的，不是本函式的主要工作——
+// 主要工作是「用 timingSafeEqual 而不是 ===」，見 F-2 變異。
+export function hashesMatch(a, b) {
+    const bufA = Buffer.from(a, "utf8");
+    const bufB = Buffer.from(b, "utf8");
+    return bufA.length === bufB.length && crypto.timingSafeEqual(bufA, bufB);
+}
+// B-1 #2：明文只在這裡回傳一次，呼叫端（cli.ts 的 `token issue`）印出後即不再持有。
+export function issueToken(db, label) {
+    const id = crypto.randomUUID();
+    const plaintext = crypto.randomBytes(24).toString("hex");
+    db.prepare("INSERT INTO tokens (id, hash, label, created_at) VALUES (?, ?, ?, ?)").run(id, hashToken(plaintext), label ?? null, now());
+    return { id, plaintext };
+}
+export function listTokens(db) {
+    return db.prepare("SELECT id, label, created_at, revoked_at FROM tokens ORDER BY created_at").all();
+}
+// B-1 #6：HTTP 起來卻一把 token 都沒發，端點活著但沒有任何請求進得來——這個查詢是那個
+// 警告的資料來源，見 daemon.ts 的 serve()。
+export function hasAnyActiveToken(db) {
+    return db.prepare("SELECT 1 FROM tokens WHERE revoked_at IS NULL LIMIT 1").get() !== undefined;
+}
+// B-1 #4／#5：撤銷後同一把 token 即 401；撤銷不存在或已撤銷的 id 講人話，不分兩種訊息——
+// 對呼叫者而言「這個 id 現在撤不動」是同一件事，沒有必要在措辭上分岔。
+export function revokeToken(db, id, lang) {
+    const result = db.prepare("UPDATE tokens SET revoked_at = ? WHERE id = ? AND revoked_at IS NULL").run(now(), id);
+    if (result.changes === 0)
+        throw new DispatchError(m(lang, "tokenNotFoundOrRevoked", id), 2);
+}
+// B-1 #1：比對，不回傳明文、不記值。找不到未撤銷的相符 token 回傳 null。
+export function findTokenIdForPresented(db, presented) {
+    if (typeof presented !== "string" || presented.length === 0)
+        return null;
+    const presentedHash = hashToken(presented);
+    const rows = db.prepare("SELECT id, hash FROM tokens WHERE revoked_at IS NULL").all();
+    const match = rows.find((row) => hashesMatch(row.hash, presentedHash));
+    return match ? match.id : null;
+}

package/dist/cli-args.js

@@ -6,7 +6,9 @@
 // 並收緊兩處：多餘 positional 即中止（原靜默忽略，違反 fail closed）；無參數／--help 印
 // 完整用法（原僅一行）。
 import { DispatchError } from "./types.js";
+import { DEFAULT_HTTP_PORT } from "./mcp/http.js";
 import { getCommandName } from "./pkg-info.js";
+import { DEFAULT_MAX_TOOL_CALLS } from "./cost.js";
 import { m } from "./messages.js";
 const DEFAULTS = {
     out: "tmp/spoke",
@@ -22,10 +24,11 @@ const DEFAULTS = {
     retries: 2,
     rateLimitRetries: 5,
     maxRateWaitSec: 30,
-    maxToolCalls: 30,
+    maxToolCalls: DEFAULT_MAX_TOOL_CALLS,
     charsPerToken: 1.0,
     maxSpokeReasoningTokens: 50_000,
     maxRoundReasoningTokens: null,
+    httpPort: DEFAULT_HTTP_PORT,
     json: false,
     dryRun: false,
     yes: false,
@@ -88,8 +91,20 @@ export function parseArgs(argv, lang) {
     if (argv.includes("--version") || argv.includes("-V"))
         return { mode: "version" };
     const options = { ...DEFAULTS };
+    // 熱修補（票 C 驗收）：`DOWAFU_HTTP_PORT` 原本只寫在 `daemon.ts` 的 `serve()` 參數預設值裡，
+    // 而 `cli.ts` 一律傳 `parsed.options.httpPort`（DEFAULTS 給了具體數字），所以那個預設永遠
+    // 用不到——環境變數看起來支援、實際是死的。同一行呼叫裡 maxConcurrent 傳的是 `undefined`，
+    // 所以 `DOWAFU_MAX_CONCURRENT` 是活的：**兩個環境變數一活一死，而死的那個沒有任何徵兆**。
+    // 在這裡讀（而不是在 module-level 的 DEFAULTS 讀）才能每次呼叫重新取值，測試也才注得進去。
+    // 優先序：--http-port > DOWAFU_HTTP_PORT > 內建預設。旗標在下方解析，故此處放在它之前。
+    const envHttpPort = Number(process.env.DOWAFU_HTTP_PORT);
+    if (Number.isInteger(envHttpPort) && envHttpPort > 0 && envHttpPort < 65536)
+        options.httpPort = envHttpPort;
     let ticketDir;
     let doctorMode = false;
+    let serveMode = false;
+    let serveStop = false;
+    let mcpMode = false;
     const numFlag = (name, apply) => {
         flagHandlers[name] = (v) => {
             const n = Number(v);
@@ -101,7 +116,10 @@ export function parseArgs(argv, lang) {
     const flagHandlers = {};
     flagHandlers["out"] = (v) => (options.out = v);
     flagHandlers["repo-root"] = (v) => (options.repoRoot = v);
-    flagHandlers["providers"] = (v) => (options.providersPath = v);
+    flagHandlers["db"] = (v) => (options.dbPath = v);
+    // Used by the local daemon worker only.  It gives each queued run its own
+    // result rows without changing the normal D1 ticket-id result key.
+    flagHandlers["job-id"] = (v) => (options.jobId = v);
     // 這裡只存原始字串，不驗證格式——格式與 DISPATCH_LANG 的組合判定需要 process.env，
     // parseArgs 是純函式不碰它，交給 cli.ts 呼叫 resolveLang（見下）。重複帶 --lang 時
     // 最後一次覆蓋前一次，與其他旗標一致（v1.3 §二之2 #8）。
@@ -117,6 +135,7 @@ export function parseArgs(argv, lang) {
     numFlag("chars-per-token", (n) => (options.charsPerToken = n));
     numFlag("max-spoke-reasoning-tokens", (n) => (options.maxSpokeReasoningTokens = n));
     numFlag("max-round-reasoning-tokens", (n) => (options.maxRoundReasoningTokens = n));
+    numFlag("http-port", (n) => (options.httpPort = n));
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
         if (arg === "--dry-run") {
@@ -134,6 +153,15 @@ export function parseArgs(argv, lang) {
             // （見迴圈後方）——這樣 --doctor 與 --lang 之類的已知旗標仍可同時給、彼此不衝突。
             doctorMode = true;
         }
+        else if (arg === "serve") {
+            serveMode = true;
+        }
+        else if (arg === "--stop") {
+            serveStop = true;
+        }
+        else if (arg === "mcp") {
+            mcpMode = true;
+        }
         else if (arg.startsWith("--")) {
             const name = arg.slice(2);
             const handler = flagHandlers[name];
@@ -162,7 +190,21 @@ export function parseArgs(argv, lang) {
         if (ticketDir !== undefined) {
             throw new DispatchError(m(lang, "tooManyArgs", ticketDir, "--doctor", helpText), 2);
         }
-        return { mode: "doctor" };
+        if (serveStop)
+            throw new DispatchError(m(lang, "stopRequiresServe"), 2);
+        return { mode: "doctor", options };
+    }
+    if (serveMode) {
+        if (ticketDir !== undefined)
+            throw new DispatchError(m(lang, "tooManyArgs", ticketDir, "serve", helpText), 2);
+        return { mode: "serve", options, stop: serveStop };
+    }
+    if (serveStop)
+        throw new DispatchError(m(lang, "stopRequiresServe"), 2);
+    if (mcpMode) {
+        if (ticketDir !== undefined)
+            throw new DispatchError(m(lang, "tooManyArgs", ticketDir, "mcp", helpText), 2);
+        return { mode: "mcp", options };
     }
     if (!ticketDir) {
         throw new DispatchError(helpText, 2);