MIT-licensed, local-first DSH companion plugin: reviewable memory, Character Card V2 import, a browser companion panel, and an optional Windows desktop-pet sidecar — privacy-first, no Shell/filesystem/network/MCP permissions.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-09-01
License
MIT
01What can it help you accomplish?
Get a quiet, local-first AI companion inside DeepSeek Harness that remembers only what you confirm
A reviewable/proposable memory panel and a gentle browser companion page inside the DSH Web UI
DSH users who want a privacy-respecting desktop companion and thought-organizing partner, not an autonomous agent
Add an optional transparent Windows desktop-pet sidecar launched from the DSH Web companion page
A built `sidecar/release/jingling-sidecar-*.exe` transparent window launched via the '打开桌面伙伴' button
Windows DSH users who want a visual desktop companion alongside the Web panel
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness (dsh) installed and on your PATH — the one-click and npm install both target the DSH `web` profile (started via `dsh --profile web` or `npx @deepseek-ai/dsh web`).
- Windows, for the optional desktop-pet sidecar — the README ships Windows-only `sidecar/` source built with `npm run dist:win`; other OSes use the browser panel only.
Installation steps
- 01
One-click (recommended): `git clone https://github.com/Yi-111-a/dsh-jingling.git`, `cd dsh-jingling`, `.\install-all.ps1` — installs deps, tests/builds the plugin, builds the Windows sidecar, packs the plugin, installs it to the DSH `web` profile, and installs the agent preset.
$ git clone https://github.com/Yi-111-a/dsh-jingling.git
- 02
From npm (no desktop pet): `dsh plugin --profile web add dsh-jingling` then `npm run install:preset`.
$ dsh plugin --profile web add dsh-jingling
- 03
From source: `git clone … && cd dsh-jingling && npm install --ignore-scripts && npm run check && npm pack --ignore-scripts && dsh plugin --profile web add .\dsh-jingling-0.1.0-alpha.19.tgz && npm run install:preset && dsh --profile web`.
$ git clone … && cd dsh-jingling && npm install --ignore-scripts && npm run check && npm pack --ignore-scripts && dsh plugin --profile web add .\dsh-jingling-0.1.0-alpha.19.tgz && npm run install:preset && dsh --profile web
- 04
Start DSH with `dsh --profile web` (or `npx @deepseek-ai/dsh web`), create a session, pick the 鲸灵 · Jingling preset, and send a first message.
$ dsh --profile web
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
Native DSH plugin: a DSH `web` profile preset plus a Sidecar interface (status, long-poll, chat)
Reviewable, proposable memory
things you allow Jingling to remember→memory you can edit or forget at any time; proposed before confirmed
Character Card V2 import
Character Card V2 JSON→imported content read only as text, never executed
Browser companion page
DSH Web UI→a gentle companion panel inside the DSH Web interface
Optional Windows desktop-pet sidecar
DSH Web companion page→transparent Windows desktop window launched with one click
builds a Windows `sidecar/*.exe` (requires Windows + `npm run dist:win`)Permission isolation
companion session vs work session→actual work is forced into a DSH `standard` session you authorize
04Who is it for? When not to use it?
Good for
- DSH users who want a privacy-respecting desktop companion and thought-organizing partner, not an autonomous agent
- Windows DSH users who want a visual desktop companion alongside the Web panel
05Compatibility, maintenance and safety notes
- Does not read the screen, camera, microphone, clipboard, files, or browsing history.
- Holds no Shell, filesystem, network, or MCP permissions — it cannot act autonomously.
- The bundled desktop-pet sidecar is Windows-only (built from `sidecar/` with `npm run dist:win`); other OSes get the browser companion page only.
- Romantic style is available only after explicitly enabling adult settings locally; not intended for public services.
- Some low-level identifiers still use `souldock` (plugin ID, RPC path, preset dir) for backward compatibility with early previews — not a second product.
MIT-licensed, pre-release alpha (dsh-jingling@0.1.0-alpha.19); repo last push 2026-08-15; no GitHub Releases tag yet.
06Frequently asked questions
How do I install dsh-jingling into DeepSeek Harness?
Use the one-click script: clone the repo, `cd dsh-jingling`, then `.\install-all.ps1`, which installs deps, builds the plugin and Windows sidecar, packs it, and installs it to the DSH `web` profile plus the agent preset. Or run `dsh plugin --profile web add dsh-jingling` (npm, no desktop pet) or build from source.
What is the desktop-pet sidecar, and is it required?
It's an optional transparent Windows window launched from the DSH Web companion page via the '打开桌面伙伴' button. It's Windows-only (built from `sidecar/` with `npm run dist:win`); if you skip it you still get the browser companion panel.
Does Jingling read my screen, files, or clipboard?
No. Per the README's safety boundary, she does not read the screen, camera, microphone, clipboard, files, or browsing history, and holds no Shell, filesystem, network, or MCP permissions — she only proposes memory that you confirm.
Can imported Character Cards execute code or tools?
No. Imported Character Card V2 JSON is read only as text and is never executed. Real work must move to a DSH `standard` session that you pick the directory for and authorize.
Which DeepSeek Harness version does it target?
The plugin is `dsh-jingling@0.1.0-alpha.19` (sidecar `jingling-sidecar@0.1.0-alpha.23`), built for DSH `0.1.0-rc.6`; install steps run it under the DSH `web` profile.
07Related DSH workflows
dsh-better-sidebar
by omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
dsh-tui
by ccch1mneyyy
Claude Code 风格全屏终端 TUI：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、上下文进度条 + TPS 仪表；接入 Agent preset（standard/code/minimal/cordis）、Skills、MCP、Goals、Todos、子代理，/ 命令注册表与随附技能（audit/bug/review/practice/pr_comments/release-notes/vuln-check）；纯插件挂载零核心改动。
openpets
by alvinunreal
Local first, desktop companion platform with animated pets, plugin SDK and coding-agent integrations.
dsh-tianshu-tui
by huiliyi37
DeepSeek Harness 交互式终端 UI 插件：会话工作区、图片端到端（剪贴板/视觉桥）、slash 下拉、审批卡片、推理可视化，纯展示层
08Data and sources
**鲸灵（Jingling）** 是 [DeepSeek Harness（DSH）](https://github.com/topics/dsh-plugin) 的一款陪伴插件。
安装到 DSH `web` profile
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-09-01. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.