caomeiyouren/momei repository overview

⁠
墨梅博客

⁠ ⁠ ⁠ ⁠ ⁠ ⁠ ⁠

简体中文⁠ | 繁體中文⁠ | English⁠ | 한국어⁠ | 日本語⁠

🌐 主站⁠  |  📚 文档站⁠

⁠📖 简介

墨梅博客 是一个基于 Nuxt 构建的现代化博客平台。它旨在通过 AI 和深度的国际化支持，为技术开发者和跨境内容创作者提供高效、智能的创作体验。无论是智能翻译、自动化摘要，还是多语言路由管理，墨梅都能帮您轻松连接全球读者。

⁠✨ 核心特性

• AI 驱动: 深度集成 AI 助手，支持全自动翻译、智能标题、摘要生成等功能，大幅提升创作效率。
• 多模态内容工作流: 已支持 AI 配图、ASR、可复用语音输入、Memos / WechatSync 手动分发与定时任务自动化，覆盖从灵感采集到发布的完整链路。
• 原生国际化 (i18n): 内置多语言支持，从 UI 到内容管理的深度集成，助你轻松触达全球读者。
• 现代化技术栈: 基于 Nuxt (Vue 3 + TypeScript) 构建，支持 SSG/SSR 混合渲染，性能卓越。
• 平滑迁移: 支持自定义 URL Slug (路径别名)，确保从旧博客迁移时 SEO 零损失。
• Markdown 创作: 简洁高效的 Markdown 编辑器，支持实时预览和图片拖拽上传。
• 内容编排与品牌语义: 首页“最新文章 + 热门文章”双区块、文章置顶和页脚版权配置链路已收口，便于运营与站点品牌管理。
• 多层级订阅: 全局、分类及标签的多维度 RSS 订阅，支持多语言探测。
• 评论只读翻译: 评论区支持按当前界面语言查看 AI 译文，并保留原文切换、语言标记、缓存复用与既有配额 / 频率限制治理。
• 可配置的系统治理: 系统设置中心、环境变量锁定、配置审计日志和部署指引已打通，便于在自部署与 Serverless 场景中统一管理。
• 云端资源交付: 已支持 S3 / R2 直传授权、资源公共地址治理与按用户 / 文章归属收敛的对象键策略，便于切换 CDN 与存储后端。

⁠🏠 在线体验

• 演示站点: https://demo.momei.app/⁠

  • 您可以通过邮箱 [email protected]，密码momei123456登录演示用管理员账号。

• 正式站点: https://momei.app/⁠

  • 您可以注册自己的账号查看用户视角。

• 文档站点: https://docs.momei.app/⁠

• 问题反馈和交流群：

  • QQ 群: 807530287⁠
  • Discord: 草梅友仁的交流群⁠

页面截图

⁠🛠️ 技术栈

• 核心框架: Nuxt⁠
• UI 框架: Vue 3⁠
• 编程语言: TypeScript⁠
• 样式预处理: SCSS⁠
• 包管理器: PNPM⁠
• 代码规范: ESLint + Stylelint + Conventional Commits

⁠📂 项目结构

• components/: 可复用的 Vue 组件
• pages/: 基于文件的页面路由
• layouts/: 页面布局模版
• server/: Nitro 服务端 API 接口与实体
• database/: 数据库初始化脚本与资源
• i18n/: 国际化语言配置文件
• utils/: 共享工具函数与通用逻辑
• styles/: 全局 SCSS 样式定义
• types/: TypeScript 接口与类型定义
• docs/: 项目详细文档与规范说明
• packages/cli/: Hexo 迁移工具 CLI (独立项目)

⁠🤖 AI 协同开发 (AI Synergy)

本项目深度集成了 AI 辅助开发流，无论你是人类开发者还是 AI 代理，都能在这里找到最高效的协作方式。

• 如果你是开发者 (Human):
  • 🚀 现代 AI 开发指南⁠ - 了解如何指挥 AI 智能体完成 80% 的重复性任务。
  • 🛠️ 环境搭建 (传统方式)⁠ - 详细的本地环境配置与手动开发说明。
• 如果你是 AI 代理 (AI Agent / LLM):
  • 📜 AGENTS.md⁠ - 唯一的项目级 AI 事实源，先读它，再执行其他入口说明。
  • 🧭 若当前平台存在专属适配文件或 Rules，请只把它们当作工具差异补充；若与 AGENTS.md 冲突，一律以 AGENTS.md 为准。
  • 🗺️ 项目地图⁠ - 快速建立项目上下文。
  • 遵循项目内置的 PDTFC+ 循环 执行任务。

