Open
README「一键部署」指令步骤编号重复(1/2/3/4/3),两处「替换后自查」标签重复 #956
wingxcnAdd on  19 days ago
wingxcn
19 days ago Create

问题描述

README 中「一键部署(推荐)」第 3 步内嵌的自动部署指令,是有序列表,但步骤编号出现了重复:1、2、3、4、3。

原文(README.md 第 22–27 行):

1. 在 /var/ 下创建 interview_Lab(知识库)和 interview_Log(日志)目录
2. 全仓替换 Skill 中的路径(注意:共 14 处、分布在 5 个 SKILL.md …)
3. 替换后自查:
   > 📌 路径口径:自动部署(华为云 AI 开发者空间,Linux)使用 /var/interview_Lab 与 /var/interview_Log;Windows 本地手动部署等价使用 D:\zhishiku\ 与 D:\面试记录\。两者按部署方式二选一,不要混用。
4. 替换后自查:`grep -rn "D:\\" Skills/` 应无输出;`grep -rn "/var/interview" Skills/` 应有 14 处命中
3. 所有 Agent 模型统一使用当前已配置的主模型

影响

这段文本是直接粘贴给 WorkSwarm 里 AI 执行的「部署指令」,而不是给人看的说明文档。编号重复会让 AI 把第 5 条(统一模型)误认成第 3 条的一部分,和第 3 条「替换后自查」合并处理;同时第 3 条其实只是「路径口径」说明,却顶着「替换后自查」的标签,和第 4 条真正的自查命令重名,模型容易只执行其中一条。

建议修改

按实际语义重排编号,并把口径说明从自查步骤里拆出来:

1. 在 /var/ 下创建 interview_Lab(知识库)和 interview_Log(日志)目录
2. 全仓替换 Skill 中的路径(共 14 处、分布在 5 个 SKILL.md):
   📌 路径口径:自动部署使用 /var/interview_Lab 与 /var/interview_Log;Windows 本地手动部署等价使用 D:\zhishiku\ 与 D:\面试记录\,两者二选一,不要混用
3. 替换后自查:`grep -rn "D:\\" Skills/` 应无输出;`grep -rn "/var/interview" Skills/` 应有 14 处命中
4. 所有 Agent 模型统一使用当前已配置的主模型

另外顺带两处小瑕疵,可一并处理(不影响主流程,可选):

  • 「两种部署方式」表格里写「见上方『一键部署(推荐)』第 3 步」,改动编号后需同步核对这处引用。
  • 「目录结构」代码块里 知识库/ 下的 4 个 PDF 与 Hands-on-Guidance/ 同级缩进写成了 ├──,树形层级看起来像和 知识库/ 平级。

复现方式

打开仓库 README.md,查看「一键部署(推荐)」章节第 3 步的代码块即可。

看到仓库近期有「修复 issue 反馈的文档与示例错误」的提交,这类指令级文档的小错误同样影响一键部署的首次成功率,故提交此 issue。

likedislike