[开发]FlintHub 提示语文案修复计划

👑Lv.11 元老 🌞 骨干会员
2026-10-24 00:29:21

本文由 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当前文案问题建议修改
1597admin.levels_hint等级根据积分自动计算,积分为到达即升级。"积分为到达即升级"多了一个"为"字,读不通等级根据积分自动计算,积分到达即升级。
2149thread.login_to_reply请只有一个"请"字,句子截断不完整请登录后回复 (需配合模板拼接,建议改为完整句)
31011admin.db_consistency_confirm执行一致性对拍?"对拍"是口语/方言词,非标准书面语执行一致性校验?
4939admin.db_layman_intro下面每一项都会说明"它是干嘛的""干嘛的"过于口语化下面每一项都会说明"它的作用"

1.2 术语不一致(建议修)

#涉及 keys问题建议
5forum.no_threads='暂无帖子'、thread.not_found='帖子不存在'、thread.no_permission='您没有权限回复该帖子' vs thread.deleted='主题已删除'、thread.delete_confirm='确定要删除这个主题吗?'同一个 thread 概念,部分用"帖子"部分用"主题"统一为"主题"(帖子是回复 post,主题是 thread)
6thread.no_permission='您没有权限回复该帖子' vs thread.no_permission_view='您没有权限浏览该帖子'同上,应改为"该主题"统一

1.3 语气/风格微调(可选)

#行号key问题建议
7847admin.queue_mode1_behavior_val"用户体验极致无延迟"偏营销语气改为"页面响应无感知延迟"
8984admin.db_capacity_warn_val"但注意——"用中文破折号,风格不统一改为"注意:"


二、英文语言包 lang/en.php 语病

2.1 语法错误(必修)

#行号key当前文案问题建议修改
1111thread.reply_count{count} reply缺少复数处理,当 count>1 时语法错误{count} replies
2149thread.login_to_replyPlease句子截断,只有 "Please" 无后文Please log in to reply (需配合模板)

2.2 术语不一致 thread/topic 混用(必修)

英文版最大的问题是 thread 和 topic 两个词混用。论坛首页用 topic,后台管理用 thread,应统一。

#key当前应改为原因
3admin.threads_titleThread ManagementTopic Management与 forum.thread_count='Topics' 统一
4admin.thread_countThreadsTopics同上
5admin.batch_deleted{count} threads deleted{count} topics deleted同上
6admin.batch_moved{count} threads moved{count} topics moved同上
7admin.batch_delete_confirmDelete the selected {count} threads?Delete the selected {count} topics?同上
8admin.batch_move_confirmMove the selected {count} threads to "{name}"?Move the selected {count} topics to "{name}"?同上
9admin.trashed_totalDeleted threads ({count} total)Deleted topics ({count} total)同上
10admin.rebuild_progress_threadsThreads {done}/{total}Topics {done}/{total}同上
11admin.db_layman_bucket...a drawer for posts...a drawer for topicsposts vs topics 不一致
12admin.db_archive_hintPosts older than the set days...Topics older than the set days...同上
13admin.db_archive_warn_val...overdue threads get marked......overdue topics get marked...threads vs topics
14admin.db_archive_daysArchive threads older than (days)Archive topics older than (days)同上
15admin.db_bucket_confirm...where future new posts are stored...where future new topics are storedposts vs topics
16admin.db_bucket_warn_valAfter expanding, new topics go into...OK(此处已用 topics)已正确,无需改

2.3 措辞不当(建议修)

#行号key当前问题建议
17336blog.floorfloor中文"楼"指楼层评论编号,英文 "floor" 无此含义#(井号更直观)
18138thread.last_editedLast edited by {username} at {time}编辑时间用 "at" 仅适合时刻;若含日期应用 "on"Last edited by {username} on {time}
19126thread.bucket_full...please contact the administrator to expand it"expand it"指代不清...please contact the administrator
201064admin.invalid_emailInvalid email format与其他处 auth.invalid_email='Invalid email address' 不一致Invalid email address
211200js.upload_successUpload succeeded与其他处风格不统一Upload successful


三、繁体中文语言包 lang/zh_tw.php 语病

3.1 简体字混入(必修)

#行号key当前问题建议修改
1149thread.login_to_reply请简体字"请"混入繁体包請

3.2 与 zh.php 相同的语病

繁体包直接继承了简体包的以下问题(繁体转写后同样存在):

#key问题建议修改
2admin.levels_hint积分为到达即升级積分到達即升級
3admin.db_consistency_confirm一致性对拍(繁体:對拍)一致性校驗
4thread.login_to_reply句子截断"請"請登入後回覆


四、硬编码文案(未走 i18n)

以下中文字符串直接硬编码在 PHP 代码中,未通过 I18n::get() 国际化:

#文件行号硬编码文案严重程度说明
1app/Helpers/Auth.php174403 - 权限不足 + 您没有访问此页面的权限。中直接输出给用户的 HTML,非英文用户可读
2app/Helpers/Csrf.php34403 - CSRF 验证失败中直接输出给用户的 HTML
3app/Helpers/Mailer.php120收件人邮箱格式不正确低内部错误返回值,用户不直接可见
4app/Models/Post.php55归档帖不可回复低RuntimeException 消息,用户通过错误页间接看到
5app/Models/Post.php166该帖所在数据桶已满载…低同上
6app/Models/User.php624用户删除未完全完成…低同上,面向管理员的异常消息

建议:#1、#2 直接面向终端用户,应迁移至 i18n。#3-#6 为内部异常/日志,优先级低,可后续统一处理。


五、修复优先级排序

第一批:必修(影响用户体验 / 明显语病)

序号语言文件修改内容工作量
1zhlang/zh.php:597admin.levels_hint "积分为到达" → "积分到达"1分钟
2zhlang/zh.php:1011admin.db_consistency_confirm "对拍" → "校验"1分钟
3enlang/en.php:111thread.reply_count '{count} reply' → '{count} replies'1分钟
4zh_twlang/zh_tw.php:149thread.login_to_reply '请' → '請'1分钟
5zhlang/zh.php:149thread.login_to_reply '请' → '请登录后回复'1分钟
6enlang/en.php:149thread.login_to_reply 'Please' → 'Please log in to reply'1分钟
7zh_twlang/zh_tw.php:1011admin.db_consistency_confirm "對拍" → "校驗"1分钟

第二批:术语统一(thread/topic、帖子/主题)

序号语言修改内容涉及 key 数量
8zh"帖子"→"主题"(仅 thread 语境下的帖子)~5 个 key
9en"threads"→"topics"(admin 后台相关)~14 个 key
10zh_tw同步 zh 的"貼文/主題"统一~5 个 key

第三批:英文措辞优化

序号修改内容涉及 key
11blog.floor 'floor' → '#'1 个
12thread.last_edited 'at' → 'on'1 个
13thread.bucket_full 删 "expand it"1 个
14admin.invalid_email 统一为 'Invalid email address'1 个
15js.upload_success 'succeeded' → 'successful'1 个

第四批:硬编码文案迁移(可后续处理)

序号文件内容
16Auth.php:174403 页面迁移到 i18n key error.403_admin
17Csrf.php:34CSRF 失败页迁移到 i18n key error.csrf_page


六、注意事项

  1. 修改 thread.login_to_reply 时需检查模板:该 key 在模板中可能与 <a href="/login"> 标签拼接,修改后需确认拼接逻辑不变
  2. thread/topic 统一影响面:涉及前台+后台约 20 个 key,建议改完后全局搜索确认无遗漏
  3. 繁体包同步:zh.php 的每处修改都需要同步到 zh_tw.php
  4. 硬编码迁移:Auth.php 和 Csrf.php 的硬编码文案修改需同时更新三个语言包
轻量级、高性能、零 MySQL 依赖的PHP社区系统。
| 浏览 3 次 | 回复 0 次

全部回复 (0)

暂无回复

请 登录