Repository navigation
v1.2.0
-
桌面端为什么没有一键重启按钮:我原来的理由不完整,查清后把真理由写进契约;顺带修掉
「刷新页面就丢掉待重启提示」(用户第六、七轮:先问「你桌面端为什么不做重启按钮」,
再问「是默认生效的吗」)。先纠正我自己。我原先写的理由是「替代进程会被单实例锁挡下」——那只是第一层。
读完壳的lib/main.js(490KB)后,事实更硬,且三条各自独立成立:- 没有「请壳重启自己」的通道。宿主→壳的 IPC 消息是封闭白名单,
壳只认ready/platform-session/shutdown-complete/fatal四种;
其余一律fail("invalid IPC event")并 SIGTERM 掉子进程(main.js:3698-3717)。
「礼貌地请求重启」连消息类型都不存在。 - 宿主一退出,壳当致命故障处理,且不会自动拉回来:
child.once("close")里
code !== 0与code === 0都走fail(...)(main.js:3721-3728)→ 弹原生
「启动失败」对话框。自动重启只发生在壳自己的更新流程里(restoreHost分支)。 - 那个对话框里有一颗破坏性按钮:
[退出应用, 重启应用, 停用第三方插件],
第三颗走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 逐字节一致。本轮记三条我自己的错(都写进注释,避免下次再犯):
- 模板字符串里写了反引号(连注释里也不行)。它提前结束模板,表达式被切成字符串拼接,
跑起来报restartBtn is not a function——与现场毫不相干,而node --check是过的,
只有真跑才暴露。 - 断言站错地方:刷新后我只等
.dshpm-entry就去查.dshpm-banner,但面板默认是关的、
横幅不在 DOM 里。而且我第一版等的是.dshpm-restartBtn——桌面端restart.available=false
时那个按钮故意不存在。两处都是「测空气」,跟功能是否生效无关。 - 改一个被「抠出来执行」的函数,要连带看谁在抠它:
sendChangeResult新增一句记账调用后,
build-approval.test.mjs(它在裸作用域里new Function(抠出的源码))当场 ReferenceError
假红——缺noteRestartFromResult与它读写的restartPending。门禁在改完当场抓住了它。
- 没有「请壳重启自己」的通道。宿主→壳的 IPC 消息是封闭白名单,
-
开关 ↔ 重启:确认有一处真冲突,并修掉(用户第五轮问「检查开关和重启是不是有冲突」)。
先回答「冲突在哪」——不是「写了同一个文件」,而是粒度不一致:
动作粒度 落盘 开关 文件级 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-onlyPASS;
② 模拟 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 复现,
修前修后都跑了变异测试)。-
「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 稳定复现。缓存会让错误结论看起来可复现。 -
「供应链策略拦下」被误报成「连不上 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里的供应链自让开,
整套测试依然全绿(两条调用路径都先判了供应链),说明那条断言当时不承重。
要么删掉那段代码,要么补一条直接调用它的断言;我选了后者(纵深防御 + 让意图可验证)。本轮记两条方法论:
- 「预期 vs 实际」的差要一直追到机制层:一开始怀疑是网络(日志末尾全是 UND_ERR),
实测才定位到「同包名的第二条规则被 pnpm 忽略」。看错误信息要分清哪些是被打印出来的原因、
哪些只是被打印出来的后果。 - 同一个包的过滤规则有顺序语义——
minimumReleaseAgeExclude不是集合,是有序规则表。
这类「看起来像集合、实际是短路的规则链」的配置,顺序就是一种隐性契约。
-
-
修 5 处缺陷,其中一条是「桌面版一键重启会把应用杀掉且不会有替代品起来」(第四轮独立审计
读 self-update / restart / http,我自己核对了壳内源码与活动进程表)。- 桌面端一键重启是「删掉
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,客户端据此
不弹重启询问窗、显示「请关掉窗口再打开」而不是一个点了会出事的按钮。 - 自更新失败丢字段,一律报成「插件市场内部出错了」——MEDIUM。宿主把可读细节放在
diagnostic、常常没有message;apply()只抄 code+message,于是 message 变空串、
diagnostic 丢掉、顶层也没有 code,index.js的result.code ?? 'internal'就把
「文件被占用 / 连不上源」说成「内部出错,稍后重试」。同一类失败走安装端点时字段是齐的
(projectChangeError会透传 code+diagnostic),自更新是唯一丢字段的路。两个字段都透传,
并补顶层code。 apply()的 ok 规则与sendChangeResult漂移——MEDIUM。契约 §18/§20 要求三处完全一致:
补上pendingBuilds非空放行(并把pendingBuilds透传出去,客户端才可能显示批准入口),
以及空结果不算 applied({}以前会得到applied/ok:true→ 客户端亮绿灯,
而宿主从没确认过这次安装;index.js对同样输入判失败)。managerOf抛错会冒出apply()——LOW。安装抛错是被正确折叠的(install-failed),
读 manager 抛错却直接冒成 500internal——同一类失败两种形状。折成manager-unavailable。- 客户端补
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 条断言)。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/里从未被执行过。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;修后坏数据被拒。readJsonBody没有读取超时:只有end/error两个出口,客户端声明
Content-Length: 100、只发 10 字节后保持连接不动时 Promise 永不 settle,
handler 与 socket 一起无限期挂着(宿主默认requestTimeout300s 也只是把「永远」
变成「五分钟」)。加 10 秒上限(可注入便于测试),到点按bad-request明确回错。gunzipSync无输出上限(解压炸弹):tarball 的dist.integrity来自同一份元数据,
挡不住「自洽地声明 255 KiB 压缩 / 256 MB 解压」的炸弹,而解压同步跑在宿主事件循环上,
再大就 OOM 掉整个 DSH。加maxOutputLength: 8 MB(正常目录 tarball 只有几十 KB)。- 孤立代理项让整个市场面板崩掉:剪贴板里被上游截断的半个 emoji(
"abc\uD83D")会让
encodeURIComponent抛URIError: URI malformed,抛点在 cataloguseEffect里、
没有 try/catch,bundle 也没有 error boundary → React 卸载整棵子树:用户只是粘贴了
一下,市场页就空白了。URL 构建前把孤立代理项换成 U+FFFD(成对 emoji 不动)。 - 两条开关路径只看有没有
error:宿主的/toggle让{application:'cancelled'}
(不带 error)与changed:false正常 resolve,于是「宿主说什么都没改」照样报绿色
「已启用」;带 error 的 cancelled 还会渲染成「红壳 + 成功文案」。改为统一的
toggleNotice(),与安装/卸载的noticeFromResult同一套语义。 readOnlyReason.not-removable在两张表里都没文案:宿主的READ_ONLY_CODES有三个码,
客户端只有两个。查不到文案时hostReason === hostReasonKey会把「没有文案」当成
「没有原因」→ 开关被误解锁(宿主其实会 400 拒绝)。补齐 zh/en。onDone被顶替的请求吞掉:startRequest会 abort 同 key 的上一个请求,而 abort 路径
在isCurrent处就 return、永远走不到onDone。于是「点检查更新 → 紧接着点可更新
页签」会让按钮永远停在「检查更新」,而 toast 已经说了有几个新版本。改为把回调挂在 ref 上、
由最终完成的那次请求消费一次(失败时丢弃,免得被下一次无关的成功消费)。- 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 持有它的句柄,pnpmscandir
被拒、整个事务回滚(这类错误市场本来就认得对);②dsh-mobile是连不上 npm 源——日志里
几十条ECONNRESET、Request took 72331ms,34 次请求全是 registry.npmjs.org、0 次镜像,
而本机实测 npmjs.org 15s 超时、npmmirror 366ms。
这里暴露了插件自身的一个盲区:抓目录走镜像,但真正安装交给宿主 pnpm、用 pnpm 自己的
registry——两条通道不同,于是「能浏览、能点安装、一下载就失败」成了最难解释的现象,而界面
只写「宿主执行这个操作时报错。看宿主日志里的 pnpm 输出」,用户不可能从中推断出「去配镜像」。
本次只改错误呈现,不动任何安装行为:- 新增
registryUnreachableDetail:只认具体网络签名(ECONNRESET/ETIMEDOUT/UND_ERR/
Request took Nms/ERR_PNPM_FETCH*等)——刻意不把裸词network/registry放进匹配集,
否则「版本不兼容」「包不存在」也会被改写文案,那是换一种撒谎。 - 命中时切到
err.registry-unreachable.*,给出可照做的下一步:在该 profile 目录建.npmrc
写registry=https://registry.npmmirror.com,完全退出 DSH 后重试。这条建议是核实过的:
从 asar 抽出dsh-plugin-manager确认 pnpm 的cwd就是 profile 目录、且extendEnv: false
(env 被清洗),所以 profile 下的.npmrc确实会被读到。 - 占用优先于网络(诊断里可能混着 registry 字样);两处行内短句原本各写一遍同样的三元
表达式,抽成共用shortFailureText——否则又是一次「两处规则漂移」(本仓库栽过)。 - 详情行现在也露出网络诊断原文,此前只显示宿主的通用句。
回归:新增门禁套件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 条:- 失败的自更新被渲染成绿色「更新成功」:
self-update.js的ok只看value.error,
而宿主 ChangeResult 的error是可选的,{application:'failed'}不带 error 时算出
ok:true→ HTTP 200 → 客户端亮绿色「更新到 vX」。sendChangeResult早把规则写清楚了,
两处规则漂移;/toggle也有一份同样漂移。三处统一成同一条规则。 - 并发
ensure()每个等待者各自归一化一遍:inflight只共享了网络,normalizeCatalog
仍被每个等待者各跑一次(约 2.5ms)并各造一份新plugins数组——这会让按数组身份的索引
缓存逐个被击破,等于白做。改成只让第一个等待者归一化。 - 发现页的「重试」是个死键:
onRetry误接bumpTick()(只动installedTick),
而目录 effect 依赖catalogTick→ 目录加载失败后点「重试」一个/catalog请求都不发,
报错框永远留在屏幕上(用户唯一的自救路径失效)。 - 退场计时器吞掉新回执:200ms 退场窗口内来的新回执被旧计时器一起
setNotice(null),
本该活 4600ms 的气泡 200ms 就没了(注释宣称覆盖了,实际 cleanup 只在卸载时跑)。 - 英文表两颗黑按钮文案相同:
action.recheckSelf与action.recheckSelfOnly都是
"Check again",而它们自己上方的注释写着「必须不同」,中文表是区分的——门禁只断言了
中文,漏掉一种语言就漏掉一种语言。
回归:catalog-search-cache15 条、client-copy34 条、self-update45 条;
变异测试 7/7 全捕获(host 3 + client 4),变异后按字节还原。
本次不递增版本、不打包、不发布。
- 失败的自更新被渲染成绿色「更新成功」:
-
搜索提速:单次目录请求 53ms → 8ms(用户要求「审查并优化 代码质量和性能」)。
审查先量后改,量完否掉了两个自己的假设,避免照着假问题改代码:- 否掉「
entriesForBundle是 O(B×P) 热点」——实测真实场景 0.039ms、夸张到 300×600 也
只有 2.1ms,不改; - 否掉「不稳定 props 打穿
React.memo记忆化」——client.js里React.memo/useMemo/
useCallback出现 0 次,没有记忆化可打穿,不改。
真正的热点只有一处:/catalog每次请求都把整份目录重做一遍搜索归一化。真实快照
(4412 条)实测一次请求折叠 30884 个字符串 = 33ms 同步 CPU(NFKD8.5ms +
\p{M}+去组合符 24ms +toLowerCase4.4ms),同一次请求buildMatchIndex再花
12ms。这些全在宿主的事件循环上,而它同时还在跑流式输出。 foldText按字符串内容记忆化(上界 65536,满了整体清空)。不是键在条目对象上的
WeakMap:joinInstalled每次请求都用{...item}造新对象,那种缓存永远命中不了——
这一点是量出来才没有写错。buildMatchIndex按数组身份记忆化(只留最新一份)。快照数组是不可变引用,
身份相同 → 索引必然相同;「刷新目录必须换索引」由身份天然保证。- 首帧冷启动不变(~75ms,必然要建一次),这是诚实的代价:快的是一词搜第二次、翻页、
改排序、切分类。
回归:新增门禁套件verify/catalog-search-cache.test.mjs(11 条,门禁现共 13 套),
并做变异测试 4/4 全捕获(索引不随数组失效 / 用数组长度当键 / 用字符串长度当键 /
查询侧不归一化),变异后按字节还原。缓存是「写错了也照样跑」的东西:结果依旧正确、
测试依旧全绿,只在特定条件下静静给错答案,所以必须用变异证明断言有牙。
顺带修正自己一处失实注释(原写「每敲一个字就发一次 /catalog」,实为 300ms 防抖)。
本次不递增版本、不打包、不发布。
- 否掉「
-
装完主动问「立即重启 / 稍后重启」:不用再自己去横幅找那颗按钮(用户要求:「安装完插件要
手动重启这很麻烦,设置一个弹窗可以选择立即重启 or 稍后重启」)。
以前装完只在页面顶部亮一条「有改动待重启」横幅,用户得自己注意到、再找到那颗按钮,而且没人
告诉他为什么要重启。现在装完(或更新完)弹一次询问窗,正文说清是哪些插件、为什么要重启。- 默认是「稍后重启」,焦点也落在它上面:重启会截断正在流式输出的回复,破坏性动作不能
做默认项。Esc与点遮罩都等同「稍后重启」——注意这不是「取消安装」,东西已经装好了,
绝不回滚。 - 批量只问一次(这是这个功能最容易做坏的地方):
noteRestartFrom有 5 个调用点
(安装 / 更新 / 卸载 / 开关 / 自更新),其中安装那一条是安装、更新、一键更新共用的。
如果每次都弹,「一键更新(N)」就会弹 N 次。所以批量里的每一步只记账(defer:true),
由批量收尾统一问一次;由 e2e 用真实浏览器盯着「批量进行中弹窗数必须为 0」。 - 问过的名字不再重复问:用户选了「稍后重启」之后再装同一个包不会被反复打扰(横幅还在,
随时能重启);但后来又装了别的东西时会再问一次——「新名字才问」而不是「问过就永远不问」。 - 重启失败会关掉弹窗:否则它会永远停在「正在重启」,而重启根本没发生。失败仍走原有的
错误回执 + 横幅可重试。 - 弹窗挂成
.dshpm-root的兄弟节点(Fragment),不做它的子项:root的直接子项被 e2e 的
几何断言盯着(「任何直接子项都不得被压扁」),而这个 fixed 覆盖层天然在 root 之上。
连带地,prefers-reduced-motion那条规则必须单独把.dshpm-modalLayer列进去——
它不在.dshpm-root里,靠.dshpm-root *覆盖不到(漏了就是「关掉动效后弹窗还带入场动画」)。 - 弹窗有
role="dialog"+aria-modal+ 可读标题。
回归:client-copy.test.mjs31→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,界面照样写「已更新」。- 新增
activation字段(仅 install 路由,可选、缺省时不出现,老客户端不受影响):
{ state, expected, installed, enabled, versionMatches, reasons },state∈
live | restart | inert | broken | disabled | unknown。判定手段是前后差集而不是猜名字:
installBundle之前记一份 bundle 名字表、之后再记一份,新出现的那个就是这次装上的——
所以不假设「包名 == bundle 名」(两者并不总相等)。候选名只在「没有新名字出现」时用于
区分「更新了已有条目」与「什么都没落地」。 restart-required优先于live:宿主的原话就是还没生效,不因为条目在列表里就改口。
inert/broken不算成功(客户端applied:false)——它们会进「一键更新」的成功计数,
谎报成功比不说更糟。- 版本回读:
expected取自目录(用户点的就是那个版本)、installed是回读到的真实版本;
对不上时versionMatches:false,客户端换一句「实际是 v{installed}(目录里写的是 v{expected})」。 unknown是一等结果,不是兜底:读不回列表、没有基线且列表里也找不到它、一次多出多个
bundle 分不清——都不猜,并带上reasons说明为什么不知道。特别地,no-baseline与live
可以并存:认不出「谁装上的」,但认得出「它在列表里」,后者才是live/inert的判据;
把已知的「它在跑」降级成unknown是另一种不诚实。- 不该谈激活的时刻不给状态:
application是failed/cancelled/overridden,或
pendingBuilds非空(还在等用户批准构建脚本——回读必然「没落地」,不看得pending就会把
「等批准」说成插件有问题)。 - 客户端文案分六路:
已安装并已在运行/实际是 v…(目录写的是 v…)/没出现在装载列表里 (可能不是 bundle)/宿主报告装载失败/装上了但处于停用/没能回读装载状态。
changed === false(宿主说这次什么都没改)时保留「没有产生变更」——那句本身是重要信息,
用「并已在运行」盖掉就等于把「你的更新其实没落地」瞒下来;唯一例外是版本对不上时必须盖。
回归:host-contract.test.mjs18→27 条(第 9 组真调verifyActivation的 8 条 + 1 条源码形状),
client-copy.test.mjs30→31 条。这 8 处语义逐个做过变异测试(把每处语义破坏一次,
对应断言必须失败):8/8 全被抓到——「测试通过」本身被验证过,不是写了就算。
契约见 API-CONTRACT §2.4;方向研究见 ROADMAP。
- 新增
- versionName
1.2.0/ versionCode10200/ 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