Configuration

🌐 Language / 语言: 中文 · English

配置说明

本页列出 AI Helper 选项页的全部配置项及其默认值。配置入口：右键扩展图标 →「选项」，或扩展详情页 →「扩展程序选项」。

← 返回 Wiki 首页 · 相关内容：安装与快速开始 · 代理服务

---

选项页标签一览

选项页共 8 个标签页，底部有一个全局「保存配置」按钮（所有标签页共用）；反思与完成度校验配置已并入「推理」标签页：

标签页	内容
基础	界面语言、界面主题（亮 / 暗 / 跟随系统）、厂商配置档案、API 地址 / 密钥 / 模型、图片识别、系统提示词、完成反馈（音效 / 彩带 / 桌面通知）、消息时间戳、侧边栏作用域
推理	ReAct 循环参数、执行日志、流式输出；反思策略开关与完成度客观取证校验开关
划词	划词浮动工具栏管理
代理	本地代理配对连接
语音	本地语音输入：总开关、语言、流式 / 定稿模型、依赖检测与一键安装、模型扫描与导入
扩展	MCP 服务器与 Skill 管理
知识库	RAG 知识库与 Embedding 配置
记忆	长期记忆的语义向量（嵌入来源、维度与查询前缀、索引状态与重建）+ 记忆条目的查看与管理

---

基础设置

界面语言

• 界面语言：中 / 英文切换下拉，切换后立即生效。

界面主题

参数	默认值	说明
界面主题	亮色	亮色 / 暗色 / 跟随系统 三分段即时切换，跨所有界面同步（存储键 appTheme）；跟随系统随操作系统 prefers-color-scheme 实时翻转；也可在侧边栏顶部「更多」菜单循环切换（亮 → 暗 → 跟随系统）。导出 PDF / Word / HTML 恒为白底黑字亮色纸张，不随暗色变化

厂商配置档案

可保存多套厂商配置档案，每个档案独立记忆 API 地址、API Key、模型列表，切换后立即生效：

• + 新建：创建全新档案
• 另存为：以当前配置另存为新档案
• 重命名 / 删除：管理已有档案

档案下方的 API 地址、密钥、模型三项属于当前档案，随档案一起保存与联动。

API 连接

参数	说明
API Base URL	从下拉列表选择（内置 18 个主流平台预设），或手动输入；支持「+ 添加地址」保存自定义地址（可带标签/备注）
API Key	OpenAI 兼容 API 密钥（必填），支持显示 / 隐藏切换
模型名称	预设 deepseek-v4-pro / deepseek-v4-flash；支持「+ 添加模型」（可填上下文窗口大小，128K=128000、200K=200000、1M=1000000，留空自动推断）与「⟳ 从 API 获取」拉取当前厂商模型列表

内置 API 地址预设（国内）：DeepSeek、腾讯混元、阿里云百炼（通义千问）、百度千帆（文心）、火山方舟（豆包）、智谱 GLM、Moonshot（Kimi）、阶跃星辰、MiniMax、讯飞星火、百川智能、硅基流动；海外 / 聚合：OpenAI、Anthropic Claude、Google Gemini、OpenRouter、Groq、Mistral。

图片识别

参数	说明
启用图片识别功能	总开关，开启后可在侧边栏发送图片给多模态模型分析
图片识别 API Base	独立 API 地址，留空则使用基础模型配置
图片识别 API Key	独立 API 密钥（可选），留空则使用基础模型配置
图片识别模型	支持多模态视觉的模型名，留空则使用基础模型的模型名称

系统提示词

• 系统提示词：自定义 AI 助手的行为和角色（可选，留空使用默认值），带一键「重置为默认值」按钮。

完成反馈与桌面通知

