@bledrui/admin-module-ai-chat

@bledrui/admin-module-ai-chat

用于验证 bledrui-admin-boot 独立 npm 模块集成流程的最小 AI Chat 页面。

当前版本只提供：

• /ai-chat 路由声明
• AI Chat 菜单项
• 一个包含标题和输入框的 Vue 3 页面

不包含 AI 接口、消息提交或回复功能。

本地调试

安装依赖并启动 Vite：

npm install
npm run dev

默认访问 http://localhost:5173。调试应用直接引用 views/AiChat.vue，因此本地看到的就是最终发布页面。

执行类型检查和生产构建：

npm run build

dev/、index.html、vite.config.ts、tsconfig.json 和 dist/ 只用于本地调试。npm 发布内容由 package.json.files 白名单控制，这些文件不会被发布。

发布内容

module.json
views/AiChat.vue

检查 npm 包内容：

npm run pack:check

自动发布

仓库通过 .github/workflows/publish.yml 发布到 npm 公共仓库。Workflow 在以下情况运行：

• 提交或 PR 合并进入 master 分支时自动运行
• 在 GitHub Actions 页面手动运行

在 GitHub 仓库的 Settings > Secrets and variables > Actions 中创建 Repository secret：

NPM_TOKEN

每次需要发布新版本时，必须先更新 package.json 和 package-lock.json 中的版本。Workflow 检测到该版本已经存在时，会完成构建检查并跳过重复发布。

本地手动发布命令：

npm publish --access public --registry=https://registry.npmjs.org

认证信息必须由 GitHub Secret 或本地 .npmrc 提供，不得提交到仓库。本地 .npmrc 已加入 .gitignore。

Boot 集成

发布 @bledrui/admin-module-ai-chat@0.1.0 后，在 bledrui-admin-boot 的模块列表中登记对应的精确 npm 坐标。

详细设计参见 docs/design.md。