dsh-single-instance-guard

DSH 的 JSONL 会话持久化后端明确规定同一时刻只允许一个写入者，但框架本身并未提供任何跨进程防护。当桌面壳应用自行拉起一个 dsh server，同时另一个 dsh web 进程也在运行，且两者解析到同一个 DSH_HOME 时，它们会带着过期的序列游标各自追加批次数据，最终导致会话日志静默损坏——没有报错、没有警告，直到你翻看历史才发现时间线已经错乱。

dsh-single-instance-guard 将这种静默损坏转化为一次响亮的启动失败。插件在启动时以 O_EXCL 原子方式创建 .dsh-server.lock 文件，写入 pid、启动时间和主机名；若锁已存在，则探测持有者的 pid 是否存活——存活则直接终止启动并给出清晰的双语错误提示，已死则安全清除残留锁并重试一次获取，正常单实例路径完全不受影响。进程退出时仅在确认锁仍由本进程持有时才删除锁文件，避免误删其他实例的锁。

它面向的是多个 dsh 实例可能共享同一数据根的场景：内嵌 web view 的桌面应用、并行拉起两台 server 的 CI 任务、或开发者工作站上标签重叠的多个实例。插件以零运行时依赖的单补丁层 profile bundle 形式交付，无需改动会话后端，即可在运行时强制执行单写入者保证。