概览
dsh-pin-session
DSH「置顶对话」插件：会话头部与会话行内一键 📌，把重要对话钉在侧栏分组顶部；宿主端只存事实（原子写 JSON + 信任栅栏内的 HTTP 接口），排序由客户端在 DOM 层完成。零运行时依赖、能力探测与熔断、面向跨版本升级设计。
README / ZH
插件文档
目录摘要
DSH「置顶对话」插件：会话头部与会话行内一键 📌，把重要对话钉在侧栏分组顶部；宿主端只存事实（原子写 JSON + 信任栅栏内的 HTTP 接口），排序由客户端在 DOM 层完成。零运行时依赖、能力探测与熔断、面向跨版本升级设计。
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **只在浏览器里生效**：置顶是客户端 DOM 排序，不动宿主端的会话顺序。 所以换个浏览器/清掉本地状态后，置顶集合还在（服务端），效果照旧 —— 但用别的 DSH 客户端 （比如移动端）看不到置顶效果。 - **只在同一个工作区分组内置顶**：DSH 侧栏按工作区分组，置顶行被提到"它自己那个分组"的顶部。 未归入任何工作区的会话（Ungrouped 桶）同样适用。 - **搜索态不干预**：搜索结果的顺序由查询决定，此时不动 DOM。 - **重命名时不动 DOM**：焦点在会话行内时跳过这一轮（搬节点会让输入框失焦），焦点离开后自动补上。 - **标题可能缺失**：从 CLI 置顶的会话若没带 title，列表里只显示 sessionId（不影响排序， 排序靠 fiber 拿的 id）。