灵构-组件工坊

本版本将外部 AI 接入迁移到 Halo 官方 MCP Server，移除灵构自建 MCP 服务及专用密钥管理。这是破坏性升级，旧 MCP 地址与密钥不再生效，需要重新配置外部 AI 客户端。

主要变化

• 向官方 MCP Server 提供 6 个灵构工具：组件搜索、组件参数、作品读取、创作 Skill、设计校验和待确认草稿提交。
• MCP 统一使用站点 /mcp 地址和官方 Bearer 访问密钥，在 Halo「工具 → MCP 服务」逐项授权工具。
• 草稿与操作记录继续按账号隔离；外部 AI 提交后仍由用户预览、载入并确认保存。
• MCP Server 为可选依赖，未安装时仍可使用灵构工作台、内置 AI 和项目功能。
• CD 已接入 Halo 应用市场 app-gwmrhmax，发布 GitHub Release 时自动构建并同步版本。

从 1.0.0 升级

1. 升级灵构 UI，并安装、启用官方 MCP Server >=1.3.0 & <2.0.0。
2. 超级管理员打开 Halo「工具 → MCP 服务」，创建官方访问密钥并选择需要的「灵构 UI」工具。旧灵构密钥及按项目授权配置不会自动迁移。
3. 用官方页面提供的连接配置替换 AI 客户端中的旧配置，重新获取工具列表，先调用 plugin-lingui__get_guidance(topic="skill") 读取创作 Skill。

环境要求

• Halo 2.26.0+、Java 21。
• 必需插件：AI Foundation 1.x。
• 外部 MCP 接入另需官方 MCP Server 1.3.0 或更高的 1.x 版本。
• 在下方 Assets 下载 plugin-lingui-1.0.1.jar，或通过 Halo 应用市场升级。

验证

• 后端测试、前端单元测试和类型检查通过。
• 本地 Halo 2.26.0 + MCP Server 1.3.0 已验证工具注册、官方 MCP 握手、密钥工具白名单、Skill 读取和组件搜索，撤销测试密钥后请求被拒绝。
• 灵构 MCP 管理页与官方 MCP 服务页已完成浏览器联调。

使用文档 · 问题反馈

---

Generated from v1.0.1