DeepSeek Harness 源码开发与构建：submodule 装不上、worktree 失败与 fork 定时任务

从源码参与 DeepSeek Harness（DSH）开发时，有三个典型的「环境差异」问题会挡在第一步：把仓库作为子模块检出后 pnpm install 必然失败（安装脚本要启用的工作树配置键与子模块的既有配置冲突）；create_worktree 在旧版 git** 上百分之百失败（它无条件前置了一个新版本才有的选项）；以及fork 仓库继承了定时工作流、每天因缺少上游密钥而报错。** 这三条都不是产品功能缺陷，而是「本地/持续集成环境的差异没被覆盖」——所以排查思路也很一致：先确认你是哪种检出方式、哪个 git 版本、哪个仓库，再对照已知限制（#9856、#9676、#9499）。

DeepSeek Harness 子模块检出后安装必失败

一句话结论：作为子模块检出时，git 会把工作树路径写在共享配置里（这是标准行为），而安装脚本需要启用工作树范围的钩子路径配置，遇到这个已存在的键就直接抛错；脚本里没有子模块分支，报错里给的「把它移走」也不可操作。 报错形态是「无法启用某扩展配置因为它在共享配置里」（#9856）。

DeepSeek Harness 子模块三步处置

1. 确认判据：只有作为子模块检出时复现；普通克隆仓库时安装正常（#9856）。
2. 规避（已验证）：以持续集成模式运行安装，让脚本走短路分支：

CI=true pnpm install
#   预期：安装成功；并且之后运行脚本时不会再重复执行该安装校验

讨论中确认这条路径会短路检查，且安装完成后依赖校验也不会再跑（#9856）。

3. 修法方向：脚本里加子模块检测并在该情形下改用局部钩子路径配置；也可以用专门的环境变量覆盖（讨论中确认现有变量不覆盖这一处检查，所以需要新增或调整）（#9856）。
4. 验证：在子模块检出里重跑 CI=true pnpm install，预期无报错且后续开发命令可正常执行（#9856）。

DeepSeek Harness create_worktree 在旧版 git 上失败

一句话结论：该能力把 --no-lazy-fetch 无条件前置到每条 git 命令上，而这个选项是较新版本才加入工作树子命令的——所以在旧版 git 上第一步就报「未知选项」。 这条已在 dsh-v0.2.1-alpha.3 修复（社区回复确认）（#9676）。

DeepSeek Harness create_worktree 三步处置

1. 确认判据：报错明确说「未知选项 --no-lazy-fetch」；git --version 低于该选项被引入的版本（讨论中给的边界是 git < 2.42）（#9676）。
2. 处置一（最省事）：升级 git 到支持该选项的版本（#9676）。
3. 处置二（已升级 DSH 的话）：升级到 dsh-v0.2.1-alpha.3 或更高，该版本已修（#9676）。
4. 补丁内容值得记（如果你在维护工具）：按版本门控（≥ 2.42 才下发该参数）、把探测排在首条命令之后、并在预检阶段对部分克隆情形给出明确拒绝——讨论中提到该补丁让本地测试从「大量失败」变成「基本通过」（#9676）。

DeepSeek Harness fork 后每天收到定时任务失败

一句话结论：定时触发的判定条件写得过宽（只排除了拉取请求事件），于是定时事件在 fork 仓库里也照常运行；而它需要上游仓库的密钥，fork 里没有，就在预检环节硬失败。 症状是 fork 之后每天收到一次工作流失败通知、并消耗配额（#9499）。

DeepSeek Harness fork 定时任务三步处置

1. 确认判据：通知来自 nightly 类定时工作流；错误发生在预检阶段、原因是缺少密钥；只在 fork 仓库出现，上游仓库正常（#9499）。
2. 修法（推荐，对上游友好）：在既有判定条件之前追加一个仓库守卫（要求仓库等于上游仓库），让定时触发在 fork 里直接跳过。job 级跳过会被记为成功，不会出现红叉——这一点很关键，能避免「修完反而更显眼」（#9499）。
3. 只解决自己的做法：在自己的 fork 里禁用或删除该工作流文件（#9499）。
4. 注意一个易错点：讨论里提醒仓库名的字面量有不同记录形式，改守卫前建议先用一次性手动触发打印出实际仓库名，确认拼写（#9499）。
5. 验证：改完后观察一个夜间周期，预期不再收到失败通知（#9499）。

DSH插件 排查注意事项

这三条全部属于「环境差异」，所以第一步永远是确认环境：检出方式 / git 版本 / 仓库归属。 七条要点：

1. 「只有子模块复现」是第一条判据（#9856）。
2. CI=true 那条规避已验证，且不会重复触发校验（#9856）。
3. 报错里的「把它移走」不可操作：不要照着做，改用环境变量或补丁（#9856）。
4. 「未知选项」优先怀疑版本而不是参数（#9676）。
5. 该条已修：dsh-v0.2.1-alpha.3 起可用，别继续在手写绕过（#9676）。
6. fork 定时任务要「加守卫」而不是「关掉上游」：改的是条件，不是别人的工作流（#9499）。
7. 修复状态如实：子模块那条未修（只有已验证规避）；create_worktree 那条已在 0.2.1-alpha.3 修复；fork 定时任务那条是上游工作流需要改条件（属仓库配置而非产品代码）。

源码开发与构建类问题往往要连着「依赖与插件」一起看。如果你在本地搭了多个 profile 做验证，与其在各处手敲命令比对，不如用 DSH Plugin Hub 这类可视化插件市场：已安装列表带来源与版本、装卸历史与系统日志集中在一个面板里。

来源：Discussion #9856、Discussion #9676、Discussion #9499。