Databasus 多语言 README 同步机制全解：assets/readme 目录结构与 Agent 工程规范

数据库灾备【免费下载链接】databasusPostgreSQL backup tool with Point-In-Time-Recovery and restore verification项目地址https://gitcode.com/gh_mirrors/po/databasus点击查看免费下载Databasus 是开源的 PostgreSQL 备份工具同时支持 MySQL、MariaDB、MongoDB内置时间点恢复 PITR 与恢复验证其英文 README 被翻译为俄语、西班牙语、葡萄牙语、中文、法语五种语言统一存放在 assets/readme/ 目录下。assets/readme/AGENTS.md 正是这套多语言文档流水线的工程规范说明书它规定了翻译副本与英文原文之间必须保持的同步纪律、目录结构与相对路径换算规则、锚点anchor推导规则、语言使用边界与翻译质量标准。阅读并遵循这份规则是维护 Databasus 六语种文档不脱节、让读者真正能照着安装命令操作的前提。这个目录解决什么问题英文 README 位于仓库根目录 README.md而翻译副本则统一放在assets/readme/下每个语言一个文件README.ru.md俄语README.es.md西班牙语README.pt.md葡萄牙语README.zh.md中文README.fr.md法语英文原版保留在仓库根目录assets/readme/下只放翻译副本。该目录同时配有AGENTS.md与CLAUDE.md两份 Agent 规则文档说明这套翻译流水线是仓库内AI 协作工程化的一部分人类与 Agent 在改动文档时都必须遵守同样的同步纪律。从根 AGENTS.md 的文件清单可以看到assets/readme/AGENTS.md被列为与 backend/AGENTS.mdGo Gin GORM 后端、agent/verification/AGENTS.md验证代理 CLI、frontend/AGENTS.mdReact 前端、website/AGENTS.md营销网站平级的模块级规则文档负责约束整个 README 翻译子系统。同步规则critical英文改动必须落进全部 5 份翻译这份规则文档的开篇就定下一条最高优先级纪律任何对/README.md的改动都必须同时应用到这里的全部 5 份副本——包括结构、标题、链接、代码块、徽章badge。理由非常实际一份落后于英文原文的翻译比没有翻译更糟——读者会照着过期的安装命令操作。文档特别点出一个最容易出错的区段README 中的## ️ Security reliability engineering安全与可靠性工程章节。由于根目录 AGENTS.md 要求该章节必须与项目真实的安全实践保持一致因此对它的实质性修改一旦发生就会同时落进 6 个文件英文原文 5 份翻译。从仓库实际内容看这一点确实成立README.md 中的安全章节详细描述了 CodeQL、CodeRabbit、gitleaks、semgrep、Trivy、Dependabot、Dependency Review 等多层安全流水线而 assets/readme/README.zh.md 的中文版逐条对应根 AGENTS.md 的 Security 小节则明确写着README 的安全章节是这些实践面向公众的版本——实质内容变化时两者必须保持一致该章节与 README 其余部分一样存在于 6 种语言中。结构镜像每个文件逐节对应英文原文每个翻译文件都必须精确镜像英文 README相同的章节、相同的顺序相同的标题层级标题中相同的 emoji相同的列表结构bullet structure相同的水平分割线相同的 HTML 块还有一个容易忽略的细节功能特性区里的### Installation简介块teaser与正文完整的## Installation章节在英文原文中是重复出现的翻译时必须保留这种重复不能好心删掉。对照中文版 assets/readme/README.zh.md 可以验证其## ✨ 功能特性、## 安装、## 使用、## ️ 安全与可靠性工程、## 许可证、## 参与贡献的章节顺序与英文 README.md 完全一致标题 emoji 也一一对应。字节级一致命令、配置与徽章绝不能意译assets/readme/AGENTS.md列出了一批必须与英文字节级相同byte-identical的内容代码块命令、YAML、块内注释shields.io 徽章 URL 及其 alt 文本行内代码图片的alt/width属性产品名与工具名版本号端口号文中引用的英文界面文案如使用步骤里的New Database——界面是英文的文档要原样引用例如中文版 assets/readme/README.zh.md 中的密码重置命令docker exec -it databasus ./main --new-passwordYourNewSecurePassword123 --emailownerexample.com与英文原文逐字符一致端口4005、镜像名databasus/databasus:latest也原样保留。这条规则的深层逻辑是安装命令、配置片段是读者会直接复制执行的内容任何润色都可能引入不可执行的差异。路径规则翻译文件深一层的相对路径换算翻译文件位于assets/readme/比英文 README仓库根目录深一层因此文档内的相对链接必须相应换算目标相对路径图片../logo.svg、../dashboard-dark.svg、../dashboard.svg、../healthchecks.svg仓库文件../../LICENSE、../../deploy/helm/README.md英文 README../../README.md这些路径在中文版 assets/readme/README.zh.md 中都能找到实证例如第 13 行的../../LICENSE、第 20 行的../../README.md、第 40-42 行的../dashboard-dark.svg与../dashboard.svg以及第 247 行指向 deploy/helm/README.md 的../../deploy/helm/README.md。图片文件确实存在于 assets/ 下logo.svg、dashboard-dark.svg、dashboard.svg、healthchecks.svg。网站链接语言前缀与固定锚点翻译文档中出现的databasus.com链接规则要求携带语言前缀并保留结尾斜杠https://databasus.com/locale/storages/https://databasus.com/locale/faq/#backup-databasus其中锚点 ID#backup-databasus、#oss-programs在所有语言中保持完全一致绝不能翻译而https://databasus.com/contribute在官网上没有翻译版本因此不加语言前缀。中文版 assets/readme/README.zh.md 中的https://databasus.com/zh/storages/、https://databasus.com/zh/faq/#backup-databasus等链接即遵循此规则。页内锚点与官网不同GitHub 锚点由标题自动推导这是这份规则里技术性最强的部分之一。官网页面的锚点在各语言间保持一致但 GitHub 仓库内的锚点不同GitHub 由标题文本自动推导锚点因此翻译后的标题会生成翻译后的锚点。由于没有外部文件链接到这些翻译文件的章节内部所以每个文件的迷你目录mini-TOC和正文内链只需指向本文件自己的 slug。slug锚点推导规则全小写去掉标点去掉 emoji但 emoji 两侧的空格会变成一个连字符其余空格变为连字符西里尔字母Cyrillic与中日韩文字CJK原样保留文档给出了两个具体示例## ✨ Features→#-features## ️ Security reliability engineering→#️-security--reliability-engineering变体选择符 variation selector 会保留在锚点中在中文版中可以验证## ✨ 功能特性的锚点就是#-功能特性中文原样保留、emoji 变连字符与 assets/readme/README.zh.md 迷你目录中的写法一致。掌握这条规则就能预测 GitHub 页面上任何一个翻译标题的跳转链接而不必每次手工查看。语言使用边界翻译文件与仓库内仅英文规则的关系仓库范围内有一条总规则代码、注释、标识符、日志、提交信息一律使用英文。但翻译文件是例外中的例外其边界被严格划定翻译内容本身使用目标语言俄语、西班牙语、葡萄牙语、中文、法语6 个语言切换器标签English、Русский、Español、Português、中文、Français也出现在根 README.md作为例外保留该目录下除此之外的一切都保持英文包括提交信息与本规则文档本身文件名只携带语言代码locale code如README.zh.md根 AGENTS.md 给出了允许翻译内容出现的全部五个位置网站页面文案website/app/[lang]/*/content/locale.tsx、README 翻译assets/readme/README.locale.md、根 README 的语言切换器标签、前端界面字典frontend/src/shared/i18n/locales/locale.ts、以及 humanizer 技能中引用的示例对。这意味着assets/readme/是这份白名单上唯一的文档翻译区。从仓库文件系统看前端字典目录 frontend/src/shared/i18n/locales/ 下确实存放着en.ts、es.ts、fr.ts、pt.ts、ru.ts、zh.ts六个界面字典文件与 README 翻译的六语种布局相呼应——界面文案与 README 翻译共享同一套语言规范。翻译质量从逐字翻译到编辑式翻译assets/readme/AGENTS.md明确引用 website/AGENTS.md 的 Translation quality 章节并逐条适用。核心要求是翻译是目标语言的编辑式成文edited copy不是逐字对应word-for-word。关键质量约束包括不硬译No calques保留英文语序的直译、逐字渲染英文结构都必须重写不官腔、不注水No bureaucratese删掉膨胀动词与自我吹捧的结尾句不重复No repeats不在相邻句子中复述同一列表或同一动词每个语言有自己的约定俄语用「е」不用「ё」数字写法如「2-х минут」西班牙语用 usted 敬称「copia de seguridad」是标题与正文的标准术语葡萄牙语为巴西葡萄牙语pt-BR用进行时«está rodando»而非欧式«está a correr»法语用 vous 敬称百分号前保留空格«99 %»中文用「你」而非「您」标题也如此、全文使用全角标点。、每个中日韩字符与拉丁字母交界处保留一个空格website/AGENTS.md 还给出了各语言标题的最高搜索量规范形ru «резервное копирование PostgreSQL»、es «copia de seguridad de PostgreSQL»、pt «backup PostgreSQL»、fr «sauvegarde PostgreSQL»、zh «PostgreSQL 备份»——标题与 h1/h2 瞄准高频检索词组同义词如 zh 的「数据库备份」放进正文。此外还有一条文案英文保留规则产品统计数字Docker pulls、GitHub stars 等必须在全部 6 种语言和页面上所有重复块之间保持同步品牌导航项Slack、Google Drive、Databasus vs X与引用的界面选项名After backup、Scheduled verification、Hourly按设计在所有语言中保持英文因为界面本身就是英文的文档必须原样引用。这份规范在仓库中的纵深验证assets/readme/AGENTS.md不是孤立的存在它与仓库其他部分的工程实践互相咬合根规则引用AGENTS.md 将assets/readme/AGENTS.md描述为根 README 的翻译副本的治理规则并规定每处受影响的模块在改动时都要接受模块级文档与本文件的双重审查见 AGENTS.md 的强制合规审查章节。网站翻译同源website/AGENTS.md 描述了 Next.js 网站的 5 语种全页面副本翻译方案app/[lang]/path/content/locale.tsx与 README 翻译共享相同的语言质量标准两者共同构成 Databasus 完整的文档多语言矩阵README 6 语言 官网 5 语言 前端界面 6 字典。界面字典联动根 AGENTS.md 提到的前端界面字典 frontend/src/shared/i18n/locales/ 使用与 README 相同的术语体系中文备份、存储、通知渠道、工作区、恢复、可用性检查、恢复验证、验证代理保证文档能原样引用界面文案。真实翻译成果assets/readme/README.zh.md 是这套规范的直接产物其章节结构、emoji 标题、命令代码块、相对路径换算、语言切换器标签与锚点写法均可对照上文规则逐一验证。实操自查清单维护一份翻译副本时的必要检查综合assets/readme/AGENTS.md全文维护者人或 Agent在改动任一翻译文件时应依次确认是否同步了根 README.md 的本次改动结构、标题、链接、代码块、徽章6 个文件一个都不能少章节顺序、标题层级、标题 emoji、列表结构、水平线与 HTML 块是否与英文逐项镜像命令、YAML、徽章 URL、行内代码、图片alt/width、产品名、版本号、端口号是否保持字节级一致图片相对路径是否为../前缀、仓库文件是否为../../前缀、英文 README 链接是否为../../README.md官网链接是否携带本语言前缀与结尾斜杠锚点 ID如#backup-databasus是否保持原样页内锚点是否符合 GitHub 自动推导规则emoji 变连字符、CJK 保留、标点删除翻译是否符合目标语言约定中文用「你」、全角标点、CJK↔Latin 空格是否杜绝硬译、官腔与重复提交信息与文件命名仅语言代码是否保持英文。这份清单同时也是一份面向 LLM/Agent 的结构化指令——当 AI 参与文档维护时规则文档本身就是其约束的载体这正是 Databasus 将AGENTS.md文件体系与翻译工作流深度绑定的工程化思路。赞分享数据库灾备【免费下载链接】databasusPostgreSQL backup tool with Point-In-Time-Recovery and restore verification项目地址https://gitcode.com/gh_mirrors/po/databasus点击查看免费下载相关推荐fastlane match 证书仓库自动 README 全解目录结构、OpenSSL 加密机制与团队签名协作规范fastlane match 证书仓库自动 README 全解目录结构、OpenSSL 加密机制与团队签名协作规范 本指南围绕 fastlane match开发工具CI/CD移动开发ESPnet DNS Interspeech 2020 语音增强 Recipe 实战指南从 BLSTM 到 TFGridNet 的完整复现与评分解读ESPnet DNS Interspeech 2020 语音增强 Recipe 实战指南从 BLSTM 到 TFGridNet 的完整复现与评分解读 本指南以人工智能语音音频深度学习NLPawesome-gpt-image-2-API-and-Prompts 多语言 README 同步中的 News/Menu 区块保护机制解析awesome gpt image 2 API and Prompts 多语言 README 同步中的 News/Menu 区块保护机制解析 多语言 READM人工智能提示工程媒体生成上一篇Docker容器中Windows虚拟机使用macvlan网络时出现Operation not supported错误分析下一篇解决WebRTC实时流卡顿Mediamtx中ICE候选收集优化指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考