zhuyun017/dsh-her-companion
「她」是一个把 DeepSeek Harness 变成陪伴助手的插件：给模型注入「神态分段协议」，让每条回复按情感切成若干段、每段以 （神态词） 开头；同时在网页端把 assistant 消息渲染成每段带小头像的气泡列。
catalog 简介 / catalog descriptioncatalog description：—
安装Install
dsh plugin --profile web add github:zhuyun017/dsh-her-companion把 zhuyun017/dsh-her-companion 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
«她» her-companion — DeepSeek Harness 陪伴皮肤
「她」是一个把 DeepSeek Harness 变成陪伴助手的插件：给模型注入「神态分段协议」，让每条回复按情感切成若干段、每段以 （神态词） 开头；同时在网页端把 assistant 消息渲染成每段带小头像的气泡列。
实拍
| 对话：分段头像气泡 | 设置：人格仓库与白名单 |
|---|---|
 |
 |
功能
- 神态分段协议：回复按
（神态词）分段，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
首次使用
- 打开 WebUI → 左下角「设置」→「她」分区；
- 如果顶部出现黄色横幅，点「启用为默认模式」——人格文本通过 companion agent preset 投递，不设为默认模式时新会话仍是普通 coding 助手（插件绝不擅自修改你的默认 preset）；
- 在「人格仓库」选择一个本地目录作为人格仓库根（可直接用仓库里的
examples/persona-repo体验）； - 开一个新会话，说句话试试——回复应该按
（神态词）分段并带小头像。
首次启动时插件会自动创建
$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
相关推荐Related
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Tencent/WeKnora
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-m…
- Nagi-ovo/voyager Enhancement suite for Gemini, AI Studio, Claude & ChatGPT — plus a prompt manager for any web UI, DeepSeek Harness inclu…
-
EverMind-AI/EverOS
One portable memory layer for every AI agent: local-first, Markdown-native, user-owned, and self-evolving across apps, t…
-
freestylefly/awesome-gpt-image-2
Prompt as Code | GPT-Image2 工业级提示词引擎与模板库，470+ 个案例逆向工程，20+ 套工业级模板，并提炼出Skills，持续更新中
-
awesome-dsh-plugin/awesome-dsh-plugin
A curated list of plugins for DeepSeek Harness (dsh) · DeepSeek Harness 插件精选列表
-
MemTensor/MemOS
Self-evolving memory OS for LLM & AI Agents: ultra-persistent memory, hybrid-retrieval, and cross-task skill reuse, with…