前言¶
在 DeepSeek Harness（DSH）里做可长期相处的 AI 角色，常见做法是：人设写在提示词里，QQ 或网页各聊各的，记忆散落在笔记或向量库里，情绪与「会不会主动说话」往往靠手工拼进上下文。跨平台同一人设、可修订的长期记忆、以及和 Obsidian 对齐的笔记结构，通常要自行对接多套桥接与存储。
dsh-starr（仓库名 starr）由 MoonLoordSaMa 维护，归类为「记忆」类 DSH 插件。它把角色人格、长期记忆、情绪与目的、QQ（经 SnowLuma 与 OneBot 11）、B 站互动、听说看唱，以及网页控制台和三维记忆星图收进同一套以角色为中心的运行模型；当前发行版本为 v0.2.4，资料中写明主要面向 Windows，已核对的宿主接口版本为 DSH 0.2.1-rc.5，其他系统与宿主版本需自行验证。
这是什么¶
starr 是面向 DSH 的 AI 角色养成插件：不同角色的数据与配置独立保存，经授权的跨平台经历可沉淀到同一角色的记忆里；自由笔记与日记可写入 Obsidian 兼容目录，控制台侧支持列表、时间线、长期理解与 Three.js 三维星图阅读，完整正文可读、桌面端右侧可独立滚动。
插件通过 Starr-chat 统一登记 QQ、B 站与显式绑定的宿主会话，提供会话接续、上下文注入与有范围的共享记忆；兼容预设编号为 starr-qqchat。能力是否可用取决于模型、桥接版本、账号权限与实际调用结果，连接检查通过不代表所有功能均在各环境完成真实平台验收（详见仓库内 docs/VERIFICATION-V024.md）。
社区目录页：https://www.skillhub.cn/plugins/MoonLoordSaMa/dsh-starr；源码与文档：https://github.com/MoonLoordSaMa/dsh-starr。SkillHub 为独立插件目录站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
下面按 README 已列能力归纳，不超出 v0.2.4 说明范围。
角色、记忆与 Obsidian¶
- 角色与人格：创建角色，编辑人设、提示词和说话方式。
- 长期记忆：角色维护自由笔记与少量长期理解，支持修订、关联、合并与可恢复归档；新会话按共享范围召回。
- Obsidian 记忆库：自由笔记写入「笔记」，日记独立目录与定时保存；支持双链、外部修改核对与备份；记忆库与备份目录须分开且不能嵌套。
- 记忆阅读与星图：列表与全文阅读，可切换时间线、长期理解或三维星图。
v0.2.4 将控制台整理为聊天、感受与表达、自主活动、记忆四个工作区；记忆收敛为日记与自由笔记。插件内 Tabbit 与固定周月年回顾已移除，保留宿主原有能力、B 站浏览、连续接听和原生文件读写。
心理情绪、会话与平台¶
- 心理、情绪与目的：虚拟心理与身体状态、正负混合情绪、需求与目的评估，影响表达与回复节奏。
- QQ 互动：经 SnowLuma，启用 OneBot 11 正向 HTTP 与 WebSocket；私聊与群聊、引用、群内 @、拍一拍、表情与图片语音等（按权限）；当前资料写明只连接本机
127.0.0.1，访问令牌须与插件设置一致（非 QQ 登录密码）。 - B 站互动：扫码登录、资料与字幕、关键帧理解、私信与评论，及经确认或授权的动态与跨平台分享。
- 听说看唱：本地 Whisper 听写、兼容 TTS（如 Breeze）、宿主或兼容接口看图、本地 SoulX 翻唱与统一曲库检索（B 站、网易云等）；点歌流程为检索 → 选择音源 → 导入片段 → SVC 翻唱 → 按权限发送。
主动行动与维护¶
主动执行默认 L0 只观察；管理员可按对象、权限、安静时段和预算逐级开放。资源侧支持表情包与曲库管理、配置审计、记忆整理、数据库一致性备份与运行诊断等。
安装与启用¶
普通用户可安装发行包，无需配置前端开发环境。插件以当前 DSH 进程权限运行，安装前应阅读源码与 MIT 许可证，并知悉个人角色、记忆与凭据落在独立数据目录。
- 在本仓库 Releases 下载
dsh-starr-0.2.4.tgz（发布后可用）。 - 在 DSH 本地插件安装入口选择该文件，或执行下列命令（将
desktop换成实际 profile，并替换文件路径）。 - 完全退出并重新打开 DSH，侧栏点击 starr，进入新手调试。
dsh plugin --profile desktop add '你的下载目录\dsh-starr-0.2.4.tgz'
包内包含构建后的网页，安装时会自动启用插件、添加侧栏入口并注册 Starr-chat · 角色会话。更新时安装新 .tgz 后同样需要完全退出并重开 DSH；升级流程保留个人角色、记忆和表情（运行数据与代码分开保存）。
| 文件 | 用途 |
|---|---|
dsh-starr-0.2.4.tgz |
给 DSH 安装的插件包 |
dsh-starr-0.2.4.zip |
运行用解压归档 |
dsh-starr-0.2.4-source.zip |
开发用完整源码 |
典型用法：首次配置与控制台¶
新手调试可保存进度，刷新或重启后继续。建议顺序与 README「第一次使用」一致：
- 连接 QQ：按教程启动 SnowLuma，配置 OneBot 11 端口、访问令牌和允许回复对象，检查协议与登录状态。
- 创建角色：填写名字与时区；已有角色需明确选择。
- 编写人格：人设、说话方式与相处边界。
- 创建记忆库：确认记忆目录与独立备份目录（可选用带
.obsidian的已有库，插件创建独立角色子目录）。 - 接入 B 站：按需扫码，可稍后配置。
- 配置扩展模型：听写、说话、视觉、唱歌均可跳过后再补。
- 进入控制台：选择 DSH 聊天模型；明确启用 QQ 并完成向导后，插件才开始自动回复。
控制台四个工作区（诗意名用于导航，配置标签为普通名称）：
| 工作区 | 主要内容 |
|---|---|
| 回廊共语 · 聊天 | 人设、聊天与连续接听、QQ 与群聊、表情包 |
| 心观万象 · 感受与表达 | 情绪与体感、看图看视频、语音、TTS、唱歌与曲库 |
| 逐光而行 · 自主活动 | 自主活动、B 站账号/浏览/发布、跨平台分享 |
| 星海拾忆 · 记忆 | 笔记与日记、共享与隐私 |
听说看唱方面：听可用免费本地 Whisper 或远程兼容接口；说可配置 Breeze 目录或远程 TTS；看优先 DSH 已配置且支持图片的模型；唱使用本地 SoulX。starr 托管的 Breeze、SoulX 与 Whisper 同一时刻只允许一个托管模型推理，切换前需先卸载空闲模型。
适用场景与注意¶
适合谁：需要在 DSH 内运营长期角色、并希望 QQ / B 站 / 宿主会话共享同一套人设与记忆；同时愿意用 Obsidian 整理笔记、或希望在控制台与星图中阅读完整记忆正文的开发者或高级用户。
使用注意：
- QQ、B 站收发、分享与定时动态需逐项开启；真实可用性以环境、平台回执与模型结果为准。
- 当前采用关键词与关系数据检索；向量检索与完整旧格式合并导入资料中写明仍未接入。
- Windows 下部分凭据可走系统数据保护 API 加密；其他系统多用环境变量，环境变量优先。
- 独立预览（
pnpm start）默认数据在~/.local/share/dsh-starr-preview，不提供 DSH 宿主模型驱动；接入宿主后默认数据在 DSH 主目录下starr/runtime。
开发者从源码构建需 Node.js ≥ 24、pnpm 11（CI 固定 11.19.0）、按需 FFmpeg 与 Python/模型引擎；pnpm pack:plugin 生成发布用 .tgz。上述路径与命令均来自仓库 README，与「仅装发行包」用户无强依赖。
结尾¶
starr 把 DSH 里的角色养成从「单次对话加外挂笔记」收成以角色为中心的一条链路：Starr-chat 管会话与共享范围，记忆进 Obsidian 与星图可读正文，SnowLuma 接 QQ，控制台分工作区完成日常配置。若要查看分类与简介，可打开 SkillHub 目录页；安装、首次配置与 v0.2.4 验证范围以 GitHub 仓库 及 docs/ 下文档为准。
