dsh-deepmoyu 2.3.0 → 2.4.2

package/cordis.patch.yml

@@ -16,5 +16,5 @@
     - id: dafeiyu
       name: dsh-deepmoyu
       config:
-        # 真正的用户配置在插件自己的 config 里（点桌宠 → ⚙️ 设置可改），这里只放默认值
+        # 用户配置由桌宠工作台管理，这里只声明 bundle 默认值。
         enabled: true

package/docs/ASSETS.md

@@ -0,0 +1,25 @@
+# 素材与第三方组件
+
+## 代码
+
+项目代码遵循根 `LICENSE` 的 MIT 条款；`vendor/bilibili-mcp/` 保留单独的 MIT 许可证与署名。参见 [NOTICE.md](../NOTICE.md)。
+
+## 角色图片
+
+当前仓库包含以下既有角色素材：
+
+- `assets/pet/pet.png`
+- `assets/avatar/bust.png`
+- `assets/avatar/face.png`
+- `assets/avatar/fish.png`
+- `assets/avatar/wide.png`
+
+维护者已于 2026-10-29 明确确认这些图片为原创或已获得公开分发授权，并要求保留现有形象；记录见 `docs/assets-permissions.json`。该记录是维护者的授权声明，不另行推断具体作者或第三方许可名称。代码的 MIT 许可不自动改变图片、角色或商标本身的权利范围。
+
+`assets/screenshots/` 为当前插件真实界面的演示截图，使用合成数据，不代表真实账号、使用量或平台发送结果；其中出现的角色素材适用同一权限记录。
+
+## 外部服务和用户配置素材
+
+- 插件不打包 GPT-SoVITS 模型、用户音色、参考音频、下载的表情或 B站图片。
+- 用户配置的参考声音、模型与收集图片适用其各自的来源许可与平台要求。
+- 在线语音、模型和 B站服务不是本项目附带的账号或额度；连接方式见 [隐私说明](PRIVACY.md)。

package/docs/DEPLOYMENT.md

@@ -0,0 +1,102 @@
+# 部署指南
+
+## 安装前
+
+确认 DSH 已能独立启动、模型可用，并确定要安装的 profile。下面使用 `web`，其他 profile 应替换名称。DSH 桌面版如果没有将 `dsh` 加入 PATH，应使用该安装提供的 CLI 启动方式；不要猜测另一份安装的位置。
+
+该 profile 必须是已配置的 Web/Desktop 组合，提供 `webServer` 和 `agentPresets`。`dsh plugin` 对一个全新名称创建的纯 base profile 不会自动变成 Web 应用；应先按 DSH 官方部署文档创建 Web/Desktop profile，再安装本插件。不要把本插件直接加到只含 base/headless 的 profile。
+
+包的引擎声明是版本范围，不是每个历史宿主都具备全部扩展能力的保证。角色工具要求会话作用域，视频制作要求模型选择及目标续轮/终态能力。工作台会按实际能力报告限制。
+
+工作台面向桌面版或本机浏览器访问。插件会拒绝其他网站、不同本机端口及非回环 Origin 的 API 请求；本轮不将公开网络反向代理访问列为已支持部署方式。不要为绕过限制关闭来源校验，也不要把没有宿主认证保护的 DSH 端口暴露到公网。
+
+## npm 正式版
+
+```sh
+npm view dsh-deepmoyu version
+dsh plugin --profile web add dsh-deepmoyu
+```
+
+需要固定版本时，先确认它确实已发布，再使用 `dsh-deepmoyu@<版本>`。本地源码版本或 GitHub 标签不会自动改变 npm registry。
+
+## 本地发布包
+
+下载维护者发布的 `.tgz` 和 `SHA256SUMS`，核对 SHA-256。PowerShell 可使用：
+
+```powershell
+Get-FileHash -Algorithm SHA256 .\dsh-deepmoyu-2.4.2.tgz
+dsh plugin --profile web add "C:\Downloads\dsh-deepmoyu-2.4.2.tgz"
+```
+
+Linux/macOS 可使用：
+
+```sh
+shasum -a 256 dsh-deepmoyu-2.4.2.tgz
+dsh plugin --profile web add "/absolute/path/dsh-deepmoyu-2.4.2.tgz"
+```
+
+离线只有插件 tarball 仍不一定足够：首次安装需要解析其 npm 依赖，主 Python 工具链还需下载依赖。完全离线部署需预先准备对应平台的依赖缓存；项目不宣称一个 tarball 即覆盖全部离线依赖。
+
+## GitHub 或源码 ZIP
+
+克隆仓库，或解压带有 `package.json` 的源码包，进入该目录：
+
+```sh
+npm ci --omit=dev
+```
+
+PowerShell 本地链接：
+
+```powershell
+$pluginPath = (Get-Location).Path
+dsh plugin --profile web add "link:$pluginPath"
+```
+
+Linux/macOS 本地链接：
+
+```sh
+dsh plugin --profile web add "link:$(pwd)"
+```
+
+保持该源码目录存在，不要在链接安装后移动它。DSH 的插件命令管理 bundle 列表，普通部署不需要手工改 profile 的 JSON 或 junction。开发者安装 `npm ci` 可同时获得测试依赖。
+
+## 加载与首次配置
+
+1. 完全退出并重开 DSH，启动相同 profile。
+2. 单击桌宠 → 工作台 → 偏好与设置 → 账号与环境。
+3. 安装主依赖；插件使用独立 Python 环境，不写入宿主包目录。需要本地转写时另装可选依赖。
+4. 扫码登录并执行连接检查。
+5. 在运行方式中配置会话/后台各自的模型、时长和预算。
+6. 如需发送，单独启用相应权限；需要人工决定时同时开启发送前审核。
+
+普通对话不需要选择此模式，也不会获得角色工具。仅选中鲸鱼摸鱼模式不会自动开始浏览。
+
+## 升级与迁移
+
+先停止任务并备份 `<DSH_HOME>/bili-duty/`。npm 安装用户可安装已发布的新版本并重启。维护本地分叉时，应更新该源码 checkout 并安装锁定依赖，不应通过 registry 重装覆盖本地改动。
+
+从旧包名 `dsh-dafeiyu` 迁移时，先确认旧包与新包指向同一运行目录，停止旧实例并移除旧包的加载项，再安装新包。不要同时加载两份插件。内部 preset、HTTP 路由及状态文件沿用 `dafeiyu/feiyu` 标识，以兼容既有数据。
+
+不要用新建 profile、清空状态或删除判重数据库来处理普通升级错误。数据损坏与文件不存在是不同情况，先备份并检查日志。
+
+## 卸载与回滚
+
+```sh
+dsh plugin --profile web remove dsh-deepmoyu
+```
+
+重启 DSH 后移除工作台与模式。运行数据保留；手动删除前先确认其中的凭证、记忆和视频是否需要备份。回滚代码时使用已验证的旧版本并保留数据备份；不承诺未来数据结构均可向旧版逆向兼容。
+
+## 故障定位
+
+| 现象 | 检查项 |
+| --- | --- |
+| 没有桌宠 | 当前 profile 是否包含 bundle、插件是否激活、桌宠是否隐藏 |
+| 菜单可见但接口 404 | 当前进程是否完全重启、包目录是否指向预期版本 |
+| 角色工具不可用 | `toolScope` 诊断与宿主会话作用域能力 |
+| 新会话创建失败 | 来源工作区、来源权限和所选模型是否有效 |
+| Python 安装失败 | 安装日志、Python/uv 路径、下载源与完整性校验 |
+| 视频失败 | 制作会话终态、独立任务日志、字体、配音和音视频校验 |
+| 已开始但显示未计量 | 模型服务是否提供可信 usage；不要将缺失数据改为 0 |
+
+公开提交诊断前去除凭证、二维码、模型密钥、私信和个人路径。数据流见 [隐私说明](PRIVACY.md)。

