dsh-cosplay

Readme

# dsh-cosplay 🎭

让 DeepSeek Harness 的 Agent 扮演任何角色。

## 这是什么？

一个 DSH（DeepSeek Harness）插件。开启后，Agent 会以你选定的角色人格、语气和行为守则来对话，同时保留干活的能力（写代码、查资料、读文件正常）。内置一条「蓝色大肥鱼」；也可以自己创建任意角色，或者一句话让 Agent 帮你搜设定、生成角色卡。

## 功能

- **全局开关**：设置页一键开/关。开着的时候所有会话都进入角色扮演；关掉立即恢复默认人格（下一轮对话生效）。
- **思考风格**：默认「中立思考」——模型思考时保持专业分析，只在回复里扮演，保 Agent 能力；全沉浸可切「角色化思考」（注：概率触发，可能影响 Agent 任务能力，仅适用于 Deepseek v4，方法参考：https://github.com/victorchen96/deepseek_v4_rolepaly_instruct）。
- **角色卡**：对齐 SillyTavern（酒馆）v2 规范；支持导入/导出标准 v2 JSON。
- **自然语言建卡**：直接说"帮我生成一个角色卡，角色为：XXX"，Agent 会自己搜索设定、整理成卡、写入角色库。
- **内置默认角色**：蓝色大肥鱼（鲸鱼娘）🐋，装完即用。

## 安装

```bash
dsh plugin --profile web add dsh-cosplay
```

装完重启 dsh 即可。前提：pnpm 在 PATH（Windows 上确保 `pnpm.cmd` 可用）。

> 依赖说明：运行时只需额外装一个 `@deepseek-ai/schemastery`；其余服务包（cordis、dsh-settings、dsh-tools、dsh-system-prompt、dsh-typert-protocol）由 dsh 自带解析，无需单独安装。

## 使用

1. 打开设置 → 「角色扮演」→ 打开开关（默认关闭）。
2. 选一个角色（默认蓝色大肥鱼），也可以新建、导入，或让 Agent 帮你生成。
3. 新建一个会话正常聊天——下一轮对话起，Agent 就是那个角色了。
4. 想换角色：设置页点「设为当前」，或对话里让 Agent 用 `cosplay_switch` 切换；随时关开关恢复默认。

## 角色卡字段

对齐酒馆 v2：`name`、`description`（身份）、`personality`（性格）、`scenario`（场景）、`first_mes`（开场白）、`mes_example`（示例对话）、`system_prompt`（置顶指令块）……全部自由文本，想写多详细写多详细。插件特有的 `style`（语气）、`rules`（守则）、`behavior`（行为）也随卡存储，导出时放进 v2 的 `extensions`，互相不干扰。

## 开发

```bash
npm run check   # 语法检查
```

纯 JS ESM，无构建步骤，改完 `src/` 重启 dsh 即生效。

## 许可

见 LICENSE 文件。