前言¶

在 DeepSeek Harness（DSH）裏做 QQ 側「角色」時，常見做法是單獨接一個 OneBot 後端，再零散掛記憶或工具插件。會話邊界、人設和工具調用往往各管一截，排查「有沒有真發出去」「記憶從哪來」也要翻多處配置。

dsh-lanya（嵐婭）是維護者 bamboosir1109 提供的 可擴展 QQ 角色集成包，分類上屬於工作流向插件。它把 DSH 插件、Windows 本機配套服務、QQ 後端與可選組件（B 站、GPT-SoVITS、memento 等）收成 一個主 LLM 統一決策 的結構；當前版本爲開發預覽 v1.4.0-dev.58（MIT 許可證）。社區目錄頁：SkillHub · dsh-lanya；源碼與文檔：GitHub · bamboosir1109/dsh-lanya。

下面按「是什麼 → 能做什麼 → 怎麼裝 → 怎麼用 → 注意點」說明，事實均來自項目 README 與 package.json，組件細節以倉庫內 docs/ 爲準。

這是什麼¶

一句話：面向 DSH 的模塊化 QQ 角色集成底座——插件側提供角色提示詞、調度與控制台入口；本機配套服務負責連接 QQ、記憶、表情、B 站等能力，外部服務按需配置。

架構上可理解爲兩部分程序協作：

                人設 · 最近對話 · 記憶
                          │
QQ 羣 / 私聊 ── QQ 後端 ── 主 LLM ── 工具與自主活動
                          │
                     本地控制台
                活動 · 記憶日記 · 費用

商店安裝 DSH 插件之後，仍需完成本機服務與各組件賬號配置；實際可用能力由組件接入情況決定，不是「裝好即有全部能力」。

核心功能¶

以下能力在 README 中有明確描述；邊界與接入條件見 組件接入表。

QQ 接入：NapCatQQ 或 SnowLuma¶

支持 NapCatQQ / SnowLuma 二選一，通過共用 OneBot v11 邊界接入。羣聊、私聊、引用消息與圖片共用同一套角色與會話策略；切換後端可保留同一人設與記憶。後端說明見 docs/QQ-BACKENDS.md。

B 站內容與互動¶

對接 dsh-bili-scroll 與配套內容工具：推薦與視頻詳情、按時間窗讀字幕、按需查看抽幀等。主 LLM 決定是否評論、回覆他人或 @ 管理員；控制台保留內容來源與互動結果。README 寫明：B 站評論、回覆和提及需本機啓用；字幕或畫面讀取不等於完整播放，接口接受也不等於公開可見。

GPT-SoVITS 語音¶

接入本機 GPT-SoVITS，由當前主 LLM 選擇要說的內容；合成、音頻校驗和 QQ 發送分步覈對，支持可播放的語音回覆。詳見 docs/VOICE.md。

可塑記憶與日記¶

記憶與日記對接 memento，並補充可塑註釋、範圍檢索、壓縮和來源記錄。README 描述短期上下文、長期事實、可塑更正、壓縮與第一人稱日記；檢索可按主題、時間、標籤和來源，並按工作區與對象隔離。

會話表現與自主活動¶

• 接話與表情：按標籤選擇真實表情（一輪最多一張）；結合近期輸入判斷接話或保持安靜，支持引用理解與靜默恢復（docs/INTERACTION-RELIABILITY.md）。
• 自主活動與工具：結合興趣、記憶與近況，可選擇瀏覽、遊戲或主動聯繫；瀏覽器與 Android 截圖等按環境接入，休息、預算、靜默與聯繫間隔繼續生效（docs/CAPABILITIES.md）。
• 本地控制台：在 http://127.0.0.1:19388/lanya-panel.html 查看連接、部件、活動、B 站內容與回覆、記憶日記，以及按天的人民幣費用 估值（依據本機價表與記錄，不等於服務商實際扣款）。

項目當前爲 開發預覽；自主行爲可以不執行，設備離線或發送結果未知時不會編造完成狀態。

組件如何組合¶