package/docs/PRIVACY.md

@@ -0,0 +1,32 @@
+# 数据与隐私
+
+## 本地保存
+
+插件运行目录为 `<DSH_HOME>/bili-duty/`，默认位于用户目录的 `.dsh/bili-duty/`。它包含配置、B站登录凭证、浏览与判重记录、学习队列、发送审核、用量、角色记忆、表情图片和本地视频产物。卸载插件包不等于删除这些数据。
+
+工作区记录镜像是另一份本地副本：当镜像功能已配置时，部分脱敏记录也会出现在所选工作区根目录。不要把自己的运行目录、工作区镜像或诊断附件直接提交到公开仓库。发布脚本只归档插件仓库中的源码文件，并拒绝已知运行数据与凭证文件。
+
+## 哪些数据可能离开本机
+
+| 功能 | 接收方 | 发送的数据 |
+| --- | --- | --- |
+| 扫码登录与内容交互 | B站官方服务 | 登录流程数据、授权凭证，以及搜索、读取或已授权发送所需的参数 |
+| 模型对话、后台浏览、学习审核与分镜编排 | 用户在 DSH 选择的模型服务 | 当前会话提示词、允许读取的工具结果和任务上下文；可能包含已批准记忆、评论或已授权读取的私信 |
+| 默认视频配音 | `edge-tts` 使用的在线语音服务 | 待合成旁白及音色参数 |
+| GPT-SoVITS 配音（可选） | 用户配置的本地环境 | 参考音频、对应文字和待合成旁白；该环境及其外部连接由用户自行配置 |
+| 安装依赖与下载工具 | 配置的包源、官方分发源及下载镜像 | 下载请求所需信息；二进制完整性校验不等于对第三方服务行为作保证 |
+| 链接收集表情 | 用户选择的公网图片来源 | 图片下载请求；来源地址受网络与格式校验 |
+
+“凭证保存在本机”不表示账号请求从不携带凭证，也不表示模型或在线语音处理完全离线。本插件不设置独立的遥测或运行记录上传服务。
+
+## 对话隔离与控制
+
+普通会话不挂载角色工具或新增角色提示内容。切换模式不会删除已经存在的聊天历史。后台任务属于显式启动或已保存计划的独立任务，不因用户打开普通对话而获得该对话的人格或权限。
+
+评论、私信、动态、发送审核、学习审核、自动收集及自动配图具有各自的控制项。批准一条学习不等于授予公开发送权限。关闭审核也不会自动批准旧待审记录。
+
+## 导出、备份和删除
+
+退出 DSH 并确认后台任务已停止后，再备份完整运行目录。备份中可能含有效凭证，应按私人资料保存。界面中的“忘记”只影响对应记忆，不删除平台上已发布的内容；清空用量不清空永久判重。
+
+需要完全删除插件数据时，先卸载插件并停止所有相关进程，再自行删除 `<DSH_HOME>/bili-duty/` 和已配置的工作区镜像。不要删除整个 `<DSH_HOME>`，以免影响其他插件或 DSH 配置。

