FAQ
你可能想问的
这些问题在文档里都有明确答案。
我们只是把它写成了人话。
默认值
KIP 最常被问到的部分：为什么出厂是这样。
因为「默认关闭 ⇒ 工具不出现在注册表」本身就是安全设计，不是功能没做完。工具面越大，可被诱导的路径越多；先把默认值收窄、再逐项显式开启，比事后补审计便宜得多。你仍然可以用三档预设一键切到标准档或开发档，也可以逐个开关自己配。
safe（只读）：工作区只读、写入要确认、内置命令与自动验收禁止。外接代码根本不会被执行。适合首次安装或有合规限制的环境。workspace（可写需确认）：工作区可读写，命令与自动验收需确认，插件工具每次调用都要一次性审批。多数人的日常状态。trusted（放行）：全部放行。MCP 工具只在这一层才可能生效，因为它需要你明确配置服务器清单并接受信任边界。
当宿主没有接入任何插件权限判定时，调用会被拒绝而不是放行。理由是：宁可一个漏接线的宿主暂时丢掉这个功能，也不给它一条未经判定的执行路径。钩子门禁同理——钩子抛异常或返回非法值，一律阻止这次调用，而不是当作「没关系」继续。
不会。预设只是默认值的来源，实现上用「这个键是否存在」来判定，只填空缺。你把某个开关显式写成
false 与「从没写过这个键」是两回事，前者必须被尊重——否则开关就关不掉了。另外，切档接口只接受 preset 和 confirmation 两个字段，夹带其它字段一律 400，防止借切档顺带改写安全开关。MCP、文档生成、上下文压缩（Headroom）、模型重写上下文。它们的共同点是必须先有用户提供的本机资源才能工作——MCP 服务器清单、文档生成解释器路径、压缩运行时、压缩收益判据。放进任何档位的默认值，只会让用户看到「已启用但依赖缺失」的红色状态，那是噪音而不是能力。它们仍然可以在配置或设置里显式打开。
数据与密钥
哪些东西留在本机，哪些会出网。
聊天、记忆、配置、执行记录与用量都保存在本机应用数据目录，默认位置为
%APPDATA% 下的应用目录。完整备份包含私人聊天、记忆与加密凭据；默认只备份应用数据，不备份应用数据目录之外的项目工作区。Windows 上保存的模型密钥、配置中识别到的 token/password/secret，以及 MCP 环境变量与请求头，使用 DPAPI 当前用户级加密。原有明文配置在读取时迁移，失败时拒绝明文回退。需要说清楚的两点：同一 Windows 账户下的恶意程序仍然可能访问这些凭据，这个机制不是进程沙箱；密钥解密依赖原账户环境，换电脑前请准备重新配置密钥。
默认不会。内置 OCR 在本地离线识别图片文字（出厂即开），只有识别出的文字会随请求发出去，原图不出本机。图片直传（多模态）是可选项，出厂关闭；打开后遇到图表、UI 布局这类 OCR 表达不了的内容才会把原图交给模型。
记忆存在本机应用数据目录。召回默认只用词法 BM25，记忆不出本机；要加向量层必须显式选择回环地址，想用远程嵌入还需要二次确认。召回反馈只记录有界的效果计数（选中、使用、零召回等），不记录原始查询文本，也不会自动把某条记忆晋升为长期记忆。
装不上？工具不出现？
从下载到跑通第一个任务，以及那些「装了却不出现」的工具。
当前提供 Windows x64 便携版（KIP 0.9.5-beta.1）：解压即用，不需要安装程序，也不会覆盖你原有的配置。程序未做代码签名，首次运行时系统可能提示来源未知。部分能力（桌面自动化、DPAPI 凭据保护）仅 Windows 可用，其它平台会如实标注不可用且不注册工具。
因为工具只有在开关打开、依赖真实存在、当前安全模式允许三者同时成立时才注册。任何一项不满足，它就完全不出现在工具清单里，并如实返回不可用原因——而不是出现一个「一调用就报错」的假工具。文档生成、LSP 用的是同一套接入形态：未配置时工具不存在，绝不伪造可用。
沙箱后端不可用时会拒绝执行，绝不回退到宿主进程跑命令。文档生成的产物会先落暂存区做真实格式校验，校验失败即删除。生成脚本超时或取消时，结束整棵进程树，不留孤儿进程。未配置的开关对应的工具根本不存在，所以也不存在「调用了才发现没配」这种情况。
目前是手工安装更新。把新版本解压到新目录即可，安装目录和用户数据目录是分离的，卸载也不清理用户数据。升级前建议在「设置 → 工作区与数据」创建一份备份：备份带递归哈希清单与 SQLite 一致快照，恢复前会先校验全部文件与密钥可解密性，再替换数据，并保留一份替换前的旧数据目录。