检测到其他存活的 dsh 实例占用同一 DSH_HOME 数据目录时中止启动，防止并发写会话日志导致的历史损坏。
安装
# GitHub 源码（首次需按提示配置 allowBuilds 构建授权后重试）
dsh plugin --profile web add github:Tang-mm95/dsh-single-instance-guard
装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络，工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截，所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS；dsh 会打印出需要添加的确切键名，把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下，重跑一次即可装上。放行构建本身就是一次信任判断：请只安装可信来源，并尽量锁定 commit（github:owner/repo#sha）。
README
一个零依赖的 DeepSeek Harness 插件：启动时对 DSH_HOME 数据目录加独占锁，发现已有存活的 dsh 实例时大声报错并中止启动。
为什么需要它
JSONL 会话持久化后端明确要求"一个会话同一时刻只有一个写进程"，且没有跨进程防护。两个 dsh 服务共用同一个 DSH_HOME（例如桌面封装自己另起服务、或两个 dsh web 进程）会用过期的序列游标并发追加日志，损坏会话历史：
history unavailable for session "…": Error: corrupt session log: seq gap in committed region …
完整诊断、只读巡检工具与手动修复步骤见这份报告。
本插件把"静默损坏"变成"启动即大声失败"。
安装
发布到 npm 后：
dsh plugin --profile <profile> add dsh-single-instance-guard
手动方式（任意 dsh 安装）：把下面这行加到 profile 的 cordis.patch.yml，并放在会话相关 bundle 之前：
- insert:
- id: single-instance-guard
name: 'dsh-single-instance-guard'
本插件同时是一个 profile bundle，manifest 自带同样的补丁，CLI 会把它作为补丁层安装。
工作原理
- 原子创建
<DSH_HOME>/.dsh-server.lock（O_EXCL），内容为{ pid, startedAt, hostname }。 - 冲突时探测持有者 pid 是否存活：存活则中止启动并给出清晰的中英双语错误；锁已过期（pid 已死或文件损坏）则删除并重试一次。
- 进程退出时仅当锁仍归本进程所有时才删除。
DSH_HOME 的解析与 dsh 一致：优先 $DSH_HOME，默认 ~/.dsh。使用不同数据目录的服务之间不会冲突。
已知限制
- 两个进程同时发现同一把过期锁时，删除+重试路径存在极小竞态窗口；但
O_EXCL原子写入保证最终只有一个胜者，败者会在重试时正确失败。 - 锁只防"多个服务共用同一个
DSH_HOME"；不防（也不支持）两个 dsh 实例通过不同 root 指向同一会话文件。
开发
npm test # node --test
许可证
MIT
链接
同类插件
yjh051108/dsh-routing-suite★ 6990
一个仓库三件套：DSH 插件包的运行时注入器（注入、热重载、卸载、开发侧挂区一键转正、路由自愈，外带设置页插件管理：列出、卸载、拖入文件夹内化）、任务感知的思维模式路由 agent 预设（router-standard / router-spec / router-react）、以及分级两级任务协议（commit_star / lock_stage / revise_do / edit_plan / mark_task / redteam_verdict 六个工具，任务状态落盘）。注入器实现直接在库内，安装的是它自己的行为而不是一份依赖清单。
strukto-ai/mirage#dsh★ 3670
把文件系统与 bash 提供者换成 mirage 虚拟工作区：文件工具与 shell 命令作用于挂载的资源（RAM、S3、Redis、Slack、Gmail、Notion、Postgres）而非宿主磁盘，支持按挂载点设置读/写/执行模式、按命令选择沙箱（进程内 monty、pyodide、quickjs；远程 docker、e2b、daytona），并可在虚拟终端中安装 CLI（git、gh、slack、linear、ntn、gws，或自行注册的程序树）作为命令头词。
hust-open-atom-club/oh-dsh★ 325
社区发行版：TUI、桌面端与 Web UI 统一体验，分层安装、一步到位。
weijiafu14/pi2dsh★ 210
Pi Host ABI 兼容引擎：装一次之后，npm 上的 Pi 扩展原包经 `dsh plugin add <pi-package>` 直接作为 DSH 原生插件挂载。已在官方 DSH 上端到端验证 pi-mcp-adapter（完整 MCP 管理面：OAuth、resources、prompts、MCP Apps、elicitation、sampling）、@tintinweb/pi-subagents、pi-code、pi-hermes-memory、pi-background-tasks；`pi2dsh inspect` 在安装前报告一个包的兼容情况。
lire1131/dsh-undo-savepoint★ 168
DSH 撤销/回退系统：配置变更自动存档，一键撤销/恢复/回退到任意版本，支持 WebUI 与离线 CLI/GUI 工具（DSH 启动失败也能救）。
Fishquito7/dsh-skill-mcp-panel★ 161
在 DSH Web 设置中管理技能与 MCP 服务器：技能卡片热启停、工作区作用域、分组、批量迁移与拖拽导入，以及 stdio/HTTP MCP 增删改查、连接测试、密钥脱敏，并附带统一 dsh-panel 命令行。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus；发表内容需要 GitHub 账号。