企业官网建设流程全解析

BossConsole是一款开源的多平台 AI Agent 操作控制台（基于 JVM 的 Kotlin/Compose 桌面应用，而非 Electron），内置Toolbox（工具箱），用于浏览、安装、启用、更新和管理插件：真实的 Fluck Browser 浏览器、BossTerm 终端、BossEditor 编辑器、密钥管理以及 200+ MCP 工具都以插件形式加载。本文是一份面向新手和运维人员的完整清单：从第一次打开 Toolbox 安装插件，到在 MCP 标签页控制 AI Agent（Claude Code、Codex、Gemini、OpenCode）能调用哪些工具，再到用开发者 CLI 打包自己的插件。

一、认识 BossConsole 插件系统：为什么是 Toolbox

BossConsole 的设计思路是"带来自家的 Agent，自己挑选它的工具"（Bring your agent. Choose its tools.）。主程序只是一个"壳"，浏览器、终端、编辑器、Git 面板、密钥管理等能力全部来自动态加载的插件，因此工作区可以按需扩展。

Toolbox（面板 id 为plugin-manager）就是插件的统一管理入口，集中提供 4 类能力：

💡 系统插件（API、Toolbox、终端、浏览器、编辑器等）受保护，不能通过开发热加载（dev staging）覆盖；更新它们走正常的安装/更新流程，必要时重启应用。相关设计见 docs/PLUGIN_LAUNCHPAD.md。

二、5分钟上手：在 Toolbox 中安装第一批插件

首次安装 BossConsole 后，推荐按下面顺序配置初始工具组合：

1. 启动 BossConsole 并登录账号；
2. 从侧边栏或顶部 Host Actions 打开Toolbox；
3. 先装上"三件套"：Fluck Browser（浏览器）+ Terminal（终端）+ Editor（编辑器）；
4. 按需追加：Docker/Kubernetes 基础设施插件、Notebook 科研插件、自动化（RPA）插件等；
5. 安装前注意查看已勾选的工具清单——BossConsole 会让你先审阅再安装。

官方 README 对这一流程的概括是："Start with a browser, terminal, and editor. Add Docker or Kubernetes for infrastructure, notebooks for research, automation for repeatable browser work, or your own plugin."（详见 README.md）。

⚠️ 插件签名说明：商店插件采用签名校验（签名与插件身份、版本、JAR 内容绑定）。签名有效只说明"来源可信"，不代表插件一定安全；若签名校验失败，插件会直接拒载（fail-closed），而不是"悄悄消失"。

三、浏览器插件 Fluck Browser：装上后能做什么

Fluck Browser 把真实网页直接放进工作区，并提供给 Agent 的导航、页面交互等 MCP 工具。安装后你可以让 Agent 帮你检索页面、打开链接，且所有操作都发生在你看得见的真实浏览器标签页里。

内置浏览器基于 Chromium 内核（随版本升级 JxBrowser 引擎）。下图是仓库中 Speedometer 3.1 跑分测试的真实截图之一（Safari 对照组，得分 28.8），完整基准数据可阅读 benchmark.md：

给 Agent 的页面上下文工作流：把当前 BOSS 网页页"附加"为上下文 → Agent 请求操作时先弹出审批 → 结果在你旁边的真实标签页中可见。这样"Agent 干了什么"全程透明可控。

四、终端与编辑器插件：连接 AI Agent 的推荐组合

Terminal（BossTerm）与 Editor（BossEditor）插件装好后，命令、代码就与任务并排呈现。接下来是把Claude Code / Codex / Gemini / OpenCode接进来：

1. 打开 BossTerm 终端，启动你习惯的 CLI Agent；
2. 通过Toolbox → MCP（或 BossTerm 的 AI 菜单）完成 attach 连接；
3. 在 MCP 标签页查看服务端口（以界面显示为准，不要默认假设7677）；
4. 用下方的工具开关决定 Agent 能调用哪些 BOSS 工具。

本地bossMCP server 会从已激活的插件中自动发现工具（浏览器、终端、编辑器、Git、自动化等）。换句话说：Toolbox 里装了哪些插件，直接决定 Agent 的工具集。

此外，还建议顺手安装命令行入口：

• 路径：Toolbox → Tools → Install BOSS CLI
• 作用：把boss可执行文件装入系统 PATH，方便脚本与外部 Agent 直接操作桌面实例（如boss status、boss mcp list）。

