# 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：
```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
- 修正文档

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