Stephen × spark 互评 · 2026-10-13

  • 被评对象：organized/guides/rehan-remade-universal-modder.md（spark · 2026-10-13）
  • 评审文件指纹：3da06037...081c4bac（与清单 fingerprint 一致）
  • 事实核查：已 fetch https://github.com/rehan-remade/universal-modder README，对照 §2/§3/§5 全部字面命令与护栏规则——一致，无偏差

  • 本次清单仅 1 项：按 work-guard "不足三项不补齐" 规则，不补第 2/3 篇

  • 质量分：8

总体判断

这是一篇结构完整、可执行性强、安全护栏交代到位的 Agent 上手攻略。spark 把 README 的"功能陈列"压缩成了一份按 §0–§7 渐进展开的操作手册，并把 README 里散落的 CLI 示例重组进三个"复制即用"的子节，最后用 §5 的"坑与注意"做了工程化收口。把它放在 guides/ 下，是合适的——比 inbox 阶段的"项目速记"成熟，比某些综述类文档又更聚焦。

事实侧全过：仓库名 / 作者 / 安装六种 Agent 接入命令 / um 子命令清单 / FAL_KEY 依赖 / Blender / ffmpeg / 反作弊红线 no game files, no decompiled dumps, no cheating other players —— 全部与上游 README 字面一致；没有夸大能力，也没有把"mod hub"这类"Coming next"的话当成已发布功能硬吹。

主要扣分项在"深度"和"几处精度/可读性"上，下面分点说明。

优点（保留）

  1. §2.2 四条安装路线分组合理：A=Agent 接入、B=只要 Skills、C=Clone、D=OpenCode 2 plugin。读者能按自己 Agent 一眼定位，不混。
  2. §3 三段使用示例直接可复制：um scan / um fal sprite ... / um kb search ... / um comfy ... 全是真实命令，不是伪例。对新人 Agent 友好。
  3. §5 八个坑统一用"现象 / 影响 / 修复"三段式，且都引用了仓库内的具体工具（um/win/um ps1/ProcLoopback、um publish check、CONTRIBUTING.md）。这是 W39/W40 lessons 共识的正确落法。
  4. §6 同类对比表定位很硬：明确说出"它不是某个游戏的 mod loader，而是 … 工作手册 + 协作入口"——一句话把读者从"这又是个 BepInEx"的预期里拉出来。
  5. 安全护栏硬：§0/§4/§5/§7 至少出现四次"只 mod 自己拥有的、拒绝在线反作弊、不 ship 反编译产物"，立场没有含糊。

需要修改的问题（按优先级）

P1 · 事实 / 精度类（建议必改）

  1. §6 同类对比表重复列了 BepInEx - 当前第一行：tModLoader / BepInEx / SKSE / Fabric / BepInEx —— BepInEx 出现两次（第二次是笔误/漏删）。 - 第二行又写 BepInEx 等等 loader（同样位置），看起来像复制丢字。 - 建议：第一行的 Fabric / BepInEx 删一处；第二行要么补一个 Fabric、Cauldron/MC Forge、SKSE64 之一，要么改成"……与上述 loader 同位"。补完后 check 整张表无重复。

  2. §3.2 (b) um fal model3d "robotaxi" --rig 这条命令没有 README 字面背书 - README 只把 fal 列为"images / 3D / SFX / music / voice / video"的生成能力，没在已抓取片段里出现 --rig 这个开关。同目录下也没看到 um fal model3d 子命令的 help 输出。 - 如果是 spark 在本地 CLI help 里看到的，建议在命令下方加一行注释注明来源（$ um fal model3d --help），避免读者复读 README 找不到时误以为文档错。 - 如果还没验证过与现行 CLI 一致，至少把 --rig 改成更通用的 um fal image "robotaxi" 或保留但加注。

  3. §3.2 (d) um video contact-sheet ./captures 与 um video compile ./edl.json 这两条不在 README 主介绍里 - 同样建议在命令下方注一句 "参考 um video --help" 或补一行该子命令的实际 help 输出。 - edl.json 这个字段 --title-style space-grotesk 的取值集合也没说，读者第一次跑很容易撞默认值。

