工作模式配置详解

工作模式的所有能力都集中在一个控制面板里——把鼠标悬停在输入框工具栏的机器人图标上就会弹出。本文逐项讲清面板里的每一个配置：它是什么、在哪里配、默认值是多少、存全局还是存单个会话。

控制面板全貌

面板从上到下分三块：模式、内置、扩展。把鼠标移到"内置""扩展"里的某一行上，右侧会滑出一个子面板做进一步设置。只有在工作模式下，下方的能力才可点击（对话模式下整片置灰）。

会话级 vs 全局：会话级设置只影响当前这个对话，换个会话会回到默认；全局设置（技能、MCP 的启用）一次配置，处处生效。

模式

面板最上方是两个并排按钮——对话模式和工作模式，点哪个用哪个。选中的按钮是品牌蓝填充，未选中是描边样式。

• 对话模式 —— 不注入任何工具，适合快速问答、写作、翻译、解释。
• 工作模式 —— 注入完整工具集，适合需要文件、代码执行、工具、MCP、技能或知识库参与的多步骤任务。

智能切换（Smart Switching）

模式按钮下方的开关，只在选中对话模式、且还没发出第一条消息时显示。它的存储级别是全局默认——你在这里改的其实是"新会话默认是否开启智能切换"。

• 开启（默认） —— 你发出第一条消息时，AI 会判断这个任务是否更适合工作模式；如果是，就在消息流里弹一张"建议使用工作模式"的卡片，由你一键决定是否升级。
• 关闭 —— 永远按你选的模式来，不打扰。

发出第一条消息后，这个开关会显示"仅在第一条消息前可用"并置灰——因为智能切换只在对话开头才有意义。

内置能力

联网搜索

让 AI 联网搜索并读取网页正文。行右侧是开关；开启后 label 旁会显示当前提供方名称。把鼠标移上去，右侧子面板可以切换提供方。

• 读网页正文：只有 Chatbox AI 和 Tavily 支持——它们会额外提供 parse_link 工具，让 AI 打开某个链接读全文。Bing 只做搜索。
• 存储级别：联网搜索开关是会话级的。用 Chatbox AI 模型的新会话默认开启，其他模型默认关闭。
• 和对话模式的关系：对话模式下也能联网——直接点输入框工具栏上的地球图标开关；进入工作模式后，统一在这个面板里管理。子面板 header 的齿轮可跳到 设置 → 联网搜索 填 API Key。

代码执行

这是工作模式的核心。AI 可以在本地沙箱里运行 Node.js 或 Bash，配有读取、写入、编辑、搜索文件以及导出可下载文件的一整套能力。行右侧的 Badge 显示当前审批级别，子面板里可切换。

• 存储级别：审批级别（agentFullAccess）是会话级的。
• 只读命令自动放行：即便在"批准"级别，一批公认安全的只读命令（如 ls、cat、grep、find、git status、git log 等）也会自动执行、不打扰你。真正需要批准的是会改动系统的写操作和未知命令。
• 沙箱边界：代码在本地沙箱目录里执行，与你的真实文件系统隔离。相对路径写在沙箱工作目录内、直接放行；写绝对路径的真实文件才需要批准（除非开了完全访问，或该路径在下方"工作目录"白名单内）。

npm run build

扩展能力

技能 Skills

技能是一份份"专家说明书"，告诉 AI 如何把某类任务做得更专业（基于 agentskills.io 规范，兼容 Claude Code 技能）。启用后 AI 会按需 load_skill 加载完整说明。行右侧的 Badge 显示已启用数量。

• 在哪管理：设置 → 技能。可以从技能市场浏览安装、从 GitHub 仓库安装、或打开本地技能文件夹手动放置。
• 兼容来源：除了自己安装的，Chatbox 还会自动发现 Claude Code 的 ~/.claude/skills 和共享的 ~/.agents/skills 目录里的技能。
• 存储级别：技能的启用状态是全局的（enabledSkillNames），对所有会话生效，没有数量上限。
• 结构：每个技能是一个含 SKILL.md 的文件夹，frontmatter 里有 name（小写+连字符）、description 等字段。
• 会话内触发：在输入框打 / 会联想技能命令；也可以在面板技能列表里点某个技能，把 /技能名 插入输入框。

MCP

MCP（Model Context Protocol）让 AI 连接外部工具与服务。Chatbox 内置一批云端 MCP，也支持你接入自定义服务。工具会以 server 为单位注入给 AI。行右侧 Badge 显示已启用 server 数，子面板里逐个开关。

内置云端 MCP（需 Premium）：

自定义 MCP：在 设置 → MCP 里添加。两种传输类型：

• 远程 (http/sse) —— 填服务 URL，跨平台可用（桌面 / Web / 移动端）。
• 本地 (stdio) —— 填本地命令、参数、环境变量，仅桌面端可用（需要在本机启动进程）。

知识库

绑定一个知识库后，AI 可以对它做语义检索、按段落读取文档，基于你自己的资料回答问题（RAG）。行右侧显示已绑定的知识库名称，子面板里单选切换。

• 创建入口：设置 → 知识库。创建时需要配置：
  • 嵌入模型（Embedding，必选） —— 把文本转成向量，需先在 设置 → 提供方 → 模型列表 里添加。
  • 重排模型（Rerank，可选） —— 让检索结果更准。
  • 视觉模型（Vision，可选） —— 预处理图片文件，需要支持视觉的模型。
  • 文档解析器（可选） —— 处理上传文档，可接入 MinerU 等。
• 支持格式：PDF、DOCX、TXT、MD、RTF、PPTX、XLSX、CSV、EPUB 等。添加文件后会自动向量化。
• 会话绑定：一个会话绑定一个知识库，会话级设置。绑定后 AI 拥有 query_knowledge_base、按段落读取等工具。
• 平台限制：Windows ARM64 因 libsql 限制不支持知识库；Web / 移动端本地文件解析仅限文本格式。

工作目录

把本地某个真实文件夹授权给 AI，它就能在这个目录里直接读写，无需逐次审批——像结对程序员一样在你的项目里干活。行右侧 Badge 显示目录数，子面板里增删。

• 平台限制：仅桌面端且非 Windows 可用（面板会据此判断显示）。
• 免审批语义：工作目录内的路径行为等同沙箱——读写都直接放行、不弹审批卡片。目录之外的绝对路径写操作仍需审批（除非开了完全访问）。
• 存储级别：会话级。对新会话（还没发消息）会先暂存，首次发送时正式写入该会话的设置。
• 底部"添加文件夹"按钮会调用系统的目录选择对话框。

安全护栏（不可配置）

有一层保护始终生效、无法关闭：每 25 步自动暂停。为防止 AI 在长任务里跑偏，连续执行 25 步工具调用后会自动暂停，让你确认方向后再"继续"或"停止"。

配置速查表