第五節命令列入口

[!ref] 詳解見使用者手冊「下載、執行與系統要求」節。

命令列版本與桌面版共享同一份會話與配置，互相之間可以接力。

桌面主程式（AVLCode，Windows 為 AVLCode.exe）內置終端機入口：

命令	用途
`AVLCode tui`	在終端機裡啟動 TUI 版本，與桌面版共享同一份會話
`AVLCode zagent-tui`	直接啟動批處理對話 TUI，適合指令碼化驅動

CLI 整合二進位（zBoxFull）提供五個服務入口：

命令	用途
`zBoxFull zWorkspace`	工作區服務
`zBoxFull zAgent`	一次性 LLM 對話（JSONL 批處理）
`zBoxFull zSkill`	技能管理與簽章（SM2/SM3）
`zBoxFull zChannel`	隨行通訊（獨立執行 / dry-run / 主 App 回呼）
`zBoxFull zMCP`	外部工具服務連線偵錯
`zBoxFull install`	把五個服務入口的符號鏈接安裝到指定目錄，裝後可直接以 `zWorkspace` 等短名呼叫

tui / zagent-tui 由桌面主二進位內置，無需額外安裝 zBoxFull 發行包。

參數	含義
`--config <path>` / `-c <path>`	Provider 配置檔案路徑；缺省時按 `ZAGENT_PROVIDER_CONFIG` 環境變數 → 隨包預設配置的順序解析
`--session <ID>`	復原指定會話（讀回記錄並重放）。留空則自動生成新會話 ID；指定的會話不存在 / 已損壞時提示後用該 ID 開新會話（保留你的命名語義）

按鍵	作用
{{kbd:Enter}}	發送
{{kbd:F2}}	新會話
{{kbd:Esc}} / {{kbd:Ctrl+C}}	執行中：中止 Agent；空閒：結束
{{kbd:y}} / {{kbd:a}} / {{kbd:n}}	Hook 批准掛起時：本次允許 / 永久允許（寫工作區批准文件，與桌面端互認）/ 拒絕。{{kbd:Esc}} 同 `n`，30 秒未選自動拒絕

所有命令在本機處理，不會作為普通訊息發給模型。

命令	參數	說明
`/goal`	`[<目標> \| budget <N> \| pause \| resume \| complete \| clear]`	會話目標，與桌面端同源；無參數 = 檢視當前目標
`/compact`	`[N]`	折疊歷史；可保留最近 N 條原文。折疊快照隨會話落盤，`/resume` 後仍在
`/sessions`	無	列出當前工作區最近 10 條會話（按更新時間倒序，當前會話標 `*`）。只讀
`/resume`	`<會話 ID>`	切換到指定會話。會話 ID 不能含 `?[]/\`；切換失敗時原會話完全不變*，只貼一行錯誤
`/login`	`<user>` / `<user> <password>` / `phone <手機號>`	登入。無參數列印用法；`<user>` 形態下一次 {{kbd:Enter}} 輸入密碼（不回顯、不進聊天歷史）；`phone` 走簡訊驗證碼，觸發風控時圖形驗證碼存成 PNG 並在狀態列給出路徑
`/sso`	`[paste <url>]` / `[cancel]`	SSO 登入：起本機回呼並顯示授權 URL；瀏覽器回跳受阻時用 `paste` 手工粘回 URL，`cancel` 取消
`/logout`	無	登出
`/usage`	無	查詢用量與可用點數（需已登入）
`/redeem`	`<兌換碼>`	兌換點券（需已登入）
`/feedback`	`<內容>`	提交回饋（需已登入）
`/attach`	`[<路徑> [ro\|rw]]`	會話級沙箱附加。無參數 = 列出當前清單（只讀，降級模式下也可用）；相對路徑按工作區根解析；mode 缺省為 `ro`；同一路徑再次附加以新 mode 覆蓋
`/detach`	`<路徑>`	解除該路徑的附加

/attach 與 /detach 的拒絕口徑（與桌面端一致）：路徑不存在、檔案系統根、工作區內部路徑一律拒絕；外部 / 無工具鏈模式下不支持附加推播。

啟動時會拉取並顯示公告橫幅。狀態列常駐提示當前可用按鍵與命令，並在右側顯示工具鏈狀態。

第五節 命令列入口