ByteNoteByteNote
字

字节笔记本

2026年2月22日

DeepToAI - 基于 Fumadocs 的 AI 驱动双语内容生产平台

#Claude Code

DeepToAI 是一个基于 Fumadocs 构建的 AI 驱动双语内容生产与发布平台。它不仅是一个文档站点，更是一个完整的内容自动化生态系统，通过智能化工作流实现技术文档的自动化获取、AI 辅助翻译和简化发布流程。

项目简介

DeepToAI 由 foreveryh 开发维护，是一个开源的智能文档平台。该项目在 GitHub 上已获得 30 stars，主要使用 MDX (87.6%) 和 TypeScript (12.4%) 编写。平台的核心价值在于将 AI 技术深度集成到内容生产流程中，帮助技术文档团队、开发者关系团队和内容策展团队高效创建和管理双语技术内容。

核心特性

AI 驱动的内容流水线

  • 智能内容获取：通过 Jina Reader API 自动下载内容
  • 智能资源处理：自动图片本地化和路径优化
  • AI 辅助翻译：忠实的中文翻译，采用叙事风格
  • 分类智能：自动内容分类（best-practices、advanced、tools 等）

双语内容管理

  • 无缝中英发布：并行中英文文档支持
  • 术语一致性：标准化的技术术语翻译
  • 文化适配：自然的中文句子结构和表达
  • 同步更新：协调的双语内容更新

自动化发布工作流

  • 主发布脚本：一键端到端发布
  • 安全特性：自动备份、验证和试运行模式
  • 内容索引：自动导航和搜索索引更新
  • 变更日志集成：自动发布跟踪和统计

内容组织与发现

  • 智能分类：best-practices、advanced、tools、community-tips
  • 最新文章管理：动态首页内容策展
  • 全文搜索：Fumadocs 集成的服务端搜索
  • 丰富元数据：全面的 frontmatter 和内容索引

技术栈

  • 框架：Next.js 15.4.5 + App Router
  • 文档引擎：Fumadocs (Core 15.6.8, UI 15.6.8, MDX 11.7.3)
  • 样式：Tailwind CSS 4.1.11
  • 语言：TypeScript 5.9.2
  • 内容格式：MDX with rich frontmatter support

安装指南

前置要求

  • Node.js 20+ (Node.js 23.1 可能存在兼容性问题)
  • npm/pnpm/yarn
  • React.js 和 MDX 基础知识

安装步骤

bash
# 克隆仓库
git clone https://github.com/foreveryh/claude-code-best-practices.git
cd deeptoai

# 安装依赖
npm install
# 或 pnpm install

# 启动开发服务器
npm run dev

访问 http://localhost:3000 查看平台运行效果。

快速开始

方式一：AI IDE 集成（推荐）

使用 AI IDE（如 Cursor、Claude Code）配合智能提示：

下载并发布该文章，注意要保留文章中的 youtube 在线观看，[ARTICLE_URL]

AI 将自动完成：

  • 使用 Jina Reader API 下载内容
  • 处理和本地化所有图片
  • 创建忠实的双语翻译
  • 执行完整的发布工作流
  • 更新索引和变更日志

方式二：手动工作流

bash
# 1. 内容获取
curl -s "https://r.jina.ai/YOUR_URL" > content/sources/article_$(date +%Y%m%d).md

# 2. 创建内容文件
# - 英文: content/docs/en/[category]/[slug].mdx
# - 中文: content/docs/zh/[category]/[slug].mdx

# 3. 完成发布
npm run publish-complete \
  content/docs/en/[category]/[slug].mdx \
  content/docs/zh/[category]/[slug].mdx

# 4. 添加变更日志条目
npm run changelog add

使用示例

核心开发脚本

bash
npm run dev      # 启动开发服务器
npm run build    # 生产构建
npm run start    # 启动生产服务器

内容管理脚本

bash
# 主发布工作流
npm run publish-complete <en-path> <zh-path>  # 完整发布
npm run publish-dry <en-path> <zh-path>       # 预览变更
npm run quick-add <path1> <path2> <path3>     # 批量处理

# 内容组织
npm run update-indexes                        # 刷新内容索引
npm run recent-posts add <path> <lang>        # 添加到最新文章
npm run recent-posts list                     # 列出最新文章
npm run recent-posts remove <slug>            # 从最新文章中移除

# 发布跟踪
npm run changelog add                         # 添加变更日志条目
npm run changelog stats                       # 查看统计信息

项目结构

text
deeptoai/
├── app/
│   ├── (home)/                 # 落地页
│   ├── docs/                   # 文档路由
│   └── api/search/             # 搜索 API
├── content/
│   ├── sources/                # 原始内容源
│   ├── docs/en/                # 英文文档
│   └── docs/zh/                # 中文文档
├── scripts/
│   ├── publish-complete.js     # 主发布工作流
│   ├── manage-recent-posts.js
│   ├── update-indexes.js
│   └── changelog.js
├── lib/
│   ├── source.ts               # 内容源适配器
│   └── changelog.ts            # 变更日志工具
└── public/images/              # 本地化图片资源

内容分类

分类用途示例
best-practices可操作的指导和设置技巧Claude Code 设置、生产力技巧
advanced复杂的技术概念Agent 架构、系统设计
tools开发工具和实用程序MCP 服务器、框架
community-tips社区贡献用户分享的工作流

Frontmatter 规范

yaml
---
title: "文章标题"
description: "文章简要描述"
date: "YYYY-MM-DD"
author: "作者名"
source: "https://original-url.com"
category: "best-practices|advanced|tools|community-tips"
language: "en|zh"
tags: ["tag1", "tag2"]
---

翻译指南

  • 忠实性：完整准确的翻译（非摘要）
  • 风格：面向普通 AI 读者的叙事方式
  • 术语：标准行业术语（LLM → 大语言模型）
  • 结构：保留所有原始 Markdown 格式
  • 文化适配：自然的中文表达和句子流畅度

适用场景

  • 需要双语内容的技术文档团队
  • 需要频繁更新的 AI 工具文档
  • 创建教育内容的开发者关系团队
  • 拥有国际社区的开源项目
  • 聚合技术资源的内容策展团队

项目链接

Built with ❤️ using Fumadocs and powered by AI-driven content workflows

Claude Code
上一篇

Flutter_Eyepetizer：基于 Flutter 的精美仿开眼视频跨平台 App

下一篇

DeepToAI - 基于 Fumadocs 的 AI 驱动双语内容生产平台

分享: