灵构-组件工坊

Full Changelog: v1.0.3...v1.0.8

---

Generated from v1.0.8

灵构 UI 1.0.3 新增第三方集成能力：其他 Halo 插件和主题可以在自己的表单中选择灵构作品，保存项目 ID，再在页面中展示最新保存版本。

主要变化

• FormKit 作品选择器：新增 linguiProjectSelect，支持关键词搜索、分类过滤、分页、清空和预览，可用于插件与主题设置。
• Vue 选择与展示组件：提供 LinguiProjectSelect 和 LinguiProjectRender，方便其他插件在 Halo 页面中接入作品。
• 轻量查询 API：提供带权限控制的作品列表与详情接口，仅返回选择所需的摘要，不加载完整文档和版本历史。
• 引用与提交可靠性：支持跨页回显，作品删除或关闭公开嵌入后保留原 ID 并提示不可用；修复选择后立即提交时可能保存旧值的问题。
• 开发者文档：补充依赖声明、FormKit / Vue 示例、查询接口及主题展示说明。

升级说明

• 选择器默认只列出已开启公开嵌入的作品，选择动作不会自动开启公开。
• 接入方保存项目 ID，展示时读取最新保存版本；已打开页面需要刷新或重新加载后更新。
• 环境要求保持 Halo 2.26.0+、Java 21、AI Foundation 1.x。
• 在下方 Assets 下载 plugin-lingui-1.0.3.jar 安装或升级。

第三方插件与主题集成文档 · 使用文档 · 问题反馈

---

Generated from v1.0.3

本次正式版将 AI 模型切换迁移到工作台，统一单方案与多方案的需求输入，并修复工作台布局和服务商错误提示。

主要变化

• 工作台切换模型：组件创作、主题生成、多方案及修复共用模型选择；按 Halo 账号在当前浏览器记住选择，清空后使用 AI 基座默认模型。首次使用会继承原插件设置中的模型。
• 统一需求输入：在同一个输入框切换“单方案 / 多方案”，切换时保留需求；候选结果进入对话区，支持比较、重试、采用与撤销。停止生成会同时取消当前及排队方案。
• 布局优化：模型工具栏适配窄宽度；修正 Console 工作台高度与页脚占位，消除底部多余留白，保留对话内部滚动。
• 错误提示优化：更准确识别服务商 HTTP 503 等异常，提示切换模型或检查 AI 基座配置，并保留诊断编号。
• 历史记录：保存并恢复生成模式与多方案创作状态，候选作品也能进入创作历史。

升级说明

• 插件设置继续提供 AI 启用开关和输出 Token 预算，生成模型改在工作台选择。
• 局部修改、自动修复和消息重试保持单方案生成。
• 环境要求保持 Halo 2.26.0+、Java 21、AI Foundation 1.x。外部 MCP 接入仍使用官方 MCP Server 1.x（1.3.0+）。
• 在下方 Assets 下载 plugin-lingui-1.0.2.jar 安装或升级。

使用文档 · 问题反馈

---

Generated from v1.0.2

本次预发布将 AI 模型切换迁移到工作台，统一单方案与多方案的需求输入，并修复工作台布局和服务商错误提示。

主要变化

• 工作台切换模型：组件创作、主题生成、多方案及修复共用模型选择；按 Halo 账号在当前浏览器记住选择，清空后使用 AI 基座默认模型。首次使用会继承原插件设置中的模型。
• 统一需求输入：在同一个输入框切换“单方案 / 多方案”，切换时保留需求；候选结果进入对话区，支持比较、重试、采用与撤销。停止生成会同时取消当前及排队方案。
• 布局优化：模型工具栏适配窄宽度；修正 Console 工作台高度与页脚占位，消除底部多余留白，保留对话内部滚动。
• 错误提示优化：更准确识别服务商 HTTP 503 等异常，提示切换模型或检查 AI 基座配置，并保留诊断编号。
• 历史记录：保存并恢复生成模式与多方案创作状态，候选作品也能进入创作历史。

升级说明

• 插件设置继续提供 AI 启用开关和输出 Token 预算，生成模型改在工作台选择。
• 局部修改、自动修复和消息重试保持单方案生成。
• 本版本为 RC 预发布；环境要求保持 Halo 2.26.0+、Java 21、AI Foundation 1.x。外部 MCP 接入仍使用官方 MCP Server 1.x（1.3.0+）。
• 在下方 Assets 下载 plugin-lingui-1.0.2-rc4.jar 安装或升级。

验证

• Gradle 完整检查通过，前端 82 个测试文件、1057 项测试通过。
• Vue / TypeScript 类型检查与插件打包通过。
• 已验证模型选择、统一输入、多方案结果展示、桌面底部填充及长页面滚动。

使用文档 · 问题反馈

---

Generated from v1.0.2-rc4

本版本将外部 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

灵构 UI 首个正式版本：通过 AI 对话与可视化搭建，像积木一样组合交互组件，再将作品放进 Halo 文章、侧边栏、页脚或主题模板。

主要功能

• AI 创作工作台：自然语言生成与修改作品，实时预览、全屏编辑，展示执行过程与具体错误信息。
• 105 种可组合组件：覆盖布局、内容、表单、数据图解、媒体、导航与反馈，支持属性、参数、状态和数据绑定。
• 主题与字体管理：提供 10 套内置主题，支持自定义配色、圆角、间距、字体，以及中文分包字体 CSS 导入。
• API 与交互编排：支持自动请求、手动刷新、错误与重试处理、宿主 JS 回调和交互调试。
• 项目与版本管理：分类、搜索、预览、导入导出、版本比较与历史恢复；通过项目 ID 短标签嵌入，保存后统一更新引用内容。
• 组件市场：分别浏览组件与主题，预览后下载到我的项目，支持从已有项目准备投稿。
• Skill + MCP：外部 AI 可查询组件、读取授权项目、校验设计与提交创作草稿，使用可撤销的灵构专用密钥，草稿由用户确认后保存。
• 文章编辑器集成：在绿色加号或 Slash 菜单中选择项目，支持预览、切换组件及跳转编辑。

环境要求与下载

• Halo 2.26.0+，Java 21。
• 需要安装 AI Foundation 1.x；使用内置 AI 创作前，请先配置模型、服务商和凭据。
• 在下方 Assets 下载 plugin-lingui-1.0.0.jar，在 Halo 后台安装并启用。
• 安装后项目列表默认为空，可自行创作或从市场下载作品。

文档与交流

• 使用文档
• 演示与作者站点
• 组件市场 · 林间时光盒
• QQ 交流群
• 问题反馈 · 参与贡献