如何安装dsh和大肥鱼插件

不知道什么是agent 请看 https://llmood.cn/tutorials/tutorial-mvx74nvz

大肥鱼 · 完整安装步骤（本机实录）

这套是按这台机器（Windows 11，装在 E:\llmood\dsh）实际走过的步骤整理的。换机重装按顺序做即可；每一步都有对应的脚本或文件。

0. 先决条件

项	要求	本机
系统	Windows 10/11 x64	Windows 11 Pro
Node（DSH 自带即可，插件安装需要）	≥ 22.13	24.x
磁盘	至少 5 GB（DSH + 插件 + 素材）	E 盘
网络	能访问 npmjs 和 github	✅

1. 装 DSH NEXT（主程序）

从 github.com/anywhere-labs/dsh-desktop/releases 下载 DSH-NEXT-<版本>-x64-Portable.zip（免安装版）
解压到 E:\llmood\dsh\app，入口是 DSH NEXT.exe
先启动一次，让它生成 %USERPROFILE%\.dsh，然后完全退出

官方也提供 Setup.exe，但那是装到系统目录；便携版才能"装在当前目录"。

setx DSH_DESKTOP_NEXT_HOME "E:\llmood\dsh"

设完重新启动 DSH，之后所有数据（profile、日志、会话、凭据）都在 E:\llmood\dsh 下：

E:\llmood\dsh\
  profiles\desktop\   ← 插件和配置
  logs\               ← desktop-next.log
  sessions\ storages\ bili-duty\ 作品\ 素材\ ...

坑：不能把 %USERPROFILE%\.dsh\profiles\desktop 做成目录联接指向这里，主程序会报 Next profile path must be a real directory 拒绝启动。必须用环境变量。

3. 装插件（6 个）

profile 目录：E:\llmood\dsh\profiles\desktop

package.json 的 dependencies 和 dsh.profile.bundles：

{
  "name": "dsh-profile-desktop",
  "private": true,
  "dependencies": {
    "dsh-dafeiyu": "0.1.23",
    "dsh-video-skin": "0.1.5",
    "dsh-dafeiyu-life": "2.5.4",
    "dsh-im-style-fatfish": "0.1.0",
    "dsh-douyin-browser-local": "1.4.6",
    "dsh-image-gen": "0.10.0"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "@deepseek-ai/dsh-experimental-plugin-market-bundle",
        "@agents-anywhere/dsh-bridge-next",
        "dsh-dafeiyu", "dsh-video-skin", "dsh-dafeiyu-life",
        "dsh-im-style-fatfish", "dsh-douyin-browser-local", "dsh-image-gen"
      ]
    },
    "desktopNextPlugins": 1,
    "desktopNextScheduleBundle": 2
  }
}

安装：

corepack pnpm --dir "E:\llmood\dsh\profiles\desktop" install

装完完全退出 DSH 再打开。

4. 配置（`profiles\desktop\cordis.patch.yml`）

生图（dsh-image-gen）

- id: image-gen
  name: dsh-image-gen
  config:
    provider: openai-compat
    openaiCompatBaseURL: https://api.openlux.ai/v1
    openaiCompatModel: gpt-image-2.5-sunburst-c
    openaiCompatChannels:
      - id: channel-mvuojbii-jt4s2
        label: OpenAI 兼容 2
        keyRef: DSH_IMAGE_GEN_OPENAI_COMPAT_KEY_CHANNEL_MVUOJBII_JT4S2
        baseURL: https://api.openlux.ai/v1
        model: gpt-image-2.5-sunburst-c
    openaiCompatActiveChannel: channel-mvuojbii-jt4s2

Base URL 必须带 /v1；如果报 requires a base URL，说明只写了渠道没写扁平字段。

IM 头衔（dsh-im-style-fatfish）

- id: im-style-fatfish
  name: dsh-im-style-fatfish
  config:
    classifier: llm
    classifierModel: deepseek-flash

不想每轮多调一次模型就设 classifier: off。

5. 打补丁（三个，都是"官方更新后要重放"的）

补丁	解决的问题	怎么打	怎么回滚
`_setup\life-tools-patch`	DSH 0.2.x 的 `defineTool` 要求 `output`，插件 7 个工具挂不上	双击 `应用工具补丁.cmd`	`回滚工具补丁.cmd`
`_setup\pet-actions`	给桌宠加自主动作（96 个），从上游 webm 取帧	双击 `应用动作补丁.cmd`	`回滚动作补丁.cmd`
`_setup\helper-patch`	桌宠右键菜单加「播放动作」+ 控制口 7799	双击 `应用右键菜单补丁.cmd`	`回滚右键菜单补丁.cmd`

每个补丁打完都要完全退出 DSH 再打开。官方升级或 pnpm install 重装后，补丁会失效，重跑一次即可。

