DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-plugin-whale-soulmate

J

dsh-plugin-whale-soulmate

Manifest valid★ 2

Modular AI companion + transparent-video desktop pet for DeepSeek Harness (dsh): persona engine, LLM wiki memory, privacy firewall, IM avatars. Modular AI companion and transparent video desktop pet plugin.

UI (client)hasBundlePatch

dsh-plugin-whale-soulmate 🐋

license topic release discussions CI

Whale Soulmate · AI companion × transparent-video desktop pet

中文 · English

嗨~这里住着一只给 DeepSeek Harness(dsh)用的模块化、可插拔 AI 小伙伴(Soulmate) 🐋

人设 × 情绪 × 关系养成 × LLM Wiki 记忆 × 五道隐私防线 × 透明视频桌宠 × 可选 AIGC 云同步。

她也会当你的办公 / 编程副驾——陪你聊天的同时,DSH 本事一个都不少。

✨ 会一直养着、一直变可爱: 这个仓库还在持续更新与打磨——修小毛刺、加新表情、把记忆和陪伴做得更懂你。欢迎 star / issue / PR,一起把小伙伴养得更好~

形态:Bundle 组合包(npm 包,dsh.bundle.patch),双半侧 —— node(index.js)+ browser(client.js)。

更完整的架构说明见 docs/DESIGN.md;版权与致谢见 NOTICE.md。

形象展示

四套内置皮肤,在「设置 → 称呼与形象」一键切换(静图与桌宠皮肤同步):

汉风 · 襦裙Q版 · 冬装男孩
汉风·襦裙 — 舞Q版·冬装男孩 — 滑雪
蓝色冬装
蓝色冬装 — 卖火柴的小女孩

蓝色冬装在雪天划火柴、烤红薯、滑冰转圈。同一套动作概念,各自不同的编排。

桌宠为透明视频精灵:按住甩出去会重力弹跳、落地 Q 弹;单击轻触、双击互动、滚轮缩放。

🎬 演示视频 · 24 秒双皮肤动作集锦:跳舞 / 爱心脸红 / 生气跺脚 / 滑雪 / 跑步 / 打招呼 / 灵机一动,全部透明通道视频实机录制。


功能一览

能力说明
零配置上手装上重启后右下角冒出桌宠 + 引导;未授权云端时零外网请求
人设引擎多套预设、五维滑块、MBTI 测验、性别声线、自我成长与三档安全重置
混合记忆事实 / Wiki / 双日记本;在场摘要、承诺、冲突裁决、语义遗忘
桌宠pet-winterboy-chibi:PNG 回退 + VP9-alpha WebM;拖拽 / 点击 / 思考 / 走路
主动开口本地生物钟闸:早安 / 催饭 / 晚间 / 催睡;夜间做梦蒸馏;专属会话投递
隐私五道防线 + 审计账本;私密记忆永不进云同步
扩展B 站理解与风控写操作;微信 / QQ / 飞书 / 钉钉 IM 分身
副驾双轨提示词 + 人设漂移重锚;完整调用宿主工具链

快速安装

# 在本仓库根目录
npm pack
# → dsh-plugin-whale-soulmate-<version>.tgz

dsh plugin --profile web add ./dsh-plugin-whale-soulmate-<version>.tgz
# 或 desktop profile
dsh plugin --profile desktop add ./dsh-plugin-whale-soulmate-<version>.tgz

务必装 tarball,不要装目录。 目录会记成 link:,容易触发 ERR_MODULE_NOT_FOUND。
node 半侧无热加载:装完请重启 dsh 进程。

安装新皮肤(v0.2.108+,免改代码 / 免重启)

皮肤自动发现:插件每次请求时扫描 assets/pet-*/pet.json,面板下拉框自动列出新皮肤。

# 一条命令:把素材文件夹(含 pet.json + pet-*.webm + pet-*.png)复制进已安装插件
node install-skin.mjs <素材文件夹> --id <皮肤id>
# 例:node install-skin.mjs ../output/pet-video-my-skin/assets --id my-skin

装完在面板「形象 / 桌面小伙伴」下拉里选中新皮肤即可,无需重新打包、无需重启。

也可(锁定 commit 更稳):

dsh plugin --profile web add github:JasperGuWP/dsh-plugin-whale-soulmate#<sha>

本地 --patch(仅自用):

dsh --patch ./cordis.patch.yml

使用片刻

  1. 打开 DSH Web / Desktop,右下角出现桌宠;引导里选性格、填称呼(自动保存)。
  2. 侧边栏「小鱼 / 设置」可改人设、信任层、作息、用量等。
  3. 需要多端同步时,在设置里显式授权云端后再联网。

开发

npm run build:client     # browser/*.mjs → client.js
  • 改前端请编辑 browser/,勿手改 client.js(构建产物,且默认不入库)。
  • 改 node 后重启 dsh;改 browser 后重建并刷新页面。

仓库结构

