cc-crossbeam-tw | 台灣室內裝修送審文件助手

它想減少的工作量

室內裝修送審最耗時的不是單一法條查詢，而是把程序、文件、圖說、補正公文與專業責任分清楚。這個原型把這些工作拆成可重跑、可稽核的輔助流程。

判斷走哪個程序

依已遮罩文字與檔案 metadata 判斷案件比較接近圖說審核、竣工查驗、變更使用併室內裝修竣工查驗或簡易室內裝修，並附信心分數。

整理送件文件

依程序階段產生新北市室內裝修 packet，列出缺件、照片、材料證明與需要人工確認的項目。

拆補正公文

把遮罩後的補正公文拆成 atomic correction items，輸出回覆草稿、專業確認包與補正摘要。

保留來源與日期

法規 snapshot 與工具輸出保留來源 URL、authority rank、license/update policy、as-of date 與 gate metadata。

會做與不會做

會做

不會做

整理程序、文件、來源與待確認事項。

判定案件合法或違建。

依已遮罩資料與 metadata 做程序分流。

保證審查必過。

產生補正回覆草稿與專業確認包。

出具法律意見或合規保證。

提示消防、防火區劃、材料證明可能需要的文件。

替代建築師、消防設備師或材料廠商專業判斷。

可以這樣問 AI 助手

判斷上傳資料屬於哪個程序

請使用 tw-law-mcp 先跑 run_phase_acceptance。
接著根據我提供的已遮罩文件文字與檔案 metadata，判斷目前比較接近：
圖說審核、竣工查驗、變更使用併室內裝修竣工查驗、簡易室內裝修。
請輸出 procedure_stage 信心分數、需要的人工確認問題、會用到的 corpus packs、產出的 artifacts，以及不能判定的原因。
不要輸出法律意見、合規保證、消防設計結論、材料真偽結論或審查必過承諾。

產生竣工查驗 packet

請依新北市室內裝修竣工查驗階段，產生送件文件 packet。
請列出竣工圖說、材料證明、照片 manifest、消防相關文件、缺件與需要人工確認的項目。

拆解補正公文

以下是已遮罩公文文字。
請 parse_masked_document，normalize_atomic_correction_items，
再產生 HITL confirmation packet 與補正回覆草稿。

Secure Web 單人試用

除了 tw-law-mcp 工具本身，專案也提供一個瀏覽器介面：案件建立、原始檔案隔離上傳、Python 遮罩與既有法規分析、人工確認、稽核事件與可驗證刪除，串成單一使用者可重跑的試用流程。目前僅支援 local 與 single-user 兩種模式，尚未開放正式多人上線。

案件與身分

Google 登入驗證擁有者身分，LINE 作為輔助入口通道；案件建立與存取授權都綁定同一個應用內部使用者 ID。

隔離上傳

瀏覽器檔案直傳私有 quarantine；只有 worker 能掃描、驗證、遮罩並晉升物件，下游只讀得到已清洗的內容。

遮罩與分析

Python worker 執行去識別化遮罩與既有法規分析；本機 Codex 只在唯讀、ephemeral、隔離的環境下執行，不是網站身分提供者。

HITL 與刪除

人工確認、結果與稽核事件檢視、帳號與 LINE 連結管理，加上可驗證的檔案刪除迴圈。

Secure Web 會做與還不能做

目前可以做的事

單機 loopback 或單人 HTTPS 部署，Google OIDC 限定 owner email。
UTF-8 TXT 與檔案 metadata 的隔離上傳、遮罩與人工確認。
本機已登入的 Codex CLI 以唯讀、ephemeral worker 身分執行分析。

還不能做的事

正式多人 production 上線；cloud 模式會擋掉本機 auth、storage、DB 與本機 Codex provider，直到有 approved 服務憑證。
PDF 或圖片解析；authenticated worker 目前只收 UTF-8 TXT。
取代 Google/LINE 正式憑證、official-source 即時同步與真實案件驗收證據。

資料邊界

可以交給工具的內容

已遮罩的公文文字。
檔名、圖號、頁名、sheet type、文件類型等 metadata。
已去識別化 fixture 或測試案例。
人工確認答案、法規 snapshot、acceptance output。

不要直接貼進 prompt

未遮罩姓名、地址、電話、身分證字號。
title block、raw drawing、raw PDF、完整申請文件影像。
客戶授權範圍不明的資料。
可被誤用成法律意見或審查保證的結論。

快速開始

Clone repo

git clone https://github.com/trionnemesis/cc-crossbeam-tw.git
cd cc-crossbeam-tw

啟動 MCP server

Codex App 設定在 .codex/config.toml；Claude Code 設定在 .mcp.json。

python3 scripts/tw_law_mcp_stdio.py

先跑驗收

確認本機工具、fixtures、source adapters、scenario matrix 與 two-stage flow 都能重跑；aggregate trust gate 會保留 G2 fail-closed 狀態。

python3 scripts/run_phase_acceptance.py

啟動 Secure Web（可選）

需求：Node.js 22.x、Python 3.14。

cd web
npm ci
npm run dev

另開終端機啟動本機 worker

python3 -m worker.secure_worker.server

目前原型狀態

版本 0.4.1 prototype

首發地區 新北市

案型室內裝修

完成階段 1~6 組 + Phase 2.1-2.6 / Step 6

1. Source policy

P0 法規來源、authority rank、license/update policy 與 fallback comparison。

2. Procedure + HITL

程序階段信心分數、低信心分流與人工確認 loop。

3. G2 fixture contract

12 份 synthetic de-identified cases、84 個 atomic correction items；unsupported claims fail closed。

4. Metadata extraction

metadata-only drawing/document policy、sheet manifest 與 raw content boundary。

5. Jurisdiction registry

新北市 enabled；台北、桃園 stubs fail closed，不主動作答。

6. MCP packaging

Standalone MCP server first，Codex 與 Claude Code 維持 thin wrappers。

主線已完成 1~6 組開發，並完成 Phase 2.1-2.6 / Step 6 的 data layout、source adapters、scenario tools、hardened scenario matrix 與 two-stage contractor flow skeleton。Production 導入前仍需 approved real de-identified cases 與 live official-source ingestion/refresh workflow；G2 synthetic baseline 只驗證 schema、gate 與 HITL contract，不支撐真實案件 claim。