@saluzi/saluzi-edu 0.2.36 → 0.2.38

package/dist/guide/guide-data.json

@@ -27,6 +27,10 @@
           "title": "查看消耗",
           "path": "docs/guide/cost-usage"
         },
+        {
+          "title": "主目录与配置",
+          "path": "docs/guide/saluzi-home"
+        },
         {
           "title": "排障",
           "path": "docs/guide/troubleshooting"
@@ -40,6 +44,10 @@
           "title": "OMS 工作流",
           "path": "docs/guide/oms-workflow"
         },
+        {
+          "title": "记忆系统",
+          "path": "docs/guide/memory-system"
+        },
         {
           "title": "CodeGraph 代码智能",
           "path": "docs/guide/codegraph"
@@ -79,33 +87,40 @@
       "commands": [
         {
           "name": "btw",
-          "description": "Ask a quick side question without interrupting the main conversation"
+          "description": "Ask a quick side question without interrupting the main conversation",
+          "descriptionZh": "插话提问，不打断主对话"
         },
         {
           "name": "exit",
           "description": "Exit the REPL",
+          "descriptionZh": "退出 REPL",
           "aliases": [
             "quit"
           ]
         },
         {
           "name": "help",
-          "description": "Show help and available commands"
+          "description": "Show help and available commands",
+          "descriptionZh": "显示帮助与可用命令"
         },
         {
           "name": "keys",
-          "description": "Manage API keys and bind them to model slots"
+          "description": "Manage API keys and bind them to model slots",
+          "descriptionZh": "管理 API Key 并绑定到模型槽位"
         },
         {
-          "name": "login"
+          "name": "login",
+          "descriptionZh": "登录 Saluzi 账户或切换账户"
         },
         {
           "name": "logout",
-          "description": "Sign out from your Saluzi account"
+          "description": "Sign out from your Saluzi account",
+          "descriptionZh": "退出 Saluzi 账户"
         },
         {
           "name": "mobile",
           "description": "Show QR code to download the Saluzi mobile app",
+          "descriptionZh": "显示二维码下载 Saluzi 移动 App",
           "aliases": [
             "ios",
             "android"
@@ -113,15 +128,18 @@
         },
         {
           "name": "stats",
-          "description": "Show your Saluzi usage statistics and activity"
+          "description": "Show your Saluzi usage statistics and activity",
+          "descriptionZh": "显示 Saluzi 用量统计与活动"
         },
         {
           "name": "status",
-          "description": "Show Saluzi status including version, model, account, API connectivity, and tool statuses"
+          "description": "Show Saluzi status including version, model, account, API connectivity, and tool statuses",
+          "descriptionZh": "显示 Saluzi 状态：版本、模型、账户、API 与工具"
         },
         {
           "name": "stickers",
-          "description": "Order Saluzi stickers"
+          "description": "Order Saluzi stickers",
+          "descriptionZh": "订购 Saluzi 贴纸"
         }
       ]
     },
@@ -133,6 +151,7 @@
         {
           "name": "clear",
           "description": "Clear conversation history and free up context",
+          "descriptionZh": "清空对话历史并释放上下文",
           "aliases": [
             "reset",
             "new"
@@ -140,26 +159,32 @@
         },
         {
           "name": "compact",
-          "description": "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]"
+          "description": "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]",
+          "descriptionZh": "清空对话历史但保留摘要"
         },
         {
           "name": "effort",
-          "description": "Set effort level for model usage"
+          "description": "Set effort level for model usage",
+          "descriptionZh": "设置模型推理深度"
         },
         {
           "name": "export",
-          "description": "Export the current conversation to a file or clipboard"
+          "description": "Export the current conversation to a file or clipboard",
+          "descriptionZh": "导出当前对话到文件或剪贴板"
         },
         {
-          "name": "model"
+          "name": "model",
+          "descriptionZh": "切换当前会话模型"
         },
         {
           "name": "poor",
-          "description": "Toggle poor mode — disable extract_memories and prompt_suggestion to save tokens"
+          "description": "Toggle poor mode — disable extract_memories and prompt_suggestion to save tokens",
+          "descriptionZh": "切换节约模式：关闭记忆提取与提示建议"
         },
         {
           "name": "resume",
           "description": "Resume a previous conversation",
+          "descriptionZh": "恢复之前的对话",
           "aliases": [
             "continue"
           ]
@@ -167,17 +192,20 @@
         {
           "name": "rewind",
           "description": "Restore the code and/or conversation to a previous point",
+          "descriptionZh": "将代码或对话恢复到之前的节点",
           "aliases": [
             "checkpoint"
           ]
         },
         {
           "name": "skill-search",
-          "description": "Control automatic skill matching during conversations"
+          "description": "Control automatic skill matching during conversations",
+          "descriptionZh": "控制对话中的自动技能匹配"
         },
         {
           "name": "summary",
-          "description": "Generate and display a session summary"
+          "description": "Generate and display a session summary",
+          "descriptionZh": "生成并显示会话摘要"
         }
       ]
     },
@@ -188,26 +216,31 @@
       "commands": [
         {
           "name": "add-dir",
-          "description": "Add a new working directory"
+          "description": "Add a new working directory",
+          "descriptionZh": "添加新的工作目录"
         },
         {
           "name": "branch",
           "description": "Create a branch of the current conversation at this point",
+          "descriptionZh": "在当前节点创建对话分支",
           "aliases": [
             "fork"
           ]
         },
         {
           "name": "copy",
-          "description": "Copy Saluzi"
+          "description": "Copy Saluzi",
+          "descriptionZh": "复制最近一条回复到剪贴板"
         },
         {
           "name": "diff",
-          "description": "View uncommitted changes and per-turn diffs"
+          "description": "View uncommitted changes and per-turn diffs",
+          "descriptionZh": "查看未提交改动与每轮 diff"
         },
         {
           "name": "rename",
-          "description": "Rename the current conversation"
+          "description": "Rename the current conversation",
+          "descriptionZh": "重命名当前对话"
         }
       ]
     },
@@ -218,46 +251,56 @@
       "commands": [
         {
           "name": "agents",
-          "description": "Manage agent configurations"
+          "description": "Manage agent configurations",
+          "descriptionZh": "管理 agent 配置"
         },
         {
           "name": "guide",
           "description": "Start a local web server with the Saluzi usage guide (opens browser)",
+          "descriptionZh": "启动本地 Web 服务器并打开使用指南",
           "aliases": [
             "docs"
           ]
         },
         {
           "name": "hooks",
-          "description": "View hook configurations for tool events"
+          "description": "View hook configurations for tool events",
+          "descriptionZh": "查看工具事件的 hook 配置"
         },
         {
           "name": "ide",
-          "description": "Manage IDE integrations and show status"
+          "description": "Manage IDE integrations and show status",
+          "descriptionZh": "管理 IDE 集成并显示状态"
         },
         {
           "name": "job",
-          "description": "Manage template jobs"
+          "description": "Manage template jobs",
+          "descriptionZh": "管理模板任务"
         },
         {
           "name": "mcp",
-          "description": "Manage MCP servers"
+          "description": "Manage MCP servers",
+          "descriptionZh": "管理 MCP 服务器"
         },
         {
           "name": "pr-comments",
-          "description": "Get comments from a GitHub pull request"
+          "description": "Get comments from a GitHub pull request",
+          "descriptionZh": "获取 GitHub PR 的评论"
         },
         {
           "name": "reload-plugins",
-          "description": "Activate pending plugin changes in the current session"
+          "description": "Activate pending plugin changes in the current session",
+          "descriptionZh": "在当前会话激活待生效的插件改动"
         },
         {
           "name": "skill-learning",
-          "description": "Manage skill learning (observe, analyze, evolve)"
+          "description": "Manage skill learning (observe, analyze, evolve)",
+          "descriptionZh": "管理技能学习（观察、分析、演进）"
         },
         {
           "name": "skills",
-          "description": "List available skills"
+          "description": "List available skills",
+          "descriptionZh": "列出可用技能"
         }
       ]
     },
@@ -268,22 +311,26 @@
       "commands": [
         {
           "name": "doctor",
-          "description": "Diagnose and verify your Saluzi installation and settings"
+          "description": "Diagnose and verify your Saluzi installation and settings",
+          "descriptionZh": "诊断并校验 Saluzi 安装与设置"
         },
         {
           "name": "memory",
-          "description": "Edit Saluzi memory files"
+          "description": "Edit Saluzi memory files",
+          "descriptionZh": "编辑 Saluzi 记忆文件"
         },
         {
           "name": "permissions",
           "description": "Manage allow & deny tool permission rules",
+          "descriptionZh": "管理工具的允许与拒绝权限规则",
           "aliases": [
             "allowed-tools"
           ]
         },
         {
           "name": "plan",
-          "description": "Enable plan mode or view the current session plan"
+          "description": "Enable plan mode or view the current session plan",
+          "descriptionZh": "启用规划模式或查看当前会话计划"
         }
       ]
     },
@@ -294,30 +341,36 @@
       "commands": [
         {
           "name": "color",
-          "description": "Set the prompt bar color for this session"
+          "description": "Set the prompt bar color for this session",
+          "descriptionZh": "设置本次会话的提示栏颜色"
         },
         {
           "name": "config",
           "description": "Open config panel",
+          "descriptionZh": "打开配置面板",
           "aliases": [
             "settings"
           ]
         },
         {
           "name": "keybindings",
-          "description": "Open or create your keybindings configuration file"
+          "description": "Open or create your keybindings configuration file",
+          "descriptionZh": "打开或创建快捷键配置文件"
         },
         {
           "name": "lang",
-          "description": "Set display language (en/zh/auto)"
+          "description": "Set display language (en/zh/auto)",
+          "descriptionZh": "设置显示语言（en/zh/auto）"
         },
         {
           "name": "theme",
-          "description": "Change the theme"
+          "description": "Change the theme",
+          "descriptionZh": "切换主题"
         },
         {
           "name": "vim",
-          "description": "Toggle between Vim and Normal editing modes"
+          "description": "Toggle between Vim and Normal editing modes",
+          "descriptionZh": "在 Vim 与普通编辑模式间切换"
         }
       ]
     },