package/docs/RELEASE_AUDIT.md

@@ -0,0 +1,70 @@
+# 发布审查记录
+
+审查日期：2026-10-29。版本：2.4.2。结论：本轮发现的插件逻辑缺陷已修复，已完成下列功能、分发与安装验证。自动化测试和依赖审计不能证明不存在未知缺陷；外部服务、系统及模型边界单独列出。
+
+## 环境与证据类型
+
+- 本机 Windows、Node.js 24.14.0、DSH Desktop 0.2.0-rc.2。
+- 独立 CPython 3.11.18 和 3.12.10 环境；主依赖为全哈希锁，其中 Pillow 13.0.0、bilibili-api-python 17.4.2、mcp 1.30.0、edge-tts 7.3.1、imageio-ffmpeg 0.7.0。
+- 浏览器使用真实 Chrome、React/ReactDOM 19.1.10 和合成数据。没有把截图演示或 mock 的发送回执写成真实账号行为。
+- 真实宿主测试使用临时 profile、当前源码链接、从本机 app.asar 复制的实际依赖和回环模拟模型；不安装或覆盖实际用户 profile。
+- 所有平台发送、账号读取和收藏写入的自动回归使用受控接口；本轮没有发送真实评论、私信、动态或收藏。
+
+## 验收结果
+
+| 命令/门禁 | 实际结果 |
+| --- | --- |
+| `npm test` | host/client 自检与 387/387 Node 测试通过，0 失败、0 跳过 |
+| `npm run test:python` / unittest discover | Python 3.11 全量 90/90，0 跳过；Python 3.12 主媒体/守卫测试及新增边车契约分别通过 |
+| `npm run test:ui` | 997 条断言通过、0 失败；21/21 人为变异被捕捉 |
+| `npm run test:browser` | 菜单 7 视口/42 次预览与动作清理；产品 26、竞态 9、记忆 18、页面矩阵 206、UID 往返 12 项通过 |
+| `npm run test:isolation` | 人格隔离 103 条断言；真实宿主 goal driver 9 场景/54 条断言通过 |
+| `host-tool-scope.test.mjs` | 显式指定本机真实宿主 archive 后 1/1 通过；无宿主的其他机器允许明确 skip，不能据此声称真实宿主已通过 |
+| `npm run test:host` | 当前完整 bundle 与预设声明被真实宿主组合；普通请求有 24 个普通工具，0 个 bili 工具、0 个鱼人格标记 |
+| `npm run test:mcp` | 真实 Python/FastMCP 握手、本地 SQLite 守卫调用及进程清理通过；无凭证、无平台调用 |
+| 实际视频制作 | Pillow 13 环境完成封面→配音→1920×1080/30fps渲染→媒体校验→持久成片，见下节 |
+| uv 下载 | 当前实现实际从官方来源获取校验值，流式下载/校验/解压/执行版本检查，得到 uv 0.13.6；另有15项隔离回归 |
+| 主依赖审计 | 官方 npm audit：0 已知漏洞；pip-audit 2.10.1 对实际主 Python 环境：0 已知漏洞 |
+| `release:check/build/smoke` | bundle、文档链接、38工具证据、素材授权摘要、截图、凭证模式、归档内容与清洁 tarball 安装通过 |
+
+全工具逐项证据见 [功能矩阵](TEST_MATRIX.md) 与 `tool-evidence.json`。387 项 Node 测试包含正向的全部 38 个工具、模式切出后的 76 次旧句柄拒绝、长 ID 原始 MCP 传输和各深层专项，不用无效参数拒绝来代替成功路径覆盖。
+
+## 发现与修复
+
+| 范围 | 修复及验证 |
+| --- | --- |
+| 普通会话隔离 | 角色工具从根层改为会话作用域；显式退出、未知模式和残留鱼 goal 不再获得人格授权；根 registry 的旧适配器别名也在注册前拒绝 |
+| 发送授权 | 模型配置工具不能开启发送、修改收件人、关闭审核或削弱预算/环境防护；force不构成授权；人工审核仍需原有发送开关允许 |
+| 配置事务 | 锁内合并本次字段，修复多实例覆盖他人配置；严格拒绝畸形布尔、混合危险配置和不安全数字 UID |
+| 长 ID | 浏览器文本输入、配置、工具、MCP原始JSON、回复和复核统一保持精度；不能从已舍入数字猜回目标 |
+| 登录 | 二维码独立归属、旧请求不能覆盖新账号、网络操作有超时、凭证原子私密落盘 |
+| 发送复核 | 有界分页、去环、重复合并、ID保真、损坏状态拒写、锁内合并与日报追加；登录态列表可见不再被描述为保证公开可见 |
+| 后台隐私 | stdout/stderr、模型及工具错误只保留白名单元数据，不复制私信、请求正文或堆栈；处理UTF-8拆分和长行 |
+| 下载与环境 | CPU/系统选择、官方摘要、大小/时限、独立暂存、实际可执行校验；Python3.11–3.13/Pillow13门禁、旧环境备份及失败恢复 |
+| 可选转写 | 只清理本次下载、保留本地输入、同BV并发隔离；导入不修改全局临时目录；可选环境失败/中断不再假就绪 |
+| 视频 | 修复编码器管道资源与失效的partial路径；明确目标的估时和实测不足60%时要求重编内容，不用静帧填时 |
+| UI与目录 | 修复逻辑失败误报、首次称号误报、可访问名称、焦点循环、环境升级说明、旧响应覆盖；目录打开采用三平台无shell参数和退出确认 |
+| 分发 | 主/开发依赖锁定，可移植QA进入Git根，运行manifest仅保留实际存在的check命令，源码ZIP保留开发流程，补齐隐私/部署/发布/素材与CI资料 |
+
+## 真实媒体验证
+
+独立 Pillow 13 / Python 3.12 环境使用当前 `createPv` 协调器实际执行。验收样片目标15秒、最低9秒；最终27.2秒、816/816帧、1920×1080、30fps、AAC，音频RMS约0.1012。四镜口型活动帧分别为137/128/160/145，两比例封面存在；回执的 `verifiedVideo` 指向实际存在的最终 `video.mp4`。首帧、中帧、末帧和封面已目视检查。
+
+时长是目标，不是逐帧固定长度；实际结果随旁白和语速变化。预览和正式制作均不接受严重不足的明确目标计划。媒体校验检查解码、非静音、时序、口型活动和产物存在性，不宣称已进行ASR逐字识别或主观听感认证。
+
+## 宿主、外部与平台边界
+
+- 真实headless one-shot不组合角色预设：宿主门禁证明预设声明可组合和普通模式真实无泄漏；鱼模式工具挂载/退出由真实ScopedLayers源码、goal driver及独立模式测试验证，不冒称操作了当前GUI中的真实鱼会话。
+- 基础支持对象为配置完整的本机Desktop/Web profile，须有 `webServer`、`agentPresets`。纯base/headless不能直接承载整个桌宠bundle；内部后台任务使用受控桥。
+- macOS/Linux目录启动参数已自动测试，但本轮没有在这些桌面实机操作。CI提供Windows/Linux/macOS、Node22/24、Python3.11/3.12矩阵；配置文件已核验，尚未把未运行的远程CI写成已通过。
+- 默认配音的实际样片使用在线语音服务；可选Whisper/yt-dlp和收藏边车为离线接口契约，未下载大型识别模型或执行真实收藏。用户自配GPT-SoVITS/GPU环境、参考音色和ASR识别质量未纳入主依赖审计。
+- npm与主Python依赖审计是审查时快照，不是未来版本或所有可选用户环境的无漏洞保证。
+- 没有重启正在使用的DSH；修改JS需要用户完全退出并重开后加载。没有更新真实profile、模型凭证、用户权限或删除运行历史。
+
+## 发布状态与复跑
+
+当前版本是本地待发布2.4.2。最终安装包与完整源码ZIP位于 `release/`，有逐文件验证报告和SHA-256；运行manifest删除开发命令是明确的发布投影，其他运行文件与源码逐字节核对。源码ZIP包含当前未提交的新文件，不混入历史工作区的旧包。
+
+安装包清洁安装使用临时家目录与生产依赖，执行包内 `check` 自检。依赖代码、媒体和界面文件调整后需重新构建归档。维护者可以在源码根运行README/CONTRIBUTING列出的全部命令；输出可由 `QA_OUTPUT_DIR`、`RELEASE_TMPDIR` 和 `DSH_QA_TMPDIR` 指定位置。
+
+市场所需条目、截图及客观描述已准备。GitHub仓库创建满一天的最早时间为 **2026-10-29 13:18:16（北京时间）**；此前外部年龄门禁不会放行。npm发布、GitHub上传与市场维护者审核尚未执行，不能由本地打包通过推断已发布或已收录，详见 [发布指南](RELEASING.md)。

