LobeHub

编写和维护公开网站上的自托管、部署、迁移及配置指南。依据当前代码核实内容，保持英文与简体中文页面一致，并在页面路径变更时更新链接和经过测试的重定向。

• 编写自托管指南
• 整理部署或配置步骤
• 页面迁移后更新链接

用交互原则和检查清单设计或审查面向用户的操作流程，检查空白、加载和错误状态、草稿保护、操作引导及高级选项的呈现。

• 设计面向用户的页面
• 检查输入内容和草稿保护
• 审查错误后的恢复方式

逐个页面对照界面模式和 `ux` 清单进行审计，可检查代码、截图和实际操作流程，记录优点与问题的依据，并将可推广的经验补充到清单中。

• 逐页审计用户体验
• 通过截图检查页面呈现
• 检查实际操作流程和性能

用于准备次要版本或补丁版本发布，整理分支与拉取请求流程，并编写 GitHub Release 说明。它说明哪些更改会触发 CI 自动打标签和创建发布，以及版本号由谁处理。

• 准备功能更新的次要版本发布
• 准备每周发布或紧急修复
• 确认拉取请求是否触发发布

本指南介绍 Zustand 状态类型、选择器和独立动作类的组织方式，并说明如何用 `local-replica` 管理服务端列表与详情、乐观更新及失败回滚；修改旧式 store 时也提供相应参考。

• 设计 Zustand 状态与动作
• 同步服务端列表和详情
• 实现乐观更新与失败回滚

用于诊断偶发界面故障、陈旧状态、顺序错误和页面跳转问题。沿渲染、客户端状态及服务端边界追踪同一数据，定位结果最早出错的位置。

• 复现偶发的界面故障
• 追查跳转后的陈旧状态
• 定位显示顺序出错的边界

本技能在 macOS 桌面聊天应用中测试机器人频道：打开应用、进入频道或联系人、发送消息、等待回复并截图。支持 Discord、Slack、Telegram、微信、飞书和 QQ；iMessage 使用 BlueBubbles 桥接。

• 检查真实 Discord 频道中的机器人回复
• 测试 Slack 或 Telegram 的对话流程
• 记录 macOS 应用中的操作结果

为使用 react-i18next 的应用添加和管理界面翻译键，选择名称空间并使用插值；按流程更新英中预览，处理英文原文变更，避免已生成的译文长期过时。

• 为新页面添加翻译键
• 统一键名和名称空间
• 将英文修改同步到其他语言

从当前分支创建拉取请求，通常以 `canary` 为目标；当客户端依赖服务器契约时，按依赖顺序拆分多个请求，并整理验收链接与说明。

• 从当前分支创建拉取请求
• 按顺序拆分服务端和客户端改动
• 梳理请求依赖与合并顺序

使用 `chat` SDK 和 TypeScript 为多个聊天平台构建机器人，处理提及、斜杠命令、互动卡片、表单、Webhook 和流式回复。

• 构建支持多个聊天平台的机器人
• 响应提及或斜杠命令
• 发布带互动按钮的卡片

手动获准后，针对受支持的命令行代理和服务器提供的模型运行实时兼容性矩阵。检查请求是否经 LobeHub Desktop 和官方提供方路径完成，并生成逐项证据与结构化报告。

• 列出可用代理和模型
• 用多个命令行代理检查变更
• 查看实时验证证据和结果

指导使用 SWR 设计客户端数据获取，将 API 调用放入服务和状态钩子，并处理加载、错误及写入后的缓存刷新，也可协助迁移组件中的 `useEffect` 请求。

• 将组件请求移入状态钩子
• 修复更新后的过期缓存
• 整理加载、空结果和错误状态

本技能整理应用中的 LLM 生成流程，涵盖可复用且有版本的提示词、结构化输出、服务级模型选择和追踪，帮助区分业务流程标识与提示词标识。

• 为可复用提示词管理版本
• 将结构化 LLM 输出接入服务
• 追踪生成流程所用模型和执行状态

本技能指导在 LobeHub 中接入 AI 模型提供商，涵盖运行时、模型信息、设置、品牌展示、文档和验收，并帮助判断新增模型是否需要新的提供商集成。

• 为 LobeHub 接入新的 AI 模型提供商
• 更新提供商设置说明或介绍
• 判断添加模型是否需要新的提供商集成

定期检查项目中 `.agents/skills/` 下的技能文件，发现重复或职责重叠、过时引用、失效链接及说明与正文不符之处，并附上文件依据和修正建议。

• 检查技能是否重复
• 核对说明与正文是否一致
• 查找过时引用和失效链接

说明如何在智能体执行步骤、工具调用、人工审批、上下文压缩和子智能体调用时注册钩子。钩子可观察事件、模拟本地工具结果，也可通过 Webhook 按配置策略允许或拒绝工具调用。

• 记录智能体步骤和错误
• 测试时模拟工具结果
• 通过 Webhook 允许或拒绝工具调用

介绍如何使用 `@lobehub/ui/base-ui` 实现模态框和确认对话框，涵盖内容组织、必需的 `ModalHost`、关闭回调及常用选项，帮助正确处理关闭行为和状态清理。

• 添加确认对话框
• 实现特定功能的模态框
• 检查模态框关闭后的清理

此技能指导你调整产品数据的全文检索，涵盖 PostgreSQL 与 Elasticsearch 检索路径、权限校验、文档映射、增量同步和重新索引；不涉及智能体的外部网页搜索。

• 将产品数据加入搜索
• 更换搜索服务提供方
• 更新映射或搜索文档

编辑 TypeScript 代码时，可参考此指南统一类型安全和代码风格，涵盖导入、异步输入输出、导出、共用辅助函数、错误抑制与日志处理。

• 编辑代码并保持类型安全
• 添加异步输入输出
• 确认导入和导出规范

将大型功能拆分为按能力划分的 React 部件，让不同页面按需组合；并把数据、界面状态和操作放到对应部件中，减少轻量页面加载无用依赖。

• 在多个页面共用功能
• 避免轻量页面加载无用功能
• 按能力安置状态与操作

指导开发者为 Electron 应用添加桌面功能，涵盖主进程控制器、IPC 类型、渲染进程服务、预加载脚本以及窗口和菜单配置，并指出各部分的代码位置。

• 为 Electron 应用添加功能
• 确认 IPC 类型和服务的存放位置
• 配置菜单或管理窗口

本技能按请求范围分阶段开展网页、桌面和移动端界面设计，涵盖业务理解、页面结构、交互流程、视觉与文案优化，以及发布前检查。

• 设计新的管理后台或仪表盘
• 改进现有页面与交互
• 根据截图还原界面

用于使用 `debug` 库添加或查看日志，了解统一的 `lobe-*` 命名空间和格式指定符，并按浏览器、Node.js 或 Electron 环境启用日志输出。

• 为模块添加调试日志
• 确定日志命名空间
• 在浏览器中启用日志

根据已发布的变更撰写面向用户的中英文产品更新日志页面，按用户工作流程组织内容，并保持两种语言的事实和章节顺序一致。

• 撰写网站产品更新日志
• 统一中英文更新公告
• 按用户工作流程整理变更