dsh-panel-control 0.3.15 → 0.3.16

package/README.md

@@ -109,6 +109,16 @@ python -m http.server 8787 --bind 127.0.0.1   # 在仓库根目录
 - 文案改成「刷新后仍然缺：重启 DSH 才会应用新的插件清单」——这才是真正有效的动作。
 - 缺口修复后自动清除记忆，下次真出现新缺口还会提示。
 
+## 为什么重启后偶尔看不到入口（0.3.16）
+
+DSH 给每个插件的脚本算一个**版本号**，来源是文件的 `mtime / ctime / 大小`，注册表只认它自己在组装那一刻读到的那个版本。页面拿到的是**启动时那份清单**，只要 `client.js` 在清单发出去之后被重写过（编辑器保存、`git` 换行归一化、或者早先那个"自愈"改写），页面手里的版本号就成了作废的号，请求回 404，而页面**不会报错**——入口就这么没了。
+
+0.3.16 的处理：
+
+- Host 半只对本插件包装注册表的资源查询：页面若拿旧版本号来要，先用**本进程发过的同一版本字节**回答（缓存最近 5 个版本），再退到"用当前版本回答"，其余请求原样放行，卸载时撤掉包装。别家插件的行为一点不改。
+- 早先的"自愈"（改写 `client.js` 强制热加载）**默认关闭**：它会重跑所有插件的注册，邻居不幂等就会丢入口——`dsh-workspace-control` 就是这么被弄掉的。需要时用 `DPC_NUDGE=on` 显式打开。
+- `host.log` 每次 apply 打两行结论：`graph: lists|does not list <包名>` 和 `graph: own bundle at rev … answers 200|404`，一次就能分清是"没进清单"还是"清单有但取不到"。
+
 ## 代码审查后的加固（0.3.11）
 
 一轮完整审查（正确性 / 安全 / 可维护性 / 性能）之后改掉的东西，按主题记在这里，免得以后又踩回去。