前言¶
在 DSH 的“一切皆插件”思路里，插件常用于扩展宿主的运行方式。对 J-Space Cognition Suite 这类能力来说，如果每次都在系统提示中整体注入，简单任务会显得多余；如果不注入，复杂任务又可能错过。
dsh-jspace-trigger 提供的是一个中间做法：只观察真实用户消息，按规则判断是否值得提醒 DeepSeek Harness 代理加载 j-space。
下面介绍这个插件的定位、功能、安装方式和需要注意的边界。
插件定位¶
dsh-jspace-trigger 是一个可配置的近场触发器，由 EricWang1358 维护，许可证为 MIT。
它不做整体注入。只有规则命中时，它才提醒代理加载 J-Space Cognition Suite；没有命中时保持沉默。
这个插件适合已经使用 DSH web profile、希望按需启用 J-Space 的使用者。它的 Node 引擎要求是 >=20。
核心功能¶
下面列出已核实的能力。
- 不做整体注入：不会把 J-Space 相关提示强制加到每一次会话中。
- 可配置规则引擎：支持正则、关键词、任意/全部/评分匹配、规则级阈值和排除项。
- 长度回退：长非聊天消息可路由到
full或loop。 - 会话安全投递：一个会话的命中不会投递给另一会话的代理。
- 去重：一个事件最多触发一次提示。
- 仅观察模式：在
injectMode: none下只记录不注入。 - 技能检测与引导安装：报告
j-space是否安装，并提供安装提示或命令。 - 运行时指标：报告事件、触发、注入和仅观察命中。
- 调用漏斗分析：连接规则命中、投递和后续工具调用，并检查
j-space是否加载。 - 干运行工具：显示当前配置对消息的处理结果。
内置 opt-out 规则总是最先评估，可以覆盖内容关键词。也就是说，即使消息里包含某些会命中的关键词，只要触发 opt-out，也不会因为内容关键词而继续提醒。
安装与启用¶
先安装插件，再重启 DSH，最后验证配置。
1、安装：
dsh plugin --profile web add "github:EricWang1358/dsh-jspace-trigger"
这条命令会把仓库形式的插件添加到 web profile。
2、重启：
dsh --profile web
3、验证配置：
dsh --profile web --dump-config | Select-String dsh-jspace-trigger
经过上面的步骤，如果输出中包含 dsh-jspace-trigger，说明配置里已经能看到该插件。
典型用法¶
干运行一条消息时，可以使用：
jspace_trigger_test "<消息内容>"
这一步用于查看当前配置会如何对待这条消息。
如果要只观察、不注入，可以在 cordis.patch.yml 中设置：
config:
injectMode: none
在仅观察模式下，命中会被记录，但不会向代理注入提示。
如果你维护仓库副本，并希望它出现在基于 GitHub topic 的市场发现中，仓库需要携带 dsh-plugin GitHub topic，并保留非空描述。
适用场景与注意¶
这个插件适合希望“按需加载 J-Space”的场景：消息简单时不干扰，消息符合规则时再提醒代理。
使用前注意以下几点：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证。 - 许可证为 MIT。
- Node 引擎要求
>=20。 - DSH
0.1.0-rc.7已验证，低于0.1.0-rc.7不支持。 peerDependencies限定@deepseek-ai/cordis >=4.0.0-rc <5及相关 DSH 包。- 运行时依赖为零，仅使用 Node 内置能力。
- 命中不会跨会话投递，且一个事件最多触发一次提示。
- 内置 opt-out 规则总是最先评估，可覆盖内容关键词。
链接¶
GitHub 仓库：https://github.com/EricWang1358/dsh-jspace-trigger
社区目录线索页：https://www.skillhub.cn/plugins/EricWang1358/dsh-jspace-trigger
社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
