前言¶

在 DeepSeek Harness（DSH）里做智能体开发，工作会话往往绑定目录、工具与权限，适合执行任务，但不适合长时间「陪聊」或整理个人思路。把陪伴和工作混在同一会话里，还容易让记忆边界模糊——助手可能记住你没打算长期保留的内容，或在陪伴场景里误触文件、Shell 等能力。

下面介绍 鲸灵（Jingling），一款由 Yi-111-a 维护的 DSH 陪伴插件（GitHub 约 12 stars，SkillHub 分类为趣味换装）。她住在本地环境里，提供可审阅的记忆、浏览器陪伴面板，以及可选的 Windows 透明桌宠；实际工作仍需切回 DSH standard 会话，由你选目录、你授权。

这是什么¶

鲸灵是 DSH 生态中的一款陪伴插件，npm 包名为 dsh-jingling，当前版本为 0.1.0-alpha.19（桌宠 sidecar 为 jingling-sidecar@0.1.0-alpha.23），面向 DSH 0.1.0-rc.6。

她记得你允许她记住的事，陪你整理思路，但不会偷偷替你执行任何操作。公开名称、npm 包名和界面统一为 鲸灵 / Jingling / dsh-jingling；为兼容早期预览版本地配置，部分底层标识（插件 ID、RPC 路径、预设目录等）仍使用 souldock，并非第二个产品。

• 目录页：https://www.skillhub.cn/plugins/Yi-111-a/dsh-jingling
• 源码：https://github.com/Yi-111-a/dsh-jingling

核心功能¶

可审阅的记忆¶

她只会记住你确认过的内容，随时能改、能忘。记忆必须先提议、再确认，不会悄悄变成一份关系档案。

角色卡导入¶

支持 Character Card V2 JSON。导入的内容只当文本读取，绝不执行。

浏览器伙伴页¶

在 DSH Web 界面里拥有一个温和的陪伴面板。

可选桌面身体（Windows Sidecar）¶

DSH 插件已内置桌宠 Sidecar 接口（状态、长轮询、聊天）。本仓库同时提供 Windows 透明桌宠源码（sidecar/），构建后可在 DSH Web 里一键启动。构建产物为 sidecar/release/jingling-sidecar-*.exe。

权限隔离¶

陪伴和工作分开：实际工作必须切到 DSH standard 会话，由你选目录、你授权。她不拥有 Shell、文件系统、网络或 MCP 权限。

安装与启用¶

一键安装（推荐）¶

以下命令来自官方 README，适用于需要插件与 Windows 桌宠的完整安装：

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：

dsh --profile web
# 或
npx @deepseek-ai/dsh web

新建会话后选择 鲸灵 · Jingling preset，发送第一条消息，她就会出现；在鲸灵页面点击 「打开桌面伙伴」，透明窗体桌宠就会显示在桌面上。

从 npm 安装（不带桌宠）¶

如果只需要浏览器里的陪伴面板，不需要桌面窗体：

dsh plugin --profile web add dsh-jingling
npm run install:preset

注意：npm run install:preset 需在克隆仓库后的项目目录中执行。

从源码手动安装¶

git clone https://github.com/Yi-111-a/dsh-jingling.git
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

新建会话后选择 鲸灵 · Jingling preset，发送第一条消息即可启用。

单独构建桌宠 Sidecar¶

若跳过一键脚本、想单独构建 Windows 桌宠：

cd sidecar
npm ci
npm run dist:win

构建完成后，回到 DSH Web 的鲸灵页面，点击 「打开桌面伙伴」。若 Sidecar 不在默认位置，可在 DSH 配置里指定 sidecarExecutablePath。

典型用法¶

经过上面的安装步骤后，典型流程如下：

1. 以 web profile 启动 DSH。
2. 新建会话，选择 鲸灵 · Jingling preset。
3. 发送第一条消息，在 Web 界面打开陪伴面板。
4. 如需桌面形象，在鲸灵页面点击 「打开桌面伙伴」。
5. 需要执行文件操作、调用工具或 MCP 时，切换到 DSH standard 会话，自行选择工作目录并授权。

角色卡可通过 Character Card V2 JSON 导入，内容仅作文本上下文使用。

适用场景与注意¶

适合谁¶

• 希望在 DSH 本地环境里有一个安静陪伴、不越权执行的桌面伙伴。
• 需要把「陪聊 / 整理思路」与「带权限的工作会话」明确分开的开发者。
• 想在 Windows 桌面上显示可选透明桌宠，同时保留浏览器内陪伴面板的用户。

安全边界¶

官方文档 docs/SAFETY.md 说明了完整边界，要点包括：

• 不读取屏幕、摄像头、麦克风、剪贴板、文件或浏览历史。
• 记忆需先提议、再确认。
• 不拥有 Shell、文件系统、网络或 MCP 权限。
• 浪漫风格仅在本地明确开启成人设置后可用，不适合公开服务。

安装前须知¶

插件以当前 DSH 进程权限运行。安装前应阅读源码与 MIT 许可证；鲸灵自有代码采用 MIT，公开仓库与 npm 包仅再分发权利人授权的一张鲸灵待机头像，导入的角色卡、头像、模型和声音仍遵循各自许可证。

Node 版本要求：^22.19.0 || >=24.0.0（见 package.json 的 engines 字段）。

当前为 alpha 预览版本（0.1.0-alpha.19），桌宠 sidecar 主要面向 Windows；其他平台以 Web 陪伴面板为主。

结尾¶

鲸灵把 DSH 里的「陪伴」做成独立、本地优先、可审阅记忆的一条路径：Web 面板随时可用，Windows 用户还可选配透明桌宠；真正的工作仍留在 standard 会话里，由你掌控目录与权限。

• SkillHub 目录：https://www.skillhub.cn/plugins/Yi-111-a/dsh-jingling
• GitHub 仓库：https://github.com/Yi-111-a/dsh-jingling

更多技术细节见仓库内 docs/ARCHITECTURE.md 与 docs/PRODUCT.md。