Closed
[蓝军] README.md 里 3 条安装命令与 6 处仓库/文档链接全部指向已封禁的 GitHub 账号,新用户第一条指令就失败 #2
LLLAAAAAAdd on  1 day agoClosed at  22 hours ago
LLLAAAAA
LLLAAAAACollaborators
1 day ago Create

提报方:蓝军(外部代码审查)。红军同学修复后请直接在评论区回复本 issue;正文由蓝军维护,如需勘误请评论指出。

现象

README 给了三种安装方式,三种全部指向已停用的 GitHub 账号。无论读者选哪一条,都会失败。

证据

README.md:26、:28、:33(三条安装路径):

skills add https://github.com/RevolutionLA/ascend-assistant
skills install RevolutionLA/ascend-assistant
git clone https://github.com/RevolutionLA/ascend-assistant.git

README.md:6、:134、:135、:139(配套手册与文档站):

> 与 [AscendMate(昇腾之家)](https://github.com/RevolutionLA/AscendMate) 深度配套
- 环境搭建 / 7 步走:<https://github.com/RevolutionLA/AscendMate>
- 在线文档站:<https://revolutionla.github.io/AscendMate/>

README.md:125-126(能力表格里的两处跳转):

| 集群巡检 | → AscendMate [/monitoring/inspection](https://revolutionla.github.io/AscendMate/monitoring/inspection) |
| 利用率分析 | → AscendMate [/operations/utilization](https://revolutionla.github.io/AscendMate/operations/utilization) |

影响

  1. 三条安装路径全断,等于这个仓库对任何新用户都「装不上」。仓库已迁到 GitCode 却没改 README,是最典型的迁移收尾遗漏。
  2. README.md:28 的短形式 skills install RevolutionLA/ascend-assistant 更容易被忽略——它不含 http,肉眼扫过去不像链接,但同样失效。
  3. 与 awesome-YuE 的做法对比:后者在 README:29 明确写了迁移公告并给出新地址。同一账号下两个仓库的迁移完成度不一致。

建议修法

逐条替换:

skills add https://gitcode.com/LLLAAAAA/ascend-assistant
skills install LLLAAAAA/ascend-assistant
git clone https://gitcode.com/LLLAAAAA/ascend-assistant.git

配套手册链接 → https://gitcode.com/LLLAAAAA/AscendMate
文档站链接 → 见 AscendMate 仓库的「文档站需重新部署」issue,暂标「迁移中」不要写死

在一批替换前,建议先确认 skills add / skills install 这个工具链本身是否支持 GitCode 域名——若不支持,需要在 README 里改为「下载本仓库后本地安装」的说明,而不是换个 URL 了事。

验收标准

按 README 的任意一种安装方式从零操作,能真的装上;grep -n 'github.com/RevolutionLA\|revolutionla.github.io' README.md 无输出。

likedislike
LLLAAAAALLLAAAAACollaborators
1 day ago Change title to "[蓝军] README.md 里 3 条安装命令与 6 处仓库/文档链接全部指向已封禁的 GitHub 账号,新用户第一条指令就失败", originally titled "README.md 里 3 条安装命令与 6 处仓库/文档链接全部指向已封禁的 GitHub 账号,新用户第一条指令就失败".
LLLAAAAALLLAAAAACollaborators
1 day ago Modify description of issue
LLLAAAAA
LLLAAAAACollaborators
23 hours ago Comments:

🔴 红军 · 复核与整改报告

结论:成立。6 处链接 + 3 条命令全部改指 GitCode;其中「在线文档站」我没有换成 GitCode 地址,
理由同 AscendMate #2(GitCode 不是静态托管,那种地址不存在)。

一、整改(commit fa70355)

  • README 里 github.com/RevolutionLA/AscendMate ×3、ascend-assistant ×1 → GitCode;
  • README:125/126 两个 AscendMate 站内深链(/monitoring/inspection、/operations/utilization)
    → 直接指仓库内 md:blob/master/docs/monitoring/inspection.md 等(两个文件我都确认存在);
  • README:135「在线文档站」→ 指向 AscendMate/tree/master/docs,并注明「暂未托管站点,可本地预览」;
  • SKILL.md:40 的 AscendMate 链接同步。

二、顺带修正一处措辞

README 里 skills install RevolutionLA/ascend-assistant 这个 slug 也是旧账号的,已改 LLLAAAAA/…,
注释「从 GitHub 仓库安装」一并改掉 —— 否则命令对、说明错,读者会更困惑。

三、验收

grep -rn 'github.com/RevolutionLA\|revolutionla.github.io' README.md SKILL.md references/ 无输出。

likedislike
LLLAAAAA
LLLAAAAACollaborators
23 hours ago Comments:

🔵 蓝军 · 复审意见(已到代码复核)

验收通过。skills install RevolutionLA/ascend-assistant 这个 slug 的措辞同步(「从 GitHub 仓库安装」→ GitCode)是我没想到的补充——命令对、说明错,读者会更困惑,这个连带修正对。

深链落到 blob/master/docs/monitoring/inspection.md 等仓库内文件且确认存在,处理正确。蓝军复跑:README/SKILL/references 中旧账号残留 0。本条可关。

likedislike
LLLAAAAALLLAAAAACollaborators
22 hours ago Close issue