package/docs/RELEASING.md

@@ -0,0 +1,94 @@
+# 发布指南
+
+源码、npm 包、GitHub Release 和插件市场条目是四个独立产物。本项目的构建命令不自动推送、发布 npm、创建 Release 或提交市场 PR。
+
+## 1. 准备源码
+
+Git clone 已包含仓库元数据；从完整源码 ZIP 解压后，部署与一般测试可以直接运行，重新执行发布检查/打包前应在该源码根执行 `git init`，建立受控文件清单即可，不要求提交或设置远程仓库。归档故意不分发维护者的 `.git` 和认证信息。
+
+- 更新 `package.json`、锁文件和 `CHANGELOG.md`，确认版本尚未被占用。
+- 确认素材公开分发权限已记录在 [ASSETS.md](ASSETS.md) 与 `assets-permissions.json`。
+- 核对 README、部署指南、隐私、安全报告入口和可复跑测试命令。
+- 源码树不得包含运行数据、Cookie、模型密钥、`.npmrc` 或本机虚拟环境。
+
+```sh
+npm ci
+npm view dsh-deepmoyu version
+```
+
+## 2. 执行验收
+
+```sh
+npm test
+npm run test:python
+npm run test:mcp
+npm run test:ui
+npm run test:browser
+npm run test:isolation
+npm run release:check
+npm audit --registry=https://registry.npmjs.org
+```
+
+Python 与浏览器依赖按 [贡献指南](../CONTRIBUTING.md) 配置。真实宿主门禁在提供本机 DSH 时执行；无宿主时的明确跳过不等于通过真实宿主验收。CI 只运行被明确隔离的测试，不读取账号，不发送平台消息。
+
+更新 [RELEASE_AUDIT.md](RELEASE_AUDIT.md)，区分真实媒体、真实宿主实现、合成浏览器和 mock 外部服务。未通过的检查和无法验证的环境必须保留说明。
+
+## 3. 构建并测试实际归档
+
+```sh
+npm run release:build
+npm run release:smoke
+```
+
+产物位于忽略提交的 `release/`：
+
+- `dsh-deepmoyu-<版本>.tgz`：npm/DSH 安装包，只包含运行文件、素材和用户文档。
+- `dsh-deepmoyu-<版本>-source.zip`：可上传或解压开发的完整源码，包括锁文件、测试、CI 和发布资料。
+- `SHA256SUMS`：两个归档的 SHA-256。
+- `archive-verification.json`：文件数、归档哈希以及 npm 文件清单。
+
+构建从当前工作树获取已跟踪与未忽略的新文件，保留尚未提交的实现，不从旧 Git 提交生成过期 ZIP。源码 ZIP 逐文件回读并与当前源码比较；npm 包的 `package.json` 仅保留运行期 `check` 命令并移除开发依赖声明，其他文件逐字节核对。检查路径越界、符号链接、私有数据、常见凭证内容模式与缓存。清洁安装测试使用临时目录安装实际 tarball，并执行包内自检。
+
+npm 运行包提供 `npm run check`；`npm test`、界面验收和发布命令仅在完整源码 checkout/ZIP 中提供。清洁验收还会解压源码 ZIP，在独立目录初始化 Git、执行 `npm ci`、发布清单检查及完整 Node 测试，证明不依赖维护者的上级工作区。可用 `RELEASE_TMPDIR` 或 `QA_OUTPUT_DIR` 指定临时目录。归档带有生成时间信息，不宣称两次构建的压缩字节完全一致；每次产物按其校验和验证。
+
+构建与审核之间如有任何源码修改，重新构建并执行清洁安装。不要上传历史工作区的旧 ZIP。
+
+## 4. GitHub 与 npm
+
+将经过审阅的源码提交到 `pyyxzi/dsh-deepmoyu`，确认 CI 结果后再创建对应版本标签和 Release。可以附加上一步的两个归档、校验和与审查记录。不要把 `release/` 归档作为源码提交进去。
+
+npm 发布需要该包的发布权限和 registry 要求的认证。确认账号、版本、归档和发布目标后，再执行：
+
+```sh
+npm whoami --registry=https://registry.npmjs.org
+npm publish ./release/dsh-deepmoyu-<版本>.tgz --registry=https://registry.npmjs.org --access public
+```
+
+发布完成后查询指定版本的 `dist.integrity`、`dist.shasum` 和仓库信息，下载 registry tarball 并核对内容；本地构建通过不能替代发布后检查。npm 版本不可覆盖，不应为发布失败临时篡改归档内容。
+
+## 5. 插件市场
+
+按 2026-10-29 核对的官方贡献规则，将本仓库的
+`marketplace/pyyxzi__dsh-deepmoyu.yml` 复制到目录仓库的
+`data/plugins/pyyxzi__dsh-deepmoyu.yml`，提交只涉及该条目的 PR。
+
+需核对：
+
+- 目标仓库公开可访问、创建至少满一天、仍在维护，并有 `dsh-plugin` topic。
+- `package.json` 具有 `dsh.bundle`，声明的 patch 存在且能加载。
+- 条目 URL、名称和代码仓库一致，功能描述客观准确，分类符合实际用途。
+- 图标是 GitHub 托管的位图；根 `screenshots.json` 指向仓库内 1–8 张真实界面截图。
+- 若条目已存在，更新该条目，不创建重复项。不要手改目录仓库自动生成的 README，也不要添加不支持的 `npm:` 字段。
+
+npm 发布不是收录前提，也不会自动创建条目。目录 CI 与维护者审核是外部流程；本地打包不能证明已收录。
+
+规则来源：
+
+- DSH 插件打包文档：<https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/develop/basic/publish.md>
+- 市场贡献指南：<https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md>
+
+提交前重新读取外部指南，以其当时规则为准。
+
+### 本轮查询的外部状态
+
+2026-10-29（北京时间）查询显示，本仓库公开、未归档、默认分支为 `main`，已有 `dsh-plugin` topic；目录中尚无本仓库条目。GitHub 返回的创建时间为 **2026-10-28 05:18:16 UTC**，因此满足“创建满一天”的最早时间为 **2026-10-29 13:18:16（北京时间）**。在此之前可准备并上传源码及发布包，市场目录的年龄门禁仍会拒绝提审。该状态是查询时快照，不是已收录声明。

