前言¶

在 DeepSeek Harness（DSH）里做 B 站相关能力时，常见做法是堆「自动发帖」脚本：搜视频、生成文案、直接发出去。一旦 agent 误发、越权用他人素材，或没有可复查的学习记录，运维成本会落在人身上。社区插件 dsh-bili-whale-studio（大肥鱼工作室，维护者 DorododoG11）把「学、声、发」拆成三条可单独验证的链路，发布默认进草稿箱、需人批准后才调用发布工具。下面介绍它的定位、能力与安装用法；事实以 GitHub 仓库 README 为准。目录页：SkillHub · bili-whale-studio（社区站点，与 DeepSeek / 幻方无官方从属关系）。

这是什么¶

dsh-bili-whale-studio 是 DSH 工作流类插件（package 名 dsh-bili-whale-studio，当前资料中版本 0.2.0，MIT 许可证）。一句话：让 agent 在 B 站自学、整理自己的声音、把内容做成动态和视频——发出去之前必须过草稿箱。它不是「又一个自动发帖机」；B 站操作走 bili-cli（bili 命令），音视频走 ffmpeg，语音默认走系统 SAPI，插件负责编排、留痕和兜底。

本地数据默认落在 ~/.dsh/bili-studio/（学习笔记在 knowledge/，音色在 voices/，草稿在 drafts/）。

核心功能¶

学：教程检索与笔记落盘¶

studio_learn 支持 search 找教程、fetch 看全一条视频。fetch 会把整条视频的原始数据存成 json，笔记可经 studio_note 的 save / list / read 写成带 frontmatter 的 md。写动态时用 studio_note action=list 检索已学内容，避免重复看片。

声：边界明确的音色与风格¶

studio_voice 提供 pull / list / remove / ref / voices / tune 等 action。pull 只接受：配置里自己号的 self.mid（见 ~/.dsh/bili-whale.config.json）、config.allowedOwnerMids 中列出的 mid，或调用时显式 authorized=true（来源记入 meta.json）；他人视频一律拒绝。若要「像」某种说话方式，可用 studio_style action=analyze 从字幕统计语速、句长、标点与口头禅，存风格卡，再用自己的声音配合 tune 参数演绎。

studio_say 把文字转成 wav；studio_video 用图片与配音合成 1080p mp4（合成参数见配置中的 compose）。

发：草稿 → 批准 → 发布¶

草稿状态单向流转：draft → approved → publishing → published。requireApproval 默认开启时，未 approved 的草稿调用 studio_publish 会报错。另有每日配额（按 publish-log.jsonl 记账）、投稿强制 AI 声明、失败也记账等约束。studio_queue 管理草稿（new / list / show / preview / approve / reject）；studio_publish 只认已批准草稿；studio_history 查发布记账。

装好后可在 DSH 设置 → 工作室 面板查看队列与配额，对待批准草稿点批准或打回；界面经 /dsh-studio/api/* 与 studio_* 工具读写同一份磁盘状态，信任栅栏不可用时按拒绝处理（fail-closed）。

自检¶

studio_status 检查 B 站是否登录、ffmpeg 是否可用、当日剩余发布条数、本地库存概况。

安装与启用¶

前提（README 原文）：

• DSH ≥ 0.4
• bili CLI 已登录（bili auth status 返回 logged_in: true）
• 系统已安装 ffmpeg

安装步骤来自仓库 README，不是 dsh plugin add github:... 一类拼接命令：

# 1. 放到任意工作目录
git clone <this-repo> bili-studio && cd bili-studio

# 2. 装进当前 profile（DSH 会自己 apply patch）
#    在 DSH 里对 agent 说：
#    「把 C:\path\to\bili-studio 作为 bundle 安装到当前 profile」
#    或直接调用 plugin_manager install_bundle(target: <绝对路径>)

装完后调用 studio_status 应能回答登录、依赖、配额与本地库存。

首次运行生成 ~/.dsh/bili-studio/config.json，修改后无需重启（每次调用重读）。示例字段（节选）：

{
  "biliPath": "C:\\Users\\you\\.local\\bin\\bili.exe",
  "ffmpegPath": "C:\\Users\\you\\.dsh\\bili-whale\\bin\\ffmpeg.exe",
  "maxPublishPerDay": 3,
  "requireApproval": true,
  "allowedOwnerMids": [],
  "voice": {
    "engine": "sapi",
    "sapiVoice": "Microsoft Huihui Desktop",
    "rate": 0,
    "pitch": 1.0,
    "cloneCommand": ""
  },
  "compose": { "width": 1920, "height": 1080, "fps": 30 }
}

voice.engine = "command" 时可接外部「文本文件进、wav 出」的命令行 TTS；模型与引擎由自行部署，插件不代下载。

典型用法¶

README 给出的一条完整链路如下（BV 号需替换为真实视频）：

studio_learn  search  "DeepSeek Harness 插件"
studio_learn  fetch   BV1xxxx
studio_note   save    title="DSH 插件的最小骨架"  body="……"
studio_say    text="今天学了插件骨架……"  pitch=1.06
studio_video  audio=out/say-xxx.wav  images=["cover.png"]
studio_queue  new     kind=video title="……" tags=["DSH"] video=out/video-xxx.mp4
studio_queue  preview id=dr_xxx
studio_queue  approve id=dr_xxx
studio_publish id=dr_xxx

工具一览（与 README 表一致）：studio_status、studio_learn、studio_note、studio_voice、studio_style、studio_say、studio_video、studio_queue、studio_publish、studio_history。

适用场景与注意¶

适合谁： 希望在 DSH 里用 agent 系统学 B 站教程、把笔记与成片留在本地、且发布前必须人工过稿的开发者或创作者。

权限与安全： 插件以当前 DSH 进程权限运行；安装前应阅读源码与 MIT 许可证，确认 bili 凭据路径（插件只读 ~/.bili-ai/credentials.json，不复制、不回显）。数据默认不上传，均在 ~/.dsh/bili-studio/。

明确不做的事（v0.1）： 直播推流（依赖 bili 能力与后续版本规划）；声纹克隆；自动点赞/投币/评论等仍受 bili-cli 自身规则约束。

生态： DSH 理念是「一切皆插件」；本插件通过 bundle + patch 接入，与社区目录条目一致归类为工作流。

结尾¶

dsh-bili-whale-studio 把 B 站自学、本地笔记、可控音色与「草稿经人点头才发」绑在同一套 studio_* 工具与工作室面板上，适合不想把账号完全交给自动发帖链路的 DSH 用户。进一步了解请查看 SkillHub 目录页 与 GitHub：DorododoG11/bili-whale-studio。