@goodandready/dsh-dsml-artifact-guard
清理模型文本流中泄漏的 DeepSeek DSML 结束标签
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:GooDAnDReaDY/dsh-dsml-artifact-guard#ca35b0c7c0b0397e34c6d469e2ae9b5ea2e5671aDsml Artifact Guard 以 @goodandready/dsh-dsml-artifact-guard 发布，当前版本为 0.2.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明
|
⭐ If you like this plugin, please star it on GitHub — it shows me that the plugin is useful to you and motivates me to keep developing it.
🐛 If you find a bug or would like to request a feature, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version. |
When interacting with certain upstream model providers or API gateways, raw DSML (DeepSeek Markup Language) tool-invocation protocol tags can leak into the assistant's visible text stream. Users frequently see trailing protocol clutter like:
Done. All tests have passed.
</｜DSML｜parameter> </｜DSML｜invoke> </｜DSML｜tool_calls>
These leaked closing tags visually pollute the chat bubble, cause Markdown rendering glitches, and can confuse downstream agents or clipboard exports.
@goodandready/dsh-dsml-artifact-guard is a lightweight, host-only runtime stream interceptor for DeepSeek Harness that cleans up these terminal artifacts in real time before they reach the user interface:
AsyncIterable synchronously. Making interceptors async returns a Promise that crashes the harness turn with stream is not async iterable. This guard adheres strictly to the synchronous hook contract.KEEP = 96 bytes) to reliably match and strip multi-chunk tails.graph TD
subgraph DSH ["DeepSeek Harness Runtime"]
Turn["Agent Turn Execution<br/>(LLM Stream Request)"]
ChatUI["Chat UI Stream Consumer<br/>(Renders clean markdown text)"]
end
subgraph Guard ["@goodandready/dsh-dsml-artifact-guard"]
Hook["Synchronous llm/stream Hook<br/>(Returns AsyncIterable synchronously)"]
ScopeCheck{"Scope Match?<br/>(providerId & modelId)"}
PassThrough["Raw Stream Pass-Through<br/>(Zero overhead for other models)"]
Buffer["Sliding Tail Buffer<br/>(Preserves trailing 96 bytes across deltas)"]
Detector{"Terminal Artifact?<br/>(Matches leaked DSML tail at finish)"}
Sanitize["Sanitize Mode<br/>(Strips leaked closing tags)"]
Audit["Audit Mode<br/>(Emits ctx.logger warning only)"]
end
Turn -->|llm/stream hook| Hook
Hook --> ScopeCheck
ScopeCheck -->|No| PassThrough
ScopeCheck -->|Yes| Buffer
PassThrough --> ChatUI
Buffer --> Detector
Detector -->|No Artifact| ChatUI
Detector -->|Artifact detected: sanitize| Sanitize --> ChatUI
Detector -->|Artifact detected: audit| Audit --> ChatUI
Under Cordis and DSH service lifecycles, event listeners on llm/stream must return the transformed stream synchronously. An asynchronous hook wrapper will return a Promise<AsyncIterable>, causing the runtime dispatcher to immediately throw TypeError: stream is not async iterable. dsh-dsml-artifact-guard wraps the stream generator in a pure synchronous registration.
In real-world streaming, the artifact </｜DSML｜parameter> </｜DSML｜invoke> </｜DSML｜tool_calls> is frequently fractured into fragments:
All tasks complete. </｜DSML｜parameter> </｜DSML｜invoke> </｜DSML｜tool_calls>The guard retains a minimal 96-byte window until the next chunk or finish event arrives, ensuring fractured tags are seamlessly detected and sanitized as a single terminal artifact.
<｜DSML｜tool_calls>example</｜DSML｜tool_calls>), it is never removed.tool-call-delta, usage, finish) are forwarded immediately without delay.sanitize (default): Strips terminal DSML closing tags and logs a warning with the count of removed artifacts.audit: Emits diagnostic logs with ctx.logger.info(...) without modifying the user-visible stream.disabled: Bypasses processing entirely.Registered directly in the DeepSeek Harness settings.plugin.item slot (lib/client.js):
mode, providerId, and modelId on the fly without restarting the harness, powered by reactive scope.watch.OFF badge and warning banner when the guard is set to disabled.A canonical HTTP management route (/api/dsh-dsml-artifact-guard/update) mounted via lib/updater.js:
POST) are strictly restricted to local loopback connections with valid origin headers.All client UI styles are strictly tokenized via DeepSeek Harness --dsw-alias-... CSS custom properties and color-mix() functions with zero hardcoded hex or rgba color literals. High contrast and accessibility are guaranteed in both Dark and Light themes, guarded by automated regression tests (test/theme.test.js).
Install into your DeepSeek Harness web profile:
dsh plugin --profile web add @goodandready/dsh-dsml-artifact-guard
Restart your DeepSeek Harness instance.
settings.yaml)Configure provider and model targets in settings.yaml or through the Web UI:
# settings.yaml
dsh-dsml-artifact-guard:
mode: sanitize
providerId: "your-provider-id"
modelId: "your-model-id"
| Parameter | Type | Default | Description |
|---|---|---|---|
mode | string | "sanitize" | Operation mode: "sanitize" (strip tags), "audit" (log only), or "disabled" |
providerId | string | "opencode-go" | Target provider identifier exhibiting leaked tags |
modelId | string | "deepseek-v4-flash" | Target model identifier exhibiting leaked tags |
| Method | Endpoint | Access | Description |
|---|---|---|---|
GET | /api/dsh-dsml-artifact-guard/update | Web UI / Localhost | Retrieves current version, latest registry version, and update status |
POST | /api/dsh-dsml-artifact-guard/update | Loopback & Same-Origin | Triggers in-place package update via DSH CLI |
Run the automated test suite covering split chunks, audit vs sanitize modes, scope matching, and synchronous hook contracts:
npm test
npm run check
MIT © GooDAnDReaDY
For a complete release history and version migration notes, see CHANGELOG.md.