Bedrock 专服快速开始
适用对象
维护 Bedrock Dedicated Server（BDS），并能管理 Legacy Script Engine Node.js 插件环境的服主或管理员。
支持状态与验证版本
- 实验性：Bedrock Adapter 是
lse-nodejs插件，依赖legacy-script-engine-nodejs。 - 当前源码插件版本为
1.0.0；BDS 与 LSE 兼容性需以你使用的运行环境实际加载结果为准。 - 已知限制：当前快速开始只支持 Alice 与 BDS 同机，连接目标按
127.0.0.1:27541使用。项目虽有host/port配置字段，但当前发布流程和跨主机行为未完成验证，不应依赖修改这些字段部署远程 Alice。
前置条件
- 已安装并能启动 Alice Windows 桌面应用。
- 已准备 BDS，以及能加载 Legacy Script Engine Node.js 插件的兼容环境。
- 已取得 Bedrock Adapter 编译产物；插件目录应包含
index.js和manifest.json。 - 能查看 BDS 控制台日志，并已备份服务器数据。
步骤
- 停止 BDS。
- 在 BDS 插件目录中新建 Bedrock Adapter 目录，将编译产物复制进去；保持
manifest.json与index.js位于同一插件根目录。 - 检查
manifest.json：类型应为lse-nodejs，依赖应包含legacy-script-engine-nodejs。不要按现代 LeviLamina 原生插件 manifest 安装。 - 保持默认同机连接：Alice 与 BDS 位于同一台 Windows 主机，目标为
127.0.0.1:27541。即使看到根级config.json的host、port字段，也不要把跨主机修改当作已支持能力。 - 先启动 Alice，在“模型”页面添加模型并执行“测试连接”。
- 启动 BDS，观察控制台，确认 Bedrock Adapter 被 LSE Node.js 加载并建立 TCP 连接。
- 在 Alice 中选择新发现的 Bedrock 实例/工作区，确认工具已动态注册。
- 创建智能体并绑定该工作区，先发送只读环境查询作为首次操作。
成功标志
- BDS 日志没有插件 manifest、Node.js 运行时或入口文件错误。
- 日志显示 Adapter 已连接 Alice，Alice 中出现 Bedrock 实例。
- 当前实例显示动态注册的 Bedrock 工具。
- 智能体能完成一次只读工具调用并返回结果。
常见失败
- 插件完全未加载：确认环境是 Legacy Script Engine Node.js，插件 manifest 类型为
lse-nodejs，且存在编译后的index.js。 - 按 LeviLamina 原生插件教程安装后报错：当前 Adapter 不是现代原生插件，请改用 LSE Node.js 目录结构。
- TCP 连接被拒绝：先启动同机 Alice，并检查本机端口
27541是否被占用。 - 修改
host/port后仍连接本机或行为不一致：这是当前限制；恢复127.0.0.1:27541并同机部署，不要将远程配置视为已支持。 - 实例在线但工具为空：检查插件启动期间的工具扫描/注册错误，并确认复制的是完整编译产物而不是 TypeScript 源码。