@zink-ning-lkr/dsh-ui-state
界面状态持久化——官方左侧边栏开合与宽度跨重启恢复（自渲染 DOM，官方 client 通道），已验证兼容 DSH 0.1.0-rc.8 / 0.1.1-rc.2（0.1.x 版本线）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @zink-ning-lkr/dsh-ui-state@0.3.1Ui State 以 @zink-ning-lkr/dsh-ui-state 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
界面状态持久化插件（DSH Web GUI）——官方侧边栏与详情面板跨重启恢复。
官方 layout store 是瞬态设计（宽度/开合不持久化）。插件：
data-sidebar-collapsed /
data-details-collapsed 属性与 grid-template-columns（style），ResizeObserver
监听视口（窄屏判定）；变化防抖 600ms，聚合为单次批量 mutate 写入 settings.yaml。
另保留 60s 安全兜底轮询，兜住观察者漏网的 DOM 替换 / portal 重渲染。ctx.layout.toggleSidebar()（等 layout 服务挂载后自动重试）[data-side="sidebar"] 拖拽手柄，派发合成 pointer 序列（pointerdown/move/up，
与官方 DragHandle 的监听协议一致；同步窗口内 stub pointer capture）ctx.layout.openDetails() / closeDetails()（仅在会话打开时恢复）ui-state:
sidebarCollapsed: false # 用户显式折叠后为 true
sidebarWidth: 360 # 最近一次展开宽度
chatScroll: # 按会话保存的非底部阅读位置（自动维护，可手删）
"<sessionId>":
anchorKey: "..."
anchorTop: 120
scrollTop: 480
updatedAt: 1750000000000
已验证目标为 DSH 0.1.1-rc.2（npm 最新已装版本，本仓库按该版本构建逐 seam 核对：
@deepseek-ai/dsh@0.1.1-rc.2 + @deepseek-ai/cordis@4.0.1 + React 18.3 运行时），
同一 0.1.x 版本线的最低 0.1.0-rc.8 同样覆盖。依赖范围故意写成双线
>=0.1.0-rc.8 <0.2.0 || >=0.1.1-rc.0：npm 的 prerelease「同元组」规则使
^0.1.0-rc.8 并不包含 0.1.1-rc.2，双线范围可让宿主升级后 npm 去重为同一份
dsh-settings 实例（避免双实例导致的 SettingsConflictError instanceof 失效）。
实现基于能力探测与事件驱动，不绑定具体 rc 细节，跨版本漂移时以兜底分支降级。
已逐项核对的官方契约（0.1.1-rc.2 构建实测一致）：
@deepseek-ai/dsh-settings（双线范围，见上），register / describe / mutate（含 SettingsConflictError 冲突拒绝与 revision 乐观锁）不变。register({ kind: "exact", path, handler }) 签名不变，返回 disposer。ctx.layout.toggleSidebar() / openDetails() / closeDetails()
与 AppFrame 的 data-sidebar-collapsed / data-details-collapsed /
grid-template-columns 契约不变；拖拽手柄 [data-side="sidebar"]（展开时才渲染，
pointer capture + rAF 节流，pointerup 同步落宽）、窄屏 1024px 自动折叠同样保留。[data-shell-overlay]（AppFrame 直接子节点）、[data-chat-flow]、
[data-chat-anchor-key]、[data-conversation-scroll]、[data-composer-seat]
在官方会话视图原样保留（官方自身滚动恢复同用这套锚点）。window.__ModuleLoader__.load 包格式、插件清单
dsh.client.inject/platform、sessions.list.getSnapshot().current、
connection.isLoopback 探针、ctx.layout 面板动作均不变。settings-conflict 时，客户端刷新 revision 后重试一次，不再静默丢最后一次操作。.loose()——settings.yaml 被手改/旧版本/其他插件写入
越界或类型错误的值时，只把该字段降级为「未记录」，不会让整个 namespace 注册失败、
桥接不可用；下一次正常写入会覆盖。updatedAt 保留最近 200 条会话记录，长期使用 settings.yaml
不会无限增长。frameOf 在 overlay 层级漂移时回退到按
data-sidebar-collapsed / data-details-collapsed 直接找框架；会话判定用
[data-chat-flow] 存在性探测。官方 DOM 小幅变更时限入降级，而不是报错。loader.create 热装、HMR 重建）遇到上一实例残留的同名
namespace / 同 path 路由时复用而非抛错，不会因 "already registered" 挂掉挂载。ui-state 与桥接路由 /api/dsh-ui-state/* 均为本插件独占
（已核对官方与已知插件零冲突）；不补丁原生原型、不注入全局样式、不劫持事件，
合成拖拽仅同步窗口内 stub pointer capture，与 better-sidebar 等 localStorage 方案
以及 dsh-chat-width / dsh-client-ui-custom 等设置/样式/快捷键插件无交互冲突。dsh plugin --profile web add @zink-ning-lkr/dsh-ui-state
也可以手动安装依赖并装配：
npm install @zink-ning-lkr/dsh-ui-state
然后在 profile 的 package.json 中把 @zink-ning-lkr/dsh-ui-state 加入 dsh.profile.bundles。
到 Releases 下载
dsh-ui-state-0.3.0.tgz，然后安装：
dsh plugin --profile web add ./dsh-ui-state-0.3.0.tgz
profile package.json 的 dsh.profile.bundles 加入 @zink-ning-lkr/dsh-ui-state，依赖用 link: 指向本目录；
或使用 dev_install_package 热装（junction + loader.create，免重启）。
MIT © zink-ning (zink_ning)
better-sidebar 等插件把状态存浏览器 localStorage——localStorage 按「域名+端口」隔离，
DSH 启动端口随机（--port 0）时每次重启都会丢失。配套修复：DSH Desktop 源码
（D:\Code\dsh-desktop\main.js）已支持从 config.json 读 port 字段，把
%APPDATA%\DSH Desktop\config.json 的 "port" 固定为 13372 后，localStorage 状态
（含 better-sidebar 的面板布局）跨重启稳定。
lib/index.js — Node half：注册 ui-state settings namespace + loopback 桥接路由
（makeBridgeHandlers / makeBridgeRoutes / namespaceSchema 导出供测试）。lib/client.js — 浏览器 half：事件驱动的状态持久化 + 开合/宽度/滚动恢复。tests/bridge.test.mjs — 桥接单测 + cordis 挂载幂等测试（node --test tests/bridge.test.mjs）。