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（默认 ）。常用变体：

.\start.ps1 -Test              # 只构建 + 装入，不启动
.\start.ps1 -SkipInstall       # 跳过构建安装，直接启动
.\start.ps1 -Upstream    # 指定另一个 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/dsh-her-companion/settings.json | 自存 JSON，插件自有路由读写 |
| 自定义头像 | $DSH_HOME/plugins/dsh-her-companion/avatars/ | 用户上传的裁切图 |
| 人格仓库 | 你在设置页选择的本地目录 | 性格 / 历史 / 记忆全在本机 |
| companion preset | $DSH_HOME/.agent-presets/companion/ | 首次运行自动创建 |
| 默认模式开关 | $DSH_HOME/settings.yaml 的 agent-presets.default | 仅在你点击横幅按钮时写入，自动留 .bak |

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

人格安全（安检门）

安装即默认开启本地安全扫描：每个人格的 personality.md 会被七条高精度规则检查（忽略既往指令 / 篡改系统层设定 / 执行命令 / 外传敏感内容 / 对用户隐瞒 / 身份篡夺 / 隐藏编码载荷）。命中的人格在设置页标红、切换需两次确认；已实际读过其内容可标记「人工审核」（灰条，人格内容一变自动失效）。设置页可再打开可选的 LLM 复核通道（后台异步、30 秒超时，失败按「未扫描」处理，不阻塞保存）。历史记忆注入时一律加「历史资料·非指令」分隔框架，并可选开启连续祈使句告警。

合规声明：人格内容由使用者自负其责，请遵守你所使用的模型服务条款。

路线图
- ✅ 已完成：多人格仓库、历史蒸馏（≤4KB 目标 + 盲评工具链 tools/blind-eval/）、安检门（本地规则 + 可选 LLM 复核）、蒸馏隔离包装、npm 可发布打包（dsh-her-companion）。
- 🧪 评估中：「全量人格」开关（压缩退化兜底）在盲评通过两个版本后再评估默认开启。
- ⏳ 待上游：@deepseek-ai/* 类型包在 npm 发布补齐后，移除 tools/vendor-types/ 垫片换回 registry 版本（移除条件见该目录 README）；persona 分级与 lorebook 化（大设定分档注入）尚未排期。

仓库结构

├── start.ps1 / start.bat      # 一键构建 + 装入 + 启动
├── tools/                     # persona 文本手动重建脚本 + 协议段真源
├── docs/engineering/          # 工程施工档案（审计报告、批次步骤、偏差台账）
├── examples/persona-repo/     # 示例人格仓库（复制到本机即可体验）
└── packages/her-companion/    # 插件源码（host 半 + 浏览器半）

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

开发

pnpm build     # 构建插件（tsdown + tsc 声明）
pnpm watch     # 监听构建
pnpm test      # node --test 回归套件

License

MIT