@@ -328,19 +381,23 @@
       "commands": [
         {
           "name": "daemon",
-          "description": "Manage background sessions and daemon"
+          "description": "Manage background sessions and daemon",
+          "descriptionZh": "管理后台会话与守护进程"
         },
         {
           "name": "mom",
-          "description": "Mixture of Model (MOM) — configure a hybrid model (multiple advisors + one host) or run a one-shot MOM turn"
+          "description": "Mixture of Model (MOM) — configure a hybrid model (multiple advisors + one host) or run a one-shot MOM turn",
+          "descriptionZh": "混合模型（MOM）：配置多顾问+单主机"
         },
         {
           "name": "parade",
-          "description": "Start desktop overlay showing session status cube (running/waiting counts). Use /parade off to stop."
+          "description": "Start desktop overlay showing session status cube (running/waiting counts). Use /parade off to stop.",
+          "descriptionZh": "启动桌面悬浮窗显示会话状态立方体"
         },
         {
           "name": "tasks",
           "description": "List and manage background tasks",
+          "descriptionZh": "列出并管理后台任务",
           "aliases": [
             "bashes"
           ]
@@ -355,6 +412,7 @@
         {
           "name": "remote-control-server",
           "description": "Start a self-hosted Remote Control Server with Web UI (requires RCS_API_KEYS)",
+          "descriptionZh": "启动自托管远程控制服务器（含 Web UI）",
           "aliases": [
             "rcs"
           ]
@@ -365,26 +423,31 @@
   "commands": {
     "add-dir": {
       "name": "add-dir",
-      "description": "Add a new working directory"
+      "description": "Add a new working directory",
+      "descriptionZh": "添加新的工作目录"
     },
     "agents": {
       "name": "agents",
-      "description": "Manage agent configurations"
+      "description": "Manage agent configurations",
+      "descriptionZh": "管理 agent 配置"
     },
     "branch": {
       "name": "branch",
       "description": "Create a branch of the current conversation at this point",
+      "descriptionZh": "在当前节点创建对话分支",
       "aliases": [
         "fork"
       ]
     },
     "btw": {
       "name": "btw",
-      "description": "Ask a quick side question without interrupting the main conversation"
+      "description": "Ask a quick side question without interrupting the main conversation",
+      "descriptionZh": "插话提问，不打断主对话"
     },
     "clear": {
       "name": "clear",
       "description": "Clear conversation history and free up context",
+      "descriptionZh": "清空对话历史并释放上下文",
       "aliases": [
         "reset",
         "new"
@@ -392,156 +455,190 @@
     },
     "color": {
       "name": "color",
-      "description": "Set the prompt bar color for this session"
+      "description": "Set the prompt bar color for this session",
+      "descriptionZh": "设置本次会话的提示栏颜色"
     },
     "compact": {
       "name": "compact",
-      "description": "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]"
+      "description": "Clear conversation history but keep a summary in context. Optional: /compact [instructions for summarization]",
+      "descriptionZh": "清空对话历史但保留摘要"
     },
     "config": {
       "name": "config",
       "description": "Open config panel",
+      "descriptionZh": "打开配置面板",
       "aliases": [
         "settings"
       ]
     },
     "copy": {
       "name": "copy",
-      "description": "Copy Saluzi"
+      "description": "Copy Saluzi",
+      "descriptionZh": "复制最近一条回复到剪贴板"
     },
     "daemon": {
       "name": "daemon",
-      "description": "Manage background sessions and daemon"
+      "description": "Manage background sessions and daemon",
+      "descriptionZh": "管理后台会话与守护进程"
     },
     "diff": {
       "name": "diff",
-      "description": "View uncommitted changes and per-turn diffs"
+      "description": "View uncommitted changes and per-turn diffs",
+      "descriptionZh": "查看未提交改动与每轮 diff"
     },
     "doctor": {
       "name": "doctor",
-      "description": "Diagnose and verify your Saluzi installation and settings"
+      "description": "Diagnose and verify your Saluzi installation and settings",
+      "descriptionZh": "诊断并校验 Saluzi 安装与设置"
     },
     "effort": {
       "name": "effort",
-      "description": "Set effort level for model usage"
+      "description": "Set effort level for model usage",
+      "descriptionZh": "设置模型推理深度"
     },
     "exit": {
       "name": "exit",
       "description": "Exit the REPL",
+      "descriptionZh": "退出 REPL",
       "aliases": [
         "quit"
       ]
     },
     "export": {
       "name": "export",
-      "description": "Export the current conversation to a file or clipboard"
+      "description": "Export the current conversation to a file or clipboard",
+      "descriptionZh": "导出当前对话到文件或剪贴板"
     },
     "guide": {
       "name": "guide",
       "description": "Start a local web server with the Saluzi usage guide (opens browser)",
+      "descriptionZh": "启动本地 Web 服务器并打开使用指南",
       "aliases": [
         "docs"
       ]
     },
     "help": {
       "name": "help",
-      "description": "Show help and available commands"
+      "description": "Show help and available commands",
+      "descriptionZh": "显示帮助与可用命令"
     },
     "hooks": {
       "name": "hooks",
-      "description": "View hook configurations for tool events"
+      "description": "View hook configurations for tool events",
+      "descriptionZh": "查看工具事件的 hook 配置"
     },
     "ide": {
       "name": "ide",
-      "description": "Manage IDE integrations and show status"
+      "description": "Manage IDE integrations and show status",
+      "descriptionZh": "管理 IDE 集成并显示状态"
     },
     "job": {
       "name": "job",
-      "description": "Manage template jobs"
+      "description": "Manage template jobs",
+      "descriptionZh": "管理模板任务"
     },
     "keybindings": {
       "name": "keybindings",
-      "description": "Open or create your keybindings configuration file"
+      "description": "Open or create your keybindings configuration file",
+      "descriptionZh": "打开或创建快捷键配置文件"
     },
     "keys": {
       "name": "keys",
-      "description": "Manage API keys and bind them to model slots"
+      "description": "Manage API keys and bind them to model slots",
+      "descriptionZh": "管理 API Key 并绑定到模型槽位"
     },
     "lang": {
       "name": "lang",
-      "description": "Set display language (en/zh/auto)"
+      "description": "Set display language (en/zh/auto)",
+      "descriptionZh": "设置显示语言（en/zh/auto）"
     },
     "login": {
-      "name": "login"
+      "name": "login",
+      "descriptionZh": "登录 Saluzi 账户或切换账户"
     },
     "logout": {
       "name": "logout",
-      "description": "Sign out from your Saluzi account"
+      "description": "Sign out from your Saluzi account",
+      "descriptionZh": "退出 Saluzi 账户"
     },
     "mcp": {
       "name": "mcp",
-      "description": "Manage MCP servers"
+      "description": "Manage MCP servers",
+      "descriptionZh": "管理 MCP 服务器"
     },
     "memory": {
       "name": "memory",
-      "description": "Edit Saluzi memory files"
+      "description": "Edit Saluzi memory files",
+      "descriptionZh": "编辑 Saluzi 记忆文件"
     },
     "mobile": {
       "name": "mobile",
       "description": "Show QR code to download the Saluzi mobile app",
+      "descriptionZh": "显示二维码下载 Saluzi 移动 App",
       "aliases": [
         "ios",
         "android"
       ]
     },
     "model": {
-      "name": "model"
+      "name": "model",
+      "descriptionZh": "切换当前会话模型"
     },
     "mom": {
       "name": "mom",
-      "description": "Mixture of Model (MOM) — configure a hybrid model (multiple advisors + one host) or run a one-shot MOM turn"
+      "description": "Mixture of Model (MOM) — configure a hybrid model (multiple advisors + one host) or run a one-shot MOM turn",
+      "descriptionZh": "混合模型（MOM）：配置多顾问+单主机"
     },
     "parade": {
       "name": "parade",
-      "description": "Start desktop overlay showing session status cube (running/waiting counts). Use /parade off to stop."
+      "description": "Start desktop overlay showing session status cube (running/waiting counts). Use /parade off to stop.",
+      "descriptionZh": "启动桌面悬浮窗显示会话状态立方体"
     },
     "permissions": {
       "name": "permissions",
       "description": "Manage allow & deny tool permission rules",
+      "descriptionZh": "管理工具的允许与拒绝权限规则",
       "aliases": [
         "allowed-tools"
       ]
     },
     "plan": {
       "name": "plan",
-      "description": "Enable plan mode or view the current session plan"
+      "description": "Enable plan mode or view the current session plan",
+      "descriptionZh": "启用规划模式或查看当前会话计划"
     },
     "poor": {
       "name": "poor",
-      "description": "Toggle poor mode — disable extract_memories and prompt_suggestion to save tokens"
+      "description": "Toggle poor mode — disable extract_memories and prompt_suggestion to save tokens",
+      "descriptionZh": "切换节约模式：关闭记忆提取与提示建议"
     },
     "pr-comments": {
       "name": "pr-comments",
-      "description": "Get comments from a GitHub pull request"
+      "description": "Get comments from a GitHub pull request",
+      "descriptionZh": "获取 GitHub PR 的评论"
     },
     "reload-plugins": {
       "name": "reload-plugins",
-      "description": "Activate pending plugin changes in the current session"
+      "description": "Activate pending plugin changes in the current session",
+      "descriptionZh": "在当前会话激活待生效的插件改动"
     },
     "remote-control-server": {
       "name": "remote-control-server",
       "description": "Start a self-hosted Remote Control Server with Web UI (requires RCS_API_KEYS)",
+      "descriptionZh": "启动自托管远程控制服务器（含 Web UI）",
       "aliases": [
         "rcs"
       ]
     },
     "rename": {
       "name": "rename",
-      "description": "Rename the current conversation"
+      "description": "Rename the current conversation",
+      "descriptionZh": "重命名当前对话"
     },
     "resume": {
       "name": "resume",
       "description": "Resume a previous conversation",
+      "descriptionZh": "恢复之前的对话",
       "aliases": [
         "continue"
       ]
@@ -549,52 +646,63 @@
     "rewind": {
       "name": "rewind",
       "description": "Restore the code and/or conversation to a previous point",
+      "descriptionZh": "将代码或对话恢复到之前的节点",
       "aliases": [
         "checkpoint"
       ]
     },
     "skill-learning": {
       "name": "skill-learning",
-      "description": "Manage skill learning (observe, analyze, evolve)"
+      "description": "Manage skill learning (observe, analyze, evolve)",
+      "descriptionZh": "管理技能学习（观察、分析、演进）"
     },
     "skill-search": {
       "name": "skill-search",
-      "description": "Control automatic skill matching during conversations"
+      "description": "Control automatic skill matching during conversations",
+      "descriptionZh": "控制对话中的自动技能匹配"
     },
     "skills": {
       "name": "skills",
-      "description": "List available skills"
+      "description": "List available skills",
+      "descriptionZh": "列出可用技能"
     },
     "stats": {
       "name": "stats",
-      "description": "Show your Saluzi usage statistics and activity"
+      "description": "Show your Saluzi usage statistics and activity",
+      "descriptionZh": "显示 Saluzi 用量统计与活动"
     },
     "status": {
       "name": "status",
-      "description": "Show Saluzi status including version, model, account, API connectivity, and tool statuses"
+      "description": "Show Saluzi status including version, model, account, API connectivity, and tool statuses",
+      "descriptionZh": "显示 Saluzi 状态：版本、模型、账户、API 与工具"
     },
     "stickers": {
       "name": "stickers",
-      "description": "Order Saluzi stickers"
+      "description": "Order Saluzi stickers",
+      "descriptionZh": "订购 Saluzi 贴纸"
     },
     "summary": {
       "name": "summary",
-      "description": "Generate and display a session summary"
+      "description": "Generate and display a session summary",
+      "descriptionZh": "生成并显示会话摘要"
     },
     "tasks": {
       "name": "tasks",
       "description": "List and manage background tasks",
+      "descriptionZh": "列出并管理后台任务",
       "aliases": [
         "bashes"
       ]
     },
     "theme": {
       "name": "theme",
-      "description": "Change the theme"
+      "description": "Change the theme",
+      "descriptionZh": "切换主题"
     },
     "vim": {
       "name": "vim",
-      "description": "Toggle between Vim and Normal editing modes"
+      "description": "Toggle between Vim and Normal editing modes",
+      "descriptionZh": "在 Vim 与普通编辑模式间切换"
     }
   },
   "envVars": [
@@ -2872,19 +2980,16 @@
     },
     "docs/guide/cost-usage": {
       "frontmatter": {
-        "title": "查看消耗 - 会话花费与账户配额",
-        "description": "使用 /cost、/usage、/stats、/extra-usage 查看当前会话花费、账户配额与历史统计。",
+        "title": "查看消耗 - 会话花费与历史统计",
+        "description": "使用 /cost、/stats 查看当前会话花费与历史统计。",
         "keywords": [
           "cost",
-          "usage",
           "stats",
-          "extra-usage",
           "消耗",
-          "配额",
           "统计"
         ]
       },
-      "content": "\n## 当前会话花费\n\n`/cost` 显示本次会话的 token 消耗与费用明细。适合在长对话中随时检查开销：\n\n```\n> /cost\n```\n\n输出包含输入 token、输出 token 以及折算后的费用。会话结束后计数清零，下次对话重新累计。\n\n## 账户配额\n\n`/usage` 查看账户级别的剩余额度与订阅信息：\n\n```\n> /usage\n```\n\n| 信息 | 说明 |\n|------|------|\n| 剩余额度 | 当前周期内还可使用的用量 |\n| 订阅计划 | 当前生效的套餐名称 |\n| 周期截止 | 配额重置的日期 |\n\n当额度接近用尽时，可考虑购买额外用量（见下方\"额外额度\"）。\n\n## 历史统计\n\n`/stats` 展示跨会话的累计数据，包括总对话次数、总 token 消耗等：\n\n```\n> /stats\n```\n\n与 `/cost` 的区别在于：`/cost` 只看当前会话，`/stats` 汇总所有历史记录。\n\n## 额外额度\n\n当订阅额度用完时，`/extra-usage` 可以购买额外用量继续使用：\n\n```\n> /extra-usage\n```\n\n按提示选择额度包即可完成购买，无需切换账户或等待配额重置。\n\n## 命令速查\n\n| 命令 | 作用范围 | 用途 |\n|------|---------|------|\n| `/cost` | 当前会话 | 本次对话的 token 与费用 |\n| `/usage` | 账户级别 | 剩余额度与订阅信息 |\n| `/stats` | 全部历史 | 累计消耗与会话统计 |\n| `/extra-usage` | 账户级别 | 购买额外用量 |\n\n## 下一步\n\n- [故障排查](./troubleshooting) — 常见问题与解决方案\n- [代码图谱](./codegraph) — 用 CodeGraph 探索项目结构\n- [模型选择与切换](./model-selection) — 调整模型以控制成本\n"
+      "content": "\n## 当前会话花费\n\n`/cost` 显示本次会话的 token 消耗与费用明细。适合在长对话中随时检查开销：\n\n```\n> /cost\n```\n\n输出包含输入 token、输出 token 以及折算后的费用。会话结束后计数清零，下次对话重新累计。\n\n## 历史统计\n\n`/stats` 展示跨会话的累计数据，包括总对话次数、总 token 消耗等：\n\n```\n> /stats\n```\n\n与 `/cost` 的区别在于：`/cost` 只看当前会话，`/stats` 汇总所有历史记录。\n\n## 命令速查\n\n| 命令 | 作用范围 | 用途 |\n|------|---------|------|\n| `/cost` | 当前会话 | 本次对话的 token 与费用 |\n| `/stats` | 全部历史 | 累计消耗与会话统计 |\n\n## 下一步\n\n- [故障排查](./troubleshooting) — 常见问题与解决方案\n- [代码图谱](./codegraph) — 用 CodeGraph 探索项目结构\n- [模型选择与切换](./model-selection) — 调整模型以控制成本\n"
     },
     "docs/guide/getting-started": {
       "frontmatter": {
@@ -2898,12 +3003,12 @@
           "commit"
         ]
       },
-      "content": "\n## 安装 Saluzi CLI\n\nSaluzi 是终端原生的 agentic coding system，通过 npm 全局安装：\n\n```bash\nnpm install -g @saluzi/saluzi-edu\n```\n\n安装后验证：\n\n```bash\nslz --version\n```\n\n## 首次登录\n\n启动 CLI 后输入 `/login` 命令：\n\n```\nslz\n> /login\n```\n\n支持两种登录方式：\n\n| 方式 | 适用场景 | 说明 |\n|------|---------|------|\n| Saluzi 账户 | 个人开发者 | 通过账户登录，最常用 |\n| API Key | API 用户 | 设置 `ANTHROPIC_API_KEY` 环境变量后自动检测 |\n\n## 添加项目目录\n\n进入项目后用 `/add-dir` 挂载工作目录：\n\n```\n> /add-dir\n```\n\nSaluzi 会扫描目录结构，后续对话即可基于代码上下文回答。\n\n## 第一次对话\n\n直接输入需求：\n\n```\n> 帮我看看这个项目的目录结构，有没有潜在问题\n```\n\nSaluzi 会：\n1. 调用 `Read`、`Glob`、`Grep` 工具探索代码\n2. 分析后给出建议\n3. 若需修改，会请求权限后调用 `Edit`、`Write` 工具\n\n每次工具调用前会弹出权限确认（除非已 Allow）。\n\n## 提交代码工作流\n\n完成修改后：\n\n```\n> /diff          # 预览改动\n> /commit        # 提交（自动生成 commit message）\n> /commit-push-pr # 一条龙：提交 + 推送 + 创建 PR\n```\n\n## 下一步\n\n- [模型选择与切换](./model-selection) — 了解 `/model`、`/effort`、`/mom`\n- [对话基础](./conversation-basics) — 多轮对话与流式输出\n- [上下文管理](./context-tips) — 让 AI 更好理解你的项目\n"
+      "content": "\n## 安装 Saluzi CLI\n\nSaluzi 是终端原生的 agentic coding system，通过 npm 全局安装：\n\n```bash\nnpm install -g @saluzi/saluzi-edu\n```\n\n安装后验证：\n\n```bash\nslz --version\n```\n\n## 首次登录\n\n启动 CLI 后输入 `/login` 命令：\n\n```\nslz\n> /login\n```\n\n弹出 `Login` 对话框，首先提示 `Select login method:`，共 6 个 Provider 选项。按 `↑/↓` 选择，`Enter` 确认：\n\n| # | 选项 | 副标题 | 适用场景 |\n|---|------|--------|---------|\n| 1 | Anthropic Compatible | Configure your own API endpoint | 自建/代理的 Anthropic 格式端点（如反代、中转） |\n| 2 | OpenAI Compatible | Ollama, DeepSeek, vLLM, One API, etc. | OpenAI Chat Completions 格式的本地或第三方模型 |\n| 3 | Gemini API | Google Gemini native REST/SSE | Google 原生 Gemini 接口 |\n| 4 | Saluzi account with subscription | Pro, Max, Team, or Enterprise | 订阅账户（个人/团队最常用） |\n| 5 | Anthropic Console account | API usage billing | Anthropic Console 按 API 用量计费 |\n| 6 | 3rd-party platform | Amazon Bedrock, Microsoft Foundry, or Vertex AI | 云厂商托管入口 |\n\n> 如果已设置 `ANTHROPIC_API_KEY` 环境变量，Saluzi 会自动检测并跳过登录，`/login` 此时显示为 \"Switch Saluzi accounts\"。\n\n### 选项 1-3：API 表单登录\n\n选择前三个选项（Anthropic / OpenAI / Gemini Compatible）后进入对应的字段表单。三者字段完全一致，只是写入的环境变量不同：\n\n| 字段 | 标签 | 说明 | 是否必填 |\n|------|------|------|---------|\n| baseUrl | Base URL | API 端点地址，需含协议（如 `https://api.example.com`） | 否（留空走默认） |\n| apiKey | API Key | 密钥，输入时掩码显示 | 否 |\n| stdModel | Std | standard 模型名（如 `claude-sonnet-4-5`） | 否 |\n| proModel | Pro | pro 模型名 | 否 |\n| maxModel | Max | max 模型名 | 否 |\n| maxOutputTokens | Out Tok | 单次响应最大 token 数 | 否 |\n| autoCompactWindow | AC Win | 自动压缩上下文的窗口大小 | 否 |\n| autoCompactPctOverride | AC Pct% | 自动压缩触发阈值百分比 | 否 |\n\n操作方式：`↑/↓` 或 `Tab` 切换字段，`Enter` 在最后一个字段提交保存，`Esc` 返回选项菜单。保存后表单中的值会写入 `~/.saluzi/settings.json` 的 `env` 段（对应 `ANTHROPIC_BASE_URL`/`OPENAI_BASE_URL`/`GEMINI_BASE_URL` 等环境变量），下次启动自动加载。\n\n### 选项 4-5：OAuth 浏览器登录\n\n选择 Saluzi 账户或 Anthropic Console 后进入 OAuth 流程：\n\n1. 终端显示 `Opening browser to sign in…`（带加载图标），自动打开浏览器\n2. 在浏览器完成账户登录与授权\n3. 浏览器返回一串授权码，复制后回到终端\n4. 终端提示 `Paste code here if prompted >`（掩码输入），粘贴授权码并 `Enter`\n5. 终端显示 `Creating API key for Saluzi…`，完成后提示 `Login successful. Press Enter to continue…`\n\n如果浏览器没有自动打开，终端会展示 URL 和复制提示，按 `c` 可复制 URL 手动打开。\n\n### 选项 6：第三方平台\n\n选择 3rd-party platform 后只显示提示信息：Saluzi 支持 Amazon Bedrock、Microsoft Foundry、Vertex AI，需要先设置对应的环境变量再重启 Saluzi。按 `Enter` 返回选项菜单，不在 CLI 内直接配置。企业用户需联系管理员获取配置参数。\n\n### 登录后\n\n登录成功后 Saluzi 会自动刷新策略配额、GrowthBook 特性开关、远程受管设置，并为本机注册 trusted device（用于 Remote Control）。无需额外操作，直接开始对话即可。\n\n## 添加项目目录\n\n进入项目后用 `/add-dir` 挂载工作目录：\n\n```\n> /add-dir\n```\n\nSaluzi 会扫描目录结构，后续对话即可基于代码上下文回答。\n\n## 第一次对话\n\n直接输入需求：\n\n```\n> 帮我看看这个项目的目录结构，有没有潜在问题\n```\n\nSaluzi 会：\n1. 调用 `Read`、`Glob`、`Grep` 工具探索代码\n2. 分析后给出建议\n3. 若需修改，会请求权限后调用 `Edit`、`Write` 工具\n\n每次工具调用前会弹出权限确认（除非已 Allow）。\n\n## 提交代码工作流\n\n完成修改后：\n\n```\n> /diff          # 预览改动\n> /commit        # 提交（自动生成 commit message）\n> /commit-push-pr # 一条龙：提交 + 推送 + 创建 PR\n```\n\n## 下一步\n\n- [模型选择与切换](./model-selection) — 了解 `/model`、`/effort`、`/mom`\n- [对话基础](./conversation-basics) — 多轮对话与流式输出\n- [上下文管理](./context-tips) — 让 AI 更好理解你的项目\n- [主目录与配置](./saluzi-home) — 配置文件位置与字段说明\n"
     },
     "docs/guide/model-selection": {
       "frontmatter": {
         "title": "模型选择与切换 - Max/Pro/Std 与推理深度",
-        "description": "使用 /model 切换模型，/effort 调节推理深度，/mom 配置混合模型，/fast 启用快速模式。",
+        "description": "使用 /model 切换模型，/effort 调节推理深度，/mom 配置混合模型。",
         "keywords": [
           "model",
           "effort",
@@ -2914,7 +3019,7 @@
           "推理深度"
         ]
       },
-      "content": "\n## 模型选择\n\nSaluzi 支持多个模型，按能力与成本分级：\n\n| 模型 | 能力 | 速度 | 成本 | 适用场景 |\n|------|------|------|------|---------|\n| Max | 最强 | 慢 | 高 | 复杂架构、深度推理 |\n| Pro | 均衡 | 中 | 中 | 日常开发（默认） |\n| Std | 快 | 快 | 低 | 简单任务、快速验证 |\n\n## /model 切换\n\n```\n> /model\n```\n\n打开模型选择面板，可切换当前会话的模型。也可直接指定：\n\n```\n> /model max\n> /model pro\n> /model std\n```\n\n支持模型别名：`best`、`max[1m]`（1M 上下文）、`pro[1m]`、`maxplan` 等。\n\n## /effort 推理深度\n\n`/effort` 调节推理链长度（仅支持推理模型的 extended thinking）：\n\n```\n> /effort low     # 快速响应\n> /effort medium  # 中等（默认）\n> /effort high    # 深度推理\n> /effort xhigh   # 极深度推理\n> /effort max     # 最大推理深度\n> /effort auto    # 清除手动设置，使用自动\n```\n\n也可通过环境变量设置：`SALUZI_EFFORT_LEVEL=high slz`\n\n深度推理适合：\n\n- 复杂 bug 分析\n- 架构设计\n- 多步骤规划\n- 代码审查\n\n## /fast 快速模式\n\n```\n> /fast\n```\n\n切换快速模式。如果当前模型不支持 Fast 模式，会自动切换到支持 Fast 的模型。Fast 模式有独立的速率限制，按额外用量计费。\n\n也可直接指定：`/fast on` 或 `/fast off`。\n\n## /mom 混合模型\n\n见 [MOM 混合模型章节](./mom-mixed-models)。MOM 允许多模型协同：主机 + 顾问。\n\n- `/mom` 打开配置面板\n- `/mom \"内容\"` 执行一次性 MOM 回合\n- `/mom-<mode> \"内容\"` 使用特定 MOM 模式（如 `/mom-avg`）\n\n## /poor 节约模式\n\n```\n> /poor\n```\n\n切换节约模式，关闭**记忆提取**（extract_memories）和**提示建议**（prompt_suggestion），减少 token 消耗。\n\n## Provider 选择\n\nSaluzi 自动选择最优 Provider。如需指定：\n- 通过环境变量（如 `ANTHROPIC_API_KEY`）指定\n- 通过 `/keys` 绑定特定 provider 的 Key\n- 通过 `/model` 切换当前会话模型\n\n## 推荐配置\n\n| 场景 | 推荐 |\n|------|------|\n| 日常开发 | Pro + medium effort |\n| 复杂重构 | Max + high effort |\n| 快速原型 | Std + low effort |\n| 关键决策 | MOM（Pro 主机 + Max 顾问） |\n| 节约模式 | `/poor`（关闭记忆提取与提示建议） |\n\n## 成本监控\n\n用 `/cost` 查看当前会话消耗，`/usage` 查看账户配额，`/stats` 查看历史统计。\n"
+      "content": "\n## 模型选择\n\nSaluzi 支持多个模型，按能力与成本分级：\n\n| 模型 | 能力 | 速度 | 成本 | 适用场景 |\n|------|------|------|------|---------|\n| Max | 最强 | 慢 | 高 | 复杂架构、深度推理 |\n| Pro | 均衡 | 中 | 中 | 日常开发（默认） |\n| Std | 快 | 快 | 低 | 简单任务、快速验证 |\n\n## /model 切换\n\n```\n> /model\n```\n\n打开模型选择面板，可切换当前会话的模型。也可直接指定：\n\n```\n> /model max\n> /model pro\n> /model std\n```\n\n支持模型别名：`best`、`max[1m]`（1M 上下文）、`pro[1m]`、`maxplan` 等。\n\n## /effort 推理深度\n\n`/effort` 调节推理链长度（仅支持推理模型的 extended thinking）：\n\n```\n> /effort low     # 快速响应\n> /effort medium  # 中等（默认）\n> /effort high    # 深度推理\n> /effort xhigh   # 极深度推理\n> /effort max     # 最大推理深度\n> /effort auto    # 清除手动设置，使用自动\n```\n\n也可通过环境变量设置：`SALUZI_EFFORT_LEVEL=high slz`\n\n深度推理适合：\n\n- 复杂 bug 分析\n- 架构设计\n- 多步骤规划\n- 代码审查\n\n## /mom 混合模型\n\n见 [MOM 混合模型章节](./mom-mixed-models)。MOM 允许多模型协同：主机 + 顾问。\n\n- `/mom` 打开配置面板\n- `/mom \"内容\"` 执行一次性 MOM 回合\n- `/mom-<mode> \"内容\"` 使用特定 MOM 模式（如 `/mom-avg`）\n\n## /poor 节约模式\n\n```\n> /poor\n```\n\n切换节约模式，关闭**记忆提取**（extract_memories）和**提示建议**（prompt_suggestion），减少 token 消耗。\n\n## Provider 选择\n\nSaluzi 自动选择最优 Provider。如需指定：\n- 通过环境变量（如 `ANTHROPIC_API_KEY`）指定\n- 通过 `/keys` 绑定特定 provider 的 Key\n- 通过 `/model` 切换当前会话模型\n\n## 推荐配置\n\n| 场景 | 推荐 |\n|------|------|\n| 日常开发 | Pro + medium effort |\n| 复杂重构 | Max + high effort |\n| 快速原型 | Std + low effort |\n| 关键决策 | MOM（Pro 主机 + Max 顾问） |\n| 节约模式 | `/poor`（关闭记忆提取与提示建议） |\n\n## 成本监控\n\n用 `/cost` 查看当前会话消耗，`/stats` 查看历史统计。\n\n## 下一步\n\n- [MOM 混合模型](./mom-mixed-models) — 多模型协同：主机 + 顾问\n- [查看消耗](./cost-usage) — `/cost` 与 `/stats` 详解\n- [对话基础](./conversation-basics) — 多轮对话与流式输出\n- [API Key 绑定](./keys-binding) — `/keys` 多 Key 调度\n"
     },
     "docs/guide/mom-mixed-models": {
       "frontmatter": {
@@ -2931,6 +3036,21 @@
       },
       "content": "\n## 什么是 MOM\n\nMOM（Mixture of Model）是 Saluzi 的混合模型调度系统。它允许配置：\n\n- **主机模型（host）**：负责最终输出与工具调用\n- **顾问模型（advisors）**：提供第二意见、代码审查、方案建议\n\n主机在关键决策点（如架构选择、复杂 bug 修复）会咨询顾问，综合多方建议后给出最终方案。\n\n## 配置 MOM\n\n```\n> /mom\n```\n\n打开 MOM 配置面板，可设置：\n\n| 项 | 说明 |\n|----|------|\n| 主机 | 默认模型（如 Pro） |\n| 顾问 1 | 第一顾问（如 Max，深度推理） |\n| 顾问 2 | 第二顾问（如 Std，快速验证） |\n| 触发条件 | 何时咨询顾问（如代码改动 > 50 行） |\n| 模式 | inline（同步）或 fork（异步并行） |\n\n## 一次性 MOM turn\n\n```\n> /mom 帮我设计一个端口冲突处理策略\n```\n\n不修改全局配置，仅本次对话使用 MOM 模式：主机调度顾问，综合后输出。\n\n## 适用场景\n\n| 场景 | 推荐配置 |\n|------|---------|\n| 架构设计 | 主机 Pro + 顾问 Max |\n| 代码审查 | 主机 Pro + 顾问 Std（快速）+ 顾问 Max（深度） |\n| Bug 修复 | 主机 Pro + 顾问 Max |\n| 快速原型 | 仅主机，不启用顾问 |\n\n## 与普通对话的区别\n\n| 普通对话 | MOM 模式 |\n|---------|---------|\n| 单模型 | 多模型协同 |\n| 一次推理 | 多轮咨询 |\n| 成本低 | 成本高（顾问也消耗 token） |\n| 速度快 | 速度稍慢 |\n| 适合常规任务 | 适合关键决策 |\n\n## 成本控制\n\n顾问模型也会消耗 token。建议：\n\n- 日常对话不用 MOM\n- 关键决策（架构、安全审查）启用\n- 设置触发条件（如改动 > N 行才咨询）\n- 用 `/cost` 监控消耗\n"
     },
+    "docs/guide/saluzi-home": {
+      "frontmatter": {
+        "title": "Saluzi 主目录与配置",
+        "description": " ~/.saluzi-edu 目录位置、子目录作用，以及 settings.json 的完整可配置字段清单。",
+        "keywords": [
+          "saluzi-edu",
+          "主目录",
+          "settings.json",
+          "配置",
+          "managed-settings",
+          "env"
+        ]
+      },
+      "content": "\n## 主目录位置\n\nSaluzi 把所有用户数据集中放在主目录下的 `~/.saluzi-edu` 文件夹。路径由 `getSaluziConfigHomeDir()` 统一决定：\n\n- **Linux / macOS**：`~/.saluzi-edu`\n- **Windows**：`%USERPROFILE%\\.saluzi-edu`（即 `C:\\Users\\<你>\\.saluzi-edu`）\n\n可通过环境变量 `SALUZI_CONFIG_DIR` 覆盖到任意位置（支持 `~` 展开），适合多套配置切换或放在加密分区。\n\n> 注意：企业受管配置 `managed-settings.json` **不在此目录**，而是放在系统级路径——macOS 为 `/Library/Application Support/SaluziCode`，Windows 为 `C:\\Program Files\\SaluziCode`，Linux 为 `/etc/saluzi-edu`。普通用户一般不需要动它。\n\n## 子目录与文件清单\n\n启动后 `~/.saluzi-edu` 下会按需出现以下条目。各子目录在首次写入时自动 `mkdir -p`，不需要手动创建。\n\n### 配置与凭证\n\n| 路径 | 作用 | 删除影响 |\n|------|------|---------|\n| `settings.json` | 用户全局设置（env、权限、模型、hooks 等）。详见下文 | 重置为默认配置 |\n| `settings.local.json` | 项目级本地设置（gitignored）。仅在 `<cwd>/.saluzi-edu/` 下生效 | 丢失本地覆盖 |\n| `.credentials.json` | OAuth 登录凭证 | 需重新 `/login` |\n| `.config.json` | 内部运行配置，不要手编 | 自动重建 |\n| `keybindings.json` | 自定义快捷键 | 恢复默认按键 |\n| `SALUZI.md` | 用户级记忆（跨项目的个人偏好） | 丢失用户记忆 |\n| `rules/` | 用户级规则文件 | 丢失规则 |\n\n### 项目数据（按 cwd 隔离）\n\n| 路径 | 作用 |\n|------|------|\n| `projects/<sanitized-cwd>/` | 每个工作目录一个子目录，存放该项目专属的会话与记忆 |\n| `projects/<cwd>/memory/` | 自动记忆：`MEMORY.md` + `logs/YYYY/MM/` 日志 |\n| `projects/<cwd>/*.jsonl` | 该项目的会话转录 |\n\n项目子目录名是 cwd 路径的 sanitized 形式（特殊字符替换），所以同时多个项目互不干扰。\n\n### 扩展与自定义\n\n| 路径 | 作用 |\n|------|------|\n| `skills/` | 用户技能（由 `/skill-learning` 自动生成或手写） |\n| `commands/` | 用户自定义 slash 命令 |\n| `agents/` | 用户自定义 agent（Markdown 文件） |\n| `teams/` | 团队配置 |\n| `templates/` | 任务模板 |\n| `plugins/` | 插件安装目录（由 `/plugin` 管理） |\n| `plugin-options/` | 插件运行时选项 |\n\n### 运行时状态\n\n| 路径 | 作用 |\n|------|------|\n| `sessions/` | 并发会话状态 |\n| `jobs/` | 后台任务状态 |\n| `tasks/` | 任务数据 |\n| `plans/` | plan 文件 |\n| `daemon/` | daemon 进程状态（`<name>.json`） |\n| `shell-snapshots/` | Shell 环境快照（`!` 命令用） |\n| `history.jsonl` | 全局命令历史 |\n| `stats-cache.json` | 使用统计缓存 |\n| `usage-data/` | `/insights` 用量数据 |\n| `pr-subscriptions.json` | PR 订阅列表 |\n| `file-history/` | 文件修改历史 |\n| `session-env/` | 会话环境变量 |\n| `uploads/<sessionId>/` | 入站附件 |\n\n### 缓存与日志\n\n| 路径 | 作用 |\n|------|------|\n| `cache/model-capabilities.json` | 模型能力缓存 |\n| `backups/` | 配置文件备份 |\n| `debug/<sessionId>.txt` | 调试日志 |\n| `traces/` | Perfetto 性能追踪 |\n| `startup-perf/` | 启动性能分析 |\n| `.update.lock` | 自动更新锁文件 |\n\n### IDE 与集成\n\n| 路径 | 作用 |\n|------|------|\n| `ide/` | IDE 集成数据 |\n| `local/` | 本地安装文件 |\n| `magic-docs/prompt.md` | MagicDocs prompt |\n| `skill-learning/` | 技能学习上下文 |\n| `autonomy/` | 自治运行记录（`runs.json`、`flows.json`） |\n\n所有缓存与运行时状态目录都可安全删除——Saluzi 会按需重建。配置类（`settings.json`、`SALUZI.md`、`keybindings.json`）删除会丢失个人定制，需要重新配置。\n\n## settings.json 配置\n\n`~/.saluzi-edu/settings.json` 是用户全局配置文件，JSON 格式，所有字段均可选。下面按主题分组说明。完整 JSON Schema 发布在 `https://json.schemastore.org/saluzi-edu-settings.json`，编辑器开启 JSON Schema 支持后可自动补全。\n\n### 来源与优先级\n\nSaluzi 合并 5 个来源的配置，后者覆盖前者：\n\n| 优先级 | 来源 | 路径 | 可编辑 |\n|--------|------|------|--------|\n| 1（低） | userSettings | `~/.saluzi-edu/settings.json` | 是 |\n| 2 | projectSettings | `<cwd>/.saluzi-edu/settings.json` | 是（共享，入 git） |\n| 3 | localSettings | `<cwd>/.saluzi-edu/settings.local.json` | 是（gitignored） |\n| 4 | flagSettings | `--settings <path>` CLI 参数 | 否 |\n| 5（高） | policySettings | 系统级 managed-settings.json | 否 |\n\n合并规则：标量高优先级直接覆盖；对象深度合并；数组拼接去重。policySettings 内部还按 remote > MDM (HKLM/plist) > managed-settings.json > HKCU 排序。\n\n### 1. 模型与推理\n\n| 字段 | 类型 | 默认 | 说明 |\n|------|------|------|------|\n| `modelType` | enum | `anthropic` | API 提供商：`anthropic`/`openai`/`gemini`/`grok` |\n| `model` | string | - | 覆盖默认模型 ID |\n| `availableModels` | string[] | - | 企业模型白名单（通常 managed） |\n| `modelOverrides` | Record<string,string> | - | 模型 ID 映射（如 Bedrock ARN） |\n| `effortLevel` | enum | `medium` | `low`/`medium`/`high`/`xhigh`/`max` |\n| `alwaysThinkingEnabled` | boolean | true | 是否启用 thinking |\n| `fastMode` | boolean | false | 启用 fast 模式 |\n| `fastModePerSessionOptIn` | boolean | false | fast 不跨会话持久化 |\n| `advisorModel` | string | - | 服务端 advisor 工具模型 |\n| `mom` | object | - | Mixture of Model 配置，见 [MOM 章节](./mom-mixed-models) |\n\n### 2. 环境变量\n\n`env` 是 `Record<string, string>`，写入后会注入到会话进程的环境变量。常用于配置 API Key 和端点：\n\n```json\n{\n  \"env\": {\n    \"ANTHROPIC_API_KEY\": \"sk-ant-...\",\n    \"ANTHROPIC_BASE_URL\": \"https://api.anthropic.com\",\n    \"SALUZI_EFFORT_LEVEL\": \"high\"\n  }\n}\n```\n\n常用键：\n\n| 键 | 作用 |\n|----|------|\n| `ANTHROPIC_API_KEY` | Anthropic API Key（设置后免 `/login`） |\n| `ANTHROPIC_BASE_URL` | Anthropic 端点（自建反代用） |\n| `OPENAI_API_KEY` / `OPENAI_BASE_URL` / `OPENAI_MODEL` | OpenAI 兼容 |\n| `GEMINI_API_KEY` / `GEMINI_BASE_URL` | Gemini |\n| `GROK_API_KEY` / `GROK_BASE_URL` / `GROK_MODEL` | Grok/xAI |\n| `SALUZI_EFFORT_LEVEL` | 推理深度（覆盖 effortLevel） |\n| `SALUZI_MAX_CONTEXT_TOKENS` | 最大上下文 token |\n| `SALUZI_DISABLE_1M_CONTEXT` | 禁用 1M 上下文 |\n| `SALUZI_CLIENT_CERT` / `SALUZI_CLIENT_KEY` | mTLS 证书 |\n\n### 3. 权限\n\n`permissions` 控制工具调用的授权策略：\n\n```json\n{\n  \"permissions\": {\n    \"defaultMode\": \"default\",\n    \"allow\": [\"Bash(npm test:*)\", \"Read(./src/**)\"],\n    \"deny\": [\"Bash(rm -rf:*)\"],\n    \"ask\": [\"Write(**)\"],\n    \"additionalDirectories\": [\"../other-project\"]\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `defaultMode` | enum | `default`/`acceptEdits`/`bypassPermissions`/`dontAsk`/`plan`/`auto` |\n| `allow` | string[] | 自动放行的工具规则 |\n| `deny` | string[] | 直接拒绝的规则 |\n| `ask` | string[] | 总是弹出确认的规则 |\n| `additionalDirectories` | string[] | 额外允许访问的目录 |\n| `disableBypassPermissionsMode` | `\"disable\"` | 禁用 bypass 模式 |\n\n规则语法如 `Bash(npm test:*)`、`Read(./src/**)`，可用 `*` 通配。\n\n### 4. Hooks\n\n`hooks` 在工具执行前后触发自定义命令。事件类型有 25+ 种，常用的：\n\n| 事件 | 触发时机 |\n|------|---------|\n| `PreToolUse` | 工具调用前 |\n| `PostToolUse` | 工具调用后 |\n| `UserPromptSubmit` | 用户提交输入时 |\n| `SessionStart` / `SessionEnd` | 会话开始/结束 |\n| `Stop` / `StopFailure` | 主循环停止 |\n| `Notification` | 通知发送时 |\n| `PreCompact` / `PostCompact` | 上下文压缩前后 |\n| `PermissionRequest` / `PermissionDenied` | 权限请求/拒绝时 |\n\n每个 hook 是 `{ matcher?: string, hooks: HookCommand[] }`，HookCommand 有四种类型：\n\n```json\n{\n  \"hooks\": {\n    \"PreToolUse\": [\n      {\n        \"matcher\": \"Bash\",\n        \"hooks\": [\n          { \"type\": \"command\", \"command\": \"echo 'running bash'\", \"shell\": \"bash\" },\n          { \"type\": \"prompt\", \"prompt\": \"检查这个命令是否安全\" },\n          { \"type\": \"http\", \"url\": \"https://audit.example.com/hook\", \"headers\": {} },\n          { \"type\": \"agent\", \"prompt\": \"评估风险\", \"model\": \"pro\" }\n        ]\n      }\n    ]\n  }\n}\n```\n\n| 字段 | 适用类型 | 说明 |\n|------|---------|------|\n| `command` / `shell` / `timeout` | command | 执行 shell 命令 |\n| `prompt` / `model` | prompt / agent | 让模型评估 |\n| `url` / `headers` / `allowedEnvVars` | http | HTTP 回调 |\n| `statusMessage` / `once` / `async` / `if` | 全部 | 通用控制 |\n\n`disableAllHooks: true` 可一键禁用所有 hooks 和 statusLine。\n\n### 5. 沙箱\n\n`sandbox` 控制工具执行的隔离边界：\n\n```json\n{\n  \"sandbox\": {\n    \"enabled\": true,\n    \"failIfUnavailable\": false,\n    \"autoAllowBashIfSandboxed\": true,\n    \"network\": {\n      \"allowedDomains\": [\"api.anthropic.com\", \"registry.npmjs.org\"]\n    },\n    \"filesystem\": {\n      \"allowWrite\": [\"./src\", \"./tests\"],\n      \"denyWrite\": [\".env\", \".git\"]\n    }\n  }\n}\n```\n\n| 字段 | 说明 |\n|------|------|\n| `enabled` | 启用沙箱 |\n| `failIfUnavailable` | 沙箱不可用时直接失败（通常 managed） |\n| `autoAllowBashIfSandboxed` | 沙箱内自动放行 Bash |\n| `allowUnsandboxedCommands` | 允许未沙箱化的命令 |\n| `network.allowedDomains` | 允许访问的域名 |\n| `network.allowManagedDomainsOnly` | 仅用 managed 域名白名单 |\n| `filesystem.allowWrite` / `denyWrite` | 读写路径规则 |\n| `excludedCommands` | 排除沙箱的命令 |\n\n### 6. UI 与输出\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `outputStyle` | string | 响应输出样式 |\n| `language` | string | 首选语言（如 `chinese`、`japanese`） |\n| `theme` | string | 主题名 |\n| `prefersReducedMotion` | boolean | 减少动画 |\n| `syntaxHighlightingDisabled` | boolean | 禁用 diff 语法高亮 |\n| `terminalTitleFromRename` | boolean | `/rename` 同步终端标题 |\n| `spinnerTipsEnabled` | boolean | spinner 显示提示 |\n| `spinnerVerbs` | object | 自定义 spinner 动词 |\n| `spinnerTipsOverride` | object | 覆盖 spinner tips |\n| `statusLine` | object | 自定义状态行（`{ type: \"command\", command, padding? }`） |\n\n### 7. MCP 服务器\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `enableAllProjectMcpServers` | boolean | 自动批准项目所有 MCP 服务器 |\n| `enabledMcpjsonServers` | string[] | 已批准的 .mcp.json 服务器 |\n| `disabledMcpjsonServers` | string[] | 已拒绝的 .mcp.json 服务器 |\n| `allowedMcpServers` | array | 企业 MCP 白名单 |\n| `deniedMcpServers` | array | 企业 MCP 黑名单（优先于白名单） |\n\n### 8. 插件\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `enabledPlugins` | Record<string, string[]\\|boolean> | 已启用插件（plugin-id@marketplace-id） |\n| `extraKnownMarketplaces` | Record<string, object> | 额外插件市场源 |\n| `pluginConfigs` | Record<string, {mcpServers?, options?}> | 每插件配置 |\n| `strictPluginOnlyCustomization` | boolean\\|enum[] | 阻止非插件自定义（surfaces: `skills`/`agents`/`hooks`/`mcp`） |\n\n### 9. 记忆与技能\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `autoMemoryEnabled` | boolean | 项目自动记忆开关 |\n| `autoMemoryDirectory` | string | 自动记忆存储目录（projectSettings 中忽略） |\n| `autoDreamEnabled` | boolean | 后台记忆整合 |\n| `memoryV2Enabled` | boolean | Memory V2 总开关 |\n| `memoryV2` | object | V2 子特性（gatedWrites、hybridStorage、smartRetrieval 等） |\n| `skillSearchEnabled` | boolean | 技能搜索预取 |\n| `skillLearningEnabled` | boolean | 自动技能学习 |\n| `skillImprovementEnabled` | boolean | 自动技能改进 |\n\n### 10. 自动更新与启动\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `autoUpdatesChannel` | enum | `latest`/`stable` |\n| `minimumVersion` | string | 最低版本（防降级） |\n| `cleanupPeriodDays` | number | 聊天转录保留天数（默认 30，0=禁用持久化） |\n| `includeGitInstructions` | boolean | 系统提示是否含 git 工作流（默认 true） |\n| `respectGitignore` | boolean | 文件选择器是否尊重 .gitignore（默认 true） |\n| `skipWebFetchPreflight` | boolean | 跳过 WebFetch 黑名单检查 |\n\n### 11. 登录与认证\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `forceLoginMethod` | enum | `claudeai`/`console` 强制登录方式 |\n| `forceLoginOrgUUID` | string | OAuth 组织 UUID |\n| `apiKeyHelper` | string | 输出认证值的脚本路径 |\n| `awsCredentialExport` / `awsAuthRefresh` | string | AWS 凭证脚本 |\n| `gcpAuthRefresh` | string | GCP 认证刷新命令 |\n| `otelHeadersHelper` | string | OpenTelemetry headers 脚本 |\n\n### 12. 提交与归属\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `attribution` | object | 提交/PR 归属文本（`{ commit, pr }`） |\n| `includeCoAuthoredBy` | boolean | 已弃用，改用 attribution |\n\n### 13. API Key 绑定\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `keys` | KeyEntry[] | API key 条目（`/keys` 命令） |\n| `keyBindings` | object | 模型 slot→key 索引（`{ default?, max?, pro?, std?, subagent? }`） |\n| `keyModelNames` | Record<string,string> | slot→模型名映射 |\n\n详见 [API Key 绑定章节](./keys-binding)。\n\n### 14. 企业受管字段\n\n以下字段设计上只从 managed-settings.json 读取，普通 settings.json 中写会被忽略：\n\n- `allowManagedHooksOnly` — 仅运行 managed 的 hooks\n- `allowManagedPermissionRulesOnly` — 仅用 managed 的权限规则\n- `allowManagedMcpServersOnly` — 仅从 managed 读 MCP 白名单\n- `strictPluginOnlyCustomization` — 阻止非插件自定义\n- `strictKnownMarketplaces` / `blockedMarketplaces` — 插件市场白/黑名单\n- `pluginTrustMessage` — 插件信任警告附加消息\n- `sandbox.failIfUnavailable` — 沙箱不可用即失败\n- `sandbox.network.allowManagedDomainsOnly` — 仅用 managed 域名\n- `sandbox.filesystem.allowManagedReadPathsOnly` — 仅用 managed 读路径\n\n### 15. 其他\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| `defaultShell` | enum | `bash`/`powershell`，`!` 命令默认 shell |\n| `worktree` | object | git worktree 配置（`symlinkDirectories`, `sparsePaths`） |\n| `plansDirectory` | string | plan 文件自定义目录 |\n| `feedbackSurveyRate` | number(0-1) | 会话反馈调查出现概率 |\n| `channelsEnabled` | boolean | 团队/企业频道通知 opt-in |\n| `showClearContextOnPlanAccept` | boolean | plan 批准对话框显示 clear context |\n| `saluziMdExcludes` | string[] | 排除加载 SALUZI.md 的 glob 模式 |\n| `remote.defaultEnvironmentId` | string | 远程会话默认环境 |\n| `sshConfigs` | array | SSH 远程配置（`{ id, name, sshHost, sshPort?, sshIdentityFile?, startDirectory? }`） |\n\n## 编辑建议\n\n- **优先用 userSettings**：`~/.saluzi-edu/settings.json` 放跨项目偏好（主题、模型、env）\n- **项目共享配置用 projectSettings**：`<cwd>/.saluzi-edu/settings.json`，入 git 团队共享\n- **个人项目覆盖用 localSettings**：`<cwd>/.saluzi-edu/settings.local.json`，gitignored\n- **不要手编 .config.json / .credentials.json**：用 `/login` 等命令让 Saluzi 自己写\n- **删除前备份**：`settings.json`、`SALUZI.md`、`keybindings.json` 删了不可恢复\n\n## 下一步\n\n- [排障](./troubleshooting) — `/doctor` 全面体检配置\n- [上下文管理](./context-tips) — SALUZI.md 项目记忆机制\n- [API Key 绑定](./keys-binding) — `/keys` 多 Key 调度\n"
+    },
     "docs/guide/keys-binding": {
       "frontmatter": {
         "title": "API Key 绑定",
@@ -2966,7 +3086,7 @@
         "description": "从第一次提问到多轮对话、流式输出、上下文压缩与导出恢复，掌握 Saluzi 对话的核心使用方式。",
         "keywords": ""
       },
-      "content": "\n## 开始对话\n\n直接输入需求即可。例如：\n\n```\n> 帮我看看这个项目的目录结构\n```\n\nSaluzi 会调用工具（读文件、搜索代码）探索代码后给出回答。\n\n## 多轮对话\n\n- **追加需求**：直接继续输入，Saluzi 记得前文\n- **纠正理解**：如果 AI 理解错了，直接说\"不对，我要的是 X\"\n- **切换话题**：可以随时切换，但建议用 `/clear` 清理后再切换大话题\n\n## 流式输出\n\n- AI 输出是实时的，你可以看到逐字生成\n- 按 `Esc` 打断当前输出\n- 打断后可以补充指令或换方向\n\n## 对话太长时\n\n长对话会消耗 token，Saluzi 提供几个管理工具：\n\n| 命令 | 用途 |\n|------|------|\n| `/context` | 查看当前 token 占用 |\n| `/compact` | 压缩对话历史（保留要点，丢弃冗余） |\n| `/clear` | 重置会话（清空所有历史） |\n| `/summary` | 生成当前会话摘要 |\n\n<Note>\n当 `/context` 显示超过 80% 时，建议执行 `/compact` 压缩上下文。\n</Note>\n\n## 导出与恢复\n\n| 命令 | 用途 |\n|------|------|\n| `/export` | 导出当前对话为 markdown |\n| `/resume` | 恢复历史会话（列出可选） |\n| `/rewind` | 回退到某一步（可回到之前的任意消息） |\n| `/session` | 管理多个会话 |\n\n## 实用技巧\n\n### 引用文件\n\n直接在消息里写文件路径，Saluzi 会自动读取：\n\n```\n> 改一下 app.tsx 里的样式\n```\n\nAI 会先读取文件内容再进行修改。\n\n### 引用命令输出\n\n用 `!` 前缀运行命令，输出直接进对话：\n\n```\n> !npm test\n```\n\nAI 看到测试输出后可以帮你修失败的测试。\n\n### 拖入文件\n\n终端支持拖入文件路径（取决于终端模拟器），路径会自动粘贴到输入框。\n\n## 下一步\n\n<CardGroup cols={2}>\n  <Card title=\"上下文管理技巧\" href=\"/guide/context-tips\">\n    让 AI 更好理解你的项目\n  </Card>\n  <Card title=\"新手入门\" href=\"/guide/getting-started\">\n    安装与首次登录\n  </Card>\n</CardGroup>\n"
+      "content": "\n## 开始对话\n\n直接输入需求即可。例如：\n\n```\n> 帮我看看这个项目的目录结构\n```\n\nSaluzi 会调用工具（读文件、搜索代码）探索代码后给出回答。\n\n## 多轮对话\n\n- **追加需求**：直接继续输入，Saluzi 记得前文\n- **纠正理解**：如果 AI 理解错了，直接说\"不对，我要的是 X\"\n- **切换话题**：可以随时切换，但建议用 `/clear` 清理后再切换大话题\n\n## 流式输出\n\n- AI 输出是实时的，你可以看到逐字生成\n- 按 `Esc` 打断当前输出\n- 打断后可以补充指令或换方向\n\n## 对话太长时\n\n长对话会消耗 token，Saluzi 提供几个管理工具：\n\n| 命令 | 用途 |\n|------|------|\n| `/context` | 查看当前 token 占用 |\n| `/compact` | 压缩对话历史（保留要点，丢弃冗余） |\n| `/clear` | 重置会话（清空所有历史） |\n| `/summary` | 生成当前会话摘要 |\n\n> **Tip** 当 `/context` 显示超过 80% 时，建议执行 `/compact` 压缩上下文。\n\n## 导出与恢复\n\n| 命令 | 用途 |\n|------|------|\n| `/export` | 导出当前对话为 markdown |\n| `/resume` | 恢复历史会话（列出可选） |\n| `/rewind` | 回退到某一步（可回到之前的任意消息） |\n| `/session` | 管理多个会话 |\n\n## 实用技巧\n\n### 引用文件\n\n直接在消息里写文件路径，Saluzi 会自动读取：\n\n```\n> 改一下 app.tsx 里的样式\n```\n\nAI 会先读取文件内容再进行修改。\n\n### 引用命令输出\n\n用 `!` 前缀运行命令，输出直接进对话：\n\n```\n> !npm test\n```\n\nAI 看到测试输出后可以帮你修失败的测试。\n\n### 拖入文件\n\n终端支持拖入文件路径（取决于终端模拟器），路径会自动粘贴到输入框。\n\n## 下一步\n\n- [上下文管理](./context-tips) — 让 AI 更好理解你的项目\n- [新手入门](./getting-started) — 安装与首次登录\n- [模型选择](./model-selection) — 切换 Max/Pro/Std\n- [查看消耗](./cost-usage) — `/cost` 与 `/stats` 详解\n"
     },
     "docs/guide/oms-workflow": {
       "frontmatter": {
@@ -2985,6 +3105,22 @@
       },
       "content": "\n## 什么是 OMS\n\nOMS（Orchestra Management System）是 Saluzi 的高级任务编排系统。它将复杂任务分解为多个阶段（stage），每个阶段由专属角色的 agent 执行，通过 DAG（有向无环图）调度依赖关系，支持并行执行、质量门禁、失败重试与多轮迭代。\n\n## OMS 命令一览\n\n| 命令 | 用途 | 定位 |\n|------|------|------|\n| `/oms` | 智能路由：根据自然语言自动选择最佳工作流 | 入口 |\n| `/oms-autopilot` | 全自动 6 阶段流水线：需求→规划→实现→QA→验证→报告 | 全链路 |\n| `/oms-ralplan` | 共识规划：Planner→Architect→Critic 三轮审议 | 规划 |\n| `/oms-ralph` | PRD 驱动的持久循环：逐个用户故事实现并验证 | 执行 |\n| `/oms-team` | N 并行 worker：任务分解→并行实现→集成验证 | 并行执行 |\n| `/oms-clarify` | 苏格拉底式深度访谈：通过问答降低需求模糊度 | 需求澄清 |\n| `/oms-autoresearch` | 评估器驱动的迭代改进：实验→评估→决策→迭代 | 研究 |\n| `/oms-ultrawork` | 3 层并行执行：按复杂度路由到 std/pro/max 模型 | 轻量并行 |\n| `/oms-goal` | 多目标工作流：Oracle 门控 + 角色分工执行 | 目标管理 |\n| `/oms-orchestra` | 运行自定义 YAML 工作流 | 自定义 |\n| `/oms-define` | 定义自定义 agent 或工作流（生成 YAML） | 定义工具 |\n\n## Prompt 模式与 Program 模式\n\n多数 OMS 工作流支持两种执行模式：\n\n### Program 模式（默认）\n\nWorkflowEngine 直接执行 DAG——创建 Orchestrator，加载 22 种内置 agent 角色，按拓扑序调度各阶段，管理 worker 并发。无需 LLM 参与调度，速度快、确定性强。\n\n```\n> /oms-autopilot 实现用户登录功能\n```\n\nProgram 模式失败时会自动降级到 Prompt 模式重试。\n\n### Prompt 模式（`--prompt`）\n\nLLM 作为编排层，通过 Agent 工具逐阶段派生子 agent 执行。更灵活（可适应异常情况），但速度较慢。\n\n```\n> /oms-autopilot --prompt 实现用户登录功能\n```\n\n适用于需要 LLM 判断力的场景（如需求模糊、需动态调整执行路径）。\n\n### 仅 Prompt 模式的工作流\n\n以下工作流只支持 Prompt 模式：\n\n| 工作流 | 原因 |\n|--------|------|\n| `/oms-clarify` | 苏格拉底式访谈依赖 AskUserQuestion 多轮对话，Program 模式无法支持 |\n| `/oms-goal` | Oracle 门控 + 多目标状态管理需要 LLM 判断 |\n| `/oms`（路由器） | 纯分类分发，无 DAG 执行 |\n| `/oms-define` | 纯 YAML 生成，无 DAG 执行 |\n\n## 典型用法：组合使用 /oms-define 与 /oms-orchestra\n\n除了内置工作流，OMS 支持定义和运行**自定义工作流**。\n\n### 第一步：定义自定义 agent 或工作流\n\n`/oms-define` 根据自然语言描述生成 YAML 定义文件：\n\n```\n> /oms-define 我需要一个安全审计 agent，只读代码，用 max 模型\n```\n\nSaluzi 会在 `.orchestra/agents/` 下生成 YAML：\n\n```yaml\nname: security-auditor\nrole: reviewer\ndescription: \"Security-focused code review.\"\nmodel: max\ntools: [Read, Glob, Grep]\ndisallowed_tools: [Write, Edit, Bash]\n```\n\n定义自定义工作流：\n\n```\n> /oms-define 创建一个代码审查工作流，先探索、再审查、再验证\n```\n\n生成 `.orchestra/workflows/code-review.yaml`：\n\n```yaml\nname: code-review\ndescription: \"Multi-stage code review\"\nstages:\n  explore:\n    agent: explorer\n    workers: 3\n  review:\n    agent: reviewer\n    depends_on: [explore]\n  verify:\n    agent: verifier\n    depends_on: [review]\n    gate: true\n    on_failure: retry\n    max_retries: 2\n```\n\n### 第二步：运行自定义工作流\n\n```\n> /oms-orchestra code-review \"检查最近提交的认证模块改动\"\n```\n\n`/oms-orchestra` 加载 `.orchestra/workflows/` 下的 YAML 定义，构建 DAG 并按拓扑序执行各阶段。\n\n## 各工作流 DAG 详解\n\n每个内置工作流都是一个 DAG（有向无环图）。阶段之间通过 `depends_on` 声明依赖，引擎按拓扑序调度，无依赖的阶段可并行执行。\n\n### /oms-autopilot — 全自动 6 阶段流水线\n\n```\nexpansion → planning → execution → qa → ┬─ validation-functional ─┐\n                                        ├─ validation-security  ──┼→ cleanup\n                                        └─ validation-quality  ───┘\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| expansion | Analyst | 将想法转为技术规格（需求、架构、风险） |\n| planning | Planner | 创建实现计划（任务分解、并行策略、测试方案） |\n| execution | Executor | 按计划并行实现（自动/标准/高复杂度三级路由） |\n| qa | Verifier [gate] | build + lint + test 循环，最多重试 5 次 |\n| validation-* | 3 个并行 reviewer [gate] | 功能验证、安全审查、代码质量审查 |\n| cleanup | Writer | 生成最终报告 |\n\n特点：如果已存在 ralplan 计划（`.oms/plans/ralplan-*.md`），自动跳过 expansion 和 planning，直接从 execution 开始。\n\n### /oms-ralplan — 共识规划\n\n```\nplan → architect_review → critic_review → revision\n                          ↑                      ↓ (ITERATE)\n                          └── 重新执行整个 DAG ──┘ (最多 5 轮)\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| plan | Planner | RALPLAN-DR 结构化审议（原则→驱动因素→选项→推荐） |\n| architect_review | Architect | 反方论证、权衡分析、风险评级 |\n| critic_review | Critic [gate] | 9 维度评分，输出 APPROVE / ITERATE / REJECT |\n| revision | Planner | 逐条回应 Critic 问题，更新计划 |\n\n特点：Critic 输出 ITERATE 时，引擎重新执行整个 DAG（最多 5 轮）。APPROVE 后提示选择执行路径（team 或 ralph）。支持 `--interactive` 模式在关键节点暂停确认。\n\n### /oms-ralph — PRD 驱动的持久循环\n\n```\nanalyze → implement [loop ≤50] → verify [gate] → review [gate, retry ≤10] → deslop → regression_verify [gate, retry ≤3] → debug_fix [retry ≤3]\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| analyze | Analyst | 生成 PRD（用户故事 + 验收标准） |\n| implement | Executor | 逐个实现用户故事，循环直到所有故事通过 |\n| verify | Verifier [gate] | 全量重新验证所有故事 |\n| review | CodeSimplifier [gate] | 代码审查，最多重试 10 次 |\n| deslop | CodeSimplifier | 去除不必要的复杂度 |\n| regression_verify | Verifier [gate] | deslop 后回归测试 |\n| debug_fix | Debugger | 诊断修复剩余问题 |\n\n### /oms-team — N 并行 worker\n\n```\nplan → prd → exec (N workers) → verify [gate] → fix [retry ≤3]\n                                     ↑              ↓\n                                     └──────────────┘ (loop until PASS)\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| plan | Planner | 将任务分解为 N 个独立子任务 |\n| prd | Analyst | 为每个子任务定义验收标准（任务 >5 个子任务时） |\n| exec | Executor | N 个 worker 并行实现（N>20 自动启用 Ant-Colony 模式） |\n| verify | Verifier [gate] | 验证所有子任务 + 集成检查 |\n| fix | Debugger | 诊断修复失败项，最多 3 轮 |\n\n### /oms-clarify — 苏格拉底式深度访谈（交互式）\n\n```\nexplore → interview [loop ≤20] → ┬─ challenge-contrarian (模糊度>0.4) ─┐\n                                  ├─ challenge-simplifier (模糊度>0.3) ─┼→ crystallize → bridge\n                                  └─ challenge-ontologist (模糊度>0.5) ─┘\n```\n\n| 阶段 | Agent | 说明 |\n|------|-------|------|\n| explore | Explorer | 检测项目类型（brownfield/greenfield），映射代码区域 |\n| interview | Analyst | 逐轮提问，每轮计算模糊度评分（目标/约束/标准/上下文） |\n| challenge-* | 3 个条件 agent | 反方论证、简化探测、本体论重构（按模糊度阈值激活） |\n| crystallize | Writer | 综合所有分析，生成规格文档 |\n| bridge | Planner | 推荐执行模式并跳转 |\n\n特点：模糊度降至 ≤20% 自动进入下一阶段。支持 `--quick`（阈值 30%，5 轮）和 `--deep`（阈值 10%，30 轮）。\n\n### /oms-autoresearch — 评估器驱动的迭代改进\n\n```\nconfirm-mission → initialize-run → experiment → evaluate [gate] → decide → iterate [loop ≤50] → finalize\n                                                                          ↑          ↓ (CONTINUE/PIVOT)\n                                                                          └──────────┘\n```\n\n特点：通过外部评估器（如测试套件、benchmark）量化每轮改进，决策引擎输出 CONTINUE / PIVOT / COMPLETE / ABORT。\n\n### /oms-ultrawork — 3 层并行执行\n\n```\nground → classify → ┬─ execute-simple   (LOW, std 模型) ─┐\n                    ├─ execute-standard  (MED, pro 模型) ─┼→ verify [gate] → report\n                    └─ execute-complex   (HIGH, max 模型) ─┘\n```\n\n特点：按复杂度将子任务路由到不同模型层级，独立任务并行执行。\n\n### /oms-goal — 多目标工作流\n\nOracle 门控 + 结构化 intake + 角色分工执行（Scout/Worker/Judge），通过文件系统持久化状态（`.oms/ultragoal/`），支持中断恢复。\n\n## 3 阶段流水线：ralplan → autopilot\n\n工作流之间可以串联。典型的全链路开发流程：\n\n```\n1. /oms-ralplan \"实现用户认证模块\"     → 生成共识计划\n2. Critic APPROVE 后选择执行路径       → team 或 ralph\n3. 执行完毕 → 验证通过 → 完成\n```\n\n`/oms-autopilot` 检测到已有的 ralplan 计划时，自动跳过 expansion + planning，直接从 execution 阶段开始。\n\n## 与普通对话的区别\n\n| 普通对话 | OMS 工作流 |\n|---------|-----------|\n| 单轮 request-response | 多阶段 DAG 调度 |\n| AI 自主决策 | 角色化分工 + 质量门禁 |\n| 适合小任务 | 适合复杂任务（5+ 文件） |\n| 上下文单一 | 多 agent 并行上下文 |\n\n## 何时用 OMS\n\n- 任务涉及 5+ 文件改动\n- 需要架构设计 + 实现 + 测试多阶段\n- 需要多个专业角色（如安全审查 + 性能优化）\n- 需求不明确，需要深度澄清（clarify）\n- 需要多 worker 并行执行（team）\n- 希望自动化长链任务\n"
     },
+    "docs/guide/memory-system": {
+      "frontmatter": {
+        "title": "记忆系统 - 让 AI 跨会话记住你",
+        "description": "自动记忆的目录结构、读写方式与治理周期：AI 如何记住你的偏好、如何手动写入/修改/删除记忆、如何用 /dream 与 /memory health 维护记忆健康。",
+        "keywords": [
+          "记忆",
+          "memory",
+          "auto-memory",
+          "dream",
+          "memory health",
+          "MEMORY.md",
+          "记忆治理"
+        ]
+      },
+      "content": "\n## 为什么需要记忆系统\n\n普通的 AI 对话每次都从零开始。Saluzi 的记忆系统让 AI 在跨会话、跨项目之间持续积累关于你的认知：你的角色、你的偏好、你给过的反馈、项目正在做的事、外部系统的入口。\n\n记忆系统完全在本地运行，所有数据存储在 `~/.saluzi-edu/` 下，不会上传到云端。你可以随时查看、编辑、删除任何一条记忆。\n\n## 记忆目录在哪\n\n每个项目独立维护一份记忆，按 git 仓库根目录隔离（同一个仓库的多个 worktree 共享一份记忆）。\n\n默认路径：\n\n```\n~/.saluzi-edu/projects/<sanitized-cwd>/memory/\n```\n\n- Linux / macOS：`~/.saluzi-edu/projects/<sanitized-cwd>/memory/`\n- Windows：`%USERPROFILE%\\.saluzi-edu\\projects\\<sanitized-cwd>\\memory\\`\n- `<sanitized-cwd>` 是当前工作目录路径的安全化形式（特殊字符替换为 `-`）\n\n如果想把记忆放到其他位置（例如加密分区或 NAS），有两种覆盖方式：\n\n- **环境变量**：`SALUZI_COWORK_MEMORY_PATH_OVERRIDE` 指向完整路径\n- **settings.json**：在 `~/.saluzi-edu/settings.json` 或 `<cwd>/.saluzi-edu/settings.local.json` 中设置 `autoMemoryDirectory`（支持 `~/` 展开）\n\n> **Tip** 出于安全考虑，`autoMemoryDirectory` 只接受 user/local/policy 三种来源，projectSettings（提交到仓库的 `.saluzi-edu/settings.json`）中的同名字段会被忽略——避免恶意仓库把记忆目录指向敏感路径。\n\n## 子目录与文件作用\n\n进入你的记忆目录后，会看到以下结构：\n\n```\nmemory/\n├── MEMORY.md              # 入口索引：列出所有记忆条目\n├── persona.md             # 用户画像：从 user 记忆自动合成\n├── memory.db              # SQLite 索引（FTS 全文检索 + confidence 衰减追踪）\n├── .last-governance       # 上次治理运行的时间戳\n├── episodic/              # L1 会话级记忆\n├── feedback/              # L2 方法反馈\n├── reference/             # L2 外部引用\n├── procedural/            # L3 流程性模式（自动从 feedback 提升）\n└── logs/YYYY/MM/DD.md     # 每日工作日志（Kairos 助手模式）\n```\n\n### 入口与索引\n\n| 路径 | 作用 |\n|------|------|\n| `MEMORY.md` | 主索引，按类型分组列出所有记忆条目（名称 + 一句话描述 + 链接）。每次治理后自动重新生成 |\n| `persona.md` | 从所有 `user` 类型记忆合成出的用户画像。AI 每次对话开始时读取，用于调整沟通风格 |\n| `memory.db` | SQLite 数据库，提供全文检索、confidence 衰减追踪、访问计数。删除后会自动重建 |\n| `.last-governance` | JSON 文件，记录上次治理运行的时间，AutoDream 据此判断下次何时触发 |\n\n### 四个层级子目录\n\n记忆按生命周期分四层，对应四个子目录：\n\n| 子目录 | 层级 | 作用 | 命名约定 |\n|--------|------|------|---------|\n| `episodic/` | L1 | 会话级摘要，每个会话一份。值得保留的会自动提升到 L2 | `<日期>_<sessionId>-general.md`、`-error.md`、`-turn_summary.md` |\n| `feedback/` | L2 | 你给过的方法反馈（纠正 + 确认）。**默认写入位置** | `feedback_<主题描述>.md` |\n| `reference/` | L2 | 外部系统入口指针（Linear 项目、Grafana 看板、Slack 频道等） | `reference_<主题描述>.md` |\n| `procedural/` | L3 | 从一组相关 feedback 自动综合出的流程性模式 | `procedural_<模式描述>.md` |\n\n> **Note** 你可能会在根目录看到一些 `feedback_*.md` 散落文件，这是早期版本的遗留格式。新的记忆会按类型进入对应子目录。`/dream` 整合时会清理这些遗留文件。\n\n### 四种记忆类型\n\n每条记忆文件的 frontmatter 中声明 `type` 字段，取值之一：\n\n| 类型 | 写什么 | 触发时机 |\n|------|--------|---------|\n| `user` | 用户角色、技能、偏好、知识背景 | 你透露职业、经验、习惯时 |\n| `feedback` | 你给的方法反馈，**包括纠正和确认**两种 | 你说\"不要 X\"或\"对，就这样做\"时 |\n| `project` | 项目正在做的工作、决策、deadline、责任人 | 你提到进展、计划、阻塞时 |\n| `reference` | 外部系统入口（Linear、Grafana、Slack 等） | 你提到外部资源位置时 |\n\n### 不该写入的内容\n\n以下内容**不会**被记忆系统保存，因为它们可以从其他来源派生：\n\n- 代码模式、架构、文件路径——读代码即可得知\n- git 历史、谁改了什么——`git log` / `git blame` 是权威\n- 调试方案——修复在代码里，上下文在 commit message 里\n- 已在 `SALUZI.md` 中记录的内容\n- 临时任务状态、当前对话上下文\n\n即使你明确说\"记住这周的 PR 列表\"，AI 也会反问\"哪部分是*出乎意料*或*非显然*的\"——只保留那部分。\n\n## 如何写入记忆\n\n### 方式一：对话中自然告诉 AI\n\n最自然的方式。直接说：\n\n```\n> 记住我喜欢用 conventional commits\n> 这是我的偏好：测试失败时先 git stash + rerun，再判断是不是我的改动引起的\n> 我们团队的 pipeline bug 都在 Linear 的 INGEST 项目里跟踪\n```\n\nAI 会自动调用记忆工具，在对应子目录创建一个 frontmatter + markdown 的 `.md` 文件。`feedback` 和 `project` 类型会按\"规则 + **Why:** + **How to apply:**\"结构组织正文。\n\n### 方式二：用 /memory 命令编辑\n\n```\n> /memory\n```\n\n弹出文件选择器，列出所有现有记忆文件 + \"新建\"选项。选择后会用 `$EDITOR`（或 `$VISUAL`）打开该文件编辑。\n\n```\n> /memory health\n```\n\n查看记忆系统的健康报告，输出包含：\n\n- 总条目数、平均 confidence、低 confidence（<0.3）条目数\n- 平均年龄（天）\n- 按类型统计（user / feedback / project / reference）\n- 按层级统计（episodic / semantic / procedural）\n- 容量使用率与容量层级\n- 上次治理周期的衰减、过期、冲突数\n- 上次治理运行时间\n\n### 方式三：直接编辑文件\n\n记忆文件就是普通的 markdown + frontmatter，可以直接用任何编辑器修改：\n\n```markdown\n---\nname: prefers-conventional-commits\ndescription: 用户偏好 conventional commits 格式\ntype: feedback\nconfidence: 0.8\ncreated: 2026-08-10T09:14:04.465Z\nsource: direct-write\n---\n\n提交信息使用 conventional commits 格式（feat / fix / docs / chore / refactor）。\n\n**Why:** 用户在 2026-08-10 明确表示偏好，团队未强制但个人习惯。\n**How to apply:** 调用 /commit 或 /commit-push-pr 时，自动套用该格式。\n```\n\nfrontmatter 关键字段：\n\n| 字段 | 必填 | 作用 |\n|------|------|------|\n| `name` | 是 | 唯一标识，kebab-case |\n| `description` | 是 | 一句话描述，用于检索时判断相关性 |\n| `type` | 是 | `user` / `feedback` / `project` / `reference` 之一 |\n| `confidence` | 否 | 0~1 的置信度，默认 0.5，治理时会衰减 |\n| `created` | 否 | ISO 时间戳，留空自动填 |\n| `source` | 否 | 来源标记（`direct-write` / `extract` / `dream` 等） |\n\n## 如何修改记忆\n\n三种方式都适用：\n\n- **对话中**：说\"更新关于 X 的记忆，改成 Y\"或\"那条关于 conventional commits 的偏好改成包括 scope\"。AI 会打开对应文件并 Edit。\n- **/memory 命令**：选择要修改的文件，在编辑器中改。\n- **直接编辑**：用编辑器打开 `feedback/feedback_xxx.md` 改正文或 frontmatter。\n\n修改后下一次对话即可生效。SQLite 索引会在文件保存后约 1 秒内自动同步。\n\n## 如何删除记忆\n\n- **对话中**：说\"忘记关于 X 的记忆\"或\"删除那条 conventional commits 的偏好\"。AI 会删除对应文件。\n- **/memory 命令**：选择文件后删除（取决于编辑器集成）。\n- **直接删除文件**：`rm feedback/feedback_xxx.md`，索引会自动清理。\n- **清空所有记忆**：删除整个 `memory/` 目录。下次启动 Saluzi 会自动重建空目录与 `MEMORY.md`。\n\n> **Tip** 如果只是想让 AI 在某次对话中\"忽略\"记忆（不删除），直接说\"这次对话忽略记忆\"，AI 会按 `MEMORY.md` 为空的方式工作，不引用、不比较、不提及记忆内容。\n\n## 记忆治理周期\n\n记忆不是只增不减的日志。Saluzi 有一套自动治理机制，保持记忆新鲜、相关、不冲突。\n\n### AutoDream：后台自动整合\n\n默认每 **24 小时** + **5 个新会话**后自动触发一次整合（两个条件都满足才触发）。整合时：\n\n1. 扫描自上次治理以来的所有会话转录\n2. 启动一个 forked subagent，Bash 限制为只读\n3. 提取值得保留的事实、合并重复条目\n4. 修剪过时内容、识别矛盾\n5. 重新生成 `MEMORY.md` 索引\n\nAutoDream 在会话停止的间隙运行，不打断你的工作。完成后会在主对话中显示一条系统消息，告知整合了哪些文件。\n\n### /dream：手动触发整合\n\n```\n> /dream\n```\n\n任何时候想立即整合记忆，可以手动触发。`/dream` 做的事和 AutoDream 一样，但立刻执行。适合以下场景：\n\n- 刚做了大量偏好调整，想立即固化\n- 感觉 AI 的回答\"似是而非\"，怀疑记忆有冲突\n- 即将切换到另一个项目，想先收尾\n- AutoDream 还没到触发阈值，但你想看当前记忆的整理结果\n\n### DecayEngine：confidence 衰减\n\n每条记忆有 `confidence` 字段（0~1）。每次治理周期：\n\n- 长时间未访问的记忆 confidence 衰减\n- 衰减到阈值后标记为 `decayed`\n- 进一步降低到 `expired` 后从索引移除（文件保留以便恢复）\n\n这保证了\"半年前用一次的偏好\"不会永远占据检索顶部。\n\n### ConflictDetector：冲突检测\n\n当两条 `feedback` 记忆相互矛盾时（例如\"我喜欢详细注释\" vs \"不要加注释\"），治理周期会检测到并标记。下次 `/memory health` 报告中会显示 `conflicts: N`，提示你手动解决。\n\n### PromotionEngine：层级提升\n\n治理周期会自动判断哪些记忆值得\"升级\"：\n\n| 提升路径 | 触发条件 | 结果 |\n|---------|---------|------|\n| L1 episodic → L2 semantic | 会话摘要包含值得长期保留的事实 | 提取为 `feedback/` 或 `reference/` 下的主题文件 |\n| L2 feedback → L3 procedural | 多条相关 feedback 形成模式 | 综合为 `procedural/procedural_*.md` 流程文件 |\n\nL3 procedural 记忆是最高层级，代表\"反复出现的工作模式\"，AI 在合适场景会自动调用。\n\n### 容量管理\n\n记忆目录有容量上限（默认按文件数计）。`/memory health` 中的 `Capacity` 行显示：\n\n```\nCapacity: 47/200 (23.5%) [healthy]\n```\n\n容量层级：\n\n- `healthy` — 使用率 < 70%\n- `near-full` — 70% ~ 90%\n- `full` — > 90%，新写入会被治理周期优先修剪\n\n达到 `full` 时，AutoDream 会优先清理最低 confidence、最长未访问、已 expired 的条目。\n\n### /remember：审视与晋升\n\n```\n> /remember\n```\n\n审视所有自动记忆条目，提出晋升建议：哪些应该写入 `SALUZI.md`（项目级共享记忆）、`SALUZI.local.md`（项目级个人记忆）、或共享记忆。同时检测过时、冲突、重复条目。\n\n适合定期执行，把\"经过验证的个人偏好\"沉淀为团队共享规范。\n\n## 治理周期一览\n\n| 机制 | 触发方式 | 频率 | 作用 |\n|------|---------|------|------|\n| AutoDream | 自动（时间 + 会话数双门） | 24h / 5 sessions | 后台整合、提取、修剪 |\n| /dream | 手动 | 按需 | 立即整合 |\n| DecayEngine | 治理周期内自动 | 同 AutoDream | confidence 衰减 |\n| ConflictDetector | 治理周期内自动 | 同 AutoDream | 检测矛盾 |\n| PromotionEngine | 治理周期内自动 | 同 AutoDream | 层级提升 |\n| /memory health | 手动 | 按需 | 查看健康报告 |\n| /remember | 手动 | 按需 | 审视 + 晋升建议 |\n\n## 实用建议\n\n### 定期体检\n\n每周执行一次 `/memory health`，关注：\n\n- 平均 confidence 是否持续下降（说明记忆整体在老化）\n- 低 confidence 条目是否增多\n- 是否有 conflicts\n- 容量层级是否接近 `near-full`\n\n### 主动固化偏好\n\n每次你纠正 AI 后，留意是否被自动写入。如果几天后 `/memory health` 显示该条 confidence 仍低（< 0.3），可以手动编辑文件把 confidence 调到 0.8+，避免被衰减掉。\n\n### 跨项目共享\n\n`user` 和 `feedback` 中跨项目的偏好，可以用 `/remember` 晋升到 `~/.saluzi-edu/SALUZI.md`（用户级，所有项目共享）。项目相关的偏好留在 `memory/` 目录即可。\n\n### 关闭自动记忆\n\n如果不想用自动记忆，在 `~/.saluzi-edu/settings.json` 中设置：\n\n```json\n{\n  \"autoMemoryEnabled\": false\n}\n```\n\n或环境变量 `SALUZI_DISABLE_AUTO_MEMORY=1`。已有的记忆文件不会被删除，但 AI 不再读取也不再写入。\n\n## 下一步\n\n- [上下文管理](./context-tips) — SALUZI.md 项目记忆与 /memory 命令的关系\n- [主目录与 settings.json](./saluzi-home) — `autoMemoryEnabled` 等配置字段\n- [Kairos 与自动助手](./assistant-proactive) — 助手模式下记忆如何驱动主动行为\n"
+    },
     "docs/guide/troubleshooting": {
       "frontmatter": {
         "title": "排障 - 诊断安装与调整权限",
@@ -3000,7 +3136,7 @@
           "规划模式"
         ]
       },
-      "content": "\n## 诊断安装\n\n遇到启动异常或功能不符预期时，先运行 `/doctor` 做全面体检：\n\n```\n> /doctor\n```\n\n该命令会依次检查：\n\n- CLI 版本是否为最新\n- Node / Bun 运行环境是否满足\n- 配置文件是否完整\n- 网络连接是否正常\n\n若有异常项，输出会给出具体的修复建议。\n\n## 查命令\n\n不确定某个命令的用法时，用 `/help` 列出所有可用命令：\n\n```\n> /help\n```\n\n查看单个命令的详细用法：\n\n```\n> /help commit\n```\n\n输出包含命令说明、参数列表和使用示例。\n\n## 调整权限\n\nSaluzi 每次调用工具前会请求权限。用 `/permissions` 查看和调整当前权限规则：\n\n```\n> /permissions\n```\n\n权限分三种策略：\n\n| 策略 | 含义 |\n|------|------|\n| Allow | 自动放行，不再询问 |\n| Deny | 直接拒绝，禁止调用 |\n| Ask | 每次弹出确认（默认） |\n\n对常用工具设置 Allow 可以减少交互打断，提升效率。\n\n## 规划模式\n\n面对复杂任务时，用 `/plan` 让 Saluzi 先制定计划再执行：\n\n```\n> /plan 重构用户模块，拆分为独立的 service 层\n```\n\n进入规划模式后，Saluzi 会：\n1. 分析需求并拆解步骤\n2. 列出待执行的操作清单\n3. 确认后再逐步实施\n\n适合在动手前理清思路，避免盲目修改。\n\n## 常见问题\n\n| 问题 | 可能原因 | 解决方法 |\n|------|---------|---------|\n| 登录失败 | Token 过期或网络异常 | 重新运行 `/login`，或检查代理设置 |\n| 工具权限被拒 | 对应工具被设为 Deny | 运行 `/permissions` 将策略改为 Allow |\n| 命令找不到 | 输入拼写有误 | 运行 `/help` 确认命令名称 |\n| 模型不可用 | 账户额度耗尽或区域限制 | 用 `/model` 切换到其他可用模型 |\n\n## 下一步\n\n- [查看与提交代码](./commit-workflow) — diff、commit 与 PR 工作流\n- [费用与用量](./cost-usage) — 了解 Token 消耗与费用控制\n- [代码图谱](./codegraph) — 用 CodeGraph 深入理解项目结构\n"
+      "content": "\n## 诊断安装\n\n遇到启动异常或功能不符预期时，先运行 `/doctor` 做全面体检：\n\n```\n> /doctor\n```\n\n该命令会依次检查：\n\n- CLI 版本是否为最新\n- Node / Bun 运行环境是否满足\n- 配置文件是否完整\n- 网络连接是否正常\n\n若有异常项，输出会给出具体的修复建议。\n\n## 查命令\n\n不确定某个命令的用法时，用 `/help` 列出所有可用命令：\n\n```\n> /help\n```\n\n查看单个命令的详细用法：\n\n```\n> /help commit\n```\n\n输出包含命令说明、参数列表和使用示例。\n\n## 调整权限\n\nSaluzi 每次调用工具前会请求权限。用 `/permissions` 查看和调整当前权限规则：\n\n```\n> /permissions\n```\n\n权限分三种策略：\n\n| 策略 | 含义 |\n|------|------|\n| Allow | 自动放行，不再询问 |\n| Deny | 直接拒绝，禁止调用 |\n| Ask | 每次弹出确认（默认） |\n\n对常用工具设置 Allow 可以减少交互打断，提升效率。\n\n## 规划模式\n\n面对复杂任务时，用 `/plan` 让 Saluzi 先制定计划再执行：\n\n```\n> /plan 重构用户模块，拆分为独立的 service 层\n```\n\n进入规划模式后，Saluzi 会：\n1. 分析需求并拆解步骤\n2. 列出待执行的操作清单\n3. 确认后再逐步实施\n\n适合在动手前理清思路，避免盲目修改。\n\n## 常见问题\n\n| 问题 | 可能原因 | 解决方法 |\n|------|---------|---------|\n| 登录失败 | Token 过期或网络异常 | 重新运行 `/login`，或检查代理设置 |\n| 工具权限被拒 | 对应工具被设为 Deny | 运行 `/permissions` 将策略改为 Allow |\n| 命令找不到 | 输入拼写有误 | 运行 `/help` 确认命令名称 |\n| 模型不可用 | 账户额度耗尽或区域限制 | 用 `/model` 切换到其他可用模型 |\n\n## 下一步\n\n- [查看与提交代码](./commit-workflow) — diff、commit 与 PR 工作流\n- [主目录与配置](./saluzi-home) — 配置文件位置与字段说明\n- [费用与用量](./cost-usage) — 了解 Token 消耗与费用控制\n- [代码图谱](./codegraph) — 用 CodeGraph 深入理解项目结构\n"
     },
     "docs/guide/weixin-login": {
       "frontmatter": {