文档 · BoltLynx 闪喵

快速开始

先设置智能体执行行动的机器或隔离环境。一个本地客户端可以供多个智能体使用。

安装本地客户端。
启动本地客户端，并在浏览器中确认配对页面。
进入网页端，创建或选择智能体。
选择允许智能体使用的项目目录。

Windows 本地客户端

下载 Windows 启动器：

下载 Windows 启动器

创建一个长期保留的正式目录，例如 C:\BoltLynx，然后将 ZIP 中的全部文件解压到该目录。这是绿色版，不需要安装程序。

不要在 ZIP 压缩包窗口中直接运行 boltlynx-desktop.exe。Windows 可能会从临时目录启动它，之后你可能找不到启动器及其本地文件。

进入解压后的目录，双击 boltlynx-desktop.exe。Windows 启动器用于管理本地客户端，不是与智能体对话的界面。你可以用它启动或停止客户端，以及打开或复制配对页面。

因为当前早期桌面版还没有代码签名，Windows 可能会弹出 Microsoft Defender SmartScreen 警告。如果你是从上面的官网按钮下载的，点击 更多信息，然后点 仍要运行。

如果杀毒软件将 Windows 启动器标记为威胁

本地客户端可以执行你授权的系统、命令和文件操作，因此未签名版本可能触发杀毒软件的启发式检测，例如 Trojan:Win32/Sprisky.U!cl。不要看到告警就直接允许。

先确认 ZIP 来自上方官网按钮，并确认被检测的文件确实是 C:\BoltLynx\boltlynx-desktop.exe。如果来源、文件名或被检测文件不符，请删除它，并从官网按钮重新下载。
确认无误后，打开 Windows 安全中心 → 病毒和威胁防护 → 保护历史记录，展开该检测项，选择在设备上允许；如果文件已被隔离，选择还原。不同 Windows 版本的名称可能略有不同。
如果 Defender 反复隔离已确认的文件，进入病毒和威胁防护设置 → 管理设置 → 排除项 → 添加或删除排除项，选择文件夹，仅添加 C:\BoltLynx。

不要关闭实时保护，也不要将“下载”、整个用户目录或整个磁盘加入排除项。

Microsoft 官方说明：保护历史记录和添加文件夹排除项。

配对完成后，让本地客户端在后台运行。进入网页端与智能体对话，并选择允许它使用的项目目录。

有新版本时，Windows 启动器可以下载新的本地客户端。因为它是绿色版，本地文件会保存在启动可执行文件的目录中。

Linux 命令行

安装本地客户端：

curl -fsSL https://boltlynx.com/install.sh | bash

安装程序会把 boltlynx 可执行文件放到 ~/.boltlynx/bin/ 并加入 PATH。重启终端，然后启动本地客户端。首次运行时，命令会显示一个配对页面链接；在浏览器中打开并确认后，本地客户端会继续在后台运行。无需再执行单独的配对命令。

boltlynx start

任何时候都可以查看客户端状态：

boltlynx status

macOS 命令行

安装本地客户端：

curl -fsSL https://boltlynx.com/install.sh | bash

boltlynx start

任何时候都可以查看客户端状态：

boltlynx status

本地客户端启动并完成配对后，进入网页端，创建或选择智能体，并选择允许它使用的项目目录。

进入网页端

升级本地客户端

完成升级后：

Windows：直接在启动器中更新本地客户端，然后重启客户端内核。
Linux / macOS：在终端中重启本地客户端。

重启本地客户端

boltlynx restart

核心概念

网页端

在这里与智能体对话、创建和管理工作，并决定下一步做什么。网页端在浏览器中运行。

本地客户端

本地客户端运行在你的机器上，让获得授权的智能体访问本地文件、执行命令、分析数据、搜索代码和使用私有技能。

本地客户端不是智能体。它是一个独立隔离的运行环境：可以是一台机器、一个容器，也可以是同一台机器上的独立系统用户。一个环境只需要安装一次本地客户端，并可供多个智能体使用。

智能体

一个智能体就是一段对话加上一个工作环境。它拥有对话历史、工作目录、记忆、启用的技能，以及自己的指令。

技能

技能为智能体提供领域能力。当前指南包含用于软件开发的 Code，以及用于运维和数据库安全规则的 Ops。

工作智能体

主智能体可以把工作委派给专门的工作智能体。每个工作智能体可以有自己的模型、工作目录、技能和角色。

配置智能体

每个 agent 都可以针对具体的项目或工作负载来配置。

名称、描述、工作目录	标识 agent，并定义它能操作的根目录。
技能	启用 Code、Ops 等领域能力。
模型	为这项工作选择模型和推理强度。
文件权限	设置允许、可写或禁止访问的路径。
命令权限	允许或禁止命令模式，例如允许 `git *` 同时禁止破坏性命令。
指令与记忆	给 agent 长期的工作规则，以及可跨对话保留、可编辑的笔记。
工作智能体	为更大的任务配置专门的协作者。
触发器与通知	运行定时检查、由 webhook 触发的工作流，或发送完成与告警通知。

日常使用

进入网页端。选择负责这个项目的智能体，继续对话或交代下一步工作。
描述要做的事。交代一件真实要完成的工作，而不只是一句提示词。
让它去做。在获得授权的环境里，智能体可以读写文件、执行命令、搜索代码和分析数据。
审批敏感操作。需要确认的操作会先请求人工审批。
接收通知。工作完成、出现异常，或定时任务有结果时，BoltLynx 闪喵会发送通知。

安全模型

BoltLynx 闪喵的设计围绕明确的边界。智能体只在你配置的目录和命令权限内工作。

文件访问按工作目录以及额外的允许 / 禁止规则授权。
敏感命令可以要求人工审批。
私有技能通过你的本地客户端运行，而不是作为服务端工具上传。
通知会呈现完成、失败和定时报告。

数据边界

BoltLynx 以最小化本地访问和数据传输为设计原则。它不会镜像整个工作区，也不会扫描并上传与当前工作无关的文件。

工作内容只会在模型推理、必要的行动结果、你选择的在线服务，或运行和保护服务所需的诊断场景下离开客户端。

安装本地客户端，开始工作。