用户设置
运行时行为、热键、AI 目标和其他首选项通过 JSON 设置文件进行配置。这些文件允许你自定义浏览器端审查器的行为，以及它需要与哪个 AI 工具进行通信，而完全不需要修改你的构建或打包配置。
大多数第一次接入并不需要手动编辑这份文件。请先使用 assistant-first onboarding 或 inspecto init，只有在你需要调整运行时行为时，再回到这页。
文件解析顺序
Inspecto 会按照以下优先级（从高到低）在你的项目中查找并合并配置文件：
<cwd>/.inspecto/settings.local.json<cwd>/.inspecto/settings.json- ... 向上遍历所有父目录直至 git 根目录 ...
<gitRoot>/.inspecto/settings.local.json<gitRoot>/.inspecto/settings.json~/.inspecto/settings.json(全局用户目录)
最佳实践：
- 使用
settings.json存放团队共享配置，并将其提交到 Git 仓库。 - 使用
settings.local.json存放个人覆盖配置。CLI 会自动将此文件加入你的.gitignore。
配置示例
{
"inspector.hotKey": "alt",
"inspector.theme": "auto",
"ide": "vscode",
"provider.default": "copilot.extension",
"prompt.includeSnippet": false,
"prompt.autoSend": false,
"provider.claude-code.cli.bin": "claude",
"provider.coco.cli.bin": "coco"
}配置项参考
inspector.hotKey
- 类型:
string | false - 默认值:
"alt" - 描述: 唤起热键字符串。可以是组合键例如
"cmd+shift","ctrl","metaKey"。设为false可完全禁用热键触发功能。
inspector.theme
- 类型:
"light" | "dark" | "auto" - 默认值:
"auto" - 描述: 浏览器端面板的颜色主题。
"auto"会自动跟随操作系统偏好。
ide
- 类型:
"vscode" | "cursor" | "trae" | "trae-cn" - 默认值: 自动探测
- 描述: 强制指定 IDE 上下文。如果省略，Inspecto 会根据当前环境和项目上下文解析目标 IDE。
provider.default
- 类型:
string - 示例:
"copilot.extension","claude-code.cli","trae.builtin" - 描述: 默认将提取出的代码上下文发送给哪个 AI 工具及通过何种模式。assistant-first onboarding 通常可以自动解析这一项，因此大多数用户第一次接入时不需要先手动设置。
prompt.includeSnippet
- 类型:
boolean - 默认值:
false - 描述: 是否将原始代码片段以字符串形式注入到发给 AI 的 prompt 中。当使用诸如 Copilot/Cursor/Trae 等原生集成了 IDE 的 AI 工具时，将此项设置为
false（默认）可以为你节省大量 Token，因为 AI 本身已经可以直接读取到本地文件了。
prompt.autoSend
- 类型:
boolean - 默认值:
false - 描述: 是否在发送上下文后自动按下回车提交，无需等待用户确认。只有部分 assistant / IDE 组合支持这一能力；不支持的目标可能仍然会打开 prompt，但不会自动提交。
Inspect 菜单自定义 (prompts.json)
为了保持配置的整洁，我们将弹出菜单（意图菜单）的配置独立放在了 .inspecto/prompts.json 和 .inspecto/prompts.local.json 文件中。
- 类型:
Array<string | IntentConfig> | { $replace: true, items: Array<string | IntentConfig> } - 默认值: 预设的内置常见 Prompt 选项
- 描述: 自定义
Inspect mode下选中组件后弹出的 inspect 菜单里的 AI 快捷动作。
IntentConfig 结构:
id(string): 唯一标识符。label(string): 菜单按钮上显示的文本。prompt(string): 完整的基础 Prompt 模板。aiIntent("ask" | "fix" | "review" | "redesign"): 必填语义类型，Inspecto 会基于它决定默认上下文附加等行为。prependPrompt(string, 可选): 在基础 prompt 最前面追加的文本（会自动换行拼接）。appendPrompt(string, 可选): 在基础 prompt 最后面追加的文本。enabled(boolean, 可选): 设为false可在不删除配置的情况下隐藏该项。
源码跳转不通过 prompts.json 配置。Open in Editor 仍然是 inspect 菜单头部提供的内置能力。
证据入口同样不通过 prompts.json 或 settings.json 配置。
bug和css都属于内置 UI 能力，不是用户 schema 字段。- 只要当前运行环境支持，对应入口就默认显示。
- 如果当前项目或目标不支持该能力，Inspecto 会自动隐藏入口。
- 是否真的把证据附加到本次发送，由当前会话中的图标开关决定，而不是由持久化配置决定。
screenshot在这一版 annotate 流程中暂不对外暴露，也不应建模成用户设置项。
数组语法（追加模式，默认）： 在 prompts.json 中直接导出一个数组。你的配置会追加或覆盖到内置的同名 Prompt 上。
[
{
"id": "add-i18n",
"label": "添加国际化",
"aiIntent": "review",
"prompt": "请帮我提取 {{file}} 这个文件中的中文硬编码，并使用 i18next 进行替换。"
},
{
"id": "explain",
"label": "中文解释",
"aiIntent": "ask",
"prependPrompt": "你是一个前端专家，请用中文回答。"
}
]对象语法（完全替换模式）： 在 prompts.json 中导出一个带有 $replace: true 的对象，将彻底丢弃所有内置的菜单项，只渲染你提供的 items。
{
"$replace": true,
"items": [
{
"id": "improve",
"label": "提升可读性",
"aiIntent": "review",
"prompt": "请审查 {{file}} 中的代码，并给出务实的可读性改进建议。"
}
]
}兼容性提示: 在早期版本中，这些配置可能被写在
settings.json的"prompts"字段下。Inspecto 依然兼容读取包含{"prompts": [...]}的prompts.json文件，但推荐直接在顶层导出数组或对象。
Prompt 模板支持的内置变量：
: 当前组件的文件路径: 源码行号: 源码列号: 组件名 (例如Button.tsx的 Button 或代码片段内解析到的名称): 文件后缀名 (如tsx,vue): 自动推断的框架名称 (如React,Vue,Svelte)
工具层级覆盖 (provider.<name>.<mode>.<option>)
使用扁平的点符号结构对单一工具的属性进行精细控制。<name> 是工具的核心品牌名（如 copilot, claude-code），<mode> 可以是 extension, cli 或 builtin。
把它们视为高级覆盖选项即可。大多数用户在首次接入时并不需要配置这一层。
bin: CLI 可执行文件名称或绝对路径（仅限 CLI 模式）。args: 传递给命令行的额外启动参数数组（仅限 CLI 模式）。cwd: CLI 进程运行的工作目录（仅限 CLI 模式）。coldStartDelay: 毫秒级别的等待延迟时间（仅限 CLI 模式）。
CLI 冷启动延迟
当在终端集成模式下使用 claude-code 或 coco 这样的 CLI 工具时，IDE 扩展必须等待该 CLI 工具彻底初始化其交互式的 REPL（等待它准备好接收输入），然后才能将初始的 Prompt 粘贴进去。
由于初始化的速度极大地受限于你的机器性能、网络速度、甚至鉴权校验状态，首次执行的安全延迟默认被设置为 5秒 (5000ms)。
你可以通过调整此延迟来匹配你机器的真实性能，从而获得更快的响应：
{
"provider.claude-code.cli.coldStartDelay": 2000
}注意： 如果你把这个数值设得太低，CLI 工具可能会在它的启动清屏动作中，将你发过去的上下文意外清除。该延迟 仅 发生在第一次唤起 CLI 终端时，后续的会话请求都将瞬间完成。