本頁是 OMW 現行技術契約的索引，不複製各文件的規則。實作、操作或驗收若有歧義，以連結的權威文件與目前程式碼為準；docs/archive/phase1/ 只保存歷史觀察。
- 安裝與日常操作：使用手冊。
- Repository development：開發說明。
- Launcher、Tailnet 或 authentication：Security。
- Release 與驗收證據：Validation。
| 介面 | 用途 | 權威文件 |
|---|---|---|
npx @sevenflanks/omw@latest |
初始化、啟動或重用 Manager；不啟動 OpenCode TUI | 使用手冊 Quick Start |
npx @sevenflanks/omw@latest opencode [project] [-s session] |
透過 OMW wrapper 啟動 Local TUI Instance | Local TUI launcher |
opencode ... |
原生 OpenCode；OMW 不攔截、不自動登錄 | Launcher contract |
日常操作優先使用使用手冊 Quick Start 的 npx @sevenflanks/omw@latest；global install 是可選路徑，原始碼／本機 .tgz 是建置驗證或替代安裝路徑，repository development 使用隔離入口。歷史 @sevenflanks/omw@0.1.0 安裝與 smoke 證據範圍見release verification 紀錄，不代表目前 latest 的完整 E2E 已驗證。
- Runtime data 與環境變數
- 隔離的 development、test 與 acceptance configuration
- Instance recovery and tracking contract
- Primary Session Binding contract
日常資料預設位於 %LOCALAPPDATA%\OMW；repository development 固定使用 worktree-local .omw/development，test 與 acceptance 使用 fresh temporary root。兩者不可混用。
- Manager API endpoints、request boundary 與 response contract
- Launcher reservation、register 與 finalize API
Browser mutation、launcher request、Origin、authority 與 token 的規則屬安全契約，不應只從 endpoint 表格推論。
- Local TUI launcher、fixed port、ownership 與 authentication contract
- Tailnet access contract and runbook
- Mobile acceptance checklist
OMW 維持 loopback-only；明示開啟 remote mode 時，OMW 只會保守新增並驗證缺少的 Tailscale Serve mappings，不會設定 Firewall、ACL、Funnel、login/up、OS service 或其他 public ingress。Browser Basic auth 與 launcher token 是不同 audience，文件、Issue、log 與截圖都不得包含 password、token 或 credentials.dpapi 內容。
| GitHub inline asset | 可編輯 source |
|---|---|
| OMW 本機與 Tailnet 架構 | HTML |
| OMW 啟動、重用與失敗處理 | HTML |
| OMW 三種停止操作 | HTML |
SVG 是由同名 HTML 的第一個 <svg> 匯出。需要修改圖時先改 HTML source，再重新匯出，避免兩份內容漂移。
- 目前驗收狀態與限制
- Release verification：
@sevenflanks/omw@0.1.0 - Issue #11 人工本機驗收
- Issue #11 正式 Vue UI + isolated mock acceptance
- Issue #12 A/B isolation acceptance
Mock UI、synthetic PTY、模擬 mobile viewport、人工本機流程與真實 Tailnet／手機驗收是不同證據層級。任何一層的 PASS 都不能改寫其他層的 NOT VERIFIED 或 NOT_PROVEN。
Phase-1 archive 保留特定版本、日期與環境下的研究結果，不是現行產品契約。完整保存邊界見專案文件與研究物件盤點。