常见问题
安装与更新
两个都还没有安装包:鸿蒙(HarmonyOS)即将支持,Linux 仍在规划中。目前提供 macOS(Apple Silicon / Intel)与 Windows x64。见安装与更新。
设置 → 关于 里有预览版开关。打开后会收到正式版发布前的版本;关掉就回到最新正式版(按钮显示为「回到正式版」)。预览版的版本号旁会标注「预览版」。
不会。触发更新时应用会先提示你,不会打断进行中的对话。
登录与账号
是的,登录是启动闸门。登录后不必马上绑模型也能浏览界面,第一次发送消息或创建项目时才会引导你绑定。
应用会轮询授权结果,正常情况下几秒内自动跳转。超时会提示重试 —— 回到登录页重新点一次即可。确认这台机器能正常联网。
模型
免费模型登录即用、不需要 API Key,适合起步。TaoToken 订阅需要先买套餐、生成 Key 并绑定,能解锁全部订阅模型。此外还可以复用本机已装的命令行 AI 工具,或用自己的 API Key(BYOK)。四种方式见模型与用量。
推理可以,登录不行。用本地模型(如 Ollama)或本机命令行工具时,推理本身不需要联网,但登录这一步仍然要联网。哪些环节需要联网见数据与隐私。
自建网关和 Ollama 本地模型往往拿不到服务端的模态信息。在 BYOK 配置里手动指定 图片支持(支持 / 不支持)与上下文窗口即可,不要留在「自动判断」。
网络瞬时故障会自动重试并重建连接,断流会自动重连并重发该轮,过程在对话里按「第 N 次尝试」显示。重试有整体时间上限,不会无限空等。报错时结论一行说清,完整原文在「查看详情」里。
权限与安全
默认档是自动编辑 —— 工作区内的文件编辑不再逐个打断你。想每一步都确认,切到变更前确认;想让它只看不动,切到计划模式。见权限模式。
不是。计划模式硬拦一切写操作,不会弹审批让你放行。看完方案点开始执行回到原来的档位,或者手动切档。
不能。切档从下一次工具调用开始生效。要立刻停下来请用停止(⌘ + Shift + X 或 Esc)。
不是。 那道断路器只认 shell 删除命令的字面形态,覆盖不到 MCP 工具和任意代码执行(python -c ... 之类)。它是防模型参数幻觉的保险,不是一道完整的安全边界。完整说明见权限模式 · 已知边界。
使用
每轮回答末尾的「已编辑 N 个文件」卡片上有撤销,一键还原本轮改动。也可以在审查面板按文件还原。非 Git 项目没有版本历史可回退,会明确提示无法撤销。
技能与搜索设置的改动都在下一个新任务里才生效,已在进行的任务不受影响。开个新任务再用。
两条路:用「从某条消息继续到新任务」把关键结论带进一个新任务;或者换一个上下文窗口更大的模型。见任务与并行。
不填 Key 时走的是全体用户共用的免费共享额度,容易打满。在 设置 → 搜索 填自己的 Exa Key 即可走独立配额。见联网搜索。
这两个命令需要一个可扫描的工作区。普通对话(新建任务时没绑项目)里不会出现。新建一个绑定了项目目录的任务即可。
新建任务时选新工作树 —— 给任务一份物理隔离的检出目录,几套方案并行试而互不干扰。见工作树与环境。
数据
代码和任务记录默认留在本机。发给模型的内容会走模型服务商,此外还有匿名的使用情况统计。完整清单见数据与隐私。
整份拷走 ~/.config/inscode/ 即可 —— 任务记录、模型配置、技能、插件都在里面。项目级的技能和 AGENTS.md 跟着仓库走,不用单独处理。
界面上只显示打码后的值,真实 Key 存在本机应用数据目录里、文件权限已收紧,但还没有迁移到系统钥匙串 / 凭据管理器。请在自己信任的设备上使用。
没找到答案?侧栏帮助菜单里有问题上报和用户社群入口。