第二章 設定與外觀
本章覆蓋第 6–10 章：設定面板逐項速查、助手人設與模型 Provider 欄位，以及主題外觀與系統整合。
第六節 設定面板
[!ref] 詳解見使用者手冊「全域設定」節。
設定面板共 22 個 tab，按 6 個分組組織。下表按介面順序逐一列出，並標註作用粒度（G 全域 / W 工作區 / M 模式）與預設值。
6.0 設定面板分組
6 個分組，每組最多 6 項，互斥領域 + 使用頻率自上而下：
| 分組 | 包含的 tab | 作用 |
|---|---|---|
| 帳號 | 帳號 · 回饋 | 登入 / 用量 / 點數餘額、意見回饋 |
| 一般 | 通用 · 最近訪問 · 資料 · 例行程序 | 主題、專案工作區與會話佈局（側邊欄 / 頂部分頁）、訊息密度、系統匣、開機自啟、語言、字型、設定目錄、檢查更新；最近工作區；存儲空間 / 備份 / 清理 / 同步；例行程序 |
| 模型 | 服務提供方 · 參數設定 | LLM Provider 清單 / 憑證 / 頭；預設模型、溫度、最大 token、超時 |
| 智慧體 | Agents · 自省 · 技能 · 工具 · Hooks · 上下文 · 記憶宮殿 | 五種模式人設；自省頁：復述意圖 / 自動反省 / 任務自動復原；技能載入與簽章；工具開關；呼叫前確認與自動批准；上下文與折疊；長期記憶 |
| 安全 | 安全 · 技能/外掛簽章 · 測試與自檢 · 資料脫敏 · 供應鏈 / SBOM | 危險護欄；簽章驗證政策與信任庫；自檢門禁；外發脫敏；SBOM 漏洞庫資料源與離線同步 |
| 擴充 | 外掛 · 隨行通訊 | 外掛市集 / 安裝 / 啟停 / 權限；微信等 IM 通道與綁定碼 |
6.1 設定 → 帳號
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 登入方式 | G | 手機號驗證碼 | 手機號驗證碼（預設；無帳號自動註冊；60s 倒數計時；風控時切圖形驗證碼）/ 使用者名稱密碼 / SSO |
| 套餐額度 | G | 自動 | 登入後自動下發；無需手動配置 |
| 點數餘額提醒閾值 | G | 1 小時 | 離過期不到該時長，狀態點變琥珀；面板前綴 §（點） |
| 用量週期 | G | 24h / 7d / 30d | 每分鐘重新整理 |
| 登出 | G | — | 點擊執行；保留本機資料 |
| 兌換碼 | G | — | 輸入兌換碼 → 就地回饋（成功 / 失效 / 已用過等 12 種在地化提示） |
| 我的用量點券 | G | — | 列出全部用量點券：面額、有效期、永久券標註 |
| 可用點數口徑 | G | — | 直接取伺服器端展示欄位（/me.voucher_balance），用戶端不對券清單求和，與網頁端一致 |
| 購買點券（帳號卡） | G | — | 帳號卡內入口（舊名「快速購買」）。餘額行固定單行顯示 |
| 購買點券 / 升級 · 訂閱套餐 | G | — | 用量區與「可用點數已耗盡」橫幅的兩個按鈕 |
| 購買流程 | G | — | 先在 App 內彈選檔框（「選一檔，在瀏覽器裡確認並付款」），選檔後在系統瀏覽器開啟確認購買頁：點券 /quick-buy/?sku_id=<檔位>&quantity=1；可自助套餐 /quick-buy/?plan_id=<套餐>&months=1；「聯絡銷售」類套餐 → /dashboard/；框底「前往服務頁面」→ 點券 /recharge/、套餐 /dashboard/。落點跟隨所配帳號服務地址 |
| 低餘額行內預警 | G | 閾值 < 50 | 已登入、訊息由 AVL-Zero 產出、餘額已知且嚴格小於 50 時，在本會話最新一條助手訊息下顯示「AVL Zero 可用點數僅剩 §xx.xx，即將用盡」+「購買點券」「升級 · 訂閱套餐」；串流中 / 已有用量不足紅條 / 歷史訊息不重復 |
| 首次啟動精靈 | G | 無可用模型時自動彈 | 每次啟動檢查；三步：登入 → 建立專案（有歷史時為「開啟專案」）→ 發起首次會話。帳號頁底部「首次啟動精靈 → 重新執行精靈」或命令面板「執行首次啟動精靈」可手動開啟 |
6.2 設定 → 通用
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 語言 | G | 跟隨系統 | 簡體中文 / 繁體中文 / English。落盤 language；Header 快捷選單「語言」滑塊同步此項 |
| 主題 | G | system | system / light / dark |
| 專案工作區與會話佈局 | G | 側邊欄 | sidebar（左側邊欄）/ tabs（頂部分頁，內容區貼邊；開啟的分頁持久記憶、重新啟動恢復；登入後分頁欄右端顯示當前使用者名稱，定寬、過長省略）。落盤 workspace_display_mode；Header 快捷選單「佈局」滑塊同步此項 |
| 最小化至系統匣 | G | 關 | 關窗後駐留系統匣 |
| 開機自啟 | G | 關 | 啟動時靜默到系統匣 |
| 字型大小 | G | 中 | 小 / 中 / 大 |
| 訊息密度 | G | 正常 | detailed（正常，帶卡片 / 參數預覽） / compact（極簡，無卡片灰階細行 + 過程內容歸並計數）。落盤 message_density；只壓縮過程渲染、不動本文；舊 collapsed 自動遷到 compact；正常模式下，摺疊思考隨生成向左捲動，結束後顯示開頭摘要；極簡模式僅顯示「思考」 |
| 記住視窗狀態 | G | 開 | 關閉後啟動用螢幕自適應預設尺寸並置中、結束不回寫 |
| 顯示不可見字元 | G | 關 | 把回復中的零寬 / 變體等不可見字元在渲染時視覺化標出。檢出時另有提示（「思考 N 處 / 本文 N 處」+ 具體字元）。判定按可疑字元白名單口徑 —— CJK 語境下合法的零寬 / 變體字元預設放行。開關翻轉會清渲染快取 |
| 設定目錄 | G | — | 一鍵開啟 |
| 檢查更新 | G | 啟用 | 手動 / 自動 |
6.3 設定 → 最近訪問（獨立 Tab）
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 搜尋 | — | — | 命中詞醒目顯示；始終顯示 |
| 置頂區 / 其他區 | — | — | 各自獨立滾動；置頂項不隨下方滾動消失 |
| 多選 | — | — | 支持頂部批量操作欄（刪除 / 開啟所選） |
| 批量開啟 | — | 開啟所選 | 由「開啟全部」改為「開啟所選」；超過同時活躍上限按前 N 項截斷並告知 |
| 刪除 | — | inline 倒數計時 | 武裝 → 3 秒倒數計時 → 確認；不彈 confirm |
6.4 設定 → 資料
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 存儲佔用視圖 | G | — | 14 備份類別 + 6 非備份項，按 du 位元組級對齊 |
| 單項 / 批量清理 | G | — | 含敏感資料的類別自動落 auto-clean-<ts> 快照 |
| 全量重設 | G | — | 深度清 14 類 + 重設預設配置 + 落 auto-fullreset-<ts> 快照 |
| 建立備份 | G | — | .zbk 加密文件（SM4-GCM，PBKDF2-SM3 金鑰派生，國密；舊版 AES-256-GCM 備份仍可解密匯入），14 類應用資料 |
| 復原備份 | G | — | 選 .zbk → 輸入密碼 → 預覽 → 確認 |
| 歷史快照 | G | — | 列出所有自動 / 手動快照，深鏈可跳定位 |
| 附件 / 樣本上限 | G | 300 MiB | 範圍 1–4096 MiB；有「恢復預設」按鈕 |
| 資料目錄 | G | — | 一鍵開啟備份 / 遷移用 |
| 同步（實驗性） | G | 關 | 多設備共享 |
6.5 設定 → 上下文
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 會話自動重命名 | G | 開 | 未手動改名的會話首條 AI 回復後自動起標題 |
| 自動命名豁免 | — | 自動 | 手動改名過的會話永久豁免 |
| 歷史折疊（Compact）閾值 | G | 由模型決定 | 接近 context 上限時觸發 |
| 自動壓縮 · 觸發閾值 | G | 85% | 佔用達上下文視窗的該比例時觸發；範圍 50–99 |
| 自動壓縮 · 保留最近訊息數 | G | — | 壓縮時保留末尾若干條本文不摘要 |
| 自動壓縮 · 絕對觸發上限 | G | 372000 | 與百分比取先到者。僅對宣告的上下文視窗超過約 437K 的模型改變行為（部分模型視窗宣告極大，只按百分比會遲遲觸發不了）。0 = 關閉，只按百分比觸發。落盤 auto_compact.max_prompt_tokens；env ZAGENT_AUTO_COMPACT_MAX_PROMPT_TOKENS |
| 自動壓縮 · 單程序最大觸發次數 | G | — | 同一程序內的壓縮次數上限 |
6.6 設定 → 記憶宮殿
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 啟用記憶宮殿 | G | 開 | 記憶子系統總開關。關閉後不抽取候選、不注入記憶、訊息選單「寫入記憶宮殿」不開啟抽屜（給出提示）。零重新啟動生效（當場註銷 / 註冊後端）。落盤 memory_palace_enabled |
| 記憶條目 | G | 空 | 長期記憶庫的增刪改查 |
| 旅程設計 | G | — | 把一組記憶組合成"旅程" |
| 回顧面板 | G | — | 按主題檢視歷史回憶 |
| 單次提取上限 | G | 7 | 1–10 為固定上限；填 0 或 >10 則不設上限、由模型自主決定。自動 / 手動 / 重新提取三條路徑統一生效 |
| 待審草稿盒 | G | — | HookStop 抽取 → {宮殿}/_pending/{時戳}-{slug}.md → MemoryReviewPanel 批准 / 編輯 / 駁回。批准前不進 in-memory index / 不參與檢索 |
| 健康看板 | G | — | 總數 / 已過期 / 從未召回 / 房間分布 / 熱度 Top 10 / 冷門 ≤20 / 低效 ≤20（R≥5 且 SR≤0.2）/ 疑似重復簇 ≤20 / 待審 dup·conflict 計數；可一鍵剪枝 / 合並 |
| 召回加權 | G | 開 | RecallCount × SuccessCount；老被翻出卻沒用的自動沉底 |
| 罕見詞加權 | G | 開 | 冷門 / 特徵強詞的命中分更高，相關條更易翻出 |
| 無關時少塞 | G | 開 | 與當前提問相關性弱的記憶不注入；僅保留 Pinned 條 |
| 衝突放待審 | G | 開 | 同 S+P 但 O 不同 → 寫 ConflictHint = 舊 ID；批准時取代舊條；與 MergeHint（三元組重合 ≥ 2/3）互補 |
| judge 教訓沉澱 | G | 開 | 自檢門禁 judge 發現的問題自動落到草稿盒 |
宮殿為空（零條記錄）時，讀取路徑不呼叫 LLM 抽取檢索三元組；首輪注入只抽一次並進快取，同一 prompt 不重復計算。
6.7 設定 → 模型 → 服務提供方
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| Provider 清單 | G | AVL-Zero（共享，Delta） | 可加自定義 Provider |
| 類型 | G | AVL-Zero 預設 AVL Delta 相容，其它預設 OpenAI |
AVL Delta 相容 / OpenAI（相容）/ Anthropic（x-api-key + anthropic-version） |
| Delta 協議開關 | G | 開（AVL-Zero） | 每輪只傳增量；404/405/501 本會話一次性復原 chat/completions，401/403 不降級 |
| 新增 / 編輯 | G | — | 名稱 / 接入地址 / 憑證 |
| API Key 管理 | G | 自動下發 | 自行接入時填寫 |
| 進階 → 自定義請求標頭 | G | — | 僅自定義 Provider；多組 key/value，在內置頭之後應用，可覆蓋 Authorization / User-Agent 等；空 key 與含 CR/LF 自動跳過；Host 頭不生效 |
| 模型重新整理 | G | — | 立即按所選類型拉取模型清單 |
6.8 設定 → 模型 → 參數設定
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 未啟用模型折疊 | G | 折疊 | 每個服務提供方分組預設只顯示已啟用的；底部「展開 N 個」一鍵展開，按服務提供方各自記憶；搜尋自動繞過折疊 |
| 預設模型 | W | 由 Provider 決定 | 工作區粒度覆蓋 |
| Temperature | W·M | 0.7（瀾砥 N2.6 / N2.7：1.0） | 0–1。內置 AVL-Zero 的瀾砥 N2.6 / N2.7 一次性重設為推薦值 1.0（每模型一次，記賬於 provider yaml settings.builtin_sampling_reset_v1），之後手改不再覆蓋；「重設為預設」統一給 0.7 |
| Top-P | W·M | 0.95 | 0–1。未設定時按 0.95；瀾砥 N2.6 / N2.7 同樣一次性重設為推薦值 0.95；「重設為預設」給 0.95 |
| 上下文視窗 | W·M | 跟隨模型配置 | 模型可容納的上下文 token 總量；自動壓縮與軟閾值告警的依據 |
| 最大輸出 token | W·M | 跟隨模型配置 | 無硬性上限，超出模型標稱時以上游實際限制為準 |
| 標稱最大輸出 | W·M | 跟隨模型配置 | 模型規格宣告的輸出上限；未顯式配置「最大輸出 token」時的預設值，並參與視窗結構校驗（上下文視窗須大於它） |
| 呼叫超時 | G | 30 秒 | LLM 單次呼叫超時；填 0 = 跟隨 Provider API 設定 |
| 最大執行步數 | W·M | 0（不限） | 一次 LLM 回應或一批工具結果計 1 步；長任務建議保持 0 |
| 串流 | G | 開 | 關閉後整段輸出 |
| 思考強度 | 按模型 | 高（未設定） | 僅內置 AVL-Zero 的瀾砥 N2.7 系列；落盤 params.reasoning_effort，對該模型全部會話生效。檔位見 §19.8 |
| 支持圖片輸入 | M | 跟隨模型配置 | 勾選後該模型可隨訊息接收圖片（貼上 / 拖入 / 「+」選單）。內置標註：qwen-3.8-27b、瀾砥 N2.7 系列；未勾選時輸入框拒絕附圖並提示切換模型 |
圖片輸入限制：單條訊息最多 6 張；單張處理後 ≤ 1536 KB，合計 ≤ 3 MB；允許 PNG / JPEG / GIF / WebP；超尺寸按長邊 1568 px 等比縮放；PNG 原圖 ≤ 400 KB 且尺寸合規則原樣保留，否則轉 JPEG（質量 0.85）。執行中不可附圖發送。圖片僅隨發送它的那一輪出站（判定：該輪已正常答復且使用者有新輸入即退役；易變的上下文記錄不參與判定）。
參數編輯唯一入口：以上模型參數統一在「參數設定」抽屜裡編輯（「參數設定」頁與「服務提供方」對話框進入同一面板）。儲存校驗：輸出上限 ≥ 上下文視窗拒絕儲存；輸出上限超視窗一半給出提示（建議上下文視窗 ≥ 4 × 最大輸出）；兩處同時修改按樂觀鎖校驗，衝突就近提示。
6.8.1 設定 → 模型 → 路由策略
| 場景 | 粒度 | 可選策略 | 預設 | 說明 |
|---|---|---|---|---|
| 主會話 | G | 全域一致 / 跟隨會話 |
全域一致 | 跟隨會話：每會話記住模型，新增快照當前選擇，失效自動回落；會話自動改名同主會話 |
| 子任務 | G | 跟隨主會話 / 跟隨人設 / 優先指定模型 |
跟隨主會話 | 優先指定模型另選「不可用時」復原：跟隨主會話 / 跟隨人設；委派參數 model 僅在跟隨人設下生效 |
| 例行程序 | G | 跟隨主會話 / 自由選擇 / 優先指定模型 |
跟隨主會話 | 自由選擇 = 任務自帶模型（僅此策略下對話框顯示模型選擇）；未選或不可用時跟隨主會話 |
| Hook | G | 跟隨主會話 / 優先指定模型 |
跟隨主會話 | Hook 條目寫了 model 時以條目為準 |
| sec.decompile | G | 隨機選擇 / 成本優先 / 效果優先 |
效果優先 | 僅啟用且有 API Key 的瀾砥系列；無則用會話模型 |
| code.ask | G | 同上 | 效果優先 | 同上 |
| 記憶自動提煉 | G | 同上 | 效果優先 | 同上 |
| 自動修復 | G | 關閉 / 詢問後切換 / 自動切換 |
詢問後切換 | 選中的模型不可用（provider 不存在 / 停用 / 無此模型 / 模型停用或下線）或上游故障時，是否改用啟用了同名模型、未下線且有可用 Key 的另一 provider（按檔名順序取第一個，絕不換模型） |
| 切換後保持 | G | 開 / 關 | 關 | 策略不為「關閉」時顯示；啟用後切到的 provider 寫入會話（跟隨會話）或全域（全域一致）的模型選擇 |
- 「優先指定模型」候選：啟用、未下線、服務提供方有可用 API Key（
$VAR形式須為ZAGENT_/OPENROUTER_/OPENAI_/ANTHROPIC_/ZMCP_前綴）的模型；已選模型失效時標「(不可用)」並按復原走。 - 成本 / 效果排序：全部候選配了價格時成本按價格；否則按命名 —— 檔位 Flash < Mid < 標準、版本號越新越好、Preview /
-P2等預覽變體排在同版本正式版之後。 - 生效時機：下一次呼叫即生效；sec.decompile / code.ask 在 zWorkspace 子程序內每次現讀設定，無需重新啟動。
- 自動修復的確認條：僅 GUI 中使用者發起的發送 / 繼續生成 / 從這裡重新開始 / 有如神助可彈「切換備用模型?」確認條（「切換並傳送」/「不用」；上游故障時為「切換並重試」）；新一輪起跑時未答復的確認條作廢。
- 彈不了確認條的場景（自動續跑、IM、例行程序、子任務、Hook、上下文壓縮、SBOM、檢查項、複述意圖、經驗反省、會話命名、超長訊息摘要、記憶提煉、TUI、恢復中斷任務）：「詢問後切換」下不切換、直接報錯，toast 說明場景 / 模型 / 原因 / 策略（同場景同模型 5 分鐘內只提示一次）；會話本輪已切換過的，這些呼叫跟隨備選。本機模式下「自動切換」降為「詢問後切換」。
- 「這一輪用哪個模型」判定順序：本機模式只認會話明確選的 / 會話自身的模型 → 跟隨會話且會話記的是替使用者挑的預設 → 用當前預設模型 → 跟隨會話的會話選擇或全域一致的全域選擇 → 後端呼叫在無選擇時沿用該會話本程序最近一次的模型 → 當前預設模型（AVL-Zero /「瀾砥 N2.6」）。使用者選的模型即使不可用也原樣傳回，交給自動修復。App 自動發起的回合（壓縮續跑 / 目標續轉 / 待辦核對 / 自愈 / 測試門禁 / 任務復原 / 「繼續」）一律按此判定。
- 本機模式覆蓋：會話處於本機模式時不看上述策略 —— code.ask / sec.decompile / 記憶提煉只用會話模型；子任務用主會話模型；Hook 用觸發會話的模型（確定不了則跳過該次 Hook 模型呼叫）；發往該會話的例行程序用該會話模型。
[!warning] code.ask 的檢索片段、sec.decompile 的樣本位元組、記憶提煉的會話內容會發給路由選中的瀾砥模型（通常為內置 AVL-Zero 雲端），不一定是當前會話的模型；傳回結果中的
provider/model標明實際去向。
6.9 設定 → 外掛
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 視圖切換 | G | 已裝視圖 | 已裝 ↔ 市場，兩層麵包屑導航 |
| 已安裝清單 | G | 空 | 啟用 / 停用 / 解除安裝（行內二次確認） |
| 瀏覽市場 | G | 預設市場 | 可加 / 切換市場源；按分類、按已披露能力篩選 |
| CC 外掛適配 | G | 開 | 相容 Claude Code 外掛：github@<org>、owner/repo、git 遠端都識別 |
| 安裝前確認 | G | 開 | 攤開來源 / 命令列 / 能力 / 簽章，確認後才裝 |
| 工作區預設激活 | W | 開 | 全域外掛在每個工作區預設啟用；市場裝完即在當前工作區激活 |
| 權限設定 | G | 詢問 | 外掛可呼叫的工具範圍 |
| 自動更新 | G | 詢問 | 啟動時檢查 |
| 市場回源重新整理 | G | — | 重新拉取已新增市場源（git 重拉 / 本機重解析）；視圖露出已裝版本 + 「可升級」標記，可從市場行 / 卡片直接升級 |
| 檢查更新（已裝） | G | — | 清單頭「檢查更新」反查已裝外掛可升級項；有更新的卡片顯示「有更新」徽章 + 升級按鈕 |
| 升級機制 | G | — | 版本比對 semver 為主 + 差異兜底；升級前清空外掛目錄防舊元件殘留；市場快取原子換盤、失敗可復原 |
| 行內進度 | G | — | 安裝 / 升級 / 預覽 / 更新 / 新增顯示行內進度列（解析 git clone 真實進度）；更新 / 檢查更新按鈕為原地旋轉重新整理圖示 |
| 來源可信盾牌 | G | — | 外掛卡片作者旁標示來源可信狀態（與 zMarket 商店同款）；服務提供方條目復用所屬外掛圖示，「外掛」徽標為中性描邊 |
| 匯入身份 | G | — | zip 匯入的外掛名取自簽章 manifest 而非檔名；與既有外掛同名的 zip 不再靜默復用舊目錄 |
典型外掛目錄：官方外掛市集提供 22 個典型外掛（原始碼隨倉庫維護） — 15 家服務提供方（DeepSeek / OpenRouter / OpenCode Zen / OpenCode Go / MiniMax / 小米 MiMo 按量+Token Plan / 智譜 / 月之暗面 / 通義千問 / 豆包 / Ollama / 矽基流動 / 階躍星辰 / OpenAI 相容模板）+ 知乎工具集 + 4 個原生能力示範（tools / hooks / channels / skills）+ 2 個 CC 相容格式示範（agents+commands、mcp+hooks）。 對話內外掛管理：
PluginSearch/PluginList/PluginInstall/PluginUninstall四個工具可在會話中完成外掛生命週期，寫入類走 dry_run → confirm 兩步確認（見 §11.1 註）。
6.10 設定 → Hooks
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 工具呼叫前確認 | W·M | 見各工具 | 三態：啟用 / 詢問 / 停用 |
| 自動批准清單 | W | 空 | 「始終允許」寫入此處 |
| 工具黑名單 | W·M | 空 | 強制停用某些工具 |
| 錯誤抽屜 | W | — | 自動保留最近 100 條 |
| Hook 執行可見 | — | 開 | 每次掛鉤執行都在對話流出系統訊息（折疊條，Markdown 渲染） |
| 外掛 hook 根目錄 | — | 自動 | CLAUDE_PLUGIN_ROOT 指向外掛目錄，SessionStart 等 hook 穩定觸發 |
6.11 設定 → Agents
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| Agent 清單 | G | 5 個內置 + 使用者自定義 | 來源標籤：內置 / 全域 / 工作區 |
| 名稱 | G | 內置名 | 顯示用 |
| 個性 | G | 內置 | 短句風格 |
| 系統提示詞 | G | 內置 | 可指向工作區下文件 |
| 模式綁定 | W | 預設對應 | 五種模式各自指派一位 |
| 編輯 / 複製 / 刪除 | G | — | 僅全域 / 工作區來源可編輯 |
6.11.1 設定 → 自省（智慧體組新頁）
把「自主與自省」相關的三個開關集中到一處（tab id reflection，圖示 Brain，隸屬智慧體組）。
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 復述意圖（開工前確認） | G | 開 | 落盤鍵 intent_confirm（schema v8，預設 true）。僅對親手輸入的首條訊息、且短（≤30 字 shortFirstMsgRunes）或簡單（非多行 / 非清單、分隔符 ≤3、≤80 字 simpleMaxRunes）時觸發；多 Agent 模式給分階段計畫。確認條三選：確認開始 / 修改（目標+計畫）/ 保留我的本意（intent.confirm.keepOriginal，用原訊息繼續）。訊息選單「分析意圖並從這裡重新開始」可強制觸發（先隱藏重新啟動點之後訊息）。詳見使用者手冊「會話」節 §5.4.1 |
| 意圖復述選擇統計 | G | — | 獨立 YAML 記錄確認 / 修改 / 保留本意 / 超時自動開始 / 取消的次數與字數；在本頁以表格展示（列：類別 / 次數 / 字數） |
| 自動反省（復盤學習） | G | 關 | 落盤鍵 auto_reflect。多步任務收尾自動跑一次 GRAI+KISS 復盤（讀軌跡 + 自愈統計），把 Keep/Improve/Stop/Start 教訓沉澱到記憶待審；有 LLM 呼叫成本（見 §18.6） |
| 自動復原被中斷的任務 | G | 關 | 落盤鍵 auto_resume_tasks。啟用後重新啟動自動續跑上次當機 / 被殺時未完成的背景任務（夜間無人值守），啟動每次最多自動復原 5 個、其餘轉手動；關閉時仍在會話狀態條「中斷任務」項裡列出供手動復原（見 §18.4） |
這三項原在「一般」頁，本版起遷入「自省」頁。
6.12 設定 → 技能
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 技能清單 | G + W | 內置技能空 | 三層來源（全域 / 工作區 / 外掛）；內置技能（如 skill-creator）標「內置」徽標 |
| 載入政策 | W | 自動 | 啟動時重新整理；內置技能啟動自動物化、漂移覆蓋 |
| 安裝 / 刪除 | G | — | 拖入資料夾或掃描目錄 |
簽章校驗、簽章驗證政策與信任庫已遷至獨立的 設定 → 技能/外掛簽章 Tab（安全分組，見 §6.17.1）。
6.13 設定 → 例行程序
本頁只管理工作區例行程序（每次執行生成新會話）。AI 在會話裡用
RoutineCreate掛的會話內例行程序不在此頁顯示，見 §18.7。
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 清單 | G | 空 | 按來源工作區分組 |
| 啟停開關 | G | 開 | 與其它設定頁同款 ui/Switch |
| 立即執行 | G | — | 不等計畫，立刻跑一輪 |
| 最近執行痕跡 | G | — | 行內展開，可逐條檢視會話 |
| 跨工作區分組 | G | — | 未開啟工作區顯示徽標 + 一鍵開啟 |
| 搜尋 | G | — | 按例行程序名或工作區名 |
調度參數：
| 欄位 | 類型 | 預設 | 說明 |
|---|---|---|---|
type |
enum | manual | hourly / daily / weekdays / weekly / manual |
weekdays |
array | — | [1..7]；預設「工作日」/「週末」一鍵 |
time (HH:MM) |
string | — | 時 / 分雙列下拉（選中置中、選完分鐘自動收起）。hourly 只看分鐘，小時鎖 00、觸發器顯 :MM；NextRun 取 after 之後最近該分鐘點，撞上 / 已過則 +1h，跨日 / DST 用時間算術天然正確 |
command |
string | — | 觸發時發給 AI 的指令內容 |
mode |
string | auto | 與正常會話同款五種模式 |
model |
string | — | 與正常會話同款選擇器（搜尋分組） |
執行行為：
- 每次執行在對應工作區生成正常會話，過程與結果可回看。
- 同一條例行程序執行中自動跳過下一次觸發，不會疊跑。
- 手動模式（無計畫）儲存後立即觸發一輪，按鈕顯示「執行一次」。
6.14 設定 → 隨行通訊
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
| 通道 | G | 微信 | 同時支持微信 / 飛書 / 釘釘 |
| 掃碼登入 | G | — | 各通道獨立掃碼 |
| 綁定碼 | W | 6 位數字 | 10 分鐘 TTL |
| 工作區路由 | W | 預設會話 | 見 §4.2 |
| 節流 | G | min 200 / idle 3s / max 3800 | 字數控制 |
| 解除綁定 | W | — | 立即失效 |
6.15 設定 → 資料脫敏
落盤 ~/.config/avlcode/redaction.yaml；主程式與子程序共用 pkg/redact 引擎。
| 項 | 粒度 | 預設 | 說明 |
|---|---|---|---|
總開關 enabled |
G | 關 | opt-in；關閉時所有場景一律放行 |
場景 scopes.export_html |
G | 開（總開關後） | 會話匯出 HTML 時套用；規則對解碼後的 JSON 文字值生效並遞歸下鑽嵌套 JSON（覆蓋工具呼叫參數與結果），修了程式碼區塊行首 IP 與深層欄位漏脫敏 |
場景 scopes.export_session |
G | 開（總開關後） | .zsession 匯出時套用（同上，覆蓋程式碼區塊行首 IP） |
場景 scopes.write_md |
G | 關 | AI 寫 .md 等文件類落盤脫敏（Phase 2） |
內置 presets.secrets |
G | 關 | 內置金鑰規則包（見下） |
自定義規則 rules[] |
G | 空 | 使用者規則 + presets 並集為最終編譯輸入 |
Rule 欄位：
| 欄位 | 類型 | 說明 |
|---|---|---|
type |
enum | keyword / regex / ipv4_mask / domain_mask |
pattern |
string | keyword 自動轉義；regex RE2 |
replacement |
string | keyword 字面常數；regex 支持 $1 / ${name} 捕獲模板 |
octets |
int[] | ipv4_mask 要遮的段（1-based，1..4，任意段含中間） |
segments |
int | ipv4_mask 相容舊配置：掩前 N 段 |
keepLast |
int | domain_mask 保留末尾幾段（預設 1） |
maskChar |
string | ipv4 / domain 掩碼字元（預設 *） |
enabled |
bool | 啟停單條 |
label |
string | 命中稽核用 |
內置 secrets 預設清單：AWS Access Key（AKIA…）/ GitHub PAT (ghp_…) / GitHub Token (gh[osu]_…) / Slack Token (xox[baprs]-…) / Stripe Live Key (sk_live_…) / GCP API Key (AIza…) / OpenAI Key (sk-…) / PEM 私鑰整塊（含頭尾與中間 base64，跨行）。
命中回饋：每次脫敏完成時彈一條 toast — 命中條數 + 命中規則 label 清單。
6.16 設定 → 供應鏈 / SBOM
為 sbom.audit / sbom.vex 配置漏洞庫資料源與本機離線庫：
- 落盤
<config>/sbom.json；欄位留空 = 內置預設（直連公網）；壞 / 缺 JSON 安全回退預設，絕不阻塞稽核。 - 儲存按鈕為「測試並儲存」：先校驗合法性（URL 須 http/https、代理 http/https/socks5、路徑無空位元組），再按
default_mode探測可用性（本機庫路徑可寫性始終阻斷式，離線模式跳過連網探測）；任一阻斷項不可用拒絕儲存並列出原因。 - 本機漏洞庫路徑等離線欄位歸入「離線漏洞庫」區；相對路徑測試時規範為絕對路徑回寫。
- 「重設為預設」僅改表單、不落盤，需再點「測試並儲存」才生效。
- 後端綁定：
SBOMGetSettings/SBOMSetSettings/SBOMSyncDB/SBOMOpenVulnDBDir/SBOMTestSettings。
資料源（Data sources）：
| 項 | 落盤鍵 | 預設 | 說明 |
|---|---|---|---|
| OSV 線上查詢 API | osv_api_base_url |
https://api.osv.dev |
線上稽核的查詢端點 |
| OSV 離線 dump 源 | osv_bucket_url |
https://osv-vulnerabilities.storage.googleapis.com |
dbsync sync 拉取按生態 dump 的存儲桶 |
| KEV 名錄源 | kev_url |
CISA KEV feed | 已知被利用漏洞名錄地址 |
| 本機漏洞庫路徑 | vulndb_path |
<config>/vulndb |
離線庫目錄，可指向只讀掛載；附「開啟資料夾」 |
| HTTP 代理 | http_proxy |
空 | 留空回落 HTTPS_PROXY / NO_PROXY 環境變數 |
| 預設稽核來源 | default_mode |
auto |
auto（本機有函式庫則離線、否則線上）/ online / offline |
離線庫（Offline DB）： 按生態表格展示「生態 / 記錄數 / 新鮮度（unknown / today / Nd ago）/ 來源」，並列出 KEV 條目數；提供按生態多選下拉（含篩選、全選 / 清空）驅動 同步（每生態獨立進度列）與 同步 KEV 按鈕。可同步的生態來自後端 SyncableEcosystems（13 個有 OSV 離線 dump 覆蓋的生態）。
air-gap 提示：把上面各源指向內部鏡像（必要時配代理），再用
sbom.dbsync sync或離線import填好本機庫，audit/vex即可全程離線。
6.17 設定 → 安全（威脅檢測 · 哨兵 · VT/GTI）
VirusTotal / GTI 雲端威脅情報的配置頁（tab id security）。落盤 <config>/vtai.yaml；金鑰本機加密存儲。檢測能力與哨兵攔截解耦——配好後端 / YARA 即可讓 Agent 呼叫掃描工具，無需開攔截。四段：
① 威脅檢測
| 項 | 落盤鍵 | 預設 | 說明 |
|---|---|---|---|
| 雲端檢測服務（單選） | mode |
空（不啟用） | vtai＝VirusTotal AI·免費託管（雜湊 / 可疑文件上傳公開分析、別名上榜）；user_key＝Google Threat Intelligence·自帶 Key（結果不公開，需下方填 Key，無可用 Key 時置灰）；""＝不使用雲端。舊 local 遷移為 ""+yara_enabled |
| 上傳文件到雲端掃描 | auto_scan |
關 | 開＝允許上傳做完整掃描（金鑰 / .env 等敏感文件始終不傳）；關＝只查雜湊 |
| 本機 YARA 規則 | yara_enabled |
關 | 獨立開關，純離線；可與雲端同開；改規則目錄後工作區重新啟動才重載（不熱載入） |
| 恢復預設 | — | — | 非破壞：mode="" + auto_scan=false，保留 Key / 註冊 / api_base / full_tools |
| 重新獲取 Key（VirusTotal AI） | — | — | RefreshVTAIKey：用現有身份重註冊取新 token（換機 / 輪換時用） |
② 自動掃描攔截 · 哨兵（Sentinel）：單開關（合並 enabled+monitor），啟用後 Agent 讀 / 寫 / 執行文件自動掃描、命中即阻斷；未設定任一檢測方式時置灰（capable = mode≠"" 或 yara_enabled）。
③ Google Threat Intelligence 金鑰：API Key（本機加密，user_key 雲端與 vt.* 共用；單填不啟用任何功能）+ 自定義服務地址（預設 https://www.virustotal.com/api/v3，對接企業 / 內網鏡像）。VirusTotal AI 免費託管後端也支持各自獨立的自定義接入點（與 GTI 的地址相互獨立）。顯示名統一為全稱 VirusTotal AI / Google Threat Intelligence。
④ vt. 全量情報工具*：主開關（無可用 Key 置灰）+ 子開關 僅查詢模式（預設開）/ 啟用收費功能（預設關）/ 上傳樣本前確認（預設開，僅「僅查詢」關時出現）；啟用後顯示「當前有效：僅查詢|讀寫 · 含收費|僅免費 · 自定義端點」摘要。
面板文案為硬編碼簡體，無 i18n；後端 Wails：
GetVTAIState/SetVTAIMode/SetVTAIYaraEnabled/RefreshVTAIKey/GetVTAILeaderboard、GetVTFullToolsState/SetVTFullToolsPolicy/SetVTFullToolsAPIKey/SetVTFullToolsAPIBase；HasAPIKey用KeyUsable。
6.17.1 設定 → 技能/外掛簽章（獨立 Tab）
簽章驗證政策與信任庫從「安全」「技能」兩頁集中遷到此獨立 Tab（安全分組，tab id signatures），一份政策同時管住技能與外掛：
① 簽章驗證政策（三檔，切換時自愈歷史遺留的不一致狀態）：
| 檔位 | 語義 |
|---|---|
strict · 嚴格 |
未簽章或驗證失敗的技能 / 外掛不載入、不安裝 |
warn · 警告 |
驗證失敗仍可放行，但在 UI 上標記；「來源不可證實」的包改為彈確認、由使用者決定是否放行，存在篡改證據的包仍硬性攔截 |
skip · 跳過 |
不執行密碼學校驗，僅讀取 manifest 元資料 |
② 信任庫：
| 項 | 說明 |
|---|---|
| 信任庫路徑 | 預設路徑 / 自定義路徑均可；signer_roots/ 放簽章根 CA PEM、tsa_roots/ 放 TSA 根 CA（完整驗證時間戳記） |
| 重新載入 | 手動重載按鈕 + 自動重載；投放憑證後即時生效，無需重新啟動 |
| 匯入根憑證（PEM） | 文件選擇器匯入，寫入信任庫並立即計入簽章者錨 / TSA 錨計數 |
| 錨點計數 | 面板顯示「🔑 簽章者錨 N · 🕒 TSA 錨 N」，可一鍵開啟信任庫目錄 |
拒絕 / 匯入失敗時透出具體原因（簽章鏈、時間戳記、篡改點），不是籠統報錯。