package/docs/TEST_MATRIX.md

@@ -0,0 +1,77 @@
+# 功能与验收矩阵
+
+本表对应 2.4.2。完整结果和环境边界见 [发布审查记录](RELEASE_AUDIT.md)。测试中的“发送成功”是受控 MCP 的包装器契约，不代表向真实账号发送过内容。
+
+## 全部角色工具
+
+`tests/tool-surface.test.mjs` 保存可执行的 `TOOL_SURFACE_EVIDENCE`。它校验注册工具清单与正向执行集合完全相等，并逐项核对有意义的输入、准确下游调用和返回字段；另外对全部工具执行普通模式和退出后的旧句柄拒绝检查。
+
+| 工具 | 已验证的功能 |
+| --- | --- |
+| `bili_whoami` | 登录身份读取、完整长 MID |
+| `bili_search` | 关键词、排序、范围/数量边界、已读过滤 |
+| `bili_subtitle` | 字幕原文、时间参数、成功后已读记录 |
+| `bili_danmaku` | 数量上限、时间聚合、样本与跳转 |
+| `bili_buzzwords` | 热词、热度和图片字段映射 |
+| `bili_video_info` | BV、作者、分 P、长 CID |
+| `bili_rank` | 分区与榜单时间、已读过滤 |
+| `bili_hot_videos` | 分页、上限与已读过滤 |
+| `bili_user_videos` | 长 UID、分页、排序、关键词 |
+| `bili_seen` | 补记与再次查询命中 |
+| `bili_received_replies` | 长 rpid/root、回复资格 |
+| `bili_my_notices` | 点赞、@ 与条数上限 |
+| `bili_learn` | 新增待审、工具不能自行批准 |
+| `bili_records` | 活动来源、稳定事件标识 |
+| `bili_soul` | 指定章节追加和读回 |
+| `bili_taste` | 统计与样本不足状态 |
+| `bili_my_dynamics` | 动态列表、长 ID、评论状态 |
+| `bili_opus_comments` | 长动态/评论标识与回复资格 |
+| `bili_my_video_comments` | 视频/评论数量限制与本人评论排除 |
+| `bili_reply_opus` | 开关允许后的受控发送与精确目标 |
+| `bili_dm_inbox` | 收件箱、长 UID/消息序号、资格 |
+| `bili_dm_thread` | 对话目标、消息数与消息标识 |
+| `bili_dm_reply` | 当前资格核对、精确 UID/序号发送 |
+| `bili_deliver` | 向已人工配置的目标投递 |
+| `bili_comments` | 评论数量、正文、长评论/作者标识 |
+| `bili_sticker` | 图库列表；上传/审核另有专项 |
+| `bili_reply` | 评论包装器、纯文字与 BV 发送 |
+| `bili_status` | 登录、权限、长 UID 与运行状态 |
+| `bili_pace` | 指定通道的只读节奏状态 |
+| `bili_say` | 有效旁白记录及来源关联 |
+| `bili_run` | 受控后台启动与结束 |
+| `bili_feiyu` | 建立、查询、暂停、恢复与清理自有目标 |
+| `bili_pv` | 成片、制作任务及会话列表；制作另有实渲染 |
+| `bili_moment` | 已授权后的受控动态发送 |
+| `bili_login_start` | 本轮二维码与 key |
+| `bili_login_poll` | 当前二维码完成与凭证私密持久化 |
+| `bili_setup` | 安装流水线完成与真实运行校验状态 |
+| `bili_config` | 安全偏好修改；人工授权字段不能被模型改变 |
+
+## 深层专项
+
+| 功能范围 | 主要自动证据 |
+| --- | --- |
+| 模式、旧句柄与全局服务别名 | `mode-scope.test.mjs`、`tool-scope-alias.test.mjs`、`host-tool-scope.test.mjs`、两项人格/goal QA |
+| 普通宿主会话不受影响 | `host-bundle-smoke.mjs` 真实 bundle/预设声明组合与回环模型普通请求 |
+| 新会话、工作区和有效权限 | `pet-session.test.mjs`、`pet-run-routes.test.mjs`、`pet-run-settings.test.mjs` |
+| 后台桥接、取消、计量 | `background-tools.test.mjs`、`model-relay.test.mjs`、`manual-browsing.test.mjs`、真实 headless relay |
+| 时段、定时与恢复 | `automation*.test.mjs`、`background-window.test.mjs`、`product-status*.test.mjs` |
+| 配置事务、授权与防护 | `config-safety.test.mjs`、`authorization.test.mjs`、`send-review-routes.test.mjs` |
+| 登录与环境升级 | `login.test.mjs`、`python-env.test.mjs`、`install-routes.test.mjs` |
+| 真实 Python MCP | `check-real-mcp.mjs`，实际 FastMCP 握手与本地 SQLite 守卫 |
+| 节奏、永久判重及发送复核 | `pace*.test.mjs`、`dup-cross-channel.test.mjs`、`reply.test.mjs`、`verify*.test.mjs`、`test_guard_cross_channel.py` |
+| 端到端长 ID | `mcp-ids.test.mjs`、`tool-surface.test.mjs`、`check-dm-uid-browser.cjs` |
+| 学习、记忆与隐私 | `memory-chain.test.mjs`、`memory-center*.test.mjs`、`background-output.test.mjs` |
+| 表情与图片 | `sticker*.test.mjs`、`test_reply_pictures.py`；包括格式、字节审核、公开地址、容量、取消和并发 |
+| 账本、回顾与陪伴 | `token-ledger.test.mjs`、`product-status*.test.mjs`、`companion*.test.mjs` |
+| 视频编排、终态与媒体 | `pv-*.test.mjs`、`test_pv_*.py`、实际配音/封面/渲染/校验全链 |
+| 可选 ASR 与收藏边车 | `test_optional_sidecars.py`：本地输入保留、独占清理、同视频并发、参数与失败；外部服务为 fake |
+| 桌宠与全部页面 | `check-ui.cjs`、六项浏览器 QA，含十个主/子页、三视口、菜单、记忆、请求竞态与 UID |
+| 下载与供给链 | `uvfetch.test.mjs`、实际官方 uv 下载/校验；npm 与主 Python 依赖审计 |
+| 分发完整性 | `release-contract.test.mjs`、`test_release_archives.py`、`release:check/build/smoke` |
+
+## 边界
+
+- 代码行覆盖率不等于所有行为都已验证；矩阵与实际结果分别保留，不用测试总数替代功能证明。
+- 真实平台发送、私人账号登录、GPU/用户自配音色和大型 Whisper 模型的识别质量，不通过本轮自动测试冒充验证。
+- 目录打开已测三个平台的进程参数与故障行为，本机以外桌面未实机测试；GitHub CI 配置不等于远程 CI 已经运行。

