FAQ

中文 | English

安装与启动

macOS 提示"已损坏，无法打开"？

未购买 Apple 开发者证书（$99/年），ad-hoc 签名应用从网络下载后默认被拦。解决：

xattr -cr /Applications/BIT.app

或在 系统设置 → 隐私与安全性 → 点击"仍要打开"。原理：删除 quarantine 隔离标记，签名本身完整。

Windows SmartScreen 拦截安装包？

未做代码签名所致。点 "更多信息" → "仍要运行"。

杀毒软件会不会误报？

风险较低（Rust 原生编译、无加壳、元数据完整），但未签名 + 低流行度确实可能触发个别引擎启发式误报。便携版单文件 exe 概率高于 MSI/NSIS 安装包。遇到误报可向对应厂商提交白名单申诉。已签名的正式版本在计划中。

Linux AppImage 无法执行？

chmod +x BIT_0.5.6_amd64.AppImage && ./BIT_0.5.6_amd64.AppImage

ChromeOS 能用吗？

能，走 Crostini（Linux 开发环境）装 deb 包，见 安装指南。

AI 与对话

支持哪些模型？

任何可访问的 OpenAI 兼容 / Gemini / Claude 协议端点：DeepSeek、Kimi、通义、豆包、Ollama、LM Studio、one-api/new-api 中转等。同一时刻激活一个提供方。

"从 API 获取"模型列表失败？

部分中转/本地端点未实现 GET /v1/models。直接手填模型名即可，不影响对话。

回复中途截断 / 只输出一半？

上游 max_tokens 或余额限制。BIT 会归一化 finish_reason 并显式标注截断；若为上游配置问题请到提供方控制台调高。

AI 调用工具失败会怎样？

错误详情回传给模型继续自我纠正（例如参数缺失、幻觉工具名），不会中断会话。

缓存命中率是什么？

历史窗口按 8 条对齐回退，使相邻请求前缀逐字节一致，命中提供方提示词缓存（降低费用与延迟）。≥80% 显示绿色。

功能

远程访问默认开吗？

默认关闭，不监听端口。需在「远程」页显式开启。见 远程访问与-API。

自动更新怎么触发？

启动后自动检测并静默下载；标题栏出现更新 pill，点击安装；托盘退出时也会自动换装。见 自动更新。

AI 可以自己写工具吗？

可以，且可同名覆盖自己创建的工具；系统工具与远程工具不可覆盖。见 工具系统。

能接 MCP 服务器吗？

支持 Streamable HTTP 协议的 MCP 服务器，配置见 MCP-集成。

有命令行模式吗？

bit tui，支持会话/工具/记忆等全部核心能力，与桌面端并行运行。见 TUI-终端模式。

数据

数据存在哪？

随数据目录落盘（会话、工具、记忆、审计、配置均为本地 JSON），各平台路径见 MCP-集成。

换机器怎么迁移？

整目录拷贝数据目录即可（ai_config.json 含 API Key，注意保密）。

其他

有交流群吗？

QQ 交流群。

winget 安装报找不到？

winget install yxpil.bit 提交仍在微软审核中，可先用 Scoop 或直接下载安装包。