前言¶

在 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。