dsh-starr

第一次使用

新手调试可以保存进度，刷新或重启后继续。QQ、B站和扩展媒体可以按需要接入。

1. 连接 QQ：按教程启动 SnowLuma，启用 OneBot 11 正向 HTTP 与 WebSocket，填写端口、访问令牌和允许回复的对象，再检查协议与登录状态。当前只连接本机 127.0.0.1。
2. 创建角色：填写名字与时区；已有角色需要明确选择。
3. 编写人格：设置人设、说话方式和相处边界，后续可在“人设与提示词”继续编辑。
4. 创建记忆库：确认记忆目录与独立备份目录。可以选择两个新的空目录，也可明确确认使用带 .obsidian 标记的已有 Obsidian 库，插件会创建独立角色子目录。
5. 接入 B站：按需扫码登录；也可以稍后配置。
6. 配置扩展模型：按需启用听写、说话、视觉与唱歌，均可跳过后再补。
7. 进入控制台：选择 DSH 聊天模型；明确启用 QQ 并完成向导后，插件才开始自动回复。

记忆与备份目录必须分开，不能重叠或相互嵌套。SnowLuma 的访问令牌需要与插件设置一致，它是接口凭据，不是 QQ 登录密码。

详细操作见首次配置、QQ 连接与排错和DSH 会话接入。

听说看唱怎么配置

能力	推荐配置方式	需要准备什么
听	使用免费本地 Whisper，或填写远程兼容接口。	本地模式需要 Python、准备独立环境，并在首次使用时下载模型权重；免费指无服务接口调用费用。
说	确认本地 Breeze 安装目录与音色，或填写远程语音合成（TTS）接口。	已安装的兼容引擎与权重，或服务地址、模型、音色编号和密钥。
看	优先使用 DSH 已配置且支持图片的模型，也可配置兼容接口。	支持图片的模型；屏幕和摄像头采集需要分别授权。
唱	使用本地 SoulX，导入音源和参考音色后生成翻唱。	SoulX 环境、模型与 FFmpeg；QQ 发送还需开启对应权限。

本地发现只盘点候选文件和服务信息，应用前需要确认，不会自动安装或执行陌生引擎。参考音色能力取决于引擎和模型；没有通用的云端音色训练或云端 SVC 协议。兼容远程唱歌字节节点保留为高级接入方式，需要单独验证。

starr 托管的 Breeze、SoulX 和免费 Whisper 共用本地模型许可，同一时刻只允许一个托管模型推理。切换模型前先卸载空闲模型；Breeze 与 SoulX 闲置满 5 分钟退出，Whisper 转写结束即退出。DSH 宿主视觉模型由宿主管理生命周期。

点歌流程为 检索 → 选择音源 → 导入片段 → SVC 翻唱 → 按权限发送。高潮优先使用标题线索或时间歌词重复定位，无法可靠定位时明确回退到开头，也可手动设置起点。平台版权、付费、地区和试听限制可能阻止入库。详见听说看唱、统一曲库和远程唱歌节点。

会话、共享与自主配置

DSH 提供宿主模型与会话执行，starr 管理角色、记忆、状态和业务能力。每轮请求按预算注入人格、会话接续、状态、目的与相关记忆，需要完整内容时由工具继续读取。

同一角色可以在 QQ 和 B站之间共享经过管理员授权的记忆；会话私密内容、群聊、公开评论与主人私聊仍有各自的读取范围。主人身份来自管理员绑定。普通未绑定的 DSH 会话可以正常聊天，角色工具只提供给 Starr-chat 预设和显式绑定的会话。

角色可以调整管理员允许的日常配置，例如语气、音色、部分记忆参数与兴趣词。路径、可执行程序、凭据、主人绑定、外发权限和角色自身授权由管理员控制。

主动执行默认处于 L0 只观察。管理员可逐级开放可信主人私聊、公开阅读和指定社交能力，并设置预算、冷却与安静时段。失败、未知用量或不明发送回执会阻止相应的后续动作。心理与身体状态属于虚拟角色模拟。