参数	默认值	说明
播放提示音	关闭	成功时"叮-咚"升调、失败时"咚-叮"降调；用户主动取消不播放
播放彩带动画	关闭	仅在回答成功完成时播放；失败和取消不播放
任务完成或失败时弹出桌面通知	开启	仅在看不到侧边栏时弹出；成功通知自动消失、失败停留至手动关闭；点击通知打开侧边栏
定时任务完成或失败时弹出桌面通知	开启	定时任务在后台执行、无声音等其他提醒渠道，开关开启时总是弹出
AI 需要你确认或澄清时提醒我	开启	推理循环等待你操作时弹桌面提醒；仅在看得到侧边栏时不打扰，点击通知打开侧边栏

消息时间戳

参数	默认值	说明
显示消息时间戳	开启	在用户问题气泡下方显示发问时间，今天显示时分，非今天显示日期

侧边栏作用域

参数	默认值	说明
全局模式	默认	同一窗口内所有标签页共享同一份侧边栏实例，切换标签页时始终可见
标签页绑定模式	—	侧边栏仅在打开它的标签页可见，切换到其他标签页时自动隐藏
自动分组标签页	关闭	仅标签页绑定模式生效；把打开侧边栏的标签页归入一个彩色标签组便于识别（关闭某标签页侧边栏或切回全局模式时自动移出分组）

---

推理（ReAct）配置

控制 AI 推理循环的行为参数（高级配置）。

参数	默认值	范围	说明
最大循环次数	100	10–1000	AI 可进行的推理-行动循环轮数上限，复杂任务可适当增加
API 请求超时	5 分钟	1–10 分钟	单次 API 调用的最长等待时间
整体循环超时	30 分钟	1–120 分钟	整个推理循环的最长执行时间
工具执行超时	10 分钟	1–30 分钟	单个工具执行的最长等待时间
敏感操作确认	开启	—	模型执行敏感操作（工具调用、命令执行等）时弹窗确认；关闭后所有操作直接放行
启用执行日志	开启	—	消息底部显示「执行日志」按钮，可查看 API 调用和工具执行的详细过程
流式输出	开启	—	AI 回复实时逐字显示，代理端命令执行时也实时输出；遇兼容性问题可关闭回退一次性输出
流式工具卡片默认展开	停用	—	关闭则工具卡片默认折叠，仅显示标题与状态，点击可展开详情

💡 说明：澄清等待时间不计入整体循环超时（暂停计时）。以下参数不再提供 UI 配置，使用固定默认值：澄清超时 5 分钟、API 失败重试 3 次（指数退避，基础延迟 1s）、工具预筛选 关闭（工具数超过 10 个才启动预筛选）、流式渲染字符间延迟 30ms。

---

反思与完成度校验配置（均在「推理」Tab 内）

开关	默认值	说明
反思总开关	开启	整体控制所有反思行为
后置反思	开启	推理循环结束后评估最终结果质量，低于阈值自动修订或重新执行
工具级反思	开启	每次工具调用后检查结果是否符合预期，遇到错误或异常时调整策略
子任务反思	关闭	对复杂任务拆解后的子任务单独评估（高级功能）
完成度校验	关闭	为 plan_task 子任务的 doneCriteria 做客观取证（真实 DOM / 命令证据），与反思的主观自评互补
完成度自动重跑	关闭	仅在「完成度校验」开启时展开；四闸门驱动未达标子任务回炉

💡 反思与完成度校验子开关均位于同一「推理」Tab 面板内，以显隐控制二级开关。

💡 内部固定默认值（不提供 UI 配置）：后置反思质量阈值 7（1–10，低于此值重新执行）、修订阈值 5（低于此值直接修订而非重跑）、反思温度 0.3、最大反思轮数 1；工具级反思在工具返回错误 / 空结果 / 结果过大（>50000 字符）时触发，连续 3 次失败触发，每轮最多 2 次。

启用反思会增加 API 调用次数，建议根据需求权衡。

---

划词工具栏配置

管理网页选中文本时弹出的浮动工具栏：

参数	默认值	说明
工具栏总开关	开启	全局启用 / 停用划词工具栏
图标精简模式	关闭	仅显示图标，不显示文字
工具列表	5 个内置	内置：AI 搜索 / 解释 / 翻译 / 总结 / 复制；支持拖拽排序、编辑提示词
添加自定义工具	—	自定义工具名（≤10 字）+ 系统提示词，如"润色、改写、代码审查"
域名屏蔽	空	添加域名（不含 http/https）后，该域名下不再显示划词工具栏