5.1 动作补丁：96 个动作怎么来的

上游 PC2005-cloud/dsh-pet 的 assets/webm/ 共 106 条 webm 动画，收录 96 条成 ext_* 动作，加上官方自带的 8 个一次性动作，可播 104 个。清单在 _setup\pet-actions\apply-pet-actions.ps1 顶部的 $clips 表。

排除的 10 条（别以为是漏了）：

排除的	原因
吃Token / 哈欠连天 / 超大伸懒腰 / 挠痒咯咯笑 / 元气挥手 / 鲸鱼吐泡泡特效 / 雀跃庆祝 / 垂头叹气冒汗 / 待机呼吸休闲	官方 `eat_token` / `idle_yawn` / `idle_stretch` / `head_pat` / `poke` / `tail` / `success` / `error` / `idle` 就是这几条按同样参数转的（除 `error` 是 118 帧的剪裁版，其余 241 帧完全一致），再收一遍是同一段动画播两遍
被鼠标拖拽悬空反馈	helper 自带 `dragging` 状态

对应关系记在 _setup\pet-actions\clips.json。加动作前先查这张表，否则很容易把官方动画又抄一遍。

解码要点：webm 自带 alpha，但 ffmpeg 默认的 vp9 解码器会把它丢掉，解出来是黑底。必须 -c:v libvpx-vp9。出帧参数照官方：crop 100,0、fps 24、412×344，1:1 不缩放。

体积：96 个 ext_* 约 480 MB；加上官方的，整个 assets/pet 是 561 MB / 26580 帧， helper 启动时全部读进内存，常驻约 560 MB。

5.2 改完动作必须做的两件事

删缓存 %LOCALAPPDATA%\dsh-dafeiyu\<版本>\assets。插件只在 assets/pet-manifest.json 缺失时才重拷素材，不删就一直读旧帧——改了等于没改。 apply-pet-actions.ps1 和 apply-helper-menu.ps1 现在都会自动删。
重建 helper exe（跑 应用右键菜单补丁.cmd）。菜单逻辑和控制口都在 exe 里，只更新包内 manifest 不重建 exe，/health 还会返回旧列表。

验证：

Invoke-RestMethod http://127.0.0.1:7799/health | Select-Object -ExpandProperty clips

返回 104 个就是对的。

helper 不内嵌资产：runtime/asset_paths.py 先找 exe 同级的 assets/（缓存目录里就有），再找包根的 assets/。所以打包时不要 --add-data assets——内嵌 500 MB 会让 exe 膨胀到 600 MB、打包半小时。现在产物 44.5 MB，31 秒打完。

6. 填凭据

见 _setup\凭据清单.md。概要：

文件	内容	从哪拿
`_setup\video\studio.key`	工作流出片（GPU 云）	studio.aigate.cc/dashboard/token
`_setup\video\aigate.key`	算力 / ComfyUI API	waas.aigate.cc → 开发选项 → 令牌管理
`_setup\video\speech.apikey` + `speech.appid`	豆包音频生成	豆包语音控制台
`_setup\video\ark.key`	火山方舟（备用）	方舟 → API Key 管理
`E:\llmood\dsh\.credentials.yaml`	生图 key	DSH 插件页里填

7. 登录

B 站：设置 → 大肥鱼 → 扫码登录（建议小号），凭证写进 bili-duty\bili_credential.json
抖音：设置 → 刷抖音 → 打开抖音，在专用 Edge 窗口里扫码（独立 profile，不共用日常 Edge）

8. 验证

完全退出 DSH，重新打开
看日志 E:\llmood\dsh\logs\desktop-next.log，确认无 工具挂载失败
设置页里能看到：大肥鱼、刷抖音、插件列表里的 6 个插件
桌宠出现，右键有「播放动作」

9. 备份与回滚

# 备份 profile
Copy-Item "E:\llmood\dsh\profiles\desktop\package.json" "$env:TEMP\package.json.bak"
Copy-Item "E:\llmood\dsh\profiles\desktop\cordis.patch.yml" "$env:TEMP\cordis.patch.yml.bak"

回滚：备份覆盖回去 → pnpm install → 重启 DSH；各补丁用各自的回滚脚本。

附：素材与产出位置

大肥鱼的家\
  素材\参考图\角色-大肥鱼-高清.png   角色参考（1024×1536）
  素材\音频\大肥鱼-音色.mp3          固定音色（只锁音色）
  灵感\                              文案、分镜、每幕提示词
  作品\<日期>-<主题>\                 shots\ 正片 字幕 成片
  视频工作流.md                      出片流程手册

出片工具：_setup\video\（batch-shots.mjs 出镜头、seed-audio.mjs 配音、studio-workflow.mjs 查任务）。