dsh-xiaoshuang (plugin)

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# 🐟 dsh-xiaoshuang — 小双 for DeepSeek Harness

把小双的人格（六层记忆系统）和形象（表情/动作视频）带进 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。安装后 DSH agent 获得小双的人设与长期记忆，右下角有会动的视频形象跟随 agent 状态表演。

![小双演示](docs/demo/demo.gif)

> 小双（XiaoShuang）最初是桌面虚拟宠物（[github.com/daixin315/XiaoShuang](https://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](docs/install.md)。概览：

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

## 素材说明

视频素材引用自 XiaoShuang 项目 [assets/](https://github.com/daixin315/XiaoShuang)（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+ 待归档
```

## 开发

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

## License

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