---

代理配置

连接代理服务，实现文件读写、系统命令执行、对话记忆管理、Skill 工作流及 MCP 协议扩展等高级能力。

• 已配对代理：管理多个已配对代理，一键连接 / 切换
• 当前活跃代理：显示连接状态、工作目录，可展开详细信息
• 添加新代理：代理名称（留空自动获取）、代理地址（默认 http://127.0.0.1:18910）、6 位配对码（在 Agent 终端窗口中查看）

详见 代理服务。

---

语音（本地 STT）配置

语音标签页需 Agent 已连接 才可用；麦克风授权只能在选项页（标签页形态）完成，侧边栏弹不出授权框。

• 启用语音输入：总开关（默认关闭）。关闭后侧边栏的 🎤 与 Alt+V 一并失效
• 语言：auto / 中文 / 英文 / 日语 / 韩语 / 粤语，默认自动判断
• 流式模型 / 定稿模型：分别从已扫描到的 online / offline 模型包里选；未选时按能力自动取第一个可用包（float / int8 由包自身决定）
• 依赖状态：显示 sherpa-onnx 检测结果；未安装时提供一键安装与实时进度（每 2 秒轮询）
• 模型扫描 / 导入：重新扫描 ~/.ai-helper-agent/asr/models/，或从任意目录导入模型包；非法包会直接给出原因（缺 manifest.json、字段缺失、文件不存在、sha256_mismatch）
• “去授权”入口：仅在麦克风未授权时出现，点击后在本标签页弹出授权框

只有「依赖就绪 + 模型就绪 + 开关打开」三项同时满足，侧边栏才会出现 🎤，不需要重开面板。

完整启用步骤、模型包结构与 API → 语音输入（本地 STT）。

---

扩展（工具箱）配置

扩展标签页需 Agent 已连接 才可用，未连接时相关操作按钮为禁用状态。

MCP 服务器管理

• MCP 总开关：关闭后所有 MCP 工具将不会发送到 AI 上下文
• 搜索 + 筛选（全部 / 已启用 / 已停用）
• 增删改查 MCP Server，配置启动命令、参数与环境变量（敏感值用密码输入框）
• 连接 / 断开、启用 / 停用

Skill 管理

• Skill 总开关：关闭后所有技能内容不会注入到 AI 系统提示词
• 搜索 + 筛选（全部 / 已启用 / 已停用）
• 导入技能（JSON 文件）、重新加载技能列表

---

知识库（RAG）配置

知识库功能依赖 Agent 连接 + 依赖就绪，未就绪时显示门控引导（含就地安装引导）。

• RAG 总开关：全局启用 / 停用知识库检索
• 新建知识库：创建新的知识库集合
• 知识库卡片：编辑、导入文档、文档管理、检索测试、启用 / 停用、删除；显示文档数 / 分块数统计
• Embedding 配置（创建 / 编辑知识库时设置）：
  • 本地模式（local）：使用本地 Embedding，无可选参数
  • 远程模式（openai-compat）：配置 OpenAI 兼容的 Embedding 端点、API Key、模型名与向量维度（1–8192），支持「测试连接」验证

---

记忆（向量召回）配置

配置长期记忆的语义向量来源。本标签页的设置保存在 Agent 端 config.json 的 memoryEmbedding 字段，由扩展通过本地 HTTP 读写。

⚠️ 本标签页不再有独立的「保存到代理」按钮：点击页面底部的全局「保存配置」时，会先保存扩展自身设置，再顺带把本标签页的配置写入 Agent；若代理未连接则跳过这一项，仅保存扩展设置。

需 Agent 已连接 才可用，未连接时显示门控引导；选择「本地模型」还要求 RAG 依赖就绪，未就绪时给出就地安装引导。