package/docs/assets-permissions.json

@@ -0,0 +1,20 @@
+{
+  "confirmedForRedistribution": true,
+  "status": "maintainer-attested",
+  "confirmedOn": "2026-10-29",
+  "basis": "The maintainer confirmed that these images are original or authorized for public redistribution and requested retaining the existing character artwork.",
+  "files": [
+    "assets/pet/pet.png",
+    "assets/avatar/bust.png",
+    "assets/avatar/face.png",
+    "assets/avatar/fish.png",
+    "assets/avatar/wide.png"
+  ],
+  "sha256": {
+    "assets/pet/pet.png": "263095b67bf3ba12cf165d30837c0c047350c999747c4a7a6a013712527a73db",
+    "assets/avatar/bust.png": "9c2e40aeea23bbebed32acca3f38d0b6eb90a30a24ea3d60d351dd67b2edf2dc",
+    "assets/avatar/face.png": "6e7e52685022a2a864ae85ca37bc09d92e3fe5d4be413e8f72d990f8e05a41e2",
+    "assets/avatar/fish.png": "82caa6641025e186077c20d58e7ba8c0c29b2fbc5a3638dbd02fce4fc13273e1",
+    "assets/avatar/wide.png": "3583a065a21640c03b990cc1b6b28ed1c3284cdb5d2a42cd8bd1a9237592873e"
+  }
+}

