CZON - AI enhanced Markdown content engine
npm install czon- C: Content oriented | 内容为王,专注内容
- Z: Zero Configuration | 零配置写作,减少打扰
- O: Organic AI-Native | 有机的 AI 原生,深度集成 AI
- N: N-shaped Energy Curve | N 型能量曲线,介入创作-分发-反馈的各个环节
AI 时代下,作为网站内容创作者,我们可以有更智能的内容创作引擎。
回归内容:最小化打扰,专注写作
让文档回归本质,让写作回归宁静。
其一,我不想做图书管理员。我有时想写下一些内容,但我可能还没有想好它的标题,还没有形成特别的组织。我希望 LLM 会自动帮我生成标题、做摘要、分类、导航等整理工作。
其二,我的书房必须打扫干净。我不想要配置复杂的构建工具,折腾复杂的文档配置,不喜欢复杂的结构。每次我看到 Docusaurus、VuePress、Astro 这些工具的配置文件和项目结构,我就头疼。现在,CZON 选择将所有的配置都隐藏到 .czon 目录下,扫到角落里,用户只需要专注于写作内容,其他的交给 CZON 来处理。其他的目录都是您的写作空间,您可以随意组织您的 Markdown 文件。
回归母语:用母语写作,丝滑构建多语言版本
人生苦短,我懒得翻译。人在使用母语时,才是最能发挥自身思考深度的。但同时与世界保持连接又是必要的,我不想放弃多语言的交流。于是我希望有一个工具,能让我用母语写作,同时又能让更多人看到我的内容。现在的 i18n 需要自己翻译不说,还得自己维护内容更新,太麻烦了。我选择使用 LLM 来帮我做翻译,省下了我很多时间,并且可以一键完成多国语言翻译。
1. 🌍 AI 多语言翻译:使用 AI 进行增量翻译,让用户使用母语编写 Markdown,但是用户可以是多语言的。
2. 📊 AI 元数据提取:自动提取标题、描述、摘要、关键词、目标读者、URL 友好别名等。
3. 🏷️ AI 标签分类:使用 AI 对内容进行标签和分类的提取和管理。
4. 🧭 AI 分类导航:使用 AI 生成站点地图和导航,源文件的位置不敏感。
5. 🤖 AI 全站摘要:可使用多种风格生成全站摘要。
以及一些非 AI 功能点:
1. ⚙️ 零配置:所有配置和缓存隐藏在 .czon 目录,项目结构保持整洁。
2. 🔄 增量构建:基于内容哈希检测更改,仅处理变更文件。
3. 📚 Markdown 扩展支持:原生支持 KaTeX 数学公式、Mermaid 图表、Embla 轮播图、脚注等。
4. 🚀 静态站点生成:内置 React-based SSG,生成多语言静态站点。
5. 🌐 自动根据访问者语言路由:根据访问者的语言自动路由到对应的语言版本。
- 已安装 Node.js(建议使用 LTS 版本 24,或者版本 18 及以上,需要有 npx 命令)
- 已获取 OpenAI API Key,或者 OPENAI 兼容的 API Key
- 已安装 Git(用于从 Git 列出 Markdown 文件,忽略 .gitignore 规则过滤的文件)
``bash
export OPENAI_API_KEY="sk-xxxxxx" # 必须:请替换为您的 OpenAI API Key
export OPENAI_BASE_URL="https://api.openai.com/v1" # 可选,默认使用 OpenAI 官方 API
export OPENAI_MODEL="gpt-3.5-turbo" # 可选,默认使用 gpt-3.5-turbo 模型
export OPENAI_MAX_TOKENS="4096" # 可选,设置最大 token 数量限制 (忽略则使用模型的默认值,对于长文本翻译建议设置更高的值,例如 8192,具体取决于所使用的模型支持的最大 token 数量)
$3
在任意 Git 管理的文件夹中运行:
`bash
npx czon@latest build --lang zh-Hans --lang en-US
`由于语言代码后续会用作静态站点生成中许多功能的一部分,请确保使用 BCP 47 标准的语言代码。例如,
zh-Hans 代表简体中文,en-US 代表美国英语。您可以根据需要添加更多语言,例如 es-ES (西班牙语) ja-JP(日语)、ko-KR(韩语)等。
标准语言代码列表请参考 IETF language tag - Wikipedia。输出目录:
.czon/dist,后续需要部署该目录下的内容到静态站点托管平台。详细用法请运行
npx czon@latest --help`。| 特性 | CZON | Docusaurus | VuePress | Astro |
| ------------------ | ------------------------ | --------------- | --------------- | --------------- |
| AI 原生 | ✅ 深度集成 | ❌ | ❌ | ❌ |
| 零配置 | ✅ 隐藏配置 | ❌ 需要配置文件 | ❌ 需要配置文件 | ❌ 需要配置文件 |
| 多语言 AI 翻译 | ✅ 自动增量翻译 | ❌ 手动翻译 | ❌ 手动翻译 | ❌ 手动翻译 |
| 自动分类/标签 | ✅ AI 提取 | ❌ 手动配置 | ❌ 手动配置 | ❌ 手动配置 |
| Markdown 扩展 | ✅ KaTeX, Mermaid, Embla | ✅ 通过插件 | ✅ 通过插件 | ✅ 通过插件 |
| 主题定制 | ❌ 有限 | ✅ 丰富 | ✅ 丰富 | ✅ 丰富 |
CZON 定位为 AI 增强的内容引擎,而非全功能 SSG。它专注于通过 AI 提升内容创作效率,适合注重内容质量、希望减少配置负担的创作者。实际上,CZON 可以与 Docusaurus、VuePress、Astro 等 SSG 工具结合使用,作为内容生成和管理的前端引擎。
- 项目主页: https://github.com/zccz14/CZON
- GitHub Issues: https://github.com/zccz14/CZON/issues
- Discord 讨论区: https://discord.gg/h3QrCmz24n
---
_让写作回归宁静,让内容自然生长。_