参数	说明
启用语义召回（总开关）	默认关闭。开启后记忆召回叠加向量语义通道；关闭或向量配置不可用时自动回落关键词通道。切换即写入代理
向量索引状态	只读卡片：已索引 n / 共 m 条、已存向量指纹与当前配置指纹、生效档位；指纹不一致时标「已陈旧」并提示重建。代理版本过旧（无该状态接口）时单独提示升级
嵌入来源	单选：远端服务（OpenAI 兼容接口）（默认）/ 本地模型（复用 RAG 依赖与模型缓存，首次使用需下载模型）。选本地时隐藏下方所有远端字段，仅保留说明与重建入口
服务地址	OpenAI 兼容 Embedding 端点，如 https://api.openai.com/v1
模型名称	远端 Embedding 模型名，如 BAAI/bge-m3
API Key	出于安全不回显已存密钥（代理只返回 hasApiKey 标记），输入框留空表示不修改；「清除已存 Key」按钮仅在已存有密钥时显示——清除后远端语义召回立即停用、降回关键词档，直到重新填入并保存新 Key
向量维度	可留空（1–8192）；点「测试连通性」时实测并自动回填；手工填写的维度与端点实际返回值不一致不会被静默沿用
查询前缀（queryPrefix）	可选；部分模型要求「查询」与「入库」使用不同前缀（非对称检索）。留空则沿用 Embedding 提供方的默认前缀
测试连通性	用当前表单（含未保存的草稿值）实调一次 Embedding，成功显示「{模型} 输出 {维度} 维」；本地档无需测试
保存配置（页面底部全局按钮）	点击后顺带把本标签页配置写入 Agent config.json；来源 / 开关 / 前缀 / 维度等改动即时生效，无需重启代理。代理未连接时该项跳过，仅保存扩展自身设置
重建向量索引	用当前配置重算全部记忆条目的向量。执行前弹确认（实测本地档 41 条约 23 分钟、远端约 2 分钟），期间请勿关闭页面；完成后回报已索引条数、失败批次数与超出模型 token 窗口的条数

💡 为什么必须重建：向量按「来源 + 模型 + 维度 + 前缀」拼出的指纹归档。换配置后旧向量与新配置不可比，语义召回会静默退化（不报错，只是名次排不准）——状态卡显示「已陈旧」即表示尚未重建。

💡 本地档窗口限制：本地嵌入流水线在 512 token 处静默截断，超长记忆只有前部进入向量；批量过大时代理会自动拆批，实际耗时以代理日志为准。

💡 侧边栏「记忆」弹层（历史限制下拉）里的「＋」按钮，或 options.html#memory，都可直达本标签页。本标签页底部另提供记忆条目的查看与管理，见下节。

---

记忆条目管理

位于同一个「记忆」标签页底部，直接查看与修改 代理端持久化的记忆条目（真源 ~/.ai-helper-agent/memory/global-memory.json）。它解决的是「高价值记忆常驻系统提示词，但用户看不见也改不了」：纠错不必再回到对话里让模型先查 ID 再删，也不必手改 JSON（手改会留下指向旧条目的脏向量缓存）。

需 Agent 已连接 才可用；代理版本过旧（无 manage 接口）时如实提示升级重启，不会停在「读取中」。

区域	说明
条目列表	每行显示类型徽标（事实 / 摘要）、内容（默认两行截断，点击展开）、重要度、价值分、创建日期、最近访问与访问次数、标签；低价值候选行淡黄底高亮。列表自身限高内部滚动，条目再多也不会把整页撑高
刷新	重新拉取全量条目。列表读的是 manage 的 review（只读枚举），不会记入访问统计，侧边栏的正常召回不受影响
搜索框	按关键词过滤内容 / 标题 / 分类 / 标签，纯前端即时过滤，不重发请求
类型筛选	全部类型 / 事实 / 摘要
排序	创建时间（新→旧，默认）/ 重要度（高→低）/ 价值分（高→低）/ 价值分（低→高，淘汰视角）。同为纯前端重排，可与搜索、类型筛选叠加
编辑	弹窗可改内容、重要度（1–10）、标签（逗号或顿号分隔，留空即清空）；类型与分类只读。保存后代理会用新内容后台重算该条向量（仅语义召回启用时，失败只记日志）
删除	单条删除，弹确认；该条目的向量缓存同步摘除，不可恢复
低价值候选条 + 一键压缩	价值分低于 10 的条目会被列出，点「一键压缩」并在确认弹窗（含条数与阈值）后批量淘汰；完成后回报删除的事实 / 摘要条数

💡 与底部「保存配置」无关：编辑、删除、压缩都是点下就写入代理，不需要也不应该靠页面底部那个按钮提交。

💡 价值分由代理按「重要性 × 访问频次 × 时间衰减」算出，在界面上只读；想提升某条记忆的排序权重，改它的重要度即可。

---

键盘快捷键

快捷键	功能	平台
Ctrl+Shift+Y / Cmd+Shift+Y	全局快捷键打开侧边栏	Win / Mac
Alt+↑ / Alt+↓	跳转到上一个 / 下一个问题	Win / Mac
Alt+Ctrl/Cmd+↑ / Alt+Ctrl/Cmd+↓	回到对话顶部 / 跳到对话底部	Win / Mac
Tab（左侧把手）	聚焦把手并展开问题列表	Win / Mac
↑ / ↓ / Home / End（列表内）	在问题条目间移动，Enter 跳转	Win / Mac
Enter / Space（把手）	钉住 / 取消钉住问题列表	Win / Mac
Alt+S	全页面截图	Win / Mac
Alt+Shift+S	区域截图	Win / Mac
Ctrl/Cmd+T	打开 / 关闭工具配置	Win / Mac
Alt+/	打开快捷键面板	Win / Mac
Alt+N	新建会话	Win / Mac
Alt+W	关闭当前会话	Win / Mac
Alt+E	编辑最近一条用户消息	Win / Mac
Enter	发送消息	Win / Mac
Shift+Enter	换行	Win / Mac
↑ / ↓	输入历史（输入框内）	Win / Mac
Esc	清空输入框 / 收起问题列表（有搜索词时先清空）	Win / Mac

---

数据持久化策略

数据类型	存储位置	说明
扩展配置	chrome.storage.local	API Key、ReAct 参数、模型、图片识别、工具栏、厂商档案等
对话会话	IndexedDB (ai-helper-db)	活跃会话 + 归档会话
UI 原型	IndexedDB	按会话关联
工具栏配置	chrome.storage.local	工具列表、排序、域名屏蔽
输入历史	chrome.storage.local	去重自动管理
跨重启消息	chrome.storage.session	SW 重启恢复、后台任务持久化
记忆向量配置	Agent config.json 的 memoryEmbedding	由选项页「记忆」标签页读写，不在扩展存储里
长期记忆与派生向量	Agent memory/ 目录（global-memory.json / memory-vectors.json）	记忆条目是唯一真源，向量文件可丢可重建；选项页「记忆」标签页底部的条目管理区可直接增删改

IndexedDB 数据库设计

ai-helper-db (v6)，八个对象存储：

Store	用途
sessions	活跃会话（索引：updatedAt）
activeSession	当前活跃会话 ID
archivedSessions	已归档会话（索引：createdAt）
uiPrototypes	UI 原型（索引：createdAt, sessionId）
tokenStats	Token 使用统计（索引：timestamp, sessionId）
reactCheckpoints	ReAct Checkpoint 断点（索引：updatedAt；7 天 TTL 自动过期）
bookmarks	消息收藏（索引：sessionId, createdAt）
scheduledTasks	定时任务（索引：nextRunAt, enabled）

支持自动从事务失败恢复及旧版 chrome.storage.local 自动迁移。

---

配置导入 / 导出

选项页支持将整套配置导出为文件，或从文件导入，方便在多台设备间同步或备份。

• 导出：可选择是否包含 API 密钥（敏感信息，请确保文件安全）；导出文件包含除 Agent 连接信息外的所有配置
• 导入：导入前预览（导出时间、配置项数量）；支持两种策略：
  • 合并导入：与现有配置按厂商配置 ID 对齐合并
  • 替换导入：完全替换现有配置