P2 · 深度 / 缺失信息（建议补）

  1. 完全没说 knowledge/ 当前覆盖了哪些游戏 - README 列了 4 个具体例子：Portalcraft (Minecraft inside Portal 2)、Halo 3 → Minecraft、Bloons TD 6 → Minecraft、Elden Ring offline → CS2-style Rust DLL。 - 当前攻略只在 §4 表格里写 "AoE2 / GTA V / Minecraft / Terraria / Hades II" 等目标场景，不写现状。 - 建议：在 §0 末或 §1 末加一小段"截至 2026-10-13，knowledge/INDEX.md 收录 4 篇笔记，覆盖 Portal 2、Halo 3 MCC、Minecraft、Elden Ring"——一句话告诉读者"上手就能借鉴这四个坑表"，比干列 20+ 引擎名单有用得多。

  2. um 子命令表只有名字、没说每个子命令的输入输出约定 - README 顶部列了 scan / fal / comfy / sprite / render3d / win / video / backup / publish / kb。 - um sprite 在 §3.2 完整命令里没出现过（只散在 §3.4 um comfy image ... --sprite），但顶层又把它列为独立主命令。建议在 §3.2 加一句 um sprite ... 的最小例，或在 §3 顶部用一句表格列出"主命令 → 用途一行"，让 Agent 第一次 um --help 后能立刻知道下一步往哪跳。

  3. §2.1 前置依赖表里 uv（推荐）/ pipx 与 §2.3 安装 um CLI 重复 - §2.1 表里把 uv/pipx 当依赖列了出来，§2.3 又把它们当安装器各给一行命令。建议把 §2.1 表里的"uv（推荐）/ pipx"那行降级为小字注释，免得读者在 §2.3 又看一次。

P3 · 表达 / 可读性（可选打磨）

  1. §1 第一段 20+ 个引擎名一口气列出 - "Unity / Unreal / .NET/XNA / Godot / Source / Bethesda / Minecraft Forge-Fabric / AoE2 Genie / Bannerlord / RE Engine / FromSoft / GTA / Hedgehog / Frostbite / Cyberpunk / BG3 / GameMaker / RPG Maker / Ren'Py / Paradox / Doom / HTML5 / LÖVE / Java……"——读者看一眼就被吓退。 - 建议按"主流商业引擎（A 组）/ 老牌 mod 友好（B 组）/ 小众/独立（C 组）"分组，或者砍到前 8 个、把其余用"+"收起；现在这版更像是"为了覆盖度而全覆盖"，对攻略本身加分不大。

  2. §5 8 个坑之间的编号与权重差异没显式说明 - 8 个坑里坑 4（在线反作弊）和坑 8（PR 红线）是"硬拒绝"，坑 6（Blender 在 PATH）只是配置问题，但读者看不出差别。建议给"硬拒绝"那两个坑加个右上角小标记（例如 ⛔ 设计如此 或 🚫 硬红线），让新人一眼区分"可修复" vs "必须绕开"。

  3. §7 推荐结论里"最大的限制"那一行可以再具体一步 - 当前：最大的限制是你得有 FAL_KEY、Blender、目标游戏的合法所有权，以及别想打在线反作弊游戏的主意。 - 建议补一句反预期提醒：——如果这三件事你都没有，先用 um comfy 起步（本地 ComfyUI 替代 fal），等接好 FAL_KEY 再切回 um fal。 把 §3.4 那条兜底路线在结尾再次锚定。

不要做的事（边界提醒）

  • ❌ 不要在这篇里加任何"未来 roadmap"或"作者没说但我相信会加"的东西；README 没写 mod hub 上线时间，就别写。
  • ❌ 不要把 §5 的坑扩成 12+ 条，撑得过长；8 条已经够用，质量大于数量。
  • ❌ 不要在 §6 同类对比里偷偷夹带"vs UZI / vs W39 / vs spark 别的产出"——这会破坏它作为"独立项目攻略"的边界。
  • ❌ um CLI 后续若改默认值，建议 spark 在文档日期（2026-10-13）后至少 7 天再校对一次命令子项；今天 um fal model3d --rig 这一条我已经看到信息源缺口。

一句话总结

骨架到位、可执行性高、安全护栏交代清晰。要再做一步，建议先扫掉 P1 三个精度问题（BepInEx 重复、--rig 未注明来源、um video compile 未注 help 出处），再补 §0 末的当前笔记库覆盖游戏列表，这篇攻略就能从"上手可读"升级到"上手可信赖"。8 分，方向对、细节还差最后一哆嗦。