MIT 许可、本地优先的 DSH 陪伴插件：可审阅记忆、角色卡 V2 导入、浏览器伙伴面板，以及可选的 Windows 桌宠 Sidecar——隐私优先，无 Shell / 文件系统 / 网络 / MCP 权限。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-09-01
许可证
MIT
01它能帮你完成什么？
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
02如何接入 DeepSeek Harness？
前置条件
- 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.
安装步骤
- 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
验证接入成功
作者未说明
03DSH 适配与能力边界
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
04适合谁？何时不该用？
适合
- 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
05兼容性、维护与安全提示
- 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.
06常见问题
怎么把 dsh-jingling 安装到 DeepSeek Harness？
一键脚本：克隆仓库后 `cd dsh-jingling`，运行 `.\install-all.ps1`，它会安装依赖、构建插件与 Windows 桌宠、打包并安装到 DSH `web` profile，同时装好 agent preset。也可以用 `dsh plugin --profile web add dsh-jingling`（npm，无桌宠）或从源码构建。
桌面伙伴 Sidecar 是什么，必须装吗？
它是可选的透明 Windows 窗体，从 DSH Web 伙伴页点击「打开桌面伙伴」启动；仅支持 Windows（由 `sidecar/` 用 `npm run dist:win` 构建）。不装也能用浏览器伙伴面板。
鲸灵会读取我的屏幕、文件或剪贴板吗？
不会。按 README 的安全边界，她不读取屏幕、摄像头、麦克风、剪贴板、文件或浏览历史，也不持有 Shell、文件系统、网络或 MCP 权限——只会提议由你确认的记忆。
导入的角色卡会执行代码或工具吗？
不会。导入的 Character Card V2 JSON 仅作为文本读取，绝不执行。实际工作必须切到由你选目录并授权的 DSH `standard` 会话。
它面向哪个 DeepSeek Harness 版本？
插件为 `dsh-jingling@0.1.0-alpha.19`（桌宠 `jingling-sidecar@0.1.0-alpha.23`），面向 DSH `0.1.0-rc.6`；安装步骤在 DSH `web` profile 下运行。
07相关的 DSH 工作流
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tui
作者 ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件：Claude Code 风，鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
openpets
作者 alvinunreal
本地优先的桌面陪伴平台，提供动效宠物、插件 SDK 与编码智能体集成。
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件：自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆，很丝滑的开发体验。
08数据与来源
**鲸灵（Jingling）** 是 [DeepSeek Harness（DSH）](https://github.com/topics/dsh-plugin) 的一款陪伴插件。
安装到 DSH `web` profile
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-09-01。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。