前言¶
在 DeepSeek Harness (DSH) 的插件生态中，构建角色扮演或伴侣功能往往面临架构臃肿或侵入性强的问题。现有的解决方案常依赖独立前端应用或脆弱的静态提示注入。dsh-character-studio 提供了一种原生、轻量的替代方案。作为 DeepSeek Harness 的客户端插件，它利用 Cordis 框架构建非侵入式架构，并统一了角色卡管理与 Hindsight 图记忆引擎，使 DSH 成为一个轻量且持久化的角色扮演运行时。
核心功能¶
该插件主要包含以下能力：
- 原生轻量级架构：基于 Cordis 的原生插件，非侵入式集成，不破坏现有 DSH 进程结构。
- 多格式角色卡支持：兼容原生 Markdown 格式（含三段式结构）与 SillyTavern V2 JSON 格式。
- Hindsight 图记忆引擎：利用 Hindsight 的图记忆能力，结合时间推理，提升长期记忆的深度。
- 角色专用内存隔离：为每个角色自动创建独立的记忆库（如
rp_<character>），防止不同角色间的记忆泄漏。 - DeepSeek Persona 沉浸式独白：支持 DeepSeek 官方的
persona沉浸式独白模式，增强角色的第一人称心理分析与对话表现。 - 指令控制：提供斜杠命令与 OOC（Out-Of-Character）指令，用于快速切换角色和发布非角色内的控制指令。
安装与启用¶
在安装前，请确保你的 DeepSeek Harness 版本满足要求，并确保 Hindsight REST API 服务已运行。
- 检查环境依赖：
- DeepSeek Harness >= 0.1.1-rc.2
- Hindsight REST API 服务已启动
- 执行安装命令：
dsh plugin --profile web add dsh-character-studio
如需在无头模式下运行，可使用 --profile headless 参数。
典型用法¶
安装完成后，可通过以下指令进行操作：
- 列出角色：查看当前已加载的角色卡列表。
/rp list
- 切换角色：立即激活指定的角色人格。
/rp use <name>
- 查看状态：检查当前记忆库状态及 Hindsight 连接健康度。
/rp status
- OOC 指令：发送非角色内的控制指令或旁白。
/ooc <directive>
配置项¶
插件支持以下配置项（通常在 DSH 配置文件中设置）：
cardsPath: 角色卡根目录，默认为~/.dsh/cards。defaultCard: 默认激活的角色卡名称，留空表示不激活。hindsightEndpoint: Hindsight REST API 地址，默认为http://localhost:8888。hindsightToken: Hindsight 的 Bearer Token（可选）。bankPrefix: 记忆库前缀，默认为rp_。recallCacheTtlMs: 内存召回缓存有效期（毫秒），默认为 60000ms。enableDeepSeekImmersivePrompt: 是否启用 DeepSeek 沉浸式独白规则，默认为true。enableTavernFormatting: 是否启用角色扮演格式规则，默认为true。
适用场景与注意¶
该插件适合需要构建长期、稳定且记忆隔离度高的角色扮演场景的开发者与用户。由于插件以当前 DSH 进程权限运行，建议在安装前仔细检查源码与许可证（MIT）。
结语¶
dsh-character-studio 通过原生插件化与 Hindsight 的结合，解决了传统方案中内存隔离差、格式复杂等问题。它为 DSH 用户提供了一个轻量、优雅且可持久化的角色扮演解决方案。
