Knowai Base 镜像维护文档

分支职责

负责统一 Nuxt 运行环境与框架生态依赖。 不包含任何业务代码或配置，仅提供基础依赖环境。

镜像标签命名规范

• 格式：gitea.local.knowai.fun/tobegold574/knowai-base:主版本号.次版本号.修订号
• 示例：gitea.local.knowai.fun/tobegold574/knowai-base:1.0.0
• 版本规则：
  • 主版本号：不兼容的框架或依赖变更
  • 次版本号：兼容性增强或批量依赖升级
  • 修订号：小幅依赖更新或新增兼容依赖
• latest 标签默认指向当前稳定版本（谨慎更新）

基础环境

• Node.js LTS（Debian trixie-slim）
• pnpm（包管理器）
• 系统工具：git、curl、ca-certificates

全局依赖（长期不变部分）

核心框架

• nuxt@latest
• vue@latest
• vue-router@latest

状态管理

• @pinia/nuxt
• @pinia/plugin-persistedstate

UI组件库

• @element-plus/nuxt
• @element-plus/icons-vue

样式与构建

• @nuxtjs/tailwindcss
• @nuxt/image
• @nuxt/icon
• @nuxtjs/color-mode
• @nuxtjs/component-cache

网络请求

• axios
• node-fetch
• socket.io-client

工具库

• @vueuse/core
• lodash
• dayjs
• crypto-js

使用方式

其他分支的 Dockerfile：

FROM gitea.local.knowai.fun/tobegold574/knowai-base:1.0.0
WORKDIR /usr/src/app
# 添加业务代码与依赖

构建命令

docker build -t gitea.local.knowai.fun/tobegold574/knowai-base:1.0.0 . docker push gitea.local.knowai.fun/tobegold574/knowai-base:1.0.0

镜像分层说明

Base层仅包含：

• Node.js 运行环境
• 核心框架依赖（Vue、Nuxt、Vue Router）
• 基础状态管理的集成模块（Pinia）
• 基础UI组件库的集成模块（Element Plus, tailwindcss）
• 常用工具库

其他依赖（如测试工具、开发工具等）应在各自层中按需添加，避免Base镜像臃肿。

更新记录

2025-10-29

• 创建基础架构分支
• 初始化Nuxt3项目结构

2025-11-4

• 删除项目代码以及CI pipeline
• 重新构建base镜像1.0.0版本
• 重新确定该分支职责

2025-11-27

• 修正文档

---

仅负责全局性依赖更新，业务功能在各功能分支独立开发，构建独立镜像