Yi-111-a/dsh-jingling
31Last commit Aug 15, 2026
dsh-jingling DSH plugin
Jingling is a companion plugin for DeepSeek Harness (DSH) that lives in your local environment. It remembers things you allow, helps you organize thoughts, but never executes actions without your permission. It offers a gentle companion panel in the DSH web interface and an optional transparent desktop pet window on Windows.
How to install the dsh-jingling DSH plugin
dsh plugin --profile web add dsh-jinglingCopying does not run this command. Review the repository and version before installing the dsh-jingling DSH plugin.
dsh-jingling DSH plugin data source
dsh-jingling DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-jingling DSH plugin can do
- Reviewable memory: only remembers content you confirm, and you can modify or delete it anytime.
- Character card import: supports Character Card V2 JSON, imported content is read as text only, never executed.
- Browser companion page: a gentle companion panel inside the DSH web interface.
- Optional desktop sidecar: a transparent window pet (Windows only) that can be launched from the web interface.
- Permission isolation: companion and work sessions are separated; actual work requires switching to a standard DSH session with your explicit authorization.
Where the dsh-jingling DSH plugin fits
- Personal diary and thought organization with a private AI companion.
- Role-playing conversations using imported character cards.
- Privacy-focused AI companionship where memory is always under your control.
Who the dsh-jingling DSH plugin is for
- Users who want a local, privacy-first AI companion that does not exfiltrate data.
- Developers and enthusiasts who enjoy desktop pet aesthetics and want to integrate with DSH.
dsh-jingling DSH plugin limitations
- Desktop sidecar is currently only available on Windows.
- Plugin is in early alpha stage (0.1.0-alpha.19) and bound to DSH 0.1.0-rc.6.
- Romantic styles require explicit local adult settings and are not suitable for public services.
- Does not have shell, file system, network, or MCP permissions by design.
dsh-jingling DSH plugin: from the repository README
Quoted from the Yi-111-a/dsh-jingling README, the upstream source of the dsh-jingling DSH plugin. Copyright remains with the original authors.
> 你的 DSH 桌面小同伴 · 本地优先 · 安静陪伴 · 不偷看  **鲸灵（Jingling）** 是 [DeepSeek Harness（DSH）](https://github.com/topics/dsh-plugin) 的一款陪伴插件。她住在你的本地环境里，记得你允许她记得的事，陪你整理思路，但不会偷偷替你执行任何操作。 当前版本：`dsh-jingling@0.1.0-alpha.19`（插件）/ `jingling-sidecar@0.1.0-alpha.23`（桌宠），面向 DSH `0.1.0-rc.6`。 --- ## ✨ 她能做什么 | 能力 | 说明 | | --- | --- | | 🧠 **可审阅的记忆** | 她只会记住你确认过的内容，随时能改、能忘。 | | 🎭 **角色卡导入** | 支持 Character Card V2 JSON，导入的内容只当文本读，绝不执行。 | | 🖥️ **浏览器伙伴页** | 在 DSH Web 界面里拥有一个温和的陪伴面板。 | | 🪟 **可选桌面身体** | DSH 插件已内置桌宠 Sidecar 接口（状态、长轮询、聊天）；本仓库同时提供 Windows 透明桌宠源码（`sidecar/`），构建后可在 DSH Web 里一键启动。 | | 🔒 **权限隔离** | 陪伴和工作分开：实际工作必须切到 DSH `standard` 会话，由你选目录、你授权。 | --- ## 🚀 快速安装 ### 一键安装（推荐） ```powershell git clone https://github.com/Yi-111-a/dsh-jingling.git cd dsh-jingling .\install-all.ps1 ``` 脚本会自动完成：安装插件依赖 → 测试/构建插件 → 构建 Windows 桌宠 sidecar → 打包插件 → 安装到 DSH `web` profile → 安装 agent preset。 安装完成后启动 DSH： ```powershell dsh --profile web # 或 npx @deepseek-ai/dsh web ``` 新建会话后选择 **鲸灵 · Jingling** preset，发送第一条消息，她就会出现；在鲸灵页面点击 **“打开桌面伙伴”**，透明窗体桌宠就会显示在桌面上。 ### 从 npm 安装（不带桌宠） 如果你只需要浏览器里的陪伴面板，不需要桌面窗体： ```powershell dsh plugin --profile web add dsh-jingling npm run ins
Read the full READMERepository license: MIT
dsh-jingling DSH plugin questions
How do I install the Jingling DSH plugin?
The recommended way is to run the install-all.ps1 script from the cloned repository, which installs dependencies, builds the sidecar, and configures the plugin. Alternatively, you can use the npm command: `dsh plugin --profile web add dsh-jingling` and then `npm run install:preset` to set up the preset.
How do I launch the desktop pet (sidecar)?
After installing the plugin and starting DSH with the web profile, create a new session and select the 'Jingling' preset. Send a message and the companion panel will appear. In the Jingling page, click the 'Open Desktop Companion' button to launch the transparent window pet. Note that the sidecar is only available on Windows.
Does Jingling support macOS or Linux?
The desktop sidecar is currently only built for Windows. However, the browser companion panel works on any platform where DSH web interface runs (since it's a web-based plugin). The plugin itself is cross-platform, but the optional desktop pet requires Windows.
Is my memory safe with Jingling?
Yes, memory is reviewable and consensual. The plugin only remembers what you explicitly confirm, and you can view, edit, or delete memories at any time. It does not read your screen, camera, microphone, clipboard, files, or browsing history. Memory is stored locally and never shared without your permission.
How do I import a character card into Jingling?
Jingling supports Character Card V2 JSON format. You can import a character card file through the plugin interface. The imported content is only read as text and never executed, ensuring safety. After importing, you can interact with the character in conversations.