DeepSeek Harness Hub
← 返回列表

人格化伴侣插件wanghehe123/dsh-Friend

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
未验证

给 AI 装上 Live2D 形象、语音与本地记忆陪你工作

尚未跑自动兼容性验证,可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/15 · 已提供中文文档

人格化伴侣插件 for DeepSeek Harness:角色卡、语音、Live2D、本地记忆与工作陪伴。

综合分
27.5
GitHub 分
27.5
用户评分
★ Stars
1
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add wanghehe123/dsh-Friend
该插件未发布到 npm,走 GitHub 源安装(pnpm 若拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑)
数据截至 2026/9/16(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-client-connection@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-conversation@deepseek-ai/dsh-client-ui-slots@deepseek-ai/dsh-host-webserver@deepseek-ai/dsh-settings@deepseek-ai/schemastery
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

dsh-Friend · DeepSeek Harness 人格化伴侣

dsh-Friend 是 DeepSeek Harness(DSH)的人格化伴侣插件:人设卡、语音对话、Live2D 舞台、本机记忆、成长故事、工作陪伴。挂在现有 dsh web 上,一条命令装齐。

衍生自 Kokoro Engine(MIT, © 2026 chyinan)。

dsh-Friend 主界面

Live2D 舞台

打开 /friend/pet,或看 dsh web 右下角的悬浮层。配置中心 → 形象 → 当前 Live2D 切换模型。

源码或 npm 安装后自带 奶龙(Cubism 4.2 / moc v4)。官方 Hiyori 要在本机同意条款后下载,不进仓库。也可以导入自己的 Cubism zip(需含 model3.json,上限 200 MB)。

表情按钮:平静、笑、尴尬、难过、惊讶、困倦、生气。回复里的 [expr:smile] 会驱动形象,不会出现在悬浮气泡和朗读里。

| 独立舞台 | 形象选择 |
| --- | --- |
| Live2D 舞台 | 形象设置 |

Cubism 5.3(moc v5+)目前画不出来,请用 SDK 4.2 导出。奶龙已是 moc v4。

奶龙 runtime 在仓库 models/naiwa-live2d/naiwa-live2d-v3-sdk4.2-runtime.zip,首次挂载解压到本机 vendor/nailong/。

人设

配置中心「人设」改名字、称呼、性格、背景、说话风格。Live2D 不在这张卡上选,统一走「形象」。支持多角色和酒馆卡导入。

人设

语音合成

配置中心「语音合成」选引擎、试听、调语速和自动朗读。

| 引擎 | 说明 |
| --- | --- |
| Edge | 不用 key,晓晓 / 云希等 |
| 百炼 | 阿里云 Qwen-TTS / CosyVoice(dashscope) |
| MiniMax | 官方 t2a_v2 |
| OpenAI 兼容 | 实现了 /audio/speech 的网关 |
| 浏览器 | speechSynthesis |

舞台指示默认不朗读。API key 只存在 host settings。

语音合成

语音输入

配置中心「语音输入」:

- 引擎:Chrome Web Speech,或自定义 ASR 端点
- 模式:按住说话、开关切换、自动监听
- 识别完可自动发给伴侣;打开「说话时打断朗读」后,开口会停掉当前 TTS

语音输入

Safari 没有可用的 Web Speech,请配自定义 ASR 端点。

记忆与成长

记忆写在本机 Markdown:MEMORY.md、memory/YYYY-MM-DD.md、USER.md。可以空闲自动小结,按钟点蒸馏到长期记忆。

成长是三步向导:基础设定 → 模拟人生 → 草稿审核后再写入记忆。也可以单独打开 /friend/growth。

成长向导

工作陪伴

只看会话事件的类型、时长和成败,不读文件内容和用户正文。档位:仅动作、动作 + 气泡、再加语音。可设安静时段和冷却。

「悬浮与桌面」能弹出独立窗口(Document PiP 或 window.open)。可选薄壳:

cd apps/friend-shell && cargo run

dsh 没起来时显示引导页,起来后切到 /friend/pet。

设置

设置 → dsh-Friend 是总开关。「打开配置中心」进入分区小窗,地址是 #/friend/config/,刷新还停在当前分区。

设置卡片

| 分区 | 内容 |
| --- | --- |
| 模型 | 对话 / 小结 / 成长,可继承 dsh 当前模型 |
| 人设 | 角色卡 |
| 语音合成 | TTS 引擎与试听 |
| 语音输入 | ASR 引擎、模式、快捷键 |
| 形象 | 当前 Live2D、导入 zip、帧率 |
| 记忆 | 开关、小结、蒸馏时刻 |
| 成长 | 三步向导 |
| 工作陪伴 | 反应档位与冷却 |
| 悬浮与桌面 | 位置、弹出、壳心跳 |
| 数据与关于 | 导出 zip(不含 cache/、vendor/) |

安装

DSH 插件通过 dsh plugin 装进 profile(dsh web 对应 web)。推荐装聚合包 @wishp3/dsh-friend-all,一个包装齐全部子包。

方式一:从 npm 安装(推荐)

插件已发布到 npm(@wishp3 scope):

dsh plugin --profile web add @wishp3/dsh-friend-all@0.1.0

装完重启 dsh web。

版本钉在当前发布版 0.1.0。升级时把 @0.1.0 换成新版本号。

如果这个 profile 以前跑过 link-profile,先把 ~/.dsh/profiles/web/cordis.patch.yml 恢复成 [],再装 npm 包。两套清单叠在一起会报 duplicate loader entry id。

方式二:从 GitHub 仓库安装(改代码调试)

包已经在 npm 上,仓库安装只给本地改代码用(需要 Node.js >= 22 与 pnpm)。本机 pnpm 11 没有 TTY 时会退出,先:

export CI=true

1. 克隆仓库
git clone https://github.com/wanghehe123/dsh-Friend.git
cd dsh-Friend

2. 安装依赖并构建
pnpm install
pnpm -r build

3. 把全家桶链接进 web profile
node scripts/link-profile.mjs
dsh plugin --profile web add link:$(pwd)/packages/dsh-friend-all

4. 重启 dsh web
dsh web

profile 目录不是 pnpm workspace,聚合包里的 workspace:* 会回退拉 npm。
改本地代码必须先跑 node scripts/link-profile.mjs,否则改的是已发布包,不是这份仓库的 lib/。

逐步说明见 docs/dev-loop.md。

单独安装某个插件

不想装全家桶时,可以按包名单独装:

dsh plugin --profile web add @wishp3/dsh-friend-stage      # Live2D 舞台
dsh plugin --profile web add @wishp3/dsh-friend-persona    # 人设
dsh plugin --profile web add @wishp3/dsh-friend-tts        # 语音合成
dsh plugin --profile web add @wishp3/dsh-friend-asr        # 语音输入
dsh plugin --profile web add @wishp3/dsh-friend-memory     # 记忆
dsh plugin --profile web add @wishp3/dsh-friend-growth     # 成长
dsh plugin --profile web add @wishp3/dsh-friend-reactions  # 工作陪伴
dsh plugin --profile web add @wishp3/dsh-friend-settings   # 配置中心

单独装时请同时装 @wishp3/dsh-friend-shared,以及你用到的包之间的依赖(例如舞台会用到 ASR)。不确定就装聚合包。

验证与卸载

重启 dsh web 之后:

- 设置导航出现 dsh-Friend
- GET http://127.0.0.1:3080/friend/pet 返回 200
- 形象列表里能看到奶龙和 Hiyori

也可以 dsh --profile web --dump-config 看插件层在不在。侧边栏或悬浮层没出来,多半是装完没重启。

卸载:dsh plugin --profile web remove @wishp3/dsh-friend-all,然后重启。开发链接用 node scripts/link-profile.mjs --unlink。

开发

export CI=true
pnpm test
pnpm typecheck
node scripts/aggregate.mjs --check
node scripts/release-scan.mjs --pack

壳:cd apps/friend-shell && cargo test。发布说明:docs/release.md。

来源与版权

| 部分 | 来源 | 许可 |
| --- | --- | --- |
| 插件逻辑 | 衍生自 Kokoro Engine | MIT(chyinan;本项目追加版权行) |
| Hiyori FREE / Cubism Core | Live2D 官方 | 用户同意条款后本机下载,不进仓库 |
| 本仓库其余源码 | wanghehe123 | MIT |

友情链接

- dsh-web-ui —— DSH Web UI 插件与皮肤集合
- dshfind —— DeepSeek Harness 学习与分享社区
- deepseek-plugin-store —— 社区插件商店
- dsh-pet —— 官方工作台吉祥物
- dsh-plugin topic

Star 历史

Star History Chart

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群