index.js                 # node 入口
cordis.patch.yml         # Bundle / patch 声明
packages/soulmate-core/  # 记忆 / 人设 / 隐私 / 调度 / 路由 / 工具
packages/soulmate-home/  # 桌宠状态机
packages/soulmate-bili/  # B 站扩展
packages/soulmate-im/    # IM 扩展
browser/                 # 前端源模块
assets/pet-winterboy-chibi/  # 桌宠素材
docs/DESIGN.md           # 设计概览(中英)
NOTICE.md                # 版权与致谢

版权与许可

  • 代码与文档:MIT,Copyright © 2026 JasperGuWP —— 见 LICENSE
  • 素材版权与第三方致谢 —— 见 NOTICE.md

欢迎打主题标签 dsh-plugin,以便 deepseek-harness 插件库 发现本仓库。


English

Hi — a modular, pluggable AI companion (Soulmate) for DeepSeek Harness 🐋

persona × mood × relationship · LLM Wiki memory · five privacy layers · transparent video desktop pet · optional AIGC cloud sync.

Also your coding / office co-pilot — cuddles never strip host tools.

✨ Kept cozy, kept improving: this repo is actively maintained — polish, new pet moods, smarter memory & companionship. Stars, issues, and PRs are very welcome~

Form: dual-face Bundle (dsh.bundle.patch) — node (index.js) + browser (client.js).

Architecture: docs/DESIGN.md · Credits: NOTICE.md.

Pet skins

Four bundled skins — switch in Settings → Identity (static avatar and pet skin stay in sync):

Hanfu · RuqunChibi · Winter Boy
Hanfu skin — ribbon danceWinter boy skin — skiing
Blue Winter
Blue winter skin — match girl

Transparent video sprites: flick-throw with gravity bounces and a landing squash; tap to pet, double-tap to nuzzle, wheel to zoom.

Features

AreaWhat you get
Zero-configPet + onboarding after install/restart; no network until cloud consent
PersonaPresets, 5-axis sliders, MBTI quiz, voice/gender, safe 3-tier reset
MemoryFacts / Wiki / dual diaries; presence, promises, conflicts, semantic decay
Desktop petpet-winterboy-chibi PNG + VP9-alpha WebM; drag / tap / think / walk
ProactiveLocal circadian gate; night dream distill; dedicated chat-home delivery
PrivacyFive layers + audit ledger; private memories never sync
ExtensionsBilibili watcher + gated writes; WeChat / QQ / Feishu / DingTalk
Co-pilotDual-track prompts + drift anchor; full host tool access

Install

npm pack
dsh plugin --profile web add ./dsh-plugin-whale-soulmate-<version>.tgz

Install the tarball, not a directory. Restart dsh (node half is not hot-reloadable).

New skins (v0.2.108+) need no code change or restart: node install-skin.mjs <asset-folder> --id <skin-id> copies the pack into the installed plugin; skins are discovered per request and listed in the panel dropdowns.

dsh plugin --profile web add github:JasperGuWP/dsh-plugin-whale-soulmate#<sha>

Develop

npm run build:client   # browser/*.mjs → client.js

Edit browser/ sources; do not hand-edit generated client.js.

License & credits

  • Code & docs: MIT, Copyright © 2026 JasperGuWP — LICENSE
  • Asset copyright & third-party thanks — NOTICE.md

Please tag the repo with dsh-plugin so the harness plugin library can discover it.

Comments

Loading…

From the same category

reactive-resume

DeepSeek Harness plugin for Reactive Resume: bridges your resumes and job applications into a Harness session over MCP.

Tools & CapabilitiesManifest valid

★ 41.7k

↓ 61/wk

MIT

Aug 24, 2026

dsh plugin --profile web add dsh-plugin-reactive-resume

by dsh-market

The plugin market inside DeepSeek Harness — browse, search, one-click install · DSH 可视化插件市场

Tools & CapabilitiesManifest valid

★ 12.8k

↓ 271k/wk

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile web add dshmarket

by Tencent

Let AI agents use your real, logged-in browser without interrupting your work. CLI + extension for browser automation across any shell-capable AI agent.

Tools & CapabilitiesManifest valid

★ 10.5k

↓ 17k/wk

MIT

TypeScript

Nov 17, 2026

dsh plugin --profile terminal add @wxg-prc-cpg/browser-skill-dsh-plugin

by kingcharleslzy-ai

Community-maintained dsh-purge fork with host-policy patches, prompt and rule settings, diagnostics, separate update-check and install controls, and local backup/rollback.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 9.8k

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add dsh-purge-community

by superdesigndev

OpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn

Tools & CapabilitiesManifest valid

★ 8.3k

NOASSERTION

Python

Nov 18, 2026

dsh plugin --profile web add treg-dsh

by yjh051108

dsh-routing-suite — injector + router-standard kit: install the runtime injector first, then the task-aware reasoning-mode router preset (measured P1-P23).

Tools & CapabilitiesManifest valid

★ 7k

MIT

JavaScript

Sep 18, 2026

dsh plugin --profile web add @dsh-external/dsh-super-injector