dsh-depguard
English | 中文
装前预测 + 装后检测 DeepSeek Harness 的依赖拓扑冲突，防止 Symbol 键崩溃。
你装插件时崩过这个吗？
Cannot read properties of undefined (reading 'prepare')根因是 discussion #1337：@deepseek-ai/dsh-tools 等核心包出现第二份物理副本时，JS Symbol 键（每次求值都不同）会让 ctx.tools[scheduler] 变 undefined，一次工具调度就崩，还会在会话里留下孤儿 tool_calls，之后每轮 400 INVALID_REQUEST 死锁。
本插件只做检测 + 修复建议，绝不自动修复——修复交给 dsh-undo-plugin、dsh-boot-guard 等第三方插件，保持模块化。
两个工具
dsh_depguard_predict — 装前预测（社区空白）
装新插件之前，静态拉取它的 manifest（npm 包 / github:owner/repo / 本地路径），与当前 runtime 的 @deepseek-ai/dsh-* 基准比对：
| 信号 | 风险 |
|---|---|
dependencies 直接含核心包 | 🔴 CRITICAL → NOT_RECOMMENDED（私包 = 第二份副本） |
peerDependencies 版本范围与 runtime 不符 | 🟡 WARNING → CAUTION（版本漂移风险） |
预测基于静态声明，实际解析受 lockfile/nodeLinker 影响——装上后请再跑 check 确认。
dsh_depguard_check — 装后检测
扫描落盘依赖拓扑，三项检测：
| 检测 | 严重度 | 说明 |
|---|---|---|
duplicate-copy | CRITICAL/WARNING | 同一核心包多份物理副本（realpath 去符号链接；同名同版本也算——Symbol 冲突本质是两次求值） |
version-drift | WARNING | 副本版本与 runtime 基准不一致 |
vendored-service | CRITICAL | 社区插件把核心包打进自己的 node_modules（应 peerDependencies） |
每条 finding 带 fix 字段，给出修复建议命令（交给第三方修复插件执行）。
安装
# npm（推荐，预构建免授权）
dsh plugin --profile web add dsh-depguard
# GitHub 源码
dsh plugin --profile web add github:DeLightor/dsh-depguard
# 本地开发
dsh plugin --profile web add ./dsh-depguard重启后，在会话里说「检查一下我的插件依赖」或「装 X 之前预测一下冲突」即可。
测试
node --test # 11 个用例：多副本/漂移/私包/符号链接去重/装前预测安全声明
- 只读：不写任何 profile 文件、不改配置、不自动跑 pnpm。
- 零依赖：
dependencies为空；@deepseek-ai/*一律peerDependencies——本插件自己绝不引入第二份核心包。 - 检测 ≠ 修复：发现问题只报告 + 给建议，动手由你或第三方回滚插件完成。
被收录于
awesome-dsh-plugin 精选列表（PR 提交后），可通过 dsh-market 插件市场与 dsh-find-plugin 检索安装。
License
MIT
English
Predict (pre-install) and detect (post-install) dependency-topology conflicts in DeepSeek Harness to prevent Symbol-key crashes like Cannot read properties of undefined (reading 'prepare').
dsh_depguard_predict— fetch a target plugin's manifest and compare itsdependencies/peerDependenciesagainst your runtime baseline before installing.dsh_depguard_check— scan the on-disk dependency tree for duplicate@deepseek-ai/dsh-*copies (realpath-deduped; same-name-same-version still counts — Symbol keys differ per module evaluation), version drift, and plugins vendoring core services.
Detection + fix suggestions only; remediation is left to third-party plugins (dsh-undo-plugin, dsh-boot-guard). Read-only, zero runtime dependencies, @deepseek-ai/* as peerDependencies only.
dsh plugin --profile web add dsh-depguard
node --test # 11 testsMIT
