前言¶
在 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/ 下文檔爲準。