README 中的集成方式摘要如下，擴展步驟以 docs/INTEGRATIONS.md 爲準。

DSH 要求（package.json）：dsh >=0.2.0-rc.2，Node >=22.13.0；運行環境 README 列爲 Windows 10 / 11、PowerShell 5.1、Python 3.10+ 與可用的 DSH。

安裝與啓用¶

拉取源碼、部署本機服務、加載 DSH 插件是 三步分開 的流程；安裝器只複製文件，刷新控制台頁面不會升級常駐進程。完整說明見倉庫 docs/INSTALL.md。

1、部署本機配套服務¶

在已取得項目目錄的前提下，於 PowerShell 中先預覽將複製的文件，再執行正式安裝（$workspace 與 $repo 按你的工作區路徑替換；README 示例工作區名爲 qq-character-work）：

$workspace = Join-Path $env:USERPROFILE 'qq-character-work'
$repo = Join-Path $workspace 'dsh-lanya'
Set-Location -LiteralPath $repo
.\install.ps1 -Target $workspace -DataDir 'character' -WhatIf
.\install.ps1 -Target $workspace -DataDir 'character'

2、把插件接入 DSH¶

將 desktop 換成你實際使用的 profile；$repo 指向本地插件目錄：

dsh plugin --profile desktop add ("link:" + $repo)

按 docs/INSTALL.md 中「單獨安裝 DSH 插件」一節設置 workDir，選擇調度方式，並完成依賴、身份與 QQ 連接配置；模型與憑據使用你自己的 DSH 配置。

3、啓動並覈對¶

按安裝手冊啓動服務後，在瀏覽器打開：

http://127.0.0.1:19388/lanya-panel.html

在控制台查看「QQ 接入」與「部件與插件」，再用自己的 QQ 客戶端覈對消息是否真實到達。升級前閱讀 docs/MAINTENANCE.md，保留自己的人設與運行配置。

公開演示頁（不連接 QQ、不讀取本機數據）：bamboosir1109.github.io/dsh-lanya。

典型用法與文檔入口¶

沒有單獨一行「魔法命令」能替代完整部署；可復現路徑就是：配套服務 + DSH link 插件 + 按文檔配 QQ 後端與可選組件。

FAQ 中說明：這是開發預覽，需要自行配置 DSH、QQ 後端、外部插件與本機服務；SnowLuma 側私聊、羣聊、引用圖片、表情圖與可播放語音等曾有客戶端驗收記錄，但不代表全部動作與版本均已驗收。

適用場景與注意¶

更適合誰：已在 Windows 上運行 DSH，希望用 一套主 LLM 帶人設與記憶，在 QQ 裏接話，並可選擴展 B 站互動、語音與自主活動；願意按文檔逐項配置 NapCatQQ 或 SnowLuma、memento、dsh-bili-scroll、GPT-SoVITS 等組件的開發者。

務必注意：

1. 插件權限：DSH 插件在 當前 dsh 進程權限 下運行；安裝前請閱讀源碼與 MIT 許可證，確認本機服務、QQ 憑據與模型 API 的使用方式。
2. 預覽狀態：v1.4.0-dev.58 爲開發預覽；社區商店收錄申請（awesome-dsh-plugin PR #13180）README 寫明仍在等待審覈，與本地完整部署不是同一回事。
3. 組件邊界：未配置的組件不會 magically 可用；費用面板爲估值，缺少記錄不會顯示爲零元。
4. 生態關係：DSH 理念是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係——本文介紹的是社區維護的集成包，而非官方應用商店條目。

結尾¶

dsh-lanya 的價值在於：把 QQ 接入、記憶日記、B 站、語音與自主活動收到 同一角色與會話邊界 下，由主 LLM 按需調用，並在本地控制台集中查看過程與估算開銷。若你要從預覽版開始搭建，以倉庫 docs/INSTALL.md 爲主路徑，目錄頁與 issue 分別用於發現插件與反饋問題。

• 目錄頁：https://www.skillhub.cn/plugins/bamboosir1109/dsh-lanya
• GitHub：https://github.com/bamboosir1109/dsh-lanya