ToukaIDE (燈火 VS Code 擴充套件)
ToukaIDE 是為 VS Code 量身打造的 AI 原生開發插件。它不僅提供了側邊欄對話，更透過內建的 ToukaMcpServer 賦予 AI 讀寫檔案、執行終端機指令以及操作 Git 的能力。
🚀 核心功能
- 內嵌式聊天視圖：直接與 Touka 進行對話，支援代碼解釋、重構與計畫追蹤。0.3.0延續安全純文字模式：保留換行，但不解析Markdown或HTML；Webview不載入外部CDN JavaScript（ADR-0219）。
- 提及系統 (@Mentions)：
@problems: 獲取目前的診斷資訊 (Diagnostics)。@terminal: 獲取終端機最後的輸出內容。@git: 獲取 Git 暫存區與未暫存的變更摘要。@opened: 引用所有目前已開啟的檔案內容。
- Artifact 橋接接收器：
- 預覽與套用：接收來自
ToukaChat 的 Apply to Project 指令。
- 虛擬編輯器 (Virtual Buffer)：內容會以「未儲存檔案」形式在 VS Code 中開啟，讓使用者審核後再決定是否存檔，確保安全性。
- MCP 工具整合 (Model Context Protocol)：
- 檔案操作：基於
FileHandlers 的讀寫與目錄遍歷。
- Terminal Auto-Fix：自動捕捉 Exit Code 並在 ReAct 迴圈中嘗試修正。
- 分級授權機制 (Tiered Auth)：
ReadOnly: 僅讀取，禁止寫入。Manual: 寫入前需手動確認 (預設)。SafeAuto: 自動執行安全範圍內的指令。FullYOLO: 全自動執行 (排除 Git/Docker 等高危指令)。
- MCP 2026 bridge (ADR-0202) ⭐：0.3.0只提供 Streamable HTTP
/mcp；
退役 /mcp/sse＋/mcp/messages 回 404，保留 modern request-scoped SSE。此版本不再接受舊 HTTP+SSE clients；更新客戶端後使用 /mcp。
- 逐 request Bearer：啟動時以
crypto.randomBytes(32) 生成 session token，
discovery 只交給 ToukaProxy；modern 每個 HTTP request 都重驗，空 token
fail-closed。
- 多連線與取消：modern request 彼此隔離；client
關閉 stream 時取消訊號會傳至 terminal executor。
- P11-B raw rollout evidence＋P11-C follow-up（ADR-0213／0215 committed implementation）：feature預設完全關閉；
只有
MCP_ROLLOUT_EVIDENCE_DIR 與 MEMORY_APP_DATA_DIR 都明示才記錄固定 modern MCP
endpoint 的 payload-free counters；退役入口不觀察、legacy counters 為零。Observer 位於 Bearer＋Host／Origin 與 exact method/path
guards 後；path alias／method mismatch 不計數。Shutdown close phase 以 bridge latch 讓合法
late request 回 503，並 bounded close listener／transport，最後才封存 evidence。非空 generation 固定每
300 秒以 atomic create-only artifact 封存，既有檔案不覆寫、不自動刪除。產物仍是 untrusted
raw evidence。P11-C committed implementation已把filesystem publication移至bounded worker、在BigInt()前做
Python-derived pre-cap，並加入exact release-window ID＋digest binding與successful-start latch；raw
artifact仍須經fixed-slot trusted verifier。原 IDE candidate/runtime/publication provider 鏈仍為 ADR-0220 NOT SELECTED；本輪依 ADR-0221 本機 modern-only 方向驗收，不啟用舊 sunset provider。
🛠️ 技術架構
src/extension.ts: 核心入口與指令註冊。src/mcp/server.ts: AuthLevel 與 IDE 工具 executor 組裝。src/mcp/httpBridge.ts: modern-only /mcp transport bridge。src/mcp/protocolServer.ts: 官方 Node SDK v2 server/tool registry。src/mcp/contracts.ts: endpoint 與 discovery SSOT。src/mcp/rolloutRuntime.ts: 選配 rollout producer／writer／lifecycle 組裝。src/mcp/rolloutPublicationWorker.ts: extension-host bounded queue／ACK／shutdown controller。src/mcp/rolloutArtifactWorker.ts: worker-thread artifact store／writer entry。src/mcp/generated/rolloutContract.ts: 由 Python rollout_contract.py 經
scripts/generate_mcp_rollout_ts.py 機械產生的 binding；包含 automatic validator discovery、
executable field／validator recipes 與全部欄位必填的 artifact output types，禁止手改。src/mcp/handlers/: 工具邏輯分離 (Editor, File, Git, Terminal)。src/providers/: 提供 ChatViewProvider 與 CodeLens 支援。
安裝、連線與更新
- 在 VS Code 的 Extensions 搜尋 Touka IDE，核對發行者 touka-ai、完整 ID touka-ai.toukaide，按 Install／Update；也可由 Extensions 的「Install from VSIX」選擇已取得的正式 VSIX。
- 先啟動同一本機的 Touka Proxy。ToukaIDE 是獨立的 VS Code 擴充套件，不包含 Proxy，也不在三個 runtime images 內。
- 在 VS Code Settings 搜尋
Touka，將 touka.proxyUrl 設為你的 Proxy 網址（預設 http://localhost:8000），touka.apiKey 填入供此連線使用的 Bearer 憑證。不要使用 Dispatch mission token，也不要分享個人 token。
- 執行 Start Touka 開啟側欄；
touka.defaultModel 留空時採第一個可用 Agent。行內補全可由 touka.enableInlineCompletion 關閉。
- IDE 提供給 Touka 的工具反向連線只綁 loopback，使用
/mcp及啟動時產生的 discovery token；這與側欄聊天到 Proxy 的認證是不同方向。
0.3.0 更新內容：Node SDK v2／MCP 2026-07-28 modern-only bridge；退役 /mcp/sse與/mcp/messages，保留 modern request-scoped SSE、逐 request Bearer、取消與多連線隔離。Webview仍以純文字顯示HTML／Markdown並保留換行，不載入外部CDN腳本。版本更新不替你改動Touka的個人資料或部署。
套件宣告 VS Code ^1.90.0／Node20+；建置工具版本與實際驗證的host分開記錄，不代表所有Windows／Linux／macOS都已實測。0.3.0採一份universal VSIX；原0.2.0保留為歷史版本。
原始碼開發與發行
建置固定 Node.js 24.19.0／npm 11.19.1。從 ToukaIDE 目錄依序執行：
npm ci --ignore-scripts --no-audit --no-fund
npm test
npm run typecheck
npm run compile
npm run package
compile／package共用dist/，必須串行。F5可啟動擴充開發主機；source建置不會自行安裝或發布。
正式候選由ToukaIDE/scripts/build_marketplace_candidate.py在clean、v0.3.0錨定的來源建立，使用repo-local
@vscode/vsce@3.9.2、10-member allowlist、root MIT LICENSE及create-only SHA-256 manifest；不上傳、不登入、不使用npx。
正式發行須另驗隔離Windows Stable smoke與Marketplace回讀，不因本機runtime映像成功而通過。
以下GitHub來源與進階文件位於私有儲存庫，須既有存取權；Marketplace安裝不要求取得原始碼：
MIT License。Publisher：touka-ai；extension ID：touka-ai.toukaide。
| |