⁠📚 文档

详细的开发和设计文档请访问：墨梅博客文档站⁠

主要章节：

• 快速开始⁠ - 一键部署与启动
• 方案对比⁠ - 为什么选择墨梅?
• 增强包⁠ - 批量翻译编排、多平台分发追踪与内容资产统一管理
• 部署指南⁠ - Vercel/Docker/私有服务器
• 环境与系统设置⁠ - 环境变量、设置中心映射与锁定策略
• 开发指南⁠ - 环境搭建与贡献
• API 设计⁠ - 接口规范与定义
• 数据库设计⁠ - 表结构与关系

⁠📦 依赖要求

• Node.js >= 20
• PNPM (推荐)

⁠☁️ 部署说明

⁠支持情况

建议使用 Vercel、Netlify、Docker 或自托管 Node 环境进行部署。若你需要接入 Cloudflare，当前仅建议用于 R2 对象存储与 Scheduled Events 等外围能力。受 TypeORM 与 Node 运行时依赖限制，当前版本暂不支持将应用主体完整部署到 Cloudflare Pages / Workers。

当前版本的部署配置以环境变量为主，推荐优先阅读 部署指南⁠ 和 环境与系统设置⁠，先完成核心变量，再按需启用 AI、对象存储、ASR、Webhook 定时任务等增强能力。

点击下方按钮一键部署到 Vercel。

⁠数据库支持

墨梅原生支持以下数据库：

• SQLite: 默认选项，无需配置服务器，适合个人博客。推荐设置 DATABASE_URL=sqlite://database/momei.sqlite。
• MySQL / PostgreSQL: 适合有更高数据管理需求的用户，通过 DATABASE_URL 协议头自动推断。
• Cloudflare D1: 计划中。该规划不代表当前版本已支持 Cloudflare 运行时整站部署；现阶段仍建议使用外部数据库，并将应用主体部署在 Vercel、Docker 或自托管 Node 环境。

详情请参考 部署指南⁠。

⁠🔄 Hexo 迁移工具

墨梅提供了独立的 CLI 工具，帮助你从 Hexo 博客系统快速迁移文章。

⁠功能特性

• ✅ 递归扫描目录中的所有 Markdown 文件
• ✅ 精确解析 Hexo Front-matter (YAML 格式)
• ✅ 保留发布时间、分类、标签等元数据
• ✅ 支持通过 API Key 批量导入
• ✅ 支持并发导入，提高效率
• ✅ 支持 Dry Run 模式预览

⁠快速使用

# 进入 CLI 目录
cd packages/cli

# 安装依赖
pnpm install

# 构建工具
pnpm build

# 预览导入（不实际导入）
pnpm start import ./hexo-blog/source/_posts --dry-run --verbose

# 正式导入
pnpm start import ./hexo-blog/source/_posts \
  --api-url https://your-blog.com \
  --api-key your-api-key-here

详细使用说明请查看 packages/cli/README.md⁠。

⁠🚀 快速开始

⁠安装依赖

pnpm install

⁠启动开发服务器

pnpm dev

⁠构建生产版本

pnpm build

⁠运行测试

pnpm test

⁠代码检查

pnpm lint
pnpm lint:i18n

⁠👤 作者

CaoMeiYouRen

• Website: https://blog.cmyr.ltd/⁠
• GitHub: @CaoMeiYouRen⁠

⁠🤝 贡献

欢迎贡献、提问或提出新功能！ 如有问题请查看 Issues⁠. 贡献指南请查看 CONTRIBUTING.md⁠.

⁠💰 支持

如果觉得这个项目有用的话请给一颗 ⭐️，非常感谢！

如需商业版支持、定制开发或赞助等，请通过 爱发电⁠ 联系（可直接下单）。

⁠

⁠🌟 Star History

⁠📝 License

Copyright © 2025 CaoMeiYouRen⁠.

本项目采用双重许可：

• 代码部分：根据 MIT⁠ 许可证授权。
• 文档部分：根据 CC BY-NC-SA 4.0⁠ 许可证授权。

本项目的 Logo 不在上述 License 协议范围内，图片版权由项目所有者 CaoMeiYouRen⁠ 保留。如要进行商业化使用，需更换 Logo。非商业化使用的情况允许在不影响项目所有者权益的情况下使用。

This README was generated with ❤️ by cmyr-template-cli⁠