前言¶
在 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 / 幻方無官方從屬關係。
