安装
要求
- DeepSeek Harness 0.2.x；
- Node.js 22 或更高版本；
- 带网页界面的 DSH 配置档案；
- 至少一个能运行 GM 和子智能体的语言模型路由。
rclone 是可选依赖。只有需要在多台设备间同步资料库时才需要安装；仅在本机游玩不会调用它。
建议使用专用 DSH 配 置档案。套件会加入角色扮演预设、侧边栏界面、设置和会话页签。放在专用配置档案中，可以避免影响无关的 DSH 工作区。
dsh plugin --profile <profile> add @dsh-agentic-roleplay/all
套件会安装角色扮演核心和 @dsh-agentic-roleplay/state。重启该配置档案后，从 DSH 侧栏打开角色扮演。
麦克风输入是可选功能。需要时，请从 DSH 自己的插件列表安装并启用 Voice Input。角色扮演套件不再安装 DSH 的语音包，因此这些包可以与 DSH 运行时保持同一版本。SenseVoice 提供方、API 语音识别提供方可以任选，也可以同时使用。
只保留 all 套件这一层。核心包和状态包也各自带有一层补丁，用于不通过套件单独安装，而这些层会加入相同的插件行。两者同时选中时，配置档案里会有两个 roleplay 行，DSH 会拒绝保存设置 → 角色扮演（提示「本部署没有接受这些值」）。若使用插件管理器，请取消选中 @dsh-agentic-roleplay/core 和 @dsh-agentic-roleplay/state 这两层（包仍保持安装），然后重启。检测到这种情况时，角色扮演设置页会显示警告，日志中也会记录一条错误。
首次运行清单
- 在设置 → 角色扮演中设置存储根目录。
- 配置至少一个语言模型路由。项目维护的提供方集成见 AI 服务。
- 打开角色扮演 → 世界卡，添加示例世界或创建自己的世界。
- 点击世界卡上的播放按钮，选择可扮演角色并开始会话。
套件不包含模型凭据，也不会下载模型。只有相应服务可用时，媒体和检索增强功能才会出现。
存储根目录
在设置 → 角色扮演中选择绝对路径作为数据根目录。默认值是 ~/dsh-roleplay，支持开头的 ~。世界、化身、会话数据库和媒体都位于其中；插件配置和凭据仍由 DSH 配置档案管理。
修改根目录后，只要新值有效，目录会立即切换。无效修改会被拒绝，并继续使用先前目录。
请将此目录视为你的角色扮演资料库。备份它即可保存创作的世界、可复用化身、会话数据库、生成媒体和会话设置。不要让两个同时运行的配置档案指向同一根目录。
更新
更新套件后应重启配置档案。升级 DSH 次版本前请查看项目说明，因为子智能体组合依赖少量与 DSH 版本相关的接口。
从 0.9.0 升级
0.9.0 随套件安装了 DSH Voice Input 的组件。0.9.1 将它们移出套件，使其版本可以独立跟随 DSH。先停止该配置档案，再在现有安装上安装 0.9.1：
dsh plugin --profile <profile> add @dsh-agentic-roleplay/all@0.9.1
重新启动配置档案。若需要麦克风输入，请打开插件管理器，启用 DSH 的 Voice Input 插件。不要为旧语音包添加版本豁免。角色扮演根目录与插件安装位置分开，此更新不会删除世界或会话。如果你手工编辑过配置档案的补丁文件，请先备份配置。
下一步请阅读 AI 服务。