@steerloop/dsh-plugin
DeepSeek Harness Cordis 插件，将 DSH 会话和审批连接到 Steerloop 移动端/网页控制平面。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @steerloop/dsh-plugin@0.1.0-alpha.1Plugin 以 @steerloop/dsh-plugin 发布，当前版本为 0.1.0-alpha.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
@steerloop/dsh-plugin connects a DeepSeek Harness runtime to a Steerloop Relay.
It is a thin Cordis plugin for adding Steerloop mobile/browser observation and
remote approval handling to existing dsh profiles.
This package is alpha quality for npm testing. It has been loaded by a real
DeepSeek Harness headless profile and verified against a local Steerloop Relay,
including paired-device signed approve and decline approval flows.
^22.19.0 || >=24.0.0, matching the current Harness engine range.approval/request prompts from signed Steerloop
approval.resolve commands.The plugin does not replace Harness UI or storage. It adds a remote control plane for long-running Harness jobs.
Install the current alpha from npm:
dsh plugin --profile headless add @steerloop/dsh-plugin@alpha
Before publication, install from a locally packed tarball for the closest npm release simulation:
npm pack -w @steerloop/dsh-plugin
dsh plugin --profile headless add ./steerloop-dsh-plugin-0.1.0-alpha.1.tgz
For active local development you can install this checkout directly:
dsh plugin --profile headless add "file:/path/to/steerloop/packages/dsh-plugin"
The package declares a DeepSeek Harness bundle, so dsh plugin add activates
its cordis.patch.yml layer automatically. For one-off development without
modifying the Harness profile, use the source-checkout.cordis.yml overlay in
the Steerloop repository examples.
Add the plugin as a Harness patch overlay after the session and approval plugins:
- insert:
- id: steerloop
name: '@steerloop/dsh-plugin'
config:
relayUrl: "wss://relay.example.com/ws"
token: "use-a-high-entropy-token"
hostId: "workstation-dsh"
hostName: "Workstation DeepSeek Harness"
pairingCode: "PAIR-1234"
requireRelayUrl: true
requireToken: true
For local development with the default Steerloop stack:
- insert:
- id: steerloop
name: '@steerloop/dsh-plugin'
config: {}
By default the plugin uses ws://127.0.0.1:8787/ws and
steerloop-local-dev. It prints the pairing code after Relay authentication.
| Field | Default | Purpose |
|---|---|---|
relayUrl | STEERLOOP_RELAY_URL or ws://127.0.0.1:8787/ws | Steerloop Relay WebSocket endpoint. Must use ws: or wss:. |
token | STEERLOOP_TOKEN or steerloop-local-dev | Relay shared host token. Use a high-entropy secret remotely. |
hostId | STEERLOOP_HOST_ID or OS hostname plus -dsh | Stable host identity shown in Steerloop. |
hostName | STEERLOOP_HOST_NAME or OS hostname plus DeepSeek Harness | Display name. |
pairingCode | STEERLOOP_PAIRING_CODE or random short code | Browser/mobile pairing code, 6-32 chars using A-Z, 0-9, or -. |
pairingTtlMs | 600000 | Pairing code lifetime. |
approvalTimeoutMs | 300000 | How long a Harness approval waits for a remote decision. |
heartbeatMs | 15000 | Relay heartbeat interval. |
reconnectMinMs | 500 | Initial Relay reconnect backoff. |
reconnectMaxMs | 30000 | Maximum Relay reconnect backoff. |
approvals | enabled | Set to false to observe only and delegate approval to another answerer. |
prependApprovalAnswerer | enabled | Register before later approval answerers. |
requireRelayUrl | disabled | Throw at startup when neither config nor STEERLOOP_RELAY_URL supplies a Relay URL. |
requireToken | disabled | Throw at startup when neither config nor STEERLOOP_TOKEN supplies a Relay token. |
From the Steerloop repository root:
npm run test -w @steerloop/dsh-plugin
npm pack --dry-run -w @steerloop/dsh-plugin
examples/deepseek-harness/smoke-source-checkout.sh
examples/deepseek-harness/smoke-tarball-install.sh
examples/deepseek-harness/smoke-approval-e2e.sh
session.prompt and session.interrupt are advertised only after a stable
Harness service seam is selected for them.approval/request plus the recent
tool/call with the same callId when available.session/event and approval/request.