鲸灵 Jingling 🐋

你的 DSH 桌面小同伴 · 本地优先 · 安静陪伴 · 不偷看

鲸灵（Jingling） 是 DeepSeek Harness（DSH） 的一款陪伴插件。她住在你的本地环境里，记得你允许她记得的事，陪你整理思路，但不会偷偷替你执行任何操作。

当前版本：dsh-jingling@0.1.0-alpha.13，面向 DSH 0.1.0-rc.6。

---

✨ 她能做什么

能力	说明
🧠 可审阅的记忆	她只会记住你确认过的内容，随时能改、能忘。
🎭 角色卡导入	支持 Character Card V2 JSON，导入的内容只当文本读，绝不执行。
🖥️ 浏览器伙伴页	在 DSH Web 界面里拥有一个温和的陪伴面板。
🪟 可选桌面身体	DSH 插件已内置桌宠 Sidecar 接口（状态、长轮询、聊天）；本仓库同时提供 Windows 透明桌宠源码（sidecar/），构建后可在 DSH Web 里一键启动。
🔒 权限隔离	陪伴和工作分开：实际工作必须切到 DSH standard 会话，由你选目录、你授权。

---

🚀 快速安装

从 npm 安装（推荐）

dsh plugin --profile web add dsh-jingling

然后运行一次预设安装器：

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.13.tgz
npm run install:preset
dsh --profile web

新建会话后选择 鲸灵 · Jingling preset，发送第一条消息，她就会出现啦。

---

🪟 桌面伙伴（Windows Sidecar）

源码已经合并到本仓库的 sidecar/ 目录。你需要先构建一次：

cd sidecar
npm ci
npm run dist:win

构建产物会出现在 sidecar/release/jingling-sidecar-*.exe。之后回到 DSH Web 的鲸灵页面，点击 “打开桌面伙伴” 按钮，她就会以透明窗口的形式出现在桌面上。

如果你把 Sidecar 放在别的位置，可以在 DSH 配置里指定 sidecarExecutablePath。

---

🛡️ 安全边界

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

完整说明见 docs/SAFETY.md。

---

🏷️ 关于名字的小备注

你看到的公开名称、npm 包名和界面都是 鲸灵 / Jingling / dsh-jingling。但为了兼容早期预览版的本机配置，一些底层标识仍然使用 souldock（插件 ID、RPC 路径、预设目录等）。这不是第二个产品，只是为了不打扰你已有的本地数据。

---

📦 标签

dsh · dsh-plugin · deepseek · deepseek-harness · deepseek-harness-plugin · ai-companion · desktop-pet · character-card · local-first · privacy · jingling · 鲸灵

---

📄 许可证

鲸灵自有代码采用 MIT 许可证。公开仓库与 npm 包仅再分发权利人授权的这一张鲸灵待机头像；导入的角色卡、头像、模型和声音仍遵循各自许可证。

更多技术细节见 docs/ARCHITECTURE.md 和 docs/PRODUCT.md。