skill-forge-hub 1.1.0 → 1.2.0

package/spec-doc2spec/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/spec-doc2spec/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/spec-doc2spec/user-config.md

@@ -2,7 +2,7 @@
 
 > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
 > 本文件始终保留你的版本——输出目录、模板与引擎策略、确认方式放心改。
-> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
 > 你按需查看并手动合并新配置点到本文件。
 
 

package/spec-spec2doc/SKILL.md

@@ -1,15 +1,6 @@
 ---
 name: spec-spec2doc
-description: >
-  文档转 Word/PDF 交付稿 Skill（spec2doc）。把 Markdown 文档（规格/技术文档/说明文档/会议纪要等）导出为 Word / PDF——
-  Pandoc 负责机械转换，AI 负责转换前排版整理与转换后回验防错（Pandoc 对复杂表格、图片路径、中文字体有局限，
-  回验发现问题修正源稿重新转换直到通过，机械产物不直接交付）。主路径 Markdown → Word（支持 --reference-doc
-  模板：默认依次探测源目录 template.docx / reference.docx，可配置 TEMPLATE_DOCX）。
-  Markdown → PDF 双路径：xelatex（需 LaTeX 引擎与 CJK 中文字体）或 Chrome headless 打印（免 LaTeX、跨系统兜底），
-  引擎可配置 PDF_ENGINE。输出目录默认与源文档同目录，可配置 OUTPUT_DIR。
-  跨系统适配 macOS / Windows / Linux（Pandoc/LaTeX 安装、中文字体探测、Chrome 路径探测）。
-  .txt 纯文本视为无格式 md 同样可转；不处理一般性的文档内容讨论，只处理「Markdown → Word/PDF」的转换任务。
-  用户询问用法（spec2doc 怎么用/使用说明/能干什么）时走使用说明应答：读 resources/usage-guide.md 原样输出（首行标题改为「spec2doc 使用指南」），不执行任何转换命令。
+description: 文档转 Word/PDF 交付稿 Skill（spec2doc）。把 Markdown 文档（规格/技术文档/说明文档/会议纪要等）导出为 Word / PDF—— Pandoc 负责机械转换，AI 负责转换前排版整理与转换后回验防错（Pandoc 对复杂表格、图片路径、中文字体有局限， 回验发现问题修正源稿重新转换直到通过，机械产物不直接交付）。主路径 Markdown → Word（支持 --reference-doc 模板：默认依次探测源目录 template.docx / reference.docx，可配置 TEMPLATE_DOCX）。 Markdown → PDF 双路径：xelatex（需 LaTeX 引擎与 CJK 中文字体）或 Chrome headless 打印（免 LaTeX、跨系统兜底）， 引擎可配置 PDF_ENGINE。输出目录默认与源文档同目录，可配置 OUTPUT_DIR。 跨系统适配 macOS / Windows / Linux（Pandoc/LaTeX 安装、中文字体探测、Chrome 路径探测）。 .txt 纯文本视为无格式 md 同样可转；不处理一般性的文档内容讨论，只处理「Markdown → Word/PDF」的转换任务。 用户询问用法（spec2doc 怎么用/使用说明/能干什么）时走使用说明应答：读 resources/usage-guide.md 原样输出（首行标题改为「spec2doc 使用指南」），不执行任何转换命令。
 allowed-tools: ["Bash", "Read", "Write", "Edit"]
 disable-model-invocation: false
 ---
@@ -30,13 +21,13 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（OUTPUT_DIR/TEMPLATE_DOCX/TOC/PDF_ENGINE/CONFIG_VERSION）与临时口头要求说明都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（OUTPUT_DIR/TEMPLATE_DOCX/TOC/PDF_ENGINE/CONFIG_VERSION）与临时口头要求说明都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 配置版本机制（升级保护）
 
 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/spec-spec2doc/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/spec-spec2doc/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/spec-spec2doc/user-config.md

@@ -2,7 +2,7 @@
 
 > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
 > 本文件始终保留你的版本——输出目录、模板与引擎策略、确认方式放心改。
-> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
 > 你按需查看并手动合并新配置点到本文件。
 
 

package/team-report-collector/SKILL.md

