🐟 dsh-xiaoshuang — 小双 for DeepSeek Harness

把小双的人格（六层记忆系统）和形象（表情/动作视频）带进 DeepSeek Harness。安装后 DSH agent 获得小双的人设与长期记忆，右下角有会动的视频形象跟随 agent 状态表演。

小双（XiaoShuang）最初是桌面虚拟宠物（github.com/daixin315/XiaoShuang）。本仓库把她的记忆系统与形象做成 DSH 插件。 想要独立桌面应用（不依赖 DSH）？用桌面版 XiaoShuang：跨平台 AI 陪伴形象，表情/动作/记忆/待办/托盘常驻。

功能

能力	说明
🧠 六层记忆	core / system / important / timeline 分层，格式与桌面小双兼容
🤖 人设注入	agent 自动获得小双人格（system prompt 注入，可配置）
🛠 记忆工具	remember / recall / forget / archive（过期记忆自动归档）
📺 浮动形象	DSH 右下角视频形象，跟随 agent 状态自动表演（思考→干活→完成→眨眼）
💬 状态气泡	"正在思考… / 正在干活… / 完成啦～" 实时反馈
🔊 TTS 播报	回复完成自动语音播报（edge-tts，晓晓音色，可关）
🖱 手动交互	悬停菜单播放表情/动作；拖拽移动/缩放窗口；双击复位

目录结构

dsh-xiaoshuang/
├── packages/
│   ├── memory/    @dsh-xiaoshuang/memory — 记忆引擎（纯 TS，零依赖）
│   └── plugin/    @dsh-xiaoshuang/plugin  — 服务端插件（工具+注入+mood+素材+TTS）
├── client/        client 插件源码（浮动形象面板，需在 dsh 源码环境构建）
├── docs/install.md  安装指南
└── LICENSE

安装

完整步骤见 docs/install.md。概览：

• 服务端插件（记忆+人格+工具）：插件源码加载到 dsh 的 patch 层
• Client 形象（可选）：视频面板，需 dsh 源码 workspace 构建
• 素材：表情/动作视频需自行准备（可用 XiaoShuang Release 包，见下）

素材说明

视频素材引用自 XiaoShuang 项目 assets/（CC BY-NC-ND 4.0）。 安装后把素材放到 ~/.xiaoshuang/assets/expr|action/（或通过插件 assetsDir 配置指向现有目录）。素材目录名与桌面 XiaoShuang Release 包一致：expr（表情）、action（动作）。

记忆存储

默认 ~/.xiaoshuang/memory/，与桌面小双格式兼容：

core.txt       核心区：名字/喜好，同主题自动更新，上限30
system.txt     系统区：运行环境，上限20
important.txt  重要区：重要事件，满40条淘汰最旧
timeline.txt   流水："时间戳|内容"，24h 内保留，7d+ 待归档

开发

pnpm install && pnpm test   # 记忆引擎测试（vitest 11 项）

License

代码：个人免费 / 禁止商用（与 XiaoShuang 一致，见 LICENSE）。 素材：CC BY-NC-ND 4.0（引用自 XiaoShuang）。