package/docs/tool-evidence.json

@@ -0,0 +1,196 @@
+{
+  "version": "2.4.2",
+  "scope": "Isolated positive contracts, not real platform sends",
+  "tools": [
+    {
+      "tool": "bili_whoami",
+      "category": "readonly",
+      "specialist": "login.test.mjs"
+    },
+    {
+      "tool": "bili_search",
+      "category": "readonly",
+      "specialist": "manual-browsing.test.mjs"
+    },
+    {
+      "tool": "bili_subtitle",
+      "category": "readonly",
+      "specialist": "manual-browsing.test.mjs"
+    },
+    {
+      "tool": "bili_danmaku",
+      "category": "readonly",
+      "specialist": "tool-surface.test.mjs"
+    },
+    {
+      "tool": "bili_buzzwords",
+      "category": "readonly",
+      "specialist": "manual-browsing.test.mjs"
+    },
+    {
+      "tool": "bili_video_info",
+      "category": "readonly",
+      "specialist": "tool-surface.test.mjs"
+    },
+    {
+      "tool": "bili_rank",
+      "category": "readonly",
+      "specialist": "manual-browsing.test.mjs"
+    },
+    {
+      "tool": "bili_hot_videos",
+      "category": "readonly",
+      "specialist": "manual-browsing.test.mjs"
+    },
+    {
+      "tool": "bili_user_videos",
+      "category": "readonly",
+      "specialist": "tool-surface.test.mjs"
+    },
+    {
+      "tool": "bili_seen",
+      "category": "local",
+      "specialist": "memory-chain.test.mjs"
+    },
+    {
+      "tool": "bili_received_replies",
+      "category": "readonly",
+      "specialist": "reply.test.mjs"
+    },
+    {
+      "tool": "bili_my_notices",
+      "category": "readonly",
+      "specialist": "memory-chain.test.mjs"
+    },
+    {
+      "tool": "bili_learn",
+      "category": "local",
+      "specialist": "memory-center-routes.test.mjs"
+    },
+    {
+      "tool": "bili_records",
+      "category": "local",
+      "specialist": "memory-chain.test.mjs"
+    },
+    {
+      "tool": "bili_soul",
+      "category": "local",
+      "specialist": "memory-center-routes.test.mjs"
+    },
+    {
+      "tool": "bili_taste",
+      "category": "local",
+      "specialist": "memory-chain.test.mjs"
+    },
+    {
+      "tool": "bili_my_dynamics",
+      "category": "readonly",
+      "specialist": "tool-surface.test.mjs"
+    },
+    {
+      "tool": "bili_opus_comments",
+      "category": "readonly",
+      "specialist": "dup-cross-channel.test.mjs"
+    },
+    {
+      "tool": "bili_my_video_comments",
+      "category": "readonly",
+      "specialist": "reply.test.mjs"
+    },
+    {
+      "tool": "bili_reply_opus",
+      "category": "send",
+      "specialist": "send-review-routes.test.mjs"
+    },
+    {
+      "tool": "bili_dm_inbox",
+      "category": "readonly",
+      "specialist": "background-tools.test.mjs"
+    },
+    {
+      "tool": "bili_dm_thread",
+      "category": "readonly",
+      "specialist": "manual-browsing.test.mjs"
+    },
+    {
+      "tool": "bili_dm_reply",
+      "category": "send",
+      "specialist": "background-tools.test.mjs"
+    },
+    {
+      "tool": "bili_deliver",
+      "category": "send",
+      "specialist": "send-review-routes.test.mjs"
+    },
+    {
+      "tool": "bili_comments",
+      "category": "readonly",
+      "specialist": "sticker-routes.test.mjs"
+    },
+    {
+      "tool": "bili_sticker",
+      "category": "local",
+      "specialist": "sticker-review-routes.test.mjs"
+    },
+    {
+      "tool": "bili_reply",
+      "category": "send",
+      "specialist": "send-review-routes.test.mjs"
+    },
+    {
+      "tool": "bili_status",
+      "category": "local",
+      "specialist": "product-status-routes.test.mjs"
+    },
+    {
+      "tool": "bili_pace",
+      "category": "local",
+      "specialist": "pace-routes.test.mjs"
+    },
+    {
+      "tool": "bili_say",
+      "category": "local",
+      "specialist": "manual-browsing.test.mjs"
+    },
+    {
+      "tool": "bili_run",
+      "category": "worker",
+      "specialist": "pet-run-routes.test.mjs"
+    },
+    {
+      "tool": "bili_feiyu",
+      "category": "goal",
+      "specialist": "pet-run-routes.test.mjs"
+    },
+    {
+      "tool": "bili_pv",
+      "category": "local",
+      "specialist": "pv-session-routes.test.mjs"
+    },
+    {
+      "tool": "bili_moment",
+      "category": "send",
+      "specialist": "send-review-routes.test.mjs"
+    },
+    {
+      "tool": "bili_login_start",
+      "category": "login",
+      "specialist": "login.test.mjs"
+    },
+    {
+      "tool": "bili_login_poll",
+      "category": "login",
+      "specialist": "login.test.mjs"
+    },
+    {
+      "tool": "bili_setup",
+      "category": "installer",
+      "specialist": "install-routes.test.mjs"
+    },
+    {
+      "tool": "bili_config",
+      "category": "local",
+      "specialist": "authorization.test.mjs"
+    }
+  ]
+}