Skip to content

v1.2.0

Choose a tag to compare

@github-actions github-actions released this 09 Oct 13:33
· 41 commits to main since this release
  • 桌面端为什么没有一键重启按钮:我原来的理由不完整,查清后把真理由写进契约;顺带修掉
    「刷新页面就丢掉待重启提示」
    (用户第六、七轮:先问「你桌面端为什么不做重启按钮」,
    再问「是默认生效的吗」)。

    先纠正我自己。我原先写的理由是「替代进程会被单实例锁挡下」——那只是第一层。
    读完壳的 lib/main.js(490KB)后,事实更硬,且三条各自独立成立:

    1. 没有「请壳重启自己」的通道。宿主→壳的 IPC 消息是封闭白名单,
      壳只认 ready / platform-session / shutdown-complete / fatal 四种;
      其余一律 fail("invalid IPC event") 并 SIGTERM 掉子进程(main.js:3698-3717)。
      「礼貌地请求重启」连消息类型都不存在。
    2. 宿主一退出,壳当致命故障处理,且不会自动拉回来:child.once("close") 里
      code !== 0 与 code === 0 都走 fail(...)(main.js:3721-3728)→ 弹原生
      「启动失败」对话框。自动重启只发生在壳自己的更新流程里(restoreHost 分支)。
    3. 那个对话框里有一颗破坏性按钮:[退出应用, 重启应用, 停用第三方插件],
      第三颗走 disableAllPlugins()——一键停用所有第三方插件(含市场自己)。

    让用户撞出「启动失败」框、还可能手滑停掉全部插件,比「请关掉窗口再打开」糟得多。
    真正合规的重启通道是壳自己的 InstallAndRestart(带任务收割与交接),那是壳的职责。

    修掉的真问题:待重启提示只活在页面内存里。客户端原来把「待重启」存在 React state,
    注释还写着「刷新后没了就没了」——但那是磁盘上的事实,刷新不会让它消失,宿主仍在跑旧代码。
    后果正是用户遇到的那一幕:更新完 dsh-mobile 随手刷新 → 横幅消失 → 他以为已经生效,
    于是来问「是默认生效的吗」。
    修法:宿主半 restartPending 模块级记账 → /status 带 pendingRestart → 客户端挂载时水合。
    它成立的关键是语义恰好自洽:模块级变量在宿主真重启时自然清空,不需要任何落盘或过期逻辑。
    边界:只记 restart-required/requiresRestart(applied 已热生效不记)、上限 32 条、
    水合不弹窗、不许把 restarting 退回 idle、宿主说没有时什么都不做(不清掉已有的)。

    验证:真实浏览器 e2e 87→90(新增 [11]:拦截 /status 注入「宿主仍记得」→ 整页重载 →
    断言横幅出现、且不弹窗、且桌面端仍不给按钮;再反向断言「宿主没有时不得凭空出现」);
    门禁 18 套件 PASS(host-contract 38 项)。
    变异测试 6/6 全部被抓住,且各自被正确的车道抓住:M5 去掉客户端水合 → e2e 红;
    M6 去掉 /status 的 pendingRestart、M7 把 applied 也算待重启 → host-contract/门禁红
    (e2e 抓不到这两条是正确的——它拦截了 /status,只测客户端半)。还原后 sha256 逐字节一致。

    本轮记三条我自己的错(都写进注释,避免下次再犯):

    1. 模板字符串里写了反引号(连注释里也不行)。它提前结束模板,表达式被切成字符串拼接,
      跑起来报 restartBtn is not a function——与现场毫不相干,而 node --check 是过的,
      只有真跑才暴露。
    2. 断言站错地方:刷新后我只等 .dshpm-entry 就去查 .dshpm-banner,但面板默认是关的、
      横幅不在 DOM 里。而且我第一版等的是 .dshpm-restartBtn——桌面端 restart.available=false
      时那个按钮故意不存在。两处都是「测空气」,跟功能是否生效无关。
    3. 改一个被「抠出来执行」的函数,要连带看谁在抠它:sendChangeResult 新增一句记账调用后,
      build-approval.test.mjs(它在裸作用域里 new Function(抠出的源码))当场 ReferenceError
      假红——缺 noteRestartFromResult 与它读写的 restartPending。门禁在改完当场抓住了它。
  • 开关 ↔ 重启:确认有一处真冲突,并修掉(用户第五轮问「检查开关和重启是不是有冲突」)。

    先回答「冲突在哪」——不是「写了同一个文件」,而是粒度不一致:

    动作粒度 落盘
    开关 文件级 setBundleEnabled → selectBundle 写 package.json 的 dsh.profile.bundles;setPluginEnabled → writePluginEnabled 写 cordis.patch.yml(都用 writeFileAtomic,写在半路不留半个文件)
    重启 进程级 宿主在 RESTART_EXIT_DELAY_MS(900ms) 后 process.exit(0)

    所以真正危险的是「在写操作进行中点重启」:进程会在写入落地前退出;安装还牵着
    pnpm 子进程(pnpm 子树可能比宿主活得久)。修复前重启按钮只看 restart.phase === "restarting",
    完全不看有没有写操作在跑——用户可以在一键更新跑到一半时点「重启 DSH」。

    同时验明「开关状态能活过重启」(新增 verify/repro-toggle-vs-restart.ps1):
    热开关 application:"applied" → 杀掉宿主 → 重启同一 profile → enabled 仍是关着的。
    持久化不靠内存,所以重启本身不会丢开关状态——冲突只发生在「同时」。

    修法:写操作进行中(job 非空,或「一键更新」整轮 batch.running)禁用重启,
    与更新按钮同一个口径;tooltip 说明原因(新增 restart.busy)。两处都挡:
    横幅按钮的 disabled,以及 startRestart() 自身(弹窗里的「立即重启」是另一个入口,
    只挡按钮会留后门)。写操作结束后恢复可点(另加一条反向断言,防止一禁到底)。

    验证:真实浏览器 e2e 83→86,3 条新断言(前置可点 / 进行中禁用 / 结束后恢复),
    先跑到红再改;变异测试 2/2 CAUGHT(去掉 writeInFlight 判定 / 把 data-write-busy 写死),
    还原后 sha256 逐字节一致。

    本轮记一条我自己的错:第一版把 var writeInFlight = … 写进了 el(...) 的参数列表——
    JSX 参数位是表达式,不是语句,node --check 当场报 Unexpected token 'var'。
    第二版把断言放在批量进行中去查 .dshpm-restartBtn,那时重启横幅还没出现(它由
    restart-required 点亮),取到 null 而失败——那不是修复没生效,是断言站错了地方。
    教训:断言「某个东西被禁用」之前,要先确认那个东西此刻真的存在于 DOM 里,
    否则测的是空气。

  • 上一轮的「版本并集」豁免方案本周就被现实打破(同一天复现,已换成裸包名)。

    第五轮我把 profile 的 minimumReleaseAgeExclude 写成 dsh-context@0.64.0 || 0.65.0,
    当次 PASS。但它是会腐坏的:dsh-context 的 specifier 是 ^0.66.0(caret 范围,会自动升版),
    升级当天 pnpm 就把触发的 - dsh-context@0.66.0 追加到列表末尾,而
    evaluateVersionPolicy 只认第一个同名规则(命中就 return)——于是:

    minimumReleaseAgeExclude:
      - dsh-context@0.64.0 || 0.65.0   # ← 先命中就返回,0.66.0 不在里面
      - dsh-context@0.66.0             # ← pnpm 自己追加的,永远不生效

    lockfile 校验再次失败(实测 dsh-context@0.66.0 was published at … within the cutoff)。
    我的修复「通过了一次」,但没通过时间。

    改成裸包名 - dsh-context(放行该包所有版本)。理由不是它更"安全",
    而是它对「先命中者胜」是稳定且自愈的:pnpm 之后再怎么往末尾追加,都不会再破。
    代价写在注释里:这个包不再享受 24h 发布冷静期(本 profile 的有意取舍)。

    验过两件事(不只是「改完绿了」):
    ① 真 profile 上 pnpm install --lockfile-only PASS;
    ② 模拟 pnpm 再次追加同类条目后再跑,仍然 PASS(这正是上一版缺的性质)。

    同时把客户端 err.supply-chain.next 的建议改对了:原来教「写一条版本并集」,
    现改为明确说明并集只能生效一次、并教裸包名,并加断言禁止再出现并集写法
    (assert.equal(/dsh-context@0\.64\.0 \|\| 0\.65\.0/.test(...), false))。

    教训:修一个「方向性」bug 时,要问的不只是「现在好了吗」,还有
    「谁会在什么时候把它再弄坏」。这次的破坏者是 pnpm 自己的追加行为——
    它就在同一个文件里、每次升级都会发生。

  • 热开关:证伪 + 一个真缺陷(第六轮;用户要求「完成文档里面的热开关」)。

    结论:热开关不用做——宿主本来就会热应用。 ROADMAP §3.3 把它列成待做的大件,
    理由是「现在完全依赖宿主 setBundleEnabled;热开关能免重启」,这个前提是错的。

    实测(新增 verify/repro-hot-toggle.ps1 → verify/probe-toggle-hot.mjs,跑在 scratch
    profile 上,不碰用户的 desktop profile):

    POST /plugin-market/toggle  {"name":"@feiyang666/dsh-usage-plugin","enabled":false}
    → 200 {"ok":true,"changed":true,"application":"applied","enabled":false,"error":null,"warnings":[]}
    

    application:"applied" = 已经热生效,没有重启。机制取自宿主源码:setPluginEnabled
    自己就 writePluginEnabled(this.profile.patchPath, …) 写 patch 文件,紧接着 reload() →
    reconcileProfilePatches(...);而 dsh-base 的 bundle 常驻加载
    - id: hmr / name: '@deepseek-ai/dsh-hmr',本 profile 的 HMR 在场。佐证:用户的
    cordis.patch.yml 里本来就有宿主写过的开关行(- id: whale-mode / disabled: false)。

    所以自己写 cordis.patch.yml 既多余又有害:违反写下来的安全不变量
    (PLUGIN-MARKET.md §5「host 半只做 GET 目录与调用宿主服务,不写任何文件」),
    还得抄参考实现约 45 条受保护模块正则(写错一条就可能把 boot 链自己关掉)。
    调用者不该绕过被调用者去改它的文件。

    顺带查出一个真缺陷(已修,TDD):toggleNotice 只认 cancelled / changed,
    对宿主另外两种可达结果都回绿色「已启用 {name}」:

    宿主回 修复前 真相
    applied 「已启用 X」✅ 对
    restart-required 「已启用 X」绿色 ❌ 还没生效(无 HMR 的 profile)
    overridden 「已启用 X」绿色 ❌ 被覆盖层压住,状态没变

    overridden 由宿主 setPluginEnabled 显式 return(index.js:1658),不是假想分支。
    修法:补两条分支(warn +「重启 DSH 后生效」/「被覆盖层压住,实际没有启用」),并把
    !changed 与 noticeFromResult 统一到同一条排除规则。applied 语义有意与安装路径不同:
    安装问「包装上了吗」(true),开关问「状态真的切过去了吗」(false)。

    验证:门禁 PASS(18 套件;client-errorcopy 22→25,3 条新断言先跑到红再修);
    真实浏览器 e2e 83/83。

    这一轮的教训:「文档说缺什么」不等于「真的缺」。这条 if 从写下到被当任务执行,
    中间隔了好几轮;真正推翻它的是一次在 scratch profile 上真发出去的请求,
    而不是再读一遍参考实现。同时它也暴露了同一个病的第二次发作——
    用一条 happy path 的规则去覆盖一个有多分支的真实接口。

  • 修「有更新时按钮却还写『检查更新』」(用户第四轮报:
    「有更新时检查更新状态机应该为一键更新」)。

    可更新页左边那颗按钮的主动作由 checked && bundles.length > 0 决定,也就是先逼用户点一次
    「检查更新」
    ,它才肯变成「一键更新(N)」。但那一页打开时,列表已经把 N 个可更新插件
    逐条摆出来了、页签角标也写着 N——信息早就到手了,按钮却让用户去「检查」一件刚刚
    已经确认的事
    。真实复现(把 e2e 断言改成首屏即「一键更新(2)」后跑红):

    ✗ 页头右侧首屏就是「一键更新(2)」与「插件市场更新(四态之一)」两个按钮
        实际:["检查更新","插件市场更新"]
    

    改法:主动作改由数据决定 —— var canUpdateAll = bundles.length > 0;。
    checked 保留,但只用于没有更新时区分「检查更新」还是「重新检查」(那个区分是有意义的:
    没检查过就不该谎称「已检查」,这条不放松)。

    先写会失败的断言 → 跑到红 → 再改代码 → 跑到绿(TDD),并把那条「先点检查更新再点一键更新」
    的旧断言改成「首屏无需任何点击就已是『一键更新(2)』」+「不再存在多余的『检查更新』按钮」。

    验证:门禁 PASS(18 套件);真实浏览器 e2e 83/83(净 +1)。
    变异测试 2/2 CAUGHT(改回 checked && … / 改成恒 false),还原后 sha256 逐字节一致;
    另把 e2e 的这条断言也做了变异(把代码改回旧写法 → e2e 转红),确认它真的承重。

  • 修 2 处缺陷(1 条 HIGH)+ 一个真实环境故障的根因:用户报「dsh-mobile 更新失败」
    (第五轮:从 .plugin-manager/logs 的真实失败日志倒推,逐条用 pnpm 复现,
    修前修后都跑了变异测试)。

    1. 「dsh-mobile 更新失败」的真根因不在插件里,在 profile 的 pnpm-workspace.yaml——
      同时暴露了插件自身 1 处 HIGH 文案缺陷(见第 1 条)。

      根因:pnpm 11.7.0 把 minimum-release-age 的默认值设成 1440 分钟(24 小时)
      (dist/pnpm.mjs:145910 "minimum-release-age": 24 * 60,注释写着 // 1 day)。
      lockfile 里只要有一个包是 24 小时内发布的,整个 lockfile 就校验失败并抛
      ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION——与 registry 通不通无关。
      用户的 profile 里 dsh-context@0.65.0(发布于故障前 19 小时)正卡在这个窗口内。

      为什么「已经加过豁免」却还是失败:profile 里写了
      - dsh-context@0.64.0 和 - dsh-context@0.65.0 两条同名规则,而 pnpm 的
      evaluateVersionPolicy(pnpm.mjs:64074)是「匹配到第一个同名规则就 return」:

      for (const { nameMatcher, exactVersions } of rules) {
        if (!nameMatcher(pkgName)) continue;
        if (exactVersions.length === 0) return true;   // 裸包名 = 全放行
        return exactVersions;                          // ← 只返回第一条,后面的被忽略
      }

      第一条只含 0.64.0 ⇒ 0.65.0 拿不到豁免 ⇒ 每次都失败。
      实测规律(各跑 2–3 次确认):0.64.0 + 0.65.0(失败)/ 0.65.0 + 0.64.0(通过)
      ——同样的两条内容,只改顺序结果就不同,正是「只认第一条」的直接证据。

      修法:把两条并成一条版本并集 dsh-context@0.64.0 || 0.65.0
      (parseExactVersionsUnion 支持 ||)。刻意不用裸包名 dsh-context——
      那等于永久关掉这个包的发布冷静期保护,为修一次更新而拆掉一道供应链闸门不划算。
      已备份原文件为 pnpm-workspace.yaml.bak-minage-*,改后实测真实 pnpm add dsh-mobile@0.6.1
      exit=0,dsh-mobile 0.5.5 → 0.6.1 落盘。

      顺带确认的一件事:我第一次复现时看到「移除豁免反而通过」,差点据此写结论——
      核实后那是 pnpm 把上一次的校验结果缓存了(输出里的 verified 8m ago)。
      清掉 cache/store 重跑后 A/B 稳定复现。缓存会让错误结论看起来可复现。

    2. 「供应链策略拦下」被误报成「连不上 npm 源」,劝用户去配镜像——HIGH。
      真实的失败日志同时含 [ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION] 和
      GET https://registry.npmmirror.com/… error (UND_ERR_DESTROYED)。后一行是结果不是原因
      (校验一失败 pnpm 就放弃下载),但网络正则会命中它 ⇒ 修复前 errorCopy 给出
      title=连不上源 / next=配镜像。配镜像、换源都不可能修好——这是「自信地指错方向」,
      比不说话更糟:用户会照做、浪费时间,然后更困惑。
      做法:新增 supplyChainDetail()(认 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION /
      failed supply-chain polic / minimumReleaseAge cutoff),优先级排为
      供应链 > 占用 > 网络(三处:errorCopy 的 prefix、registryUnreachableDetail
      的自让开、shortFailureText),并新增 zh/en 的 err.supply-chain.{title,why,next,row},
      文案里明确说了「这不是网络问题」+ 同一个包只能写一条规则这个坑。
      用真实日志原文跑修复后的 errorCopy 验证:err.supply-chain.*。

    验证:门禁 PASS(17 套件;client-errorcopy 14→22、client-copy 35→36、
    error-classify 18→18);真实浏览器 e2e 82/82。
    新增断言全部过了变异测试(4/4 CAUGHT,还原后 sha256 逐字节一致)。
    其中一条 M2 一开始是 MISSED——删掉 registryUnreachableDetail 里的供应链自让开,
    整套测试依然全绿(两条调用路径都先判了供应链),说明那条断言当时不承重。
    要么删掉那段代码,要么补一条直接调用它的断言;我选了后者(纵深防御 + 让意图可验证)。

    本轮记两条方法论:

    1. 「预期 vs 实际」的差要一直追到机制层:一开始怀疑是网络(日志末尾全是 UND_ERR),
      实测才定位到「同包名的第二条规则被 pnpm 忽略」。看错误信息要分清哪些是被打印出来的原因、
      哪些只是被打印出来的后果。
    2. 同一个包的过滤规则有顺序语义——minimumReleaseAgeExclude 不是集合,是有序规则表。
      这类「看起来像集合、实际是短路的规则链」的配置,顺序就是一种隐性契约。
  • 修 5 处缺陷,其中一条是「桌面版一键重启会把应用杀掉且不会有替代品起来」(第四轮独立审计
    读 self-update / restart / http,我自己核对了壳内源码与活动进程表)。

    1. 桌面端一键重启是「删掉 ELECTRON_RUN_AS_NODE 后启动 GUI」——HIGH。
      真实拓扑(活动进程表 + app.asar/lib/main.js 核实):
      7872 DeepSeek Harness.exe(GUI 主进程,持 Electron 单实例锁)
      ← 19496 …exe --expose-internals <entry>(宿主,7872 用 stdio: […,'ipc'] 拉起的子进程,
      环境里带 ELECTRON_RUN_AS_NODE=1)。宿主半跑在 19496 里,助手拿到它的 execPath/argv、
      删掉那个变量再拉起同一个 exe —— 那是启动 GUI:新进程执行
      claimDesktopSingleInstance() → requestSingleInstanceLock() 失败(7872 还持锁)→ 立刻
      application.quit()(实测 exit=0、无输出、231–391ms)。于是宿主已退出、替代品也死了,
      整个应用什么都不剩,壳随后弹「DeepSeek Harness 无法使用」。
      这不是某个变量写错——参考实现(_ref/dsh-market/src/restart.ts 的
      restartAllowed/detectedSupervisor)对同类问题的结论一样:有监管者的部署里,
      「重启」不属于这个插件
      (systemd 下会连助手一起被杀,桌面壳下会被锁挡在门外)。
      所以如实拒绝而不是半修:isDesktopManagedHost()(node 模式 且 有 IPC 通道两个信号,
      避免误伤终端 dsh web 的宿主)→ spawnRestartHelper 拒绝、POST /restart 回
      409 restart-unsupported、/status 带 restart.available:false,客户端据此
      不弹重启询问窗、显示「请关掉窗口再打开」而不是一个点了会出事的按钮。
    2. 自更新失败丢字段,一律报成「插件市场内部出错了」——MEDIUM。宿主把可读细节放在
      diagnostic、常常没有 message;apply() 只抄 code+message,于是 message 变空串、
      diagnostic 丢掉、顶层也没有 code,index.js 的 result.code ?? 'internal' 就把
      「文件被占用 / 连不上源」说成「内部出错,稍后重试」。同一类失败走安装端点时字段是齐的
      (projectChangeError 会透传 code+diagnostic),自更新是唯一丢字段的路。两个字段都透传,
      并补顶层 code。
    3. apply() 的 ok 规则与 sendChangeResult 漂移——MEDIUM。契约 §18/§20 要求三处完全一致:
      补上 pendingBuilds 非空放行(并把 pendingBuilds 透传出去,客户端才可能显示批准入口),
      以及空结果不算 applied({} 以前会得到 applied/ok:true → 客户端亮绿灯,
      而宿主从没确认过这次安装;index.js 对同样输入判失败)。
    4. managerOf 抛错会冒出 apply()——LOW。安装抛错是被正确折叠的(install-failed),
      读 manager 抛错却直接冒成 500 internal——同一类失败两种形状。折成 manager-unavailable。
    5. 客户端补 err.restart-unsupported.*、restart.manualBody、restart-available 判定;
      /status 新增 restart.available。

    验证:门禁 PASS(17 套件;self-update 46→50、restart-helper 8→10);
    真实浏览器 e2e 82/82。

    本轮记一条方法论:审计 F1 的第一版假设是错的(它以为 bug 是「删掉变量导致 node 启动失败」),
    是它自己用隔离实验证伪后才改成「单实例锁」——而这个改口正是关键:如果按第一版假设去修
    (保留 ELECTRON_RUN_AS_NODE),桌面端会变成「以 node 模式再起一个宿主」,
    同样起不来。结论对而机制错,修法就会错。

    本次不递增版本、不打包、不发布。

  • 修 4 个稳健性缺陷 + 3 个客户端缺陷,其中一条把上一轮的修复整个抵消了(第二轮独立审计:
    3 个并行只读审计分别读 catalog / self-update+restart / client 数据层与渲染层,
    我自己读 host 路由与 http.js)。每条都先用真函数复现、再改、再做变异测试
    (变异 4/4 + 2/2 全捕获,每次按字节还原;两个新套件共 23 条断言)。

    1. errorCopy 把「连不上 npm 源」的专属解释覆盖回宿主的通用句——这一条把上一轮
      76110d9 的修复整个抵消掉了
      ,是这轮最该记住的一条。命中 registry-unreachable 之后,
      末尾那句 if (!locked && !known && message) copy.why = message 仍然生效:宿主把 pnpm
      非 0 退出归成 operation-error,而它不在 ERROR_PREFIXES 里 → known=false →
      why 被写成「宿主执行这个操作时报错。」。于是用户看到标题和「下一步」都在说「去配镜像」,
      唯独「为什么」那一句退回了无效信息。条件补上 unreachable === ""。
      用真 errorCopy 实测:修前 why=宿主执行这个操作时报错。,修后是网络专属解释。
      为什么上一轮没测出来:error-classify.test.mjs 只直接调用两个 detail 函数、
      用正则断言 message: 那一行;而 errorCopy(真正决定用户看到哪段文案的函数)
      在 verify/ 里从未被执行过。
    2. validateCatalogPayload 的核对只挡正数:if (declared > 0 && actual === 0) 对
      {count:-1, plugins:[]}、{count:1.5, plugins:[{}]} 全部放行(前者 declared > 0
      不成立,后者的差值落在 5 条容差内)。后果正是这条校验存在的理由:以
      stale:false, error:null 覆盖掉好缓存 → 市场变空、分类消失、连过期横幅都不显示。
      改为先要求 Number.isInteger(count) && count >= 0(合法的 count:0 空目录仍放行)。
      实测:好目录 count=2 → 喂坏数据后 count=0;修后坏数据被拒。
    3. readJsonBody 没有读取超时:只有 end/error 两个出口,客户端声明
      Content-Length: 100、只发 10 字节后保持连接不动时 Promise 永不 settle,
      handler 与 socket 一起无限期挂着(宿主默认 requestTimeout 300s 也只是把「永远」
      变成「五分钟」)。加 10 秒上限(可注入便于测试),到点按 bad-request 明确回错。
    4. gunzipSync 无输出上限(解压炸弹):tarball 的 dist.integrity 来自同一份元数据,
      挡不住「自洽地声明 255 KiB 压缩 / 256 MB 解压」的炸弹,而解压同步跑在宿主事件循环上,
      再大就 OOM 掉整个 DSH。加 maxOutputLength: 8 MB(正常目录 tarball 只有几十 KB)。
    5. 孤立代理项让整个市场面板崩掉:剪贴板里被上游截断的半个 emoji("abc\uD83D")会让
      encodeURIComponent 抛 URIError: URI malformed,抛点在 catalog useEffect 里、
      没有 try/catch,bundle 也没有 error boundary → React 卸载整棵子树:用户只是粘贴了
      一下,市场页就空白了。URL 构建前把孤立代理项换成 U+FFFD(成对 emoji 不动)。
    6. 两条开关路径只看有没有 error:宿主的 /toggle 让 {application:'cancelled'}
      (不带 error)与 changed:false 正常 resolve,于是「宿主说什么都没改」照样报绿色
      「已启用」;带 error 的 cancelled 还会渲染成「红壳 + 成功文案」。改为统一的
      toggleNotice(),与安装/卸载的 noticeFromResult 同一套语义。
    7. readOnlyReason.not-removable 在两张表里都没文案:宿主的 READ_ONLY_CODES 有三个码,
      客户端只有两个。查不到文案时 hostReason === hostReasonKey 会把「没有文案」当成
      「没有原因」→ 开关被误解锁(宿主其实会 400 拒绝)。补齐 zh/en。
    8. onDone 被顶替的请求吞掉:startRequest 会 abort 同 key 的上一个请求,而 abort 路径
      在 isCurrent 处就 return、永远走不到 onDone。于是「点检查更新 → 紧接着点可更新
      页签」会让按钮永远停在「检查更新」,而 toast 已经说了有几个新版本。改为把回调挂在 ref 上、
      由最终完成的那次请求消费一次(失败时丢弃,免得被下一次无关的成功消费)。
    9. CSS 层叠把骨架屏的 shimmer 覆盖掉:.dshpm-updateRow--ghost 与 .dshpm-updateRow
      都是单类选择器(特异性相同),靠后的赢 → 加载占位播的是 .26s 一次性淡入而不是无限扫光。
      用双类选择器(0,2,0)钉死。另删一处可证明不可达的死条件
      (retrying: state.phase === "loading" 写在 phase === "error" 分支里,恒为 false)。

    新增两个门禁套件(这些模块此前在 verify/ 里一条断言都没有):
    verify/robustness.test.mjs(9 条)与 verify/client-errorcopy.test.mjs(14 条)。
    门禁 15 → 17 套件;真实浏览器 e2e 82/82。

    顺带记两条我自己的错(都留了痕):① 我把反引号写进 CSS 注释,而那整段 CSS 是 JS 的
    模板字面量——直接把 client.js 的语法打断(靠 node --check 立刻抓到);② 变异测试脚本
    被 kill 时把变异留在磁盘上(http.js 里留了个 if (false)),而我的「还原校验」拿的
    正是已被污染的内容当基准,自己认证自己通过。后续版本改为:先跑基线、基线不通过就
    拒绝继续;用 try/finally 保证还原;结束后复跑基线确认回到干净状态。

    本次不递增版本、不打包、不发布。

  • 修「更新已装插件后激活状态被误判成 unknown」:verifyActivation 的候选名没去重,
    同一个字符串出现多次被当成「多个候选都命中」→ 一律报 ambiguous-bundle。
    真实链路:客户端「更新」发的是 submitInstall({ name: bundle.name, spec: bundle.name }),
    而宿主 install() 传的候选是 [hit?.npm, hit?.name, hit?.id, requestedSpec, requestedName]
    ——npm / name / requestedSpec / requestedName 本来就是同一个值(dsh-kaomoji、
    @anonyjcy/dsh-j-space 这类全都如此)。更新一个已装插件时 before 里已经有它、
    appeared 为空,于是走到 present 分支,而那里数的是出现次数而不是不同名字的个数。
    影响面用真实目录(4412 条)量过:2288 个有 npm 的条目 100% 命中,修完 0%。
    两个用户可见后果:① 一次成功的更新被渲染成「已安装 {name},但这次没能回读装载状态,
    无法确认它是否已经在跑」(notice.installUnknown,蓝色 info)而不是绿色的
    「已安装 {name},并已在运行」;② 更严重的是 versionMatches=false 那条**「磁盘上还是旧版、
    更新其实没落地」的告警被这次误报盖掉**——因为走不到 hit 分支就根本不会算版本,
    用户会以为更新成功了。修法是候选名先 new Set() 去重,present.length 才代表不同名字的个数。
    回归:verify/host-contract.test.mjs 新增一条断言(真调 verifyActivation,把真实调用点的
    候选形状写进去),并带反向断言——两个不同名字各自命中一个 bundle 时仍然必须报歧义
    (去重不能把真歧义一起抹掉)。变异测试 2/2 全捕获(改回不去重 / 只留第一个候选,
    两个方向都被抓到),变异后按字节还原、sha256 一致。
    这一条此前测不出来,是因为既有的 7 条相关断言全都只传单个候选名,从不传重复项。
    本次不递增版本、不打包、不发布。

  • 修「构建脚本待批准」这条路径:批准入口此前是不可达的死代码(用户报「还是安装不了」)。
    这是插件自身的 bug,也是这轮排查真正的根因。
    真实链路:装 @linxin666/dsh-remote-web-ui 时,它的依赖 cloudflared 有 postinstall
    (下载二进制),而 pnpm 11 默认忽略未批准的构建脚本、并以非零退出。宿主把这次
    installBundle 折成 { application:'failed', error, pendingBuilds:['cloudflared'] }
    ——含义是「没装成,但只差你批准一下」,不是失败到底。
    Bug:sendChangeResult 把 application:'failed' 一律报 ok:false,而客户端
    requestJSON 在 ok !== true 时直接抛错——于是客户端那段「读 payload.pendingBuilds
    弹批准框」成了永远不可达的死代码:用户只看到一条普通错误,没有任何批准入口,
    装多少次都装不上。修法是一行:pendingBuilds 非空时放行 ok:true(cancelled 的既有
    放行语义不变),并顺带把 pendingBuilds 的过滤提到变量里复用。
    怎么定位的(值得记):先否掉了「pnpm / 镜像 / 包坏了」三个嫌疑——在 profile 目录手动跑
    宿主的原命令 pnpm add,装成功了;再用宿主自己的 CLI 跑同一条 pluginManager 代码,
    也失败,且失败点明确指向 [ERR_PNPM_IGNORED_BUILDS]。于是问题定位到插件处理这条
    结果的路径,而不是环境。
    回归:新增门禁套件 verify/build-approval.test.mjs(9 条)——把真
    sendChangeResult 抠出来真调并读它发出的响应体(不是源码形状断言);
    真实浏览器 e2e 78 → 82 条,其中 [10] 直接断言「批准确认条出现过、点了名 cloudflared、
    有『允许并安装』按钮、toast 指路」。变异测试 4/4 全捕获(回到旧规则 /
    无条件放行 / 不透传 pendingBuilds / 不过滤脏数据),变异后按字节还原。
    本次不递增版本、不打包、不发布。

  • 安装失败不再只说「看宿主日志」:连不上 npm 源时直接告诉你配镜像(用户报「我在插件市场
    装了俩个插件都没能成功 你排除一下问题」)。排查用户真实 profile 的 pnpm 日志发现,两个
    失败是两种完全不同的原因
    :① @linxin666/dsh-remote-web-ui 是 ERR_PNPM_EPERM——报错
    目录甚至是另一个插件(dsh-our-free-model),运行中的 DSH 持有它的句柄,pnpm scandir
    被拒、整个事务回滚(这类错误市场本来就认得对);② dsh-mobile 是连不上 npm 源——日志里
    几十条 ECONNRESET、Request took 72331ms,34 次请求全是 registry.npmjs.org、0 次镜像,
    而本机实测 npmjs.org 15s 超时、npmmirror 366ms。
    这里暴露了插件自身的一个盲区:抓目录走镜像,但真正安装交给宿主 pnpm、用 pnpm 自己的
    registry——两条通道不同,于是「能浏览、能点安装、一下载就失败」成了最难解释的现象,而界面
    只写「宿主执行这个操作时报错。看宿主日志里的 pnpm 输出」,用户不可能从中推断出「去配镜像」。
    本次只改错误呈现,不动任何安装行为:

    1. 新增 registryUnreachableDetail:只认具体网络签名(ECONNRESET/ETIMEDOUT/UND_ERR/
      Request took Nms/ERR_PNPM_FETCH* 等)——刻意不把裸词 network/registry 放进匹配集,
      否则「版本不兼容」「包不存在」也会被改写文案,那是换一种撒谎。
    2. 命中时切到 err.registry-unreachable.*,给出可照做的下一步:在该 profile 目录建 .npmrc
      写 registry=https://registry.npmmirror.com,完全退出 DSH 后重试。这条建议是核实过的:
      从 asar 抽出 dsh-plugin-manager 确认 pnpm 的 cwd 就是 profile 目录、且 extendEnv: false
      (env 被清洗),所以 profile 下的 .npmrc 确实会被读到。
    3. 占用优先于网络(诊断里可能混着 registry 字样);两处行内短句原本各写一遍同样的三元
      表达式,抽成共用 shortFailureText——否则又是一次「两处规则漂移」(本仓库栽过)。
    4. 详情行现在也露出网络诊断原文,此前只显示宿主的通用句。
      回归:新增门禁套件 verify/error-classify.test.mjs(18 条)——把真 bundle 里的识别函数
      取出来执行,喂从用户那份真实 pnpm 日志逐字抄下的原文,并显式覆盖「不许误伤」;
      变异测试 6/6 全捕获,变异后按字节还原。变异纠正了我一次:第一版「行内短句不报镜像」
      没被捕获——暴露的是我的测试漏了 shortFailureText,补上后 6/6。
      本次不递增版本、不打包、不发布。
  • 修 6 个真实缺陷:最严重的一条会把别人的插件标成「已安装 / 可更新」(独立审计发现,
    我逐条独立复现)。这一轮先说结论:buildMatchIndex 的 putBareName 用原始 repo 名当
    nameKeys 的键,而查表一律走 lookupKey(会小写化)。真实目录 4412 条里有 88 个仓库名
    含大写字母:实测 0 个命中自己、5 个标到了另一个 owner 的同名小写仓库——
    bill277048-hash/DSH-model-router 被标成 superboy911/dsh-model-router 已安装。
    这正是该文件注释里明令禁止的「宁可不显示,也不能指错人」:注释写对了,代码没做到。
    一行修复后命中自己 0 → 82、标错 5 → 3;剩下 6 条我逐条查清才收尾——
    3 条是目录里真有同名 npm 包(npm 名优先是设计),3 条是不同 owner 的小写裸名真撞车、
    修好后正确判为歧义不猜(仍比修复前「猜错到别人头上」正确)。
    其余 5 条:

    1. 失败的自更新被渲染成绿色「更新成功」:self-update.js 的 ok 只看 value.error,
      而宿主 ChangeResult 的 error 是可选的,{application:'failed'} 不带 error 时算出
      ok:true → HTTP 200 → 客户端亮绿色「更新到 vX」。sendChangeResult 早把规则写清楚了,
      两处规则漂移;/toggle 也有一份同样漂移。三处统一成同一条规则。
    2. 并发 ensure() 每个等待者各自归一化一遍:inflight 只共享了网络,normalizeCatalog
      仍被每个等待者各跑一次(约 2.5ms)并各造一份新 plugins 数组——这会让按数组身份的索引
      缓存逐个被击破,等于白做。改成只让第一个等待者归一化。
    3. 发现页的「重试」是个死键:onRetry 误接 bumpTick()(只动 installedTick),
      而目录 effect 依赖 catalogTick → 目录加载失败后点「重试」一个 /catalog 请求都不发,
      报错框永远留在屏幕上(用户唯一的自救路径失效)。
    4. 退场计时器吞掉新回执:200ms 退场窗口内来的新回执被旧计时器一起 setNotice(null),
      本该活 4600ms 的气泡 200ms 就没了(注释宣称覆盖了,实际 cleanup 只在卸载时跑)。
    5. 英文表两颗黑按钮文案相同:action.recheckSelf 与 action.recheckSelfOnly 都是
      "Check again",而它们自己上方的注释写着「必须不同」,中文表是区分的——门禁只断言了
      中文,漏掉一种语言就漏掉一种语言。
      回归:catalog-search-cache 15 条、client-copy 34 条、self-update 45 条;
      变异测试 7/7 全捕获(host 3 + client 4),变异后按字节还原。
      本次不递增版本、不打包、不发布。
  • 搜索提速:单次目录请求 53ms → 8ms(用户要求「审查并优化 代码质量和性能」)。
    审查先量后改,量完否掉了两个自己的假设,避免照着假问题改代码:

    1. 否掉「entriesForBundle 是 O(B×P) 热点」——实测真实场景 0.039ms、夸张到 300×600 也
      只有 2.1ms,不改;
    2. 否掉「不稳定 props 打穿 React.memo 记忆化」——client.js 里 React.memo/useMemo/
      useCallback 出现 0 次,没有记忆化可打穿,不改。
      真正的热点只有一处:/catalog 每次请求都把整份目录重做一遍搜索归一化。真实快照
      (4412 条)实测一次请求折叠 30884 个字符串 = 33ms 同步 CPU(NFKD 8.5ms +
      \p{M}+ 去组合符 24ms + toLowerCase 4.4ms),同一次请求 buildMatchIndex 再花
      12ms。这些全在宿主的事件循环上,而它同时还在跑流式输出。
    3. foldText 按字符串内容记忆化(上界 65536,满了整体清空)。不是键在条目对象上的
      WeakMap:joinInstalled 每次请求都用 {...item} 造新对象,那种缓存永远命中不了——
      这一点是量出来才没有写错。
    4. buildMatchIndex 按数组身份记忆化(只留最新一份)。快照数组是不可变引用,
      身份相同 → 索引必然相同;「刷新目录必须换索引」由身份天然保证。
    5. 首帧冷启动不变(~75ms,必然要建一次),这是诚实的代价:快的是一词搜第二次、翻页、
      改排序、切分类。
      回归:新增门禁套件 verify/catalog-search-cache.test.mjs(11 条,门禁现共 13 套),
      并做变异测试 4/4 全捕获(索引不随数组失效 / 用数组长度当键 / 用字符串长度当键 /
      查询侧不归一化),变异后按字节还原。缓存是「写错了也照样跑」的东西:结果依旧正确、
      测试依旧全绿,只在特定条件下静静给错答案,所以必须用变异证明断言有牙。
      顺带修正自己一处失实注释(原写「每敲一个字就发一次 /catalog」,实为 300ms 防抖)。
      本次不递增版本、不打包、不发布。
  • 装完主动问「立即重启 / 稍后重启」:不用再自己去横幅找那颗按钮(用户要求:「安装完插件要
    手动重启这很麻烦,设置一个弹窗可以选择立即重启 or 稍后重启」)。
    以前装完只在页面顶部亮一条「有改动待重启」横幅,用户得自己注意到、再找到那颗按钮,而且没人
    告诉他为什么要重启。现在装完(或更新完)弹一次询问窗,正文说清是哪些插件、为什么要重启。

    1. 默认是「稍后重启」,焦点也落在它上面:重启会截断正在流式输出的回复,破坏性动作不能
      做默认项。Esc 与点遮罩都等同「稍后重启」——注意这不是「取消安装」,东西已经装好了,
      绝不回滚。
    2. 批量只问一次(这是这个功能最容易做坏的地方):noteRestartFrom 有 5 个调用点
      (安装 / 更新 / 卸载 / 开关 / 自更新),其中安装那一条是安装、更新、一键更新共用的。
      如果每次都弹,「一键更新(N)」就会弹 N 次。所以批量里的每一步只记账(defer:true),
      由批量收尾统一问一次;由 e2e 用真实浏览器盯着「批量进行中弹窗数必须为 0」。
    3. 问过的名字不再重复问:用户选了「稍后重启」之后再装同一个包不会被反复打扰(横幅还在,
      随时能重启);但后来又装了别的东西时会再问一次——「新名字才问」而不是「问过就永远不问」。
    4. 重启失败会关掉弹窗:否则它会永远停在「正在重启」,而重启根本没发生。失败仍走原有的
      错误回执 + 横幅可重试。
    5. 弹窗挂成 .dshpm-root 的兄弟节点(Fragment),不做它的子项:root 的直接子项被 e2e 的
      几何断言盯着(「任何直接子项都不得被压扁」),而这个 fixed 覆盖层天然在 root 之上。
      连带地,prefers-reduced-motion 那条规则必须单独把 .dshpm-modalLayer 列进去——
      它不在 .dshpm-root 里,靠 .dshpm-root * 覆盖不到(漏了就是「关掉动效后弹窗还带入场动画」)。
    6. 弹窗有 role="dialog" + aria-modal + 可读标题。
      回归:client-copy.test.mjs 31→32 条;真实浏览器 e2e 67→78 条——新增的 11 条里有 6 条是
      这一轮特意补的:用 elementFromPoint 做真实命中测试(JS .click() 会绕过命中测试,
      覆盖层就算把按钮盖住也照样「成功」,那种断言等于没测)、批量进行中弹窗数为 0、只弹一次、
      弹窗内部几何不重叠、完整落在视口内、Esc 关掉后横幅仍在。
      本次不递增版本、不打包、不发布。
  • 装后激活校验 + 版本回读:让「装」和「更新」不再说谎(用户要求「先做 2」——来自
    docs/ROADMAP.md 的功能方向研究第二项)。
    以前 POST /install 把宿主的 application 原样透传就完事了,而 application 说的是
    宿主执行了什么,不是结果。于是 applied 完全可能对应「写进了 node_modules,但
    profile 的 bundle 列表里从来没有它」——界面渲染绿色「已安装」,插件却永远不出现;更新时
    目录说 0.63.0、磁盘上还是 0.62.3,界面照样写「已更新」。

    1. 新增 activation 字段(仅 install 路由,可选、缺省时不出现,老客户端不受影响):
      { state, expected, installed, enabled, versionMatches, reasons },state ∈
      live | restart | inert | broken | disabled | unknown。判定手段是前后差集而不是猜名字:
      installBundle 之前记一份 bundle 名字表、之后再记一份,新出现的那个就是这次装上的——
      所以不假设「包名 == bundle 名」(两者并不总相等)。候选名只在「没有新名字出现」时用于
      区分「更新了已有条目」与「什么都没落地」。
    2. restart-required 优先于 live:宿主的原话就是还没生效,不因为条目在列表里就改口。
      inert / broken 不算成功(客户端 applied:false)——它们会进「一键更新」的成功计数,
      谎报成功比不说更糟。
    3. 版本回读:expected 取自目录(用户点的就是那个版本)、installed 是回读到的真实版本;
      对不上时 versionMatches:false,客户端换一句「实际是 v{installed}(目录里写的是 v{expected})」。
    4. unknown 是一等结果,不是兜底:读不回列表、没有基线且列表里也找不到它、一次多出多个
      bundle 分不清——都不猜,并带上 reasons 说明为什么不知道。特别地,no-baseline 与 live
      可以并存
      :认不出「谁装上的」,但认得出「它在列表里」,后者才是 live/inert 的判据;
      把已知的「它在跑」降级成 unknown 是另一种不诚实。
    5. 不该谈激活的时刻不给状态:application 是 failed/cancelled/overridden,或
      pendingBuilds 非空(还在等用户批准构建脚本——回读必然「没落地」,不看得 pending 就会把
      「等批准」说成插件有问题)。
    6. 客户端文案分六路:已安装并已在运行 / 实际是 v…(目录写的是 v…) / 没出现在装载列表里 (可能不是 bundle) / 宿主报告装载失败 / 装上了但处于停用 / 没能回读装载状态。
      changed === false(宿主说这次什么都没改)时保留「没有产生变更」——那句本身是重要信息,
      用「并已在运行」盖掉就等于把「你的更新其实没落地」瞒下来;唯一例外是版本对不上时必须盖。
      回归:host-contract.test.mjs 18→27 条(第 9 组真调 verifyActivation 的 8 条 + 1 条源码形状),
      client-copy.test.mjs 30→31 条。这 8 处语义逐个做过变异测试(把每处语义破坏一次,
      对应断言必须失败):8/8 全被抓到——「测试通过」本身被验证过,不是写了就算。
      契约见 API-CONTRACT §2.4;方向研究见 ROADMAP。

  • versionName 1.2.0 / versionCode 10200 / build +97.6a94ef4
  • 安装:dsh plugin --profile web add <本页附件 deepseek-harness-market-1.2.0.tgz>(发布到 npm 后可直接 add deepseek-harness-market)
  • 回退 / 旧版:从本页附件下载对应版本的 tgz
  • 变更与验收细节见仓库 docs/ 与 verify/REPORT.md