@@ -21,7 +21,7 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（TEAM/TITLE/DIR/OPEN_HTML/THEME/REPORT_DATE）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（TEAM/TITLE/DIR/OPEN_HTML/THEME/REPORT_DATE）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 - **THEME**：收集台页面主题，tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 `<html data-theme="THEME值">` 定默认，页面右下角换肤坞五色点随点随换（localStorage 记忆，键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢；生成时头部写 `<meta name="trc-id" content="<UUID>">`，每次 crypto.randomUUID() 生成标准 UUID v4（8-4-4-4-12 十六进制，禁止手写变体、禁止沿用占位与旧值）；落盘写文件前顺扫落盘目录下本技能命名的 html，读各文件 id meta 查重，撞号重掷至不重复）
 
@@ -29,7 +29,7 @@ disable-model-invocation: false
 
 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/team-report-collector/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/team-report-collector/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/team-report-collector/user-config.md

@@ -1,5 +1,5 @@
 # user-config.md（本文件不会被 skill 升级覆盖，你的修改永久保留）
-# 官方配置更新时，另存 user-config.md.upstream 对照文件，可手动合并新配置点
+# 官方配置更新时，另存 user-config.upstream.md 对照文件，可手动合并新配置点
 
 ```yaml
 CONFIG_VERSION: 1  # 配置结构版本，skill 升级迁移依据

package/template/SKILL.md

@@ -20,13 +20,13 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（<配置项列表>）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（<配置项列表>）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 配置版本机制（升级保护）
 
 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/template/user-config.md

@@ -2,7 +2,7 @@
 
 > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
 > 本文件始终保留你的版本——落盘目录、格式开关放心改。
-> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
 > 你按需查看并手动合并新配置点到本文件。
 
 ## ⚙️ 默认配置（用户可手动修改；临时口头要求永远优先）

package/twin-docs/SKILL.md

@@ -19,13 +19,13 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DIRECTION/GLOSSARY_FILE/LINK_RULE/STYLE/SYNC_MODE）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DIRECTION/GLOSSARY_FILE/LINK_RULE/STYLE/SYNC_MODE）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 配置版本机制（升级保护）
 
 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/twin-docs/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/twin-docs/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/twin-docs/user-config.md

@@ -1,5 +1,5 @@
 # user-config.md（本文件不会被 skill 升级覆盖，你的修改永久保留）
-# 官方配置更新时，另存 user-config.md.upstream 对照文件，可手动合并新配置点
+# 官方配置更新时，另存 user-config.upstream.md 对照文件，可手动合并新配置点
 
 ```yaml
 CONFIG_VERSION: 1  # 配置结构版本，skill 升级迁移依据

package/weekly-report/SKILL.md

@@ -27,7 +27,7 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义模板
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/THEME/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION/DATA_SOURCES）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（DISK/FORMATS/DIR/OPEN_HTML/THEME/TEMPLATE/ROLE/CONFIRM/CONFIG_VERSION/DATA_SOURCES）与自定义模板都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 - **THEME**：html 页面主题，tech 深蓝科技（默认）/ biz 浅色商务 / mono IDEA 黑亮 / light IDEA 白亮 / warm 温暖渐变；生成时写 `<html data-theme="THEME值">` 定默认，页面右下角换肤坞随点随换（localStorage 记忆（键按页内嵌唯一 ID 隔离、多份产物互不串台、改名/移动目录记忆不丢（生成时头部写 `<meta name="weekly-id" content="<UUID>">`，每次 crypto.randomUUID() 生成标准 UUID v4（8-4-4-4-12 十六进制，禁止手写变体、禁止沿用占位与旧值）；落盘写文件前顺扫落盘目录下本技能命名的 html，读各文件 id meta 查重，撞号重掷至不重复））、?shot 截图模式与打印隐藏）
 - **DATA_SOURCES 意图路由**：用户说「把这些 git 地址 / 目录配置到这个 skill」「数据源加一下」「以后数据从 XX 仓库取」→ 默认指配置到 `user-config.md` 的 `DATA_SOURCES` 数据源清单（不是 SKILL.md、不是 disk-and-html.md）；「git 地址」给的是 URL 或本地仓库路径、目录给的是本地路径都写进 DATA_SOURCES。用户话术只指向某个特定数据源（如「只算这个仓库」）→ 当次生效，不写配置。意图仍有歧义（如分不清「数据收集配置」与「落盘目录配置」）→ 一句话与用户确认后写入，不猜
@@ -36,7 +36,7 @@ disable-model-invocation: false
 
 本 skill 当前配置版本为 `3`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/weekly-report/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/weekly-report/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/weekly-report/user-config.md

@@ -2,7 +2,7 @@
 
 > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
 > 本文件始终保留你的版本——落盘目录、格式、角色画像、自定义模板放心改。
-> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
 > 你按需查看并手动合并新配置点到本文件。