本文由 FlintHub 开发文档归档发布。原始文档日期见标题前缀,来源:暂存20260913/mimo提示语文案修复计划.md。
FlintHub 提示语文案修复计划
审查范围:lang/zh.php(1247行)、lang/en.php(1247行)、lang/zh_tw.php(1247行)、app/ 下硬编码文案
审查日期:2026-09-09
审查模型:AtomCode (mimo-v2.5-pro)
一、中文语言包 lang/zh.php 语病
1.1 语法/错别字(必修)
| # | 行号 | key | 当前文案 | 问题 | 建议修改 |
|---|
| 1 | 597 | admin.levels_hint | 等级根据积分自动计算,积分为到达即升级。 | "积分为到达即升级"多了一个"为"字,读不通 | 等级根据积分自动计算,积分到达即升级。 |
| 2 | 149 | thread.login_to_reply | 请 | 只有一个"请"字,句子截断不完整 | 请登录后回复 (需配合模板拼接,建议改为完整句) |
| 3 | 1011 | admin.db_consistency_confirm | 执行一致性对拍? | "对拍"是口语/方言词,非标准书面语 | 执行一致性校验? |
| 4 | 939 | admin.db_layman_intro | 下面每一项都会说明"它是干嘛的" | "干嘛的"过于口语化 | 下面每一项都会说明"它的作用" |
1.2 术语不一致(建议修)
| # | 涉及 keys | 问题 | 建议 |
|---|
| 5 | forum.no_threads='暂无帖子'、thread.not_found='帖子不存在'、thread.no_permission='您没有权限回复该帖子' vs thread.deleted='主题已删除'、thread.delete_confirm='确定要删除这个主题吗?' | 同一个 thread 概念,部分用"帖子"部分用"主题" | 统一为"主题"(帖子是回复 post,主题是 thread) |
| 6 | thread.no_permission='您没有权限回复该帖子' vs thread.no_permission_view='您没有权限浏览该帖子' | 同上,应改为"该主题" | 统一 |
1.3 语气/风格微调(可选)
| # | 行号 | key | 问题 | 建议 |
|---|
| 7 | 847 | admin.queue_mode1_behavior_val | "用户体验极致无延迟"偏营销语气 | 改为"页面响应无感知延迟" |
| 8 | 984 | admin.db_capacity_warn_val | "但注意——"用中文破折号,风格不统一 | 改为"注意:" |
二、英文语言包 lang/en.php 语病
2.1 语法错误(必修)
| # | 行号 | key | 当前文案 | 问题 | 建议修改 |
|---|
| 1 | 111 | thread.reply_count | {count} reply | 缺少复数处理,当 count>1 时语法错误 | {count} replies |
| 2 | 149 | thread.login_to_reply | Please | 句子截断,只有 "Please" 无后文 | Please log in to reply (需配合模板) |
2.2 术语不一致 thread/topic 混用(必修)
英文版最大的问题是 thread 和 topic 两个词混用。论坛首页用 topic,后台管理用 thread,应统一。
| # | key | 当前 | 应改为 | 原因 |
|---|
| 3 | admin.threads_title | Thread Management | Topic Management | 与 forum.thread_count='Topics' 统一 |
| 4 | admin.thread_count | Threads | Topics | 同上 |
| 5 | admin.batch_deleted | {count} threads deleted | {count} topics deleted | 同上 |
| 6 | admin.batch_moved | {count} threads moved | {count} topics moved | 同上 |
| 7 | admin.batch_delete_confirm | Delete the selected {count} threads? | Delete the selected {count} topics? | 同上 |
| 8 | admin.batch_move_confirm | Move the selected {count} threads to "{name}"? | Move the selected {count} topics to "{name}"? | 同上 |
| 9 | admin.trashed_total | Deleted threads ({count} total) | Deleted topics ({count} total) | 同上 |
| 10 | admin.rebuild_progress_threads | Threads {done}/{total} | Topics {done}/{total} | 同上 |
| 11 | admin.db_layman_bucket | ...a drawer for posts | ...a drawer for topics | posts vs topics 不一致 |
| 12 | admin.db_archive_hint | Posts older than the set days... | Topics older than the set days... | 同上 |
| 13 | admin.db_archive_warn_val | ...overdue threads get marked... | ...overdue topics get marked... | threads vs topics |
| 14 | admin.db_archive_days | Archive threads older than (days) | Archive topics older than (days) | 同上 |
| 15 | admin.db_bucket_confirm | ...where future new posts are stored | ...where future new topics are stored | posts vs topics |
| 16 | admin.db_bucket_warn_val | After expanding, new topics go into... | OK(此处已用 topics) | 已正确,无需改 |
2.3 措辞不当(建议修)
| # | 行号 | key | 当前 | 问题 | 建议 |
|---|
| 17 | 336 | blog.floor | floor | 中文"楼"指楼层评论编号,英文 "floor" 无此含义 | #(井号更直观) |
| 18 | 138 | thread.last_edited | Last edited by {username} at {time} | 编辑时间用 "at" 仅适合时刻;若含日期应用 "on" | Last edited by {username} on {time} |
| 19 | 126 | thread.bucket_full | ...please contact the administrator to expand it | "expand it"指代不清 | ...please contact the administrator |
| 20 | 1064 | admin.invalid_email | Invalid email format | 与其他处 auth.invalid_email='Invalid email address' 不一致 | Invalid email address |
| 21 | 1200 | js.upload_success | Upload succeeded | 与其他处风格不统一 | Upload successful |
三、繁体中文语言包 lang/zh_tw.php 语病
3.1 简体字混入(必修)
| # | 行号 | key | 当前 | 问题 | 建议修改 |
|---|
| 1 | 149 | thread.login_to_reply | 请 | 简体字"请"混入繁体包 | 請 |
3.2 与 zh.php 相同的语病
繁体包直接继承了简体包的以下问题(繁体转写后同样存在):
| # | key | 问题 | 建议修改 |
|---|
| 2 | admin.levels_hint | 积分为到达即升级 | 積分到達即升級 |
| 3 | admin.db_consistency_confirm | 一致性对拍(繁体:對拍) | 一致性校驗 |
| 4 | thread.login_to_reply | 句子截断"請" | 請登入後回覆 |
四、硬编码文案(未走 i18n)
以下中文字符串直接硬编码在 PHP 代码中,未通过 I18n::get() 国际化:
| # | 文件 | 行号 | 硬编码文案 | 严重程度 | 说明 |
|---|
| 1 | app/Helpers/Auth.php | 174 | 403 - 权限不足 + 您没有访问此页面的权限。 | 中 | 直接输出给用户的 HTML,非英文用户可读 |
| 2 | app/Helpers/Csrf.php | 34 | 403 - CSRF 验证失败 | 中 | 直接输出给用户的 HTML |
| 3 | app/Helpers/Mailer.php | 120 | 收件人邮箱格式不正确 | 低 | 内部错误返回值,用户不直接可见 |
| 4 | app/Models/Post.php | 55 | 归档帖不可回复 | 低 | RuntimeException 消息,用户通过错误页间接看到 |
| 5 | app/Models/Post.php | 166 | 该帖所在数据桶已满载… | 低 | 同上 |
| 6 | app/Models/User.php | 624 | 用户删除未完全完成… | 低 | 同上,面向管理员的异常消息 |
建议:#1、#2 直接面向终端用户,应迁移至 i18n。#3-#6 为内部异常/日志,优先级低,可后续统一处理。
五、修复优先级排序
第一批:必修(影响用户体验 / 明显语病)
| 序号 | 语言 | 文件 | 修改内容 | 工作量 |
|---|
| 1 | zh | lang/zh.php:597 | admin.levels_hint "积分为到达" → "积分到达" | 1分钟 |
| 2 | zh | lang/zh.php:1011 | admin.db_consistency_confirm "对拍" → "校验" | 1分钟 |
| 3 | en | lang/en.php:111 | thread.reply_count '{count} reply' → '{count} replies' | 1分钟 |
| 4 | zh_tw | lang/zh_tw.php:149 | thread.login_to_reply '请' → '請' | 1分钟 |
| 5 | zh | lang/zh.php:149 | thread.login_to_reply '请' → '请登录后回复' | 1分钟 |
| 6 | en | lang/en.php:149 | thread.login_to_reply 'Please' → 'Please log in to reply' | 1分钟 |
| 7 | zh_tw | lang/zh_tw.php:1011 | admin.db_consistency_confirm "對拍" → "校驗" | 1分钟 |
第二批:术语统一(thread/topic、帖子/主题)
| 序号 | 语言 | 修改内容 | 涉及 key 数量 |
|---|
| 8 | zh | "帖子"→"主题"(仅 thread 语境下的帖子) | ~5 个 key |
| 9 | en | "threads"→"topics"(admin 后台相关) | ~14 个 key |
| 10 | zh_tw | 同步 zh 的"貼文/主題"统一 | ~5 个 key |
第三批:英文措辞优化
| 序号 | 修改内容 | 涉及 key |
|---|
| 11 | blog.floor 'floor' → '#' | 1 个 |
| 12 | thread.last_edited 'at' → 'on' | 1 个 |
| 13 | thread.bucket_full 删 "expand it" | 1 个 |
| 14 | admin.invalid_email 统一为 'Invalid email address' | 1 个 |
| 15 | js.upload_success 'succeeded' → 'successful' | 1 个 |
第四批:硬编码文案迁移(可后续处理)
| 序号 | 文件 | 内容 |
|---|
| 16 | Auth.php:174 | 403 页面迁移到 i18n key error.403_admin |
| 17 | Csrf.php:34 | CSRF 失败页迁移到 i18n key error.csrf_page |
六、注意事项
- 修改
thread.login_to_reply 时需检查模板:该 key 在模板中可能与 <a href="/login"> 标签拼接,修改后需确认拼接逻辑不变 - thread/topic 统一影响面:涉及前台+后台约 20 个 key,建议改完后全局搜索确认无遗漏
- 繁体包同步:zh.php 的每处修改都需要同步到 zh_tw.php
- 硬编码迁移:
Auth.php 和 Csrf.php 的硬编码文案修改需同时更新三个语言包