dsh-starr

starr ✦

> 醉后不知天在水，满船清梦压星河。

>

> ——唐温如《题龙阳县青草湖》

一个以角色为中心的 DeepSeek Harness（DSH）人工智能（AI）角色养成插件。

starr 将角色人设、长期记忆、情绪状态、会话接续与听说看唱整合在同一个网页控制台中。它通过 SnowLuma 连接 QQ，接入 B站，并让经过授权的跨平台经历沉淀到同一角色的记忆里。你可以在 Obsidian 中阅读、整理笔记，也可以在三维星图里探索记忆之间的联系。

让每一次相遇都有记忆，让每一颗星星都有故事。

当前版本：v0.2.4。主要面向 Windows，已核对的宿主接口版本为 DSH 0.2.1-rc.5；其他系统与宿主版本仍需分别验证。

[安装与更新](docs/INSTALL.md) · [首次配置](docs/ONBOARDING.md) · [完整配置](docs/CONFIGURATION.md) · [版本说明](docs/V024.md)

v0.2.4 将页面整理为聊天、感受与表达、自主活动、记忆四个工作区。常用配置直接放在对应功能页，修改后统一保存。记忆收敛为日记与自由笔记，角色可以修订自己的可见笔记，并把少量长期理解带到新会话；同类后台任务复用会话。插件内 Tabbit 与固定周月年回顾已移除，保留宿主原有能力、B站浏览、连续接听和原生文件读写。

能做什么

| 能力 | 说明 |

| ---------------- | ---------------------------------------------------------------------------------------------------------------------- |

| 角色与人格 | 创建角色，编辑人设、提示词和说话方式；不同角色的数据与配置独立保存。 |

| 长期记忆 | 由角色维护自由笔记与少量长期理解，支持修订、关联、合并与可恢复归档；新会话按共享范围继续召回。 |

| Obsidian 记忆库 | 自由笔记统一写入“笔记”，日记保留独立目录与定时保存；支持双链、外部修改核对与备份。旧目录升级时不自动搬动。 |

| 记忆阅读与星图 | 默认列表与全文阅读，可切换时间线、长期理解或三维星图；桌面右侧长文独立滚动，不以摘要替代正文。 |

| 心理、情绪与目的 | 虚拟心理和身体状态、正负混合情绪、需求与目的评估；状态影响表达与回复节奏。 |

| Starr-chat | 统一登记 QQ、B站与显式绑定的宿主会话，提供会话接续、上下文注入与有范围的共享记忆。 |

| QQ 互动 | 分开的私聊与群聊、引用回复、群内@、拍一拍、表情尺寸、图片与语音，以及按权限开放的平台操作。 |

| B站互动 | 扫码登录、资料与字幕读取、视频关键帧理解、私信和评论，以及经确认或授权的动态与跨平台分享。 |

| 听说看唱 | 免费本地听写、兼容服务语音合成、宿主视觉模型，以及本地 SoulX 翻唱与角色曲库。 |

| 找歌与曲库 | 统一搜索本地曲库、B站和网易云；默认优先高潮／副歌片段，导入后可交给已配置的歌声转换（SVC）模型生成不超过 45 秒的翻唱。 |

| 主动行动 | 默认只观察；管理员开启后，按对象、权限、安静时段和预算执行目的，保留时间线、失败原因与用量。 |

| 资源与维护 | 表情包、曲库音源与单个成品删除，媒体密钥清除，配置审计、记忆整理、数据库一致性备份与运行诊断。 |

能力是否可用取决于模型、桥接版本、账号权限与实际调用结果。连接检查通过不代表所有功能均已完成真实平台验收，详细范围见[验证记录](docs/VERIFICATION-V024.md)。

安装到 DSH

普通用户可以直接安装发行包，无需配置前端开发环境。

1. 在本仓库的发行版（Releases）下载 dsh-starr-0.2.4.tgz（发布后可用）。

2. 在 DSH 的本地插件安装入口选择该文件，或运行以下命令。

3. 完全退出并重新打开 DSH，点击侧栏的 starr，进入新手调试。

dsh plugin --profile desktop add '你的下载目录\dsh-starr-0.2.4.tgz'

将 desktop 换成你实际使用的配置名称，并替换文件路径。包内包含构建后的网页，安装时会自动启用插件、添加侧栏入口并注册 Starr-chat · 角色会话，兼容预设编号为 starr-qqchat。

发行文件的用途如下：

| 文件 | 用途 |

| ---------------------------- | ------------------------------------------------------- |

| dsh-starr-0.2.4.tgz | 给 DSH 安装的插件包。 |

| dsh-starr-0.2.4.zip | 运行插件的解压归档；解压后可安装其中的 package 目录。 |

| dsh-starr-0.2.4-source.zip | 开发用完整源码，需要安装依赖并构建。 |

更新已有安装时，安装新的 .tgz 后同样需要完全退出并重新打开 DSH。运行数据与代码分开保存，升级流程保留个人角色、记忆和表情。详见[安装与更新](docs/INSTALL.md)。

第一次使用

新手调试可以保存进度，刷新或重启后继续。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 登录密码。

详细操作见[首次配置](docs/ONBOARDING.md)、[QQ 连接与排错](docs/QQ.md)和[DSH 会话接入](docs/DSH-INTEGRATION.md)。

控制台导航

| 工作区 | 主要内容 |

| --------------------- | -------------------------------------------------------- |

| 回廊共语 · 聊天 | 人设与说话方式、聊天与连续接听、QQ连接与群聊、表情包。 |

| 心观万象 · 感受与表达 | 情绪与体感、看图与视频、听语音、说话与音色、唱歌与曲库。 |

| 逐光而行 · 自主活动 | 自主活动、B站账号/浏览/发布、跨平台分享。 |

| 星海拾忆 · 记忆 | 笔记与日记、日记与记忆设置、共享与隐私。 |