# Bi — 本地智能体工作台 > v0.1.11 Bi 是一个本地智能体工作台：选一个文件夹，用一句话描述任务，它自主规划、执行并交付。过程全程可视，任意步骤可回退。 本页汇总 Bi 的完整文档内容，供 LLM 与检索工具直接引用。 --- # 安装与首次运行 下载、解压与模型配置。 Bi 以压缩包或安装盘形式提供，不需要安装依赖，也不需要单独的运行时。 下载 前往下载页 (/download)，按系统选择对应产物。每个平台提供 x64 与 ARM64 两种架构： - Windows：解压后运行 bi-windows-.exe。请先解压，不要在压缩包内直接双击，否则 ocr/ 无法随程序加载。 - macOS：推荐 .dmg 安装盘，双击挂载后把 Bi 拖入「应用程序」；也可以使用绿色版 .zip。 - Linux：解压后运行对应架构的可执行文件。 ocr/ 是文档识别组件，需要与可执行文件保持同级。删除它只会失去扫描件的文字识别能力，其他功能不受影响。 首次运行 启动后 Bi 在本机运行，并自动在浏览器中打开工作台。三个平台的操作方式略有不同： - Windows 以 GUI 模式启动，并常驻系统托盘。 - macOS 提供菜单栏图标，可打开工作台、工作区、配置目录与日志。 - Linux 以服务模式运行，界面在浏览器中访问。 数据保存在程序目录旁的 .bi 目录内：设置与模型密钥、会话记录、本地数据库和运行日志都在这里。Bi 没有自己的服务器。 配置一个模型 Bi 不包含模型。首次使用前，在「设置」中添加至少一个模型服务——云端 API，或本机运行的 Ollama / LM Studio。具体步骤见添加模型 (/docs/configuration/providers)。 校验下载（可选） 下载页给出了每个文件的 SHA-256。按系统执行： macOS / Linux shasum -a 256 bi-linux-amd64.zip Windows PowerShell Get-FileHash .\bi-windows-amd64.zip -Algorithm SHA256 把输出与下载页显示的值比对即可。 --- # 快速开始 用五分钟走通一次完整的 Bi 任务流程。 本页带你走通一次完整的「提出任务 → 智能体执行 → 查看产物」流程。 1. 选定工作区 在界面中选择任务所在的工作区。Bi 将该工作区作为边界：所有文件操作都限制在其中，范围之外的路径一律拒绝。 2. 提出一个可以验收的任务 与其说「帮我看看这个项目」，不如给一个能判断是否完成的目标。例如： 阅读 src 目录下的入口文件，梳理模块依赖关系，并写入 DEPENDENCIES.md。 目标越具体，智能体越容易判断何时算完成，你也越容易验收。 3. 观察它如何执行 对话区会实时显示智能体正在做什么：读取了哪些文件、运行了什么命令、修改了哪些内容。首次写入文件或运行命令时，Bi 会请你确认。 如果某些只读操作反复打断你，可以在设置中把低风险操作设为自动放行，见需要你批准的操作 (/docs/configuration/permissions)。 4. 查看产物 生成的文档、图片和代码会出现在产物面板中，可以直接预览；终端输出与本次改动清单也在这里，见产物面板 (/docs/using-bi/artifacts)。 5. 不满意就回退 关键节点留有检查点。如果某一步出现偏差，退回该检查点让智能体重新执行，无需重开会话，见检查点与回退 (/docs/advanced/checkpoints)。 下一步 - 它能做什么 (/docs/using-bi/tools) —— 智能体具体可以完成哪些事 - 工作区 (/docs/using-bi/workspace) —— 边界如何划定 - 添加模型 (/docs/configuration/providers) —— 接入云端或本地模型 --- # 配置概览 设置界面、本机配置文件与数据位置。 Bi 的设置在界面中完成，保存后立即生效，不需要重启。 设置保存在哪里 设置与数据都保存在程序目录旁的 .bi 目录内： - 偏好设置 - 模型密钥 - 会话记录与本地数据库 - 运行日志 macOS 的 Bi.app 把 .bi 与工作区放在 app 所在目录旁；如果安装在「应用程序」等只读位置，会回退到 ~/Library/Application Support/Bi。 隐私 Bi 没有自己的服务器。配置与模型密钥只保存在本机；密钥与会话内容只在你和所配置的模型服务之间传输。使用本机模型时，内容可以完全不离开这台电脑。 界面与配置文件 界面修改的就是本机配置，两者始终一致。日常使用在界面中操作即可；需要批量修改或自行备份时，也可以直接编辑配置文件，保存后即时生效。 端口 工作台通过本机端口在浏览器中打开，通常无需改动。如果端口已被占用，可以在设置中更换。 相关 - 添加模型 (/docs/configuration/providers) - 需要你批准的操作 (/docs/configuration/permissions) - 本地服务与访问 (/docs/reference/http-api) --- # 模型提供商配置 接入云端模型或本机模型，并设置自动切换。 Bi 通过通用的模型接口与服务通信，大多数模型服务都能直接接入。 添加一个服务 在「设置」中填写： - 服务地址（Base URL） —— 接口地址，例如 https://api.openai.com/v1 - API 密钥（API Key） —— 你在该服务处的密钥 - 模型名 —— 例如 gpt-4o - 接口类型 —— 通常选择 OpenAI 兼容；使用 Ollama 时也可选其原生接口 可以为每个模型标注能力（视觉、工具、推理）和上下文长度，用于界面展示与筛选。 密钥保存在哪里 密钥保存在本机的 .bi 目录内。Bi 没有自己的服务器，密钥只会发送到你填写的服务地址。 本地模型 把服务地址指向本机运行的模型服务，内容就不必离开这台电脑。常见选择： - Ollama - LM Studio - vLLM 默认模型与自动切换 你可以固定使用某一个模型，也可以交给自动选择。自动选择会在可用模型之间挑选；某个模型暂时不可用（连接失败或超时）时，会改用其他可用模型继续本次任务，无需中断。 长会话 上下文如何被压缩与延续，见长会话的上下文延续 (/docs/advanced/context)。 --- # 需授权操作 默认每一步都要确认，再按需放行低风险操作。 Bi 的默认做法是：智能体的每一次操作都需要你的确认，包括读取文件。控制权先交给你，再由你决定哪些操作可以免去确认。 在保持整体安全级别的前提下，通过按需设置自动放行提升易用性。 默认需要确认 在默认设置下，智能体的每一步都会弹出确认框： - 读取或查找文件 - 新建或修改文件 - 运行命令 你可以逐一批准，也可以拒绝。 设置自动放行 如果某些操作你反复批准、并且确信没有风险，可以在「设置」中把它们设为自动放行。常见的做法是： - 只读查看，例如查看文件、列出目录 - 运行测试或检查类命令 写入文件和运行命令的风险更高，建议保持确认。 与危险操作拦截的关系 除了逐次确认，Bi 还会拦截一部分明确危险的命令（例如删除、推送代码、修改权限）。这类操作会被直接拒绝，不会执行，详见危险操作拦截 (/docs/advanced/intercept-rules)。 工作区边界 无论权限如何设置，文件操作都被限制在你选定的工作区内，范围之外的路径一律拒绝。这是与权限独立的一层保护，无法通过设置放宽。见工作区 (/docs/using-bi/workspace)。 --- # 能力范围 智能体在工作区内可以完成的几类工作。 在你选定的工作区内，智能体可以完成以下几类工作。每一步都可见，也可以按需批准或拒绝。 阅读与查找 按文件名或内容查找，并读取文件。用于快速了解项目、定位相关信息，无需遍历整个目录。 修改文件 新建或更新文件。所有改动都会被记录，并留下可回退的检查点，见检查点与回退 (/docs/advanced/checkpoints)。 运行命令 执行命令并获取输出，用于构建、测试、处理数据。运行前会先请你确认，见需要你批准的操作 (/docs/configuration/permissions)。 如果命令依赖的程序未安装，Bi 会直接告诉你缺了什么，并给出对应系统的安装建议。需要管理员权限的安装仍需你手动执行；系统级安装命令（brew / apt / winget 等）始终需要确认。 了解项目结构 列出目录结构，并定位代码中的函数、类型和变量定义，帮助智能体和你在不盲目搜索的情况下熟悉项目。 并行处理 当一个任务可以拆成几件互不依赖的事时，智能体会派生多个实例同时处理，再汇总结果，缩短等待时间。见并行子任务 (/docs/using-bi/subagents)。 边界 无论执行哪类操作，文件访问都限制在工作区内；运行命令同样受权限与拦截规则约束。能力更多，不代表权限更大。 --- # 工作区 用工作区限定智能体可以操作的范围。 工作区是智能体可以操作的边界。选定工作区后，所有文件操作都被限制在它的范围内。 为什么要设定边界 没有边界的智能体可能顺着相对路径走到项目之外，误改无关文件。限定一个工作区，就把影响控制在你明确选择的范围内。这层保护独立于权限设置，无法通过自动放行放宽。 切换工作区 不同项目使用不同的工作区。切换后，新建的会话以新的范围为准；已有会话保留各自的路径。 查看项目结构 智能体只会展开工作区内的目录，帮助你和它自己快速了解项目结构。 项目设置 选好项目目录后，输入框旁「项目目录」胶囊右侧会出现一个齿轮。点开可以为这个项目单独设置： - 提示词：项目系统提示词，保存后追加在全局提示词之后，写入项目目录下的 .bi/agent.md。输入框实时显示字节数，超过 64KB 会禁止保存。 - 插件：默认全部启用；取消勾选的插件只在本项目中不可用，全局不受影响。 - 技能：勾选声明了 pin: true 的技能作为项目级常驻技能，该项目下所有会话每轮自动注入。 三个 tab 的改动在点「保存」时一并落盘；切换 tab 只切换视图，不会丢改动。未选择工作区的会话不显示此入口。 相关 - 会话 (/docs/using-bi/sessions) - 需要你批准的操作 (/docs/configuration/permissions) --- # 产物面板 集中预览智能体生成的文件与执行输出。 智能体生成的图片、文档和代码会集中出现在产物面板中，无需在临时目录中查找。 支持的预览 - 图片：直接显示 - 代码：语法高亮 - Markdown / 文本：按排版显示 - Office / PDF：抽取文本预览；扫描件与图片由本地 OCR 处理 终端与改动 面板中还包括终端输出和本次会话的改动清单。改动以行级 diff 展示，采纳之前可以先看清智能体做了什么。 收尾与回退 确认无误后，把产物移动到工作区的正式位置，就可以继续下一步。如果某个改动不对，回到对应检查点回退，见检查点与回退 (/docs/advanced/checkpoints)。 相关 - 会话 (/docs/using-bi/sessions) - 内置终端 (/docs/using-bi/terminal) --- # 技能 将重复流程封装为可复用的技能。 如果同一套流程需要反复交代，可以把它封装成技能。 什么是技能 技能是一段可复用的说明，告诉智能体遇到特定任务时应当怎么做。它把「每次重新描述」变成「调用一次」。 使用技能 在会话中通过技能名称调用。智能体按技能定义的流程执行，免去重复说明。 适合的场景： - 反复进行的同类任务，例如生成某类报告、按固定流程检查代码 - 团队内共享的一套标准做法 - 一段较长的说明中，你只需要用到其中一部分 子目录与技能包 技能可以放进子目录分类。技能名就是 / 分隔的相对路径，例如 文案/品牌文案.md 对应技能 文案/品牌文案。 目录里含 SKILL.md 时，整个目录算一个技能包：技能名取目录名，调用时只注入 SKILL.md，同目录其他文件作为伴随文件，由智能体按需用 read 读取。选择器把技能包显示为单独一条（带目录图标），伴随文件不会出现在列表里——但搜索伴随文件名仍能命中所属包，也可以用 [skill:包/伴随] 手工挂载单份。流程很长时适合这样做：入口保持精简，细节用到才加载。 常驻技能 用 / 调用的技能只对当前这一轮生效。要让技能跨多轮保持，把它固定住： - 会话级：输入框上方的常驻技能栏。技能文件声明 pin: true 后会出现在这里，点击即为本会话开启，每轮自动注入，直到你关掉或切换会话。 - 项目级：项目设置弹窗的「技能」tab。在这里固定，该项目下所有会话都生效，同项目目录的使用者共享。 三层并存、互不冲突：一次性 [skill:xxx] 标记、会话级固定、项目级固定会在每轮取并集去重后注入。上下文面板的「技能内容」段会显示本轮注入了哪些技能及其 token 占用。 技能要出现在常驻栏，需在 frontmatter 里声明 pin: true（声明不等于自动启用，仍需手动开启）： --- name: 水保方案 description: …… pin: true --- 技能目录下的加密技能（.skl）在读取时自动解密，因此加密交付下伴随文件同样可用。 相关 - 插件 (/docs/using-bi/plugins) - 并行子任务 (/docs/using-bi/subagents) --- # 并行子智能体 将可并行的任务分派给多个子智能体。 单个智能体按顺序处理任务，遇到本可以同时进行的部分就会浪费时间。并行子任务让它们同时开工。 如何工作 主智能体把其中一部分交给自己派生出的其他实例处理，同时继续处理别的工作，最后汇总各方结果。 适合的场景 - 任务能拆成几件互不依赖的事，例如同时调研若干个库 - 希望得到几份独立的产出，例如每个模块一份小结 - 范围较大的查找，拆开能明显缩短等待 需要注意 每个并行实例都会各自消耗模型额度。它们在各自的范围内工作，结果由主智能体整合后统一交付。 相关 - 会话 (/docs/using-bi/sessions) - 它能做什么 (/docs/using-bi/tools) --- # 插件 通过安装插件扩展智能体的能力。 插件让 Bi 借助外部程序获得新的能力，从而处理更多类型的任务。 安装插件 每个插件是一个独立目录。将其放入程序目录下的 .bi/plugins 目录中，重启后即会加载。之后每次启动都会重新扫描该目录，因此更新插件后重启即可生效。 使用插件 插件加载后，它提供的能力会像内置能力一样，由智能体按需调用；调用前同样会请你确认。 按项目启用 在项目的设置弹窗中，可以取消勾选不希望在本项目里使用的插件。这只影响当前项目，全局配置保持不变。见工作区 (/docs/using-bi/workspace)。 安全提示 插件本质上是在你电脑上运行的程序，等同于你亲自运行它。安装第三方插件前，请确认它的来源与行为是否可信。 加载失败 如果某个插件无法加载，Bi 会跳过它并记录日志，不影响正常会话。 相关 - 技能 (/docs/using-bi/skills) - 需要你批准的操作 (/docs/configuration/permissions) --- # 内置终端 在界面中直接操作命令行，并区分它与智能体运行命令。 Bi 中有两种「运行命令」的入口，容易混淆，先区分清楚： 入口 谁来用 结果去哪里 --- --- --- 终端面板 你本人 只显示在屏幕上，不会进入模型的上下文 智能体运行命令 智能体 作为运行结果反馈给智能体，供它继续处理任务 终端面板 界面中的「终端」是一个可以持续使用的命令行窗口，供你手动操作： - 工作目录取自当前会话的工作区；未设置会话时使用全局工作区 - 输出逐行显示，中文不会乱码 - 它的输出只显示给你，不会自动提供给模型 智能体运行命令 智能体执行的命令在工作区根目录下运行，结果会反馈给它，用于继续推进任务： - 运行前会请你确认（除非你把相应操作设为自动放行） - 命令会经过危险操作拦截 (/docs/advanced/intercept-rules)检查 因此，「命令的输出会进入上下文」只对智能体运行命令成立。如果你希望智能体看到某条命令的结果，应当让它去运行，无需在终端面板中运行后再粘贴结果。 关于联网 智能体运行的命令可以访问网络（例如下载文件、安装依赖、拉取代码）。这是功能的一部分，但意味着： - 即使使用本地模型，也不等于「绝不联网」——命令本身仍可能发起网络请求 - 运行命令前的确认是主要的人工把关环节，请留意你批准的每一次运行 相关 - 需要你批准的操作 (/docs/configuration/permissions) - 工作区 (/docs/using-bi/workspace) --- # 会话 会话的保存、与工作区的关联，以及导出。 会话把一次完整的工作过程保留下来：对话、执行过程、产物和用量统计都归属于同一个会话。 会话里保存什么 会话保存在本机。它记录用户与智能体的会话、智能体执行的过程（读取和写入的文件、运行的命令）以及用量统计，方便随时回看。 会话与工作区 每个会话可以关联各自的工作区： - 不同项目各自开一个会话，智能体只在对应会话的工作区内活动 - 未单独设置时，会话使用全局工作区 这样，一个 Bi 进程可以同时推进多个互不干扰的项目。 管理会话 可以置顶、重命名或删除会话。删除会话时，其中的会话记录会一并移除。 导出会话 可以把会话导出为 Markdown 文件，保存在工作区内。导出内容为纯文本，包含提问、回复、思考过程、执行过程与结果，以及权限确认记录，方便归档，也方便交给其他 AI 工具继续处理。 相关 - 工作区 (/docs/using-bi/workspace) - 长会话的上下文延续 (/docs/advanced/context) --- # 检查点与回退 出现偏差时可退回上一步继续，无需重新开始。 让智能体放手修改的前提是：改错了能退回来。Bi 的检查点就是为此而设。 它做什么 Bi 会在关键节点自动留下检查点，记录该步骤之前的状态。如果后续改动出现偏差，可退回某个检查点，让智能体从那里重新开始。 如何使用 在产物面板的改动清单中找到想回退的节点，选择回退。Bi 会恢复文件状态，你可以让智能体换个思路再试。 与版本管理的关系 检查点由 Bi 内置，无需你手动管理版本历史，适合「小步试错」。如果你需要长期追溯历史，仍建议使用专业的版本管理工具。 存储占用 检查点会随会话逐渐积累，占用一定空间。不再需要时，可以在产物面板中清理旧的检查点。 相关 - 产物面板 (/docs/using-bi/artifacts) - 会话 (/docs/using-bi/sessions) --- # 长会话的上下文延续 较长会话中早期内容的处理方式。 在较长的会话中，模型每次能够参考的内容是有限的。为支持长任务持续进行，Bi 会自动处理历史内容： - 最近几轮完整保留 - 更早的内容被整理成一段摘要，包含你的要点、已经得到的结论以及改动过的文件 - 过于久远的内容会被舍弃 整理摘要不会额外消耗模型额度。 这意味着什么 会话越长，越早的细节就越容易被概括掉。如果某段信息仍然重要，可以在后续会话中重新说明，或者新开一个会话专门处理它。 上下文预算 每轮提示词有硬上限。超出时，旧的工具结果会收缩成占位，避免上下文无限膨胀；这与上面的历史摘要是同一套预算机制的两面。取舍是明确的：少读无关内容，把预算留给当前任务。 是否需要设置 这一处理自动进行，默认设置对大多数任务都合适，通常无需手动调整。 相关 - 添加模型 (/docs/configuration/providers) - 会话 (/docs/using-bi/sessions) --- # 危险操作拦截 对明确危险的命令直接拒绝执行。 除了逐次请你确认，Bi 还会对一部分明确危险的命令进行拦截，命中后直接拒绝执行，作为比权限更硬的一道关卡。 会被拦截的操作 - 破坏性命令，例如删除文件、推送代码、发布等 - 修改文件权限的命令 - 用命令去做本应由专用能力完成的事，例如用命令读文件、写文件、搜索 - 未登记的插件或能力名称 这些是内置的默认规则，开箱即生效。你也可以在设置中增删自己的规则。 命中后会怎样 被拦截的调用会直接拒绝，不会弹出确认框。智能体会收到失败原因，并尝试其他做法。 部分规则可以改为「需要确认」：命中后弹出确认框，由你当场批准或拒绝，批准后才会执行。 与权限设置的关系 两者都用于把关，但作用不同： - 需要你批准的操作 (/docs/configuration/permissions)命中后会弹出确认框，你可以当场放行 - 拦截规则命中后直接拒绝，没有确认环节 两者叠加生效，只有都被允许，操作才会真正执行。 一处常见误解 拦截规则只针对命令内容，不能用来限制「访问工作区之外的路径」。工作区边界是另一套独立的保护机制，无法通过设置放宽。见工作区 (/docs/using-bi/workspace)。 --- # 本地服务与访问 了解 Bi 在本机的运行方式与访问范围。 Bi 在本机运行，并在浏览器中打开工作台。它无需连接 Bi 的服务器——Bi 没有自己的服务器。 它是如何运行的 启动后，Bi 在本机运行一个本地服务，界面通过浏览器访问它。你可以把它理解为一个只在你电脑上运行的小型应用，数据都保存在本机。 谁可以访问 默认情况下，本机上的浏览器即可访问。请留意谁能够访问这个地址：同一局域网中的其他设备、本机上的其他程序，都可能访问到它。 因此，不建议在不可信的网络环境中把它开放给外部访问。如有需要，可以通过系统防火墙或调整监听范围来限制访问。 端口 界面使用的端口可以在设置中修改。如果默认端口已被占用，可以更换为其他端口。 安全提示 请把它当作本机应用来使用，不要把它当作对外提供服务的安全屏障。 相关 - 设置与配置 (/docs/configuration/overview) - 常见问题 (/docs/troubleshooting) --- # 常见问题 使用中可能遇到的问题及处理办法。 遇到问题时，可以先对照下面几种常见情况。 端口被占用，无法启动 - 确认是否已经有另一个 Bi 正在运行 - 确认系统防火墙是否放行 - 在设置中把端口更换为其他值 界面打开了，但显示的是旧版本 浏览器可能缓存了旧页面，强制刷新一次即可： - Windows：Ctrl + Shift + R - macOS：Command + Shift + R 中文显示乱码 终端面板中的输出通常不会乱码。如果在 Windows 控制台直接运行命令时出现乱码，多与系统的字符编码设置有关。 智能体一直停在等待确认 默认情况下，每一次操作都需要你的确认。如果一直没有看到确认提示，请检查设置中是否关闭了确认机制，或者该操作已被拦截规则拒绝。 模型报错或连接失败 - 检查设置中的服务地址、密钥和模型名是否填写正确 - 如果某个模型暂时不可用，可以改用其他模型 - 使用自动选择时，某个模型不可用会自动尝试其他可用的模型 会话不见了 会话保存在本机。请不要删除程序目录下的 .bi 目录。如果会话已被删除，目前无法恢复；建议对重要的会话及时导出为 Markdown 备份，见会话 (/docs/using-bi/sessions)。 磁盘占用变大 检查点会随着会话逐渐积累，占用一定空间。不再需要时，可以在产物面板中清理旧的检查点，见检查点与回退 (/docs/advanced/checkpoints)。 仍然无法解决 请先记录以下信息，便于排查： - 出问题时的现象 - 复现的步骤 - 你当时的操作 寻求帮助时请一并提供这些信息，并注意不要附带模型密钥。 --- 英文版：https://basein.cn/docs/llms-full.en.txt