技术栈详解
本项目技术选型与 momei 对齐，优先复用已验证的成熟方案。
运行时
| 组件 | 版本要求 | 说明 |
|---|---|---|
| Node.js | >= 20 LTS | 运行环境 |
| pnpm | 最新稳定版 | 包管理器 + workspace monorepo |
Monorepo 结构
采用 packages/<name> 命名规范（npm 包名带 @dependfix/ scope）：
| 子包 | npm 名 | 类型 | 构建 |
|---|---|---|---|
| packages/core | @dependfix/core | 内部库 | tsdown |
| packages/cli | dependfix | CLI（unscoped） | tsdown |
| packages/github | @dependfix/github | 内部库 | tsdown |
| packages/action | @dependfix/action | Action | tsdown |
| packages/mcp | @dependfix/mcp | MCP Server | tsdown |
| apps/platform | — | Nuxt 应用 | Nuxt 构建 |
命名规范：CLI / 可执行入口使用 unscoped 名称，内部库使用
@dependfix/*scope。
全栈平台（apps/platform）
核心框架
| 依赖 | 版本 | 用途 |
|---|---|---|
| nuxt | ^4.x | 全栈框架 |
| vue | ^3.5 | UI 框架 |
| vue-router | ^5.x | 路由 |
| @primevue/core + primevue | ^4.x | UI 组件库 |
| @primeuix/themes | ^2.x | 主题引擎 |
| @nuxtjs/i18n | ^10.x | 国际化 |
| @vueuse/core + @vueuse/nuxt | ^14.x | 组合式工具 |
| @sentry/nuxt | ^10.x | 错误监控 |
| @vite-pwa/nuxt | ^1.x | PWA 支持 |
认证
| 依赖 | 用途 |
|---|---|
| better-auth | 认证核心 |
| @better-auth/sso | SSO / 第三方登录 |
| better-auth-localization | 认证 UI 多语言 |
数据库与 ORM
| 依赖 | 用途 |
|---|---|
| typeorm | ORM 框架 |
| reflect-metadata | TypeORM 装饰器依赖 |
| class-transformer + class-validator | 实体校验 |
| better-sqlite3 | SQLite（开发/测试） |
| pg | PostgreSQL（生产） |
| mysql2 | MySQL（生产备选） |
任务队列
| 依赖 | 用途 |
|---|---|
| bullmq | 任务队列 |
| ioredis | Redis 客户端 |
工具
| 依赖 | 用途 |
|---|---|
| zod | 数据校验 |
| dayjs | 日期处理 |
| lodash-es | 工具函数 |
| winston | 结构化日志 |
| nodemailer | 邮件发送 |
| dompurify + sanitize-html | XSS 防护 |
库（packages/*）
构建与测试
| 工具 | 用途 |
|---|---|
| tsdown | TypeScript 库打包（Rolldown 驱动） |
| vitest | 单元测试 / 集成测试 |
| playwright | E2E 测试 |
| tsc --noEmit | 类型检查 |
代码质量
| 工具 | 配置 |
|---|---|
| eslint | eslint-config-cmyr |
| stylelint | stylelint-config-cmyr |
| commitlint | commitlint-config-cmyr |
| lint-staged | 暂存区自动 lint |
| husky | Git hooks 管理 |
版本管理
| 工具 | 用途 |
|---|---|
| @changesets/cli | 子包独立版本管理 + npm 发布（开发者显式声明 bump 类型） |
| conventional-changelog + conventional-changelog-cmyr-config | CHANGELOG 生成（pnpm changelog，momei 同款格式） |
| commitizen + cz-conventional-changelog-cmyr | 交互式提交 |
发布策略
根包（dependfix-monorepo）是 pnpm workspace 壳，不交付任何产物，不参与版本发布。
子包（@dependfix/core、dependfix）通过 changesets 独立发版：
| 动作 | 命令 |
|---|---|
| 创建 changeset | pnpm changeset |
| 消费 changeset 并 bump 版本 | pnpm changeset:version |
| 生成 CHANGELOG（根级 + 包级） | pnpm changelog |
| 发布到 npm | CI 中 pnpm changeset publish（OIDC 免 token 认证） |
版本号各自独立，@dependfix/core 升级时通过 updateInternalDependencies: "patch" 自动 bump dependfix CLI 的 patch 版本。
文档站（docs/）
| 工具 | 用途 |
|---|---|
| vitepress | 文档站点生成 |
| 内置 i18n | 多语言文档 |
| 本地搜索 | 离线全文搜索 |
AI 基建（从 momei 复用）
以下规范和方法论从 momei 项目继承：
| 规范 | 来源 | 说明 |
|---|---|---|
| PDTFC+ 工作流 | docs/standards/ai-collaboration.md | Plan → Do → Audit → Validate → Test → Finish |
| 搜索优先原则 | docs/standards/ai-collaboration.md | 修复失败 ≥ 2 次时先搜索外部信息 |
| 验证矩阵 | docs/standards/ai-collaboration.md | V0(范围) → V1(lint) → V2(测试) → V3(E2E) → V4(性能) → RG(审查) |
| 质量门 | AGENTS.md | lint + typecheck + build + test + code-review |
| 文档标准 | docs/standards/documentation.md | 单 H1、无跳级标题、Mermaid 图表、VitePress 容器 |
| 安全红线 | docs/standards/security.md | 不修改 .env、不硬编码密钥、推送前确认 |
详细规范内容参见 momei 项目
docs/standards/目录，本项目文档继承相同约定。