README.md

April 30, 2026 · View on GitHub

墨梅博客

Version

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

🌐 主站 | 📚 文档站

墨梅博客 - AI 驱动、原生国际化的开发者博客平台。

AI 赋能，全球创作。

📖 简介

墨梅博客是一个基于 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/
- 您可以通过邮箱 admin@example.com，密码momei123456登录演示用管理员账号。
正式站点: https://momei.app/
- 您可以注册自己的账号查看用户视角。
文档站点: https://docs.momei.app/
问题反馈和交流群：
- QQ 群: 807530287
- Discord: 草梅友仁的交流群

页面截图

QQ截图20251221215342

QQ截图20251221221235

QQ截图20251221215644

🛠️ 技术栈

核心框架: 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