正文开始
有些话,意思其实很简单,但如果直接说出来,总觉得少了一点郑重。
比如“这瓜保熟吗”,换成普通表达就是一句很直接的询问;但如果放进《合乎周礼》,它可能会变成一段关于时节、诚信、买卖双方名分和待人礼数的完整论述。
这就是 合乎周礼 想做的事情:把现代白话包装成一本正经的“周礼体”,让一句普通话听起来像是经过礼法推演之后才得出的结论。
项目并不是传统意义上的翻译器。它不追求逐字对应,而是根据输入内容重新组织语气、身份、关系和论证方式,最后生成一种带有古代议论腔调、但仍然能够读懂的中文表达。
除了“问礼”,项目还提供“释礼”功能,可以把这类周礼体文字拆开,翻译成直接、清楚的人话。
一、项目能做什么
《合乎周礼》目前提供两种主要方向。
“问礼”用于把日常表达改写成周礼体。例如输入一句:
这瓜保熟吗?
生成结果可能会变成:
我听闻从前有个买瓜的客人,到了瓜摊之前,先拱手向卖瓜人问道:敢问此瓜可是顺应时节而生,可曾用过催熟之法?若是熟得恰到好处,我愿依市价相购。
它不会只替换几个古风词语,而是会尝试补充上下文,让原本很短的一句话变成一段完整的论述。
“释礼”则是反向操作,将周礼体中的铺垫、名分和道理剥开,直接说明原文想表达的意思。例如:
我听闻,今日我设此礼门,并非拒人千里,只是怕众人一拥而入,坏了满座通畅。
可以翻译为:
我设置次数限制不是为了故意拦人,而是怕接口被刷爆,影响正常用户使用。
这种双向设计让项目不只是一个玩梗页面,也可以用来观察同一句话在不同语气、身份和叙事方式下会产生什么变化。
问礼模式提供四种风格:
温言相劝 大儒辩经 强行圆场 痛心疾首
释礼模式也有四种表达方式:
直白释义 耐心讲明 潜台词版 锐评拆穿
生成长度分为三档。问礼使用“小礼”“成礼”“大礼”,释礼则对应“略释”“明释”“详释”。短档适合评论和聊天,长档则更适合生成完整段落。
二、实际使用体验
打开在线页面后,输入需要处理的文字,选择“问礼”或“释礼”,再选择表达风格和篇幅,最后提交生成即可。
例如输入:
疯狂星期四,谁请我吃饭才合乎周礼?
选择“温言相劝”后,生成结果通常会围绕宴饮、朋友情义和行仁义展开,让一句网络热梗变成一段看起来很有道理的礼法论证。
项目的有趣之处在于,它并不是简单把文字改成“之乎者也”。真正的周礼体需要先把原话放进一个更大的关系框架里:
原始诉求 -> 找到人物关系 -> 解释行为的名分 -> 补充礼法依据 -> 用郑重语气完成论证 -> 回到原本想表达的事情
所以同样一句话,选择“温言相劝”和“痛心疾首”之后,最终结果会有明显区别。前者更像耐心劝说,后者则会把普通小事解释成一件令人痛心的礼法失序。
生成完成后,页面支持复制全文,也可以将结果导出为图片。问礼结果可以生成礼帖,释礼结果可以生成释帖,适合发到社交平台或保存下来。
项目还考虑了移动端使用。手机浏览器打开后,可以直接输入文字、选择模式并查看生成内容,不需要安装独立 App。
三、Skill 文件与 AI 使用方式
这个项目并不只有一个网页,还提供了可以单独下载的 speak-zhouli Skill。
Skill 文件位于:
skill-package/speak-zhouli/SKILL.md
网页提供 Markdown 文件和 ZIP 压缩包下载:
/downloads/speak-zhouli-SKILL.md /downloads/speak-zhouli-skill.zip
下载后,可以将 Skill 放进支持自定义 Skill 的 AI 工具中。之后不必打开网站,也可以直接在对话里提出类似要求:
问礼:把“请把接口文档发给我”改写成温和但正式的周礼体。 释礼:把下面这段周礼体翻译成直接人话。
这种方式更适合已经在使用 AI 编程工具或个人提示词系统的人。网页版本适合直接体验,Skill 版本则更适合嵌入自己的工作流。
如果修改了 Skill 源文件,需要重新生成网站公开下载文件:
cp skill-package/speak-zhouli/SKILL.md public/downloads/speak-zhouli-SKILL.md cd skill-package zip -r -X ../public/downloads/speak-zhouli-skill.zip speak-zhouli
四、本地运行与部署
项目使用 Next.js、React 和 TypeScript 开发,生产环境使用 DeepSeek 接口生成内容,服务端负责保存 API Key,浏览器端不会直接拿到密钥。
本地运行需要 Node.js 20 或更高版本。
克隆项目并安装依赖:
git clone https://github.com/Aspirin0000/zhouli-translator.git cd zhouli-translator npm install
复制环境变量模板:
cp .env.example .env.local
然后编辑 .env.local:
DEEPSEEK_API_KEY=sk-your-key-here DEEPSEEK_MODEL=deepseek-v4-flash MAX_OUTPUT_TOKENS=720
启动开发服务器:
npm run dev
浏览器打开:
http://localhost:3000
如果没有配置 DEEPSEEK_API_KEY,项目会进入本地演示模式,页面和交互仍然可以使用,但不会调用 DeepSeek 生成真实结果。
完成修改后,可以运行测试、类型检查和生产构建:
npm test npm run typecheck npm run build
项目也支持部署到 Cloudflare Workers。部署前需要配置 DeepSeek API Key、反馈签名密钥以及 D1 数据库。
npm install npx wrangler login npx wrangler secret put DEEPSEEK_API_KEY npx wrangler secret put RESPONSE_FEEDBACK_SECRET npx wrangler d1 migrations apply zhouli-analytics --remote npm run deploy
如果使用 Vercel,只需要导入仓库,并添加必要的环境变量:
DEEPSEEK_API_KEY DEEPSEEK_MODEL MAX_OUTPUT_TOKENS
也可以部署到普通 Node.js 服务:
npm install npm run build npm run start
正式部署时,建议放在 HTTPS 和进程管理器后面,例如 Nginx、PM2 或 systemd。
五、项目优点与不足
这个项目最明显的优点是主题非常集中。它没有试图做一个什么都能写的通用 AI 文案工具,而是围绕“如何把普通话说得合乎礼法”这个单一方向,把提示词、交互、文案风格和图片输出统一起来。
双向模式也是一个亮点。只提供周礼体生成,容易变成一次性玩梗;加入释礼之后,用户可以在“包装”和“拆解”之间来回切换,体验更完整。
四种风格和三档长度让结果不会完全固定。同一句输入可以生成温和、辩论、圆场或批评等不同版本,适合测试提示词对文本风格的影响。
项目还提供独立 Skill,这一点对 AI 用户比较方便。网页适合普通访问者,Skill 适合接入 Claude Code、Codex 或其他支持自定义指令的工具。
从工程实现上看,项目也比较完整:
Next.js 网站 React 交互界面 TypeScript 类型约束 DeepSeek 服务端调用 Cloudflare Workers 部署 Cloudflare D1 数据统计 礼帖与释帖图片导出 Skill 文件分发 单元测试与公开发布审计
匿名统计默认不保存用户的输入和输出,明确授权后才会提交案例内容,这种数据边界说明比很多小型 AI 项目更完整。
当然,它也有一些限制。
第一,真正的生成能力依赖 DeepSeek API。没有 API Key 时只能使用演示输出,不能把本地演示模式当成完整离线模型。
第二,生成结果具有随机性。同一句话每次得到的内容可能不同,偶尔会出现论证过度、语气重复或偏离原意的情况。它更适合娱乐、创作和风格实验,不适合作为严肃历史研究或古汉语翻译工具。
第三,周礼体本身是一种经过现代网络语境重新包装的文风,并不等同于真实的周代礼制,也不能拿生成内容直接当作历史资料引用。
第四,部署到公网后需要自己处理限流、费用和滥用问题。项目在默认配置中提供了内存限流,但多实例生产部署时,建议改用 Redis、KV 或 D1 等共享存储,并设置模型服务的费用告警。
第五,图片导出和在线生成仍然需要浏览器环境和服务端接口。离线下载 Skill 可以脱离网站,但不能脱离所使用的 AI 工具和模型能力。
《合乎周礼》是一个很有辨识度的开源项目。它把日常中文、网络梗和 AI 文本生成结合起来,不是为了提供严肃翻译,而是让一句原本平直的话多一层身份、礼数和论证。
它既可以作为一个打开即玩的中文文案工具,也可以作为一个 DeepSeek API、Next.js、Cloudflare Workers 和 AI Skill 的综合案例来研究。
项目采用 MIT License,欢迎继续修改提示词、增加新的语言风格,或者把它改造成适合自己工作流的中文文本工具。
如果只是想体验效果,可以直接访问:
https://hehuzhouli.com/
如果希望在自己的 AI 工具中使用,可以下载 Skill:
https://hehuzhouli.com/downloads/speak-zhouli-SKILL.md
图片预览





下载地址
https://github.com/Aspirin0000/zhouli-translator
https://pan.baidu.com/s/1--_z7MTdGdVOh-2wloZ6wg?pwd=dgb7 提取码: dgb7







评论抢沙发