dsh-p2m
DSH 冲突管家（P2M）：自动拦截会让 DSH 闪退的同名服务注册/版本漂移等冲突，按用时排序、隔离肇事插件。Plugin Conflict Manager for DeepSeek Harness (DSH/Cordis).
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:GiantAxeint/DSH-P2M#054020474a879b93fb9b8b27a84137fafec47722P2m 以 dsh-p2m 发布，当前版本为 0.1.7。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
DSH 冲突管家（P2M）：自动拦截会让 DSH 闪退的同名服务注册、版本漂移、补丁覆盖冲突，按用时排序并隔离肇事插件；同时统一管理插件启停、动态维护优先级。
仓库与包标识沿用
DSH-P2M/dsh-p2m（技术标识不变）；P2M 为本插件对外昵称。
插件装多了以后的三类痛点：
| 痛点 | P2M 的做法 |
|---|---|
| 没有统一管理 | 一处登记/启停/隔离/恢复所有插件，决策写入唯一的 guard 文件，跨重启生效 |
| 冲突只能被动熔断 | 检测（启动崩溃归因 / 运行期自动禁用 / 静态补丁扫描）→ 按优先级裁决 → 留痕、可回滚 |
| 没有优先级概念 | 恒定 DSH > P2M > 其他；其他插件按累计使用时长实时排序：B 用得比 C 久，维护顺序就是 DSH > P2M > B > C > … |
补充能力（v1 含）：下载后"真实开启前先试跑"——新插件启用前在子进程里试运行一次；会崩就弹窗给两个选项：「取消开启」/「无视风险继续使用」。
tier 0 DSH 本体 （name 以 @deepseek-ai/ 开头，或配置的 coreEntryIds）
tier 1 P2M 自身 （entry id: p2m，自杀免疫：guard 里出现自己会被自动移除）
tier 2 其他插件 （按 usage.json 累计使用毫秒降序 = 维护优先级）
铁律：任何决策永不禁用 tier0/tier1；同层冲突牺牲"用时短者"。
动态示例（对应需求）：台账 B=12h, C=5h, D=2h → 顺序 DSH → P2M → B → C → D；B 继续用、C 停用使 D=3h > C=5h 变 C=5h,D=3h → 顺序变为 DSH → P2M → B → D → C。
cordis.patch.yml 声明挂载行。--patch 覆盖层（guard 文件）最后生效，禁用心最强。create/update/remove）做运行期调度；root 树的 write() 是 no-op，所以每次决策双写：guard（持久，重启有效）+ 运行时热更新（即时生效）。环境要求：DSH（dsh CLI 全局安装）、Node ≥ 18。
dsh plugin --profile web add github:GiantAxeint/DSH-P2M
E:\DeepseekHome\Plugin\DSH-P2M）。package.json（Windows 示例：%USERPROFILE%\.dsh\profiles\web\package.json）：
dependencies 增加："dsh-p2m": "link:E:/DeepseekHome/Plugin/DSH-P2M"dsh.profile.bundles 数组开头插入 "dsh-p2m"（保证它最先加载，体现 DSH > P2M 顺序）。pnpm install（DSH 用 pnpm workspace）。P2M 的 entry id 固定为
p2m，请勿改动（guard 自愈机制依赖它）。
仓库内 launcher/dsh-safe.mjs 是 v2 启动器：纯启动监督（崩溃时只做紧急隔离），canonical guard 迁移到 <DSH_HOME>/p2m/plugin-guard.yml 并与 P2M 共用锁/备份协议，崩溃事件写入同一份 incidents.jsonl。把该文件复制覆盖你原来的 dsh-safe.mjs 即可（旧文件会先备份）。Windows 一键脚本：
scripts\install-safe.cmd
P2M 启动后自动工作；状态与数据落在 <DSH_HOME>/p2m/（默认 ~/.dsh/p2m/）：
| 文件 | 内容 |
|---|---|
plugin-guard.yml | 唯一 guard（被禁插件的持久名单，启动时以 --patch 注入） |
usage.json | 每插件累计使用时长台账（采样口径 30s，可配） |
incidents.jsonl | 冲突/隔离/恢复/弹窗决策的追加流水（append-only） |
state.json | p2m 自身状态（boot 计数、快照等） |
boot #N每次 DSH 启动加载 P2M 时，日志里会出现一行（N 为数字，例如 boot #11）：
[p2m] boot #11 | guard=<...> | autoIsolate=true
#N 不是等级或阶段，而是本机累计第 N 次成功执行 boot 例程——计数器存于 state.json#bootCount，每次 boot +1、只增不减（崩溃后的重启、进程内重复加载也会 +1，因此它≈“启动次数”，不精确等于进程数）。incidents.jsonl 的时间线（例如「第 11 次启动崩」→ 看该次 boot 前后的流水）。state.json 中的 bootCount 字段或整个文件即可（P2M 自动重建，不影响 guard/usage/incidents）。P2M 日志分为三级，规则如下：
| 级别 | 前缀 | 配色 | 何时出现 |
|---|---|---|---|
| info | 无 | 无色 | 正常动作：boot、隔离、启用、对账决策等 |
| 提示类 | [WARNING] | 黄色 | 未中断 DSH 启动、但需关注的问题：resolve drift、preflight peer 越界、静态扫描冲突、self-heal、loader 不可用等 |
| 中断/异常类 | [ERROR] | 红色 | 已中断或内部异常：protected 条目被自动禁用、p2m 内部错误等 |
[WARNING] / [ERROR] 之后都附带一行缩进的英文 hint:——说明应检查的具体文件、路径或冲突细节（如 ~/.dsh/p2m/incidents.jsonl、profile package.json、guard 文件）。NO_COLOR 时自动退化为无色文本，避免日志文件残留 ANSI 转义码；需强制颜色时配置 logColor: 'always'（或 'never' 关闭）。示例（preflight 发现问题时）：
[WARNING] [p2m] preflight: 2 peer violation(s) — 建议先按下方 fix 命令钉版本，再重启 DSH
@foo/bar peer @deepseek-ai/dsh-settings: declared ^0.1.1-rc.2, resolved 0.1.2-rc.1 | fix: pnpm add @deepseek-ai/dsh-settings@^0.1.1-rc.2
hint: Check the peer ranges declared in <profile>/package.json against the resolved versions above, then run the fix command (pnpm add ...) inside the profile before restarting DSH.
launcher（DSH-safe.cmd → dsh-safe.mjs）输出遵循同一套规则。
| 方法 | 作用 |
|---|---|
list() | 按优先级输出排序列表（含 tier / usageMs / running / disabled） |
status() | 当前配置与 guard 状态 |
usage() / incidents(n) | 台账 / 最近 n 条流水 |
scanConflicts() | 立即做一轮静态+运行期冲突扫描（只报告） |
enable(id) / disable(id) | 恢复/禁用（恢复前会走试用门禁；protected 不可禁用） |
trial(id) | 手动子进程试跑一次，返回 verdict（ok/crash/timeout/unsupported） |
preflight() | 跑一轮 peer 版本体检（E3），返回 findings + summary |
reconcile() / sample() | 手动触发对账 / 采样 |
autoGateRisk:false 关闭门禁，或 ui:'none' 关闭弹窗（一律默认取消）。| key | 默认 | 说明 |
|---|---|---|
sampleIntervalMs | 30000 | 使用时长采样间隔 |
autoIsolate | true | 运行期自动隔离（false=只报告） |
autoGateRisk | true | 试用门禁开关 |
ui | 'auto' | 弹窗模式：auto/desktop/none |
popupCooldownMs | 120000 | 同一插件弹窗冷却 |
trialTimeoutMs | 15000 | 试跑子进程超时 |
coreNamePrefixes | ['@deepseek-ai/'] | DSH 本体识别前缀 |
coreEntryIds | [] | DSH 本体额外 entry id |
knownCoreServices | ['sessionPersistence'] | C7 引擎核心默认服务名单快照（置 [] 关闭该告警） |
preflightOnBoot | true | E3：boot 时跑 peer 版本体检（只报告） |
scanBootLayers | true | E4：boot 静态扫描全补丁层（自动发现） |
patchLayers | [] | scanConflicts() 额外扫描的补丁文件（缺省自动发现） |
logColor | 'auto' | 日志配色：auto（TTY 且无 NO_COLOR 才着色）/ always / never |
| 类 | 含义 | 处理 |
|---|---|---|
| C1 启动崩溃 | 启动失败命中 failed to … loader entry | dsh-safe v2 紧急隔离 + incident |
| C2 运行期自动禁用 | loader 把某 entry 置 disabled 未持久化 | 试跑判定：冲突→隔离；自崩→弹窗 |
| C3 同 id 配置互踩 | 多层补丁对同一 id 给不同配置（含「出厂禁用被 profile 覆盖」形态） | 报告 + 二选一建议（需人工） |
| C4/C5 重复 id / 同名模块 | 结构性重复 | 报告（需人工） |
| C6 自杀/越权 | guard 出现 p2m/core | 自愈移除 + incident |
| C7 同名服务注册 | 不同插件会注册同一 cordis 服务（或撞引擎核心默认服务，如 sessionPersistence） | 启动前预检报告 + 二选一建议 |
| 版本漂移（preflight） | peer 声明区间 vs 实际解析版本越界（典型：本地缺失爬升到全局 CLI 旧版） | 启动前体检报告 + 钉版本命令（DSH_P2M_PREFLIGHT=block 可拒启） |
解析漂移（E2）：每次对账记录各插件
require.resolve实际落点与版本，漂移写resolve-driftincident 并持久化进state.json#lastResolve。
零依赖单测（node:test）：
node --test test/*.test.mjs # 74 个用例：guard/ledger/priority/conflicts/policy/yaml/trial/C7/preflight/resolve
DSH-P2M/
├─ lib/ P2M 本体（ESM，零运行时依赖）
│ ├─ index.js 入口：ctx.p2m 服务、采样、对账、门禁
│ ├─ guard.js guard 唯一写者（锁+备份+迁移）
│ ├─ yaml-min.js 自带 loader 补丁方言 YAML 解析器
│ ├─ ledger.js 使用时长台账（纯函数 tick）
│ ├─ priority.js 分层与动态排序
│ ├─ conflicts.js 冲突检测（静态+运行期+C7 服务注册预检）
│ ├─ policy.js 裁决引擎
│ ├─ preflight.js 启动前 peer 版本体检（E3，零依赖 semver 子集）
│ ├─ trial.js 子进程试跑（R5）
│ └─ dialog.js 崩溃风险双按钮弹窗（R5）
├─ launcher/ dsh-safe v2 纯启动监督器（复制覆盖旧版）
├─ test/ 单测 + 试跑夹具
└─ DESIGN.md 完整设计与边界（必读）
dsh plugin add 是"下载即重启"流，p2m 无法在重启前介入该流（由 v2 启动器熔断+incident 接管）；热挂载/手动恢复等 p2m 可控入口已全部接入试用门禁。| 版本 | 内容 |
|---|---|
| v0.1.3（E1） | C7 同名服务注册预检（含一跳依赖包溯源 + known-core 二选一告警） |
| v0.1.4（E2） | 解析路径留痕：resolve 快照 + 漂移 incident |
| v0.1.5（E3） | 启动前 peer 版本体检（p2m boot + launcher 内嵌，DSH_P2M_PREFLIGHT=block 可拒启） |
| v0.1.6（E4） | profile 层覆盖感知：出厂禁用被覆盖 → 二选一建议；C4 误报修正；boot 静态扫描全补丁层 |
| v0.1.6（E5） | 本文档体系同步（DESIGN §14 / 速查表 / AGENTS 心法 / 复盘 HTML） |
| v0.1.7 | 日志分级与显示规则：提示类 [WARNING] 黄色 / 中断及内部异常类 [ERROR] 红色，尾部附全英文 hint: 检查指引（含 launcher 同步）；preflight 提示文案优化；logColor 配置 |
完整背景与逐项说明见 docs/incident-2026-09-06.html（冲突事件复盘）与 DESIGN.md。
MIT © 2026 Erius (GiantAxeint)