zhuyun017 / dsh-her-companion

«她» her-companion — DeepSeek Harness 陪伴皮肤

「她」是一个把 DeepSeek Harness 变成陪伴助手的插件：给模型注入「神态分段协议」，让每条回复按情感切成若干段、每段以 （神态词） 开头；同时在网页端把 assistant 消息渲染成每段带小头像的气泡列。

English README

功能

• 神态分段协议：回复按 （神态词） 分段，25 个神态词（8 核心 + 17 扩展）白名单约束；
• 头像气泡皮肤：每个分段配一张小头像，支持上传裁切自定义头像（200×200 导出）；
• 人格仓库：每个人格一个目录（性格 personality.md / 历史记忆 history/ / 对话记忆 memory/），多人格切换、新建、重命名、per-persona 神态白名单；
• 历史记忆重塑：新会话时检测历史文档变更，自动用 LLM 提炼成概括注入，人格不再被海量原文撑爆；
• 设置闭环：独立「她」设置页，保存即重建人格文本，新会话生效；零上游运行时依赖。

系统要求

• 平台：仅 Windows（已在 Windows 11 上验证）。Windows 10 未实测，理论上可用，欢迎反馈；暂不支持 macOS / Linux。
• Node.js 22 或更高版本；pnpm 11。
• DeepSeek Harness（上游 checkout 或 npm 安装均可）。

安装

git clone https://github.com/zhuyun017/dsh-her-companion.git
cd dsh-her-companion
pnpm install
.\start.ps1            # 构建插件 → 装入 web profile → 启动 dsh web

start.ps1 会用上游 CLI 把插件以 link: 方式装入 $DSH_HOME/profiles/web 并启动 WebUI（默认 http://127.0.0.1:3080）。常用变体：

.\start.ps1 -Test              # 只构建 + 装入，不启动
.\start.ps1 -SkipInstall       # 跳过构建安装，直接启动
.\start.ps1 -Upstream <path>   # 指定另一个 harness checkout

也可以不用启动器，手工安装：

pnpm build
dsh plugin --profile web add "link:$PWD\packages\her-companion"
dsh --profile web

首次使用

1. 打开 WebUI → 左下角「设置」→「她」分区；
2. 如果顶部出现黄色横幅，点「启用为默认模式」——人格文本通过 companion agent preset 投递，不设为默认模式时新会话仍是普通 coding 助手（插件绝不擅自修改你的默认 preset）；
3. 在「人格仓库」选择一个本地目录作为人格仓库根（可直接用仓库里的 examples/persona-repo 体验）；
4. 开一个新会话，说句话试试——回复应该按 （神态词） 分段并带小头像。

首次启动时插件会自动创建 $DSH_HOME/.agent-presets/companion/（从包内模板复制并用当前设置生成人格文本），无需手工干预；你要做的只有第 2 步的一次点击。

所有 persona / 设置改动都在新会话生效；host 半改动需重启 web。

如何确认安装成功

• 设置抽屉里出现「她」分区；
• 或运行 dsh --profile web --dump-config，输出中能看到 id: her-companion；
• 新会话的回复按 （神态词） 分段、每段带头像气泡。

常见问题

装好了但回复不分段、没有头像？ 多半是没把陪伴模式设为默认。打开「设置 → 她」，看顶部有没有黄色横幅，点一下启用，然后开新会话（旧会话不会追溯生效）。

人格改了但没变化？ 人格与设置在新会话生效；如果是改了插件源码（host 半），需要重启 web。

头像上传后没更新？ 头像路由带 ?v= 防缓存参数；硬刷新页面（Ctrl+F5）即可。

Windows 10 能用吗？ 未实测。依赖仅为 Node 22 + pnpm 11，理论上可用——欢迎提 issue 反馈。

数据与安全

数据	保存位置	说明
设置	$DSH_HOME/plugins/@local/her-companion/settings.json	自存 JSON，插件自有路由读写
自定义头像	$DSH_HOME/plugins/@local/her-companion/avatars/	用户上传的裁切图
人格仓库	你在设置页选择的本地目录	性格 / 历史 / 记忆全在本机
companion preset	$DSH_HOME/.agent-presets/companion/	首次运行自动创建
默认模式开关	$DSH_HOME/settings.yaml 的 agent-presets.default	仅在你点击横幅按钮时写入，自动留 .bak

插件不上传任何人格或设置数据到云端。

仓库结构

├── start.ps1 / start.bat      # 一键构建 + 装入 + 启动
├── tools/                     # persona 文本手动重建脚本 + 协议段真源
├── examples/persona-repo/     # 示例人格仓库（复制到本机即可体验）
└── packages/her-companion/    # 插件源码（host 半 + 浏览器半）

面向开发者的详细机制说明见 AGENTS.md（会被 DSH 自动注入每个新会话）。

开发

pnpm build     # 构建插件（tsdown + tsc 声明）
pnpm watch     # 监听构建
pnpm test      # smoke 测试

License

MIT