完整命令表（boss doctor、boss pack、boss mcp等）见 docs/CLI.md。

五、MCP 工具开关：新手必知的权限控制点

这是 Toolbox 中最容易被忽略、却最关键的一页，位于Toolbox → MCP：

操作建议：

• 给 Agent attach 后，先开 kill-switch 再谈 RBAC——管理员桌面下permitted()会被 admin 短路，kill-switch 才是始终生效的控制（见 docs/mcp-agentless-operators.md）；
• 禁用状态持久化在应用数据文件mcp-disabled-tools.json中；若文件损坏，系统会 fail-closed 地"全部工具关闭"，损坏内容另存为.corrupt备份（见 docs/INFRASTRUCTURE_GUARDRAILS.md）；
• 找不到开关？可用双击 Shift 搜索输入工具名（形如mcp__boss__<name>），选中 MCP 行即可打开 Toolbox 并给出状态提示。

📌 这些控制只约束"经由 BOSS 发出的调用"，并不能给外部 Agent 本身加沙箱；已授权的工具/页面拿到密钥后仍可能泄露它，请谨慎授权。

六、自制与安装第三方插件：开发者工作流速览

除了"用别人的插件"，BossConsole 提供完整的插件开发链路，适合想在 Toolbox 里添加工具的进阶用户：

1. 两种方式创建插件

• 应用内：Toolbox →Create，使用Tool Creator脚手架 + 编码 Agent 完成创建与发布；
• CLI 手动：开发者 CLI 三件套（参考 docs/PLUGIN_LAUNCHPAD.md）：

# 1. 脚手架（可选模板：mcp-tool / ui-panel / background-service / full） boss plugin init my-tools --template mcp-tool # 2. 构建后校验（manifest、权限、字节码完整性） boss plugin validate . # 3. 链接进运行中的 BossConsole，支持热加载 boss plugin link .

boss plugin link会自动做预校验，把 JAR 放进版本轮换的开发目录~/.boss/plugins/dev/<plugin-id>/v<timestamp>/；若 BossConsole 正在运行则直接热重载并等待RELOAD_OK确认。

2. 插件清单 plugin.json 长什么样

每个插件必须携带一份 plugin.json 清单，核心字段包括pluginId（反向域名格式）、version（SemVer）、apiVersion、mainClass（入口类）、requiredPermissions（权限声明）与mcpTools（对外暴露的 MCP 工具，命名需匹配mcp__<id>__<tool>）。清单示例结构可参考仓库中的模板文件 docs/plugin-oop-template/plugin.json。

3. 版本兼容与回退规则（新手易踩坑）

• minApiVersion不能超过宿主当前 API 版本，否则校验失败；
• 启动时开发目录的 JAR 优先于商店已装版本；开发构建损坏则自动回退到商店版本；
• 失败的最新开发构建不会回退到"更旧的开发版本"，而是回退到商店构建——修正后重新link即可。

七、故障排查：插件出问题了去哪里找

两个只读诊断命令值得记住：

boss doctor # 人类可读的健康报告 + 修复建议 boss status --json # JSON 输出，含 health 字段

八、新手入门必备清单（Checklist）

最后把全文浓缩成一张可打勾的清单：

• 已从Toolbox安装三件套：Fluck Browser、Terminal、Editor
• 通过Toolbox → Tools → Install BOSS CLI安装了boss命令行
• 在Toolbox → MCP确认过 attach 的服务端口（不假设 7677）
• 为每个 Agent 工具设置了 kill-switch（管理员会话下它最可靠）
• 了解插件签名机制：拒载是 fail-closed 行为，重装可恢复
• 会用boss doctor做健康检查
• （进阶）跑通boss plugin init→validate→link开发闭环

📎 延伸阅读：plugin-platform/README.md（宿主插件平台架构）、docs/PLUGIN_LAUNCHPAD.md（CLI 完整参考）、docs/CLI.md（CLI 命令表）、docs/mcp-agentless-operators.md（MCP kill-switch 运维指南）、benchmark.md（内置浏览器跑分报告）。

一句话总结：在 BossConsole 中，Toolbox 既是"插件商店"，也是 Agent 权限的总闸。先装好浏览器、终端、编辑器，再用 MCP 开关收紧 Agent 的工具边界，就能安全地把 Claude Code、Codex、Gemini 或 OpenCode 接入你的桌面工作区。