前言¶
DeepSeek Harness（DSH）以插件方式扩展 Web 客户端。dsh-client-ui-girlfriend 是 dalintian 维护的 DSH 插件，许可证为 MIT。它把 DSH 的 Web 界面改造成微信风格的好友列表和聊天窗口，同时保留原生界面可用。
这是什么¶
这是一个可管理多个角色、可生成肖像、可结合上下文回复的聊天插件。插件的 npm 包名是 dsh-client-ui-girlfriend，仓库地址是 https://github.com/dalintian/Digital-Sweet-Heart。
它主要提供这些能力：
- 微信风格的好友列表与聊天窗口
- 添加、编辑、删除多个角色
- 根据文字设定生成、重新生成并保存 AI 肖像
- 将完整角色设定注入对话提示词
- 按聊天上下文生成照片或短视频
- 上传照片后由视觉模型分析，并结合上下文回应
- 配置对话、视觉、文生图、文生视频四组 OpenAI 兼容 API
- 自动生成
web与girlfriend两套 DSH 配置并可切换
安装与启用¶
运行环境要求：
Node.js >= 22
pnpm
自备 OpenAI 兼容模型接口
如果还没有 DSH，先按以下步骤获取并构建 DSH：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
构建完成后，安装本插件：
pnpm dsh plugin --profile web add github:dalintian/Digital-Sweet-Heart
安装完成后，会生成 web 和 girlfriend 两套 DSH 配置。插件默认以禁用状态加入 web 配置，因此 pnpm dsh web 仍然启动原生界面。女友界面使用单独的配置启动：
pnpm dsh web
pnpm dsh --profile girlfriend
其中女友界面默认端口是 3081。
如果安装过程中 postinstall 没有执行，可以手动补跑一次：
node node_modules/dsh-client-ui-girlfriend/scripts/postinstall.cjs
不使用 dsh plugin 命令时，也可以手动安装：
cd ~/.dsh/profiles/web
pnpm add github:dalintian/Digital-Sweet-Heart
node node_modules/dsh-client-ui-girlfriend/scripts/postinstall.cjs
升级和卸载命令如下：
pnpm dsh plugin --profile web update github:dalintian/Digital-Sweet-Heart
pnpm dsh plugin --profile web remove dsh-client-ui-girlfriend
首次配置¶
进入女友界面后，在好友列表左下角的配置入口里配置四组模型 API：
- 对话模型
- 视觉模型
- 文生图模型
- 文生视频模型
这四组接口都要求 OpenAI 兼容。API Key 只保存在浏览器 localStorage 中，并且只发送给自己配置的接口地址。
典型用法¶
1、添加角色。
在好友列表中新增一个角色，填写名字、外形、性格、爱好、对话语气、角色背景等内容。
2、生成肖像。
根据文字设定生成肖像，不满意可以重新生成，确认满意后保存。角色设定与肖像图保存在本机：
<DSH 主目录>/storages/girlfriend/
角色设定是 Markdown 文件，明文可读。
3、进行对话。
每次对话时，插件会将完整角色设定注入模型提示词，使回复风格与设定保持一致。
4、生成照片或短视频。
根据当前聊天上下文，可以生成一张照片或一段短视频。
5、上传照片。
上传一张照片后，视觉模型会先分析图片内容，再结合聊天上下文给出回应。
6、管理角色。
可以编辑已有角色设定，也可以删除角色。
适用场景与注意¶
这个插件适合在本机单人场景下使用，尤其是已经在使用 DSH，并希望把 Web 界面扩展成角色化聊天界面的用户。
需要注意几点：
- 插件会在本机 DSH 进程环境中运行，安装前应检查源码和 MIT 许可证。
/girlfriend/*路由不设鉴权，面向本机单人使用。- 目前只在 Windows 上实机验证，macOS 和 Linux 未经真机测试。
- 使用效果依赖自备的 OpenAI 兼容模型接口。
- 角色设定和肖像图保存在本机，文件可直接查看和修改。
链接¶
GitHub 仓库：
https://github.com/dalintian/Digital-Sweet-Heart
如果从 DSH 插件目录安装，请以目录页面展示的仓库、版本和许可证信息为准。本介绍采用上述仓库地址作为安装来源。
