Skip to content

FAQ

Jump to bottom
yxpil edited this page Sep 18, 2026 · 2 revisions

FAQ

数据存在哪里？会上传吗？

全部本地化：会话、记忆、技能、配置都保存在本机应用数据目录（Windows 默认 %APPDATA%\com.bit.hub，核心库为 bit.db），无遥测。设置了 BIT_DATA_DIR 环境变量时数据目录随之隔离；「AI 设置」页的诊断面板可直接查看数据目录与数据文件状态。

如何更换或新增模型？

「AI 设置」页添加提供方（OpenAI / Gemini / Claude 三种协议，可配置多家），填协议 / Base URL / API Key / 模型名，可点「从 API 获取」拉取模型列表。同一时刻只有一个提供方生效：点某条目的播放按钮即激活它，其余自动暂停。主流行模型有预设可一键填充，思考强度与温度也可调（部分模型不支持思考强度，报错就改回默认）。

托盘状态灯的颜色是什么意思？

托盘图标右下角的状态圆点：白色 = 空闲（启动后无任务），黄色 = 任务进行中，绿色 = 最近任务成功，红色 = 任务受阻。右键托盘图标弹出任务面板（会话回合、后台命令、子代理、活跃目标），鼠标悬停图标出现只读预览小窗，左键单击唤起主界面。

远程访问默认开启吗？安全吗？

默认关闭。在「远程」页手动开启后监听 127.0.0.1:8600（可改 0.0.0.0 供局域网访问），采用双重认证：自动生成的 Client Key（bit_ 前缀，Bearer 或 ?key=）+ 访问密码（X-Access-Password 头，默认 8 位数字自动生成）。只有 /api/health 健康检查免认证。Client Key 可一键轮换，轮换与远程访问都会记入审计。

Windows 提示 SmartScreen / macOS 提示「已损坏」怎么办？

安装包未购买代码签名证书（均为无付费证书的取舍）。Windows：SmartScreen 弹窗点「更多信息」→「仍要运行」。macOS：应用为 ad-hoc 签名，安装后执行 xattr -cr /Applications/BIT.app，或在 系统设置 → 隐私与安全性 中点「仍要打开」。详见 安装与更新。

AI 如何自己创建工具？

约定协议很简单：脚本从 stdin 读参数 JSON，把结果打印到 stdout。你可以自己在「工具」页写一段脚本、测试通过后保存为工具；AI 在对话中也能通过 add_tool / run_script 用已探测的本机解释器（Node、Python 等）写代码即刻执行，或沉淀为常驻工具（经 Rhai 沙箱受限执行，带深度 / 操作数 / 墙钟限额）。更多见 工具与-MCP。

怎么接入 MCP？

三种方式：在「工具」页扫描端口范围自动发现本机 MCP 服务器；直接粘贴端点 URL（Streamable HTTP）；或粘贴标准 mcpServers JSON 配置（stdio，兼容 Cursor / Claude Desktop 格式）。接入后其工具自动并入注册中心。反过来，触手怪自身也是 MCP 服务器，Claude Desktop 等客户端连 POST http://主机:端口/mcp 即可调用全部启用工具。

想找现成的 MCP 服务器，可看同作者的 TentacleTool（13 个零依赖 MCP 服务器，扫描端口即可接入）与 awesome-mcp-servers。

怎么下载、安装扩展插件？

触手怪的扩展分三层，都不需要联网安装包：本地插件是本地文件，MCP 扩展是连现成服务器，WorkWith 是托管你自己的程序。

本地插件的「安装」就是放文件：

  1. 拿到插件包（作者仓库 / Releases / 压缩包，或自己写）
  2. 解压到插件目录：Windows 为 %APPDATA%\com.bit.hub\toolhomes\plugins\，macOS 为 ~/Library/Application Support/com.bit.hub/toolhomes/plugins/（「工具」页 →「本地插件」区块直接显示该路径，点一下复制）
  3. 层级必须是 plugins/<插件名>/plugin.json（别多套一层）
  4. 回「工具」页点「重扫插件」→ 工具立刻可用

每个插件有独立启停开关，重扫不会丢掉你的选择；扫描失败的插件会被跳过并列出错误原因。完整的 plugin.json 字段表与示例见 扩展与插件。

WorkWith 是什么？怎么用？

WorkWith 是「服务」页的本地服务托管功能：用本机已探测的运行环境托管常驻程序（server.js、xxx.jar，或自定义可执行文件）。

你只需要在「服务」页新建条目、填程序路径、保存 —— 之后它会自动拉起程序、实时捕获日志、自动探测端口就绪并扫描接入为 MCP 服务器，该服务上的工具随即可用；停止或崩溃时自动禁用该 MCP 并同步移除工具，不留死工具。也可以勾选「会话联动」，让新会话首回合自动拉起。

字段说明与排错见 扩展与插件。

如何参与贡献？真的永久免费吗？

是。项目以 Apache-2.0 开源，所有功能无内购、无订阅、无功能锁，个人与商业使用均免费，可随时自行编译。欢迎提交 Issue 与 PR；本地开发、测试与发版流程见 开发与构建。

Clone this wiki locally