dsh-character-studio

DeepSeek Harness 原生沉浸式角色扮演（RP）与伴侣互动插件。将「解耦角色卡机制（SOUL 框架 + Markdown/Tavern 外部卡库）」与「Hindsight 图谱实体记忆引擎」深度联通，让 DSH 成为轻量、优雅且具备生产级长期记忆的原生 RP 娱乐宿主。

English | 简体中文

🌟 核心优势与竞品区别

相比 DSH 生态已有的方案以及传统酒馆（SillyTavern），dsh-character-studio 具备以下关键优势：

对比维度	传统酒馆 (SillyTavern)	社区已有 DSH RP 插件	dsh-character-studio (本插件)
系统架构	重前端单体，配置繁琐，多端同步重	侵入性修补 Host 或纯静态提示词	原生轻量 Cordis 插件，标准非侵入，零多余依赖
长期记忆机制	简单滑动窗口/粗粒度向量搜索，易遗忘	本地单文件追加或无图谱记忆	对接 Hindsight 生产级实体图谱与时序推理
多角色记忆隔离	手动切换数据库/易发生设定与记忆串线	全局共用一份记忆，多角色易串戏	专属 Bank 隔离 (`rp_<角色名>`)，换角色不串戏
思考沉浸度	需复杂正则拼接/依赖外部提示词注入	无深度思考链约束，偶发 AI 腔	DeepSeek 官方 `<think>` 第一人称内心独白注入
卡片与资产兼容	依赖专有前端格式与扩展插件	格式单一/需要手动修改代码	原生兼容 Markdown 三节卡与 SillyTavern V2 JSON

🎭 多格式角色卡原生加载：
- 标准 Markdown 角色卡（支持【角色】/【关系】/【对话】三节权威规范）；
- 兼容 SillyTavern（酒馆）V2 JSON 角色卡；
- 角色卡解耦外置，零代码热切换。
🧠 Hindsight 专属 Bank 记忆隔离：
- 每个角色自动分配独立的 Memory Bank（如 rp_alice），杜绝跨角色记忆串线；
- 跨会话沉淀剧情、羁绊与重要誓约，支持图谱实体与时间线关联分析；
- 内置 60s 内存 TTL 召回缓存与写失效机制。
🎬 DeepSeek <think> 内心独白沉浸推演：
- 官方级角色沉浸指令注入，在思考链内以第一人称进行心理分析与回复规划；
- 严格规范酒馆级演出排版（台词 ""、动作 「」、心理 ()）与活人感法则。
🕹️ 斜杠命令与 OOC 导演交互：
- /rp list：一键列出所有角色卡与当前激活卡；
- /rp use <name>：即时切换沉浸角色；
- /rp status：查看角色状态、Bank 名与 Hindsight 连通状态；
- /ooc <directive>：场外导演指令，用于调整剧情节奏或跳出戏份答疑。

dsh plugin --profile web add dsh-character-studio
# 或无头模式
dsh plugin --profile headless add dsh-character-studio

cd /path/to/dsh-character-studio
pnpm install && pnpm run build
dsh plugin --profile web add "link:$(pwd)"

在 $DSH_HOME/profiles/<profile>/settings.yaml 或 Web 界面设置中配置：

配置项	默认值	说明
`cardsPath`	`~/.dsh/cards`	角色卡存放根目录（支持 `.md` 与 `.json`）
`defaultCard`	`""`	默认激活的角色卡名称（留空则不默认激活）
`hindsightEndpoint`	`http://localhost:8888`	Hindsight 记忆服务 REST 端点
`hindsightToken`	`""`	Hindsight 认证 Token（本地无需填写）
`bankPrefix`	`rp_`	角色专属 Bank 的前缀
`recallCacheTtlMs`	`60000`	召回结果内存缓存时长（0 为禁用）
`enableDeepSeekImmersivePrompt`	`true`	是否在 `<think>` 中注入第一人称内心独白规则
`enableTavernFormatting`	`true`	是否注入酒馆台词/动作排版规范