前言¶

在 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