79 lines
3.4 KiB
Markdown
79 lines
3.4 KiB
Markdown
# 线程模板
|
||
|
||
## 使用方式
|
||
|
||
- 新开一个并行线程时，把下面内容复制到线程首条消息里，并把“线程名”和“认领文件”替换掉
|
||
- 新线程开始前，先读取：
|
||
- `docs/i18n/线程协作.md`
|
||
- `docs/i18n/翻译进度.md`
|
||
- `docs/i18n/翻译清单.md`
|
||
- `docs/i18n/主要路由.md`
|
||
- 每次准备领取新任务前，也要重新读取以上 3 份协作文档 + `docs/i18n/主要路由.md`，确认其他线程的认领状态已经写入文档，避免重复领取
|
||
- 每次领取任务时，先更新 md 认领记录，再开始改源码；不要先改代码再补文档
|
||
- 写入认领记录前和写完后，都要再检查一次以上 3 份协作文档 + `docs/i18n/主要路由.md`，确认没有线程冲突
|
||
|
||
## 文档定位
|
||
|
||
- 本文件只负责给新线程提供启动清单与首条消息模板
|
||
- 协作规则本体以 `docs/i18n/线程协作.md` 为准
|
||
- 主要路由结构与优先核查页面以 `docs/i18n/主要路由.md` 为准
|
||
- 进度时间线与文件级状态分别以 `docs/i18n/翻译进度.md`、`docs/i18n/翻译清单.md` 为准
|
||
|
||
## 启动前补充检查
|
||
|
||
- 读取 md 或源码时使用：`Get-Content -Raw -Encoding UTF8 <path>`
|
||
- 领取任务前先重读 3 份协作文档 + `docs/i18n/主要路由.md`，再决定是否写入新的认领记录
|
||
- 领取任务的推荐顺序：重读 3 份协作文档 + `docs/i18n/主要路由.md` -> 确认无人认领 -> 先写 md -> 再读同样的文档集合复查 -> 开始改代码
|
||
- 所有线程统一领取优先级：`首页 > docs/i18n/主要路由.md > 其他路由`
|
||
- 只要首页或 `docs/i18n/主要路由.md` 中页面仍未完成，就不要跳到其他普通路由
|
||
- 读取最新语言文件，避免覆盖别人新增的 key：
|
||
- `src/lang/messages/pages/en.js`
|
||
- `src/lang/messages/pages/zh.js`
|
||
- 扫描认领页面是否存在同目录私有子组件、抽屉、弹窗表单；如果有，一并检查中文展示文案
|
||
- 构建验证使用：`npm run build:prod`
|
||
- 单文件快速扫中文可用：`Select-String -Path <file> -Pattern '[\u4e00-\u9fa5]' -Encoding UTF8`
|
||
|
||
## 推荐首条消息模板
|
||
|
||
你是国际化翻译协作中的【线程X】。
|
||
|
||
请先读取以下文件并基于其内容继续工作：
|
||
|
||
- `docs/i18n/线程协作.md`
|
||
- `docs/i18n/翻译进度.md`
|
||
- `docs/i18n/翻译清单.md`
|
||
- `docs/i18n/主要路由.md`
|
||
|
||
本线程当前认领文件：
|
||
|
||
- `待填写文件路径`
|
||
|
||
执行要求：
|
||
|
||
- 只翻译展示文本
|
||
- 不改功能逻辑
|
||
- 不改接口参数
|
||
- 不改路由路径
|
||
- 不改权限码
|
||
- 不改后端依赖值
|
||
- 认领优先级遵守：`首页 > docs/i18n/主要路由.md > 其他路由`
|
||
- 如果文本依赖接口返回且当前无法推断，先跳过，并把阻塞写入 md
|
||
- 领取任务后，先把认领信息写入 md，确认无冲突后再开始改源码
|
||
- 完成后同步更新：
|
||
- `docs/i18n/翻译进度.md`
|
||
- `docs/i18n/翻译清单.md`
|
||
|
||
完成后输出：
|
||
|
||
- 已完成文件
|
||
- 新增语言 key 范围
|
||
- 未处理阻塞项
|
||
- 是否已更新 md
|
||
|
||
## 已沉淀的复用经验
|
||
|
||
- 页面内资源组/奖励配置类抽屉，优先查看是否可复用 `pages.propsSourceGroupForm`
|
||
- 如果 PowerShell 直接读取出现乱码，优先怀疑读取编码，不要急着判断文件损坏
|
||
- 如果 `npm run build` 失败，先检查 `package.json`，本项目应改用 `npm run build:prod`
|
||
- 多线程认领时，写 md 比改源码优先级更高；认领前后都要复查 3 份协作文档 + `docs/i18n/主要路由.md`，确认没有撞任务
|