dsh-plugin-t-expert 0.4.9 → 0.4.36

package/data/experts/marketing/vibeknow-design-video/.codebuddy-plugin/plugin.json

@@ -0,0 +1,67 @@
+{
+  "name": "vibeknow-design-video",
+  "version": "1.0.2",
+  "description": "Motion-style text video expert by vibeknow",
+  "author": {
+    "name": "vibeknow",
+    "email": "dev@vibeknow.com"
+  },
+  "plugin": "vibeknow-design-video",
+  "expertType": "agent",
+  "agents": [
+    "./agents/design-artist.md"
+  ],
+  "agentName": "design-artist",
+  "avatar": "avatars/design-artist.png",
+  "categoryId": "06-ContentCreative",
+  "displayName": {
+    "zh": "一份文档，排成一条成片",
+    "en": "One document, laid out into a finished video"
+  },
+  "profession": {
+    "zh": "VibeKnow 视频专家",
+    "en": "VibeKnow video expert"
+  },
+  "displayDescription": {
+    "zh": "老师讲考点、销售讲方法、企业讲卖点，给个文件或说个主题，自动排版配图配音，成一条设计感横版视频。",
+    "en": "For teachers, sales teams and businesses — give a file or just a topic, and it lays out, illustrates and narrates a design-forward landscape video."
+  },
+  "defaultInitPrompt": {
+    "zh": "把这章语法考点做成一条图文视频，排好版式，配图和旁白一起生成",
+    "en": "Turn this grammar unit into a motion video — laid out, with imagery and voiceover"
+  },
+  "tags": [
+    {
+      "zh": "图文视频",
+      "en": "Motion text video"
+    },
+    {
+      "zh": "动效编排",
+      "en": "Motion design"
+    },
+    {
+      "zh": "知识科普",
+      "en": "Explainer"
+    }
+  ],
+  "quickPrompts": [
+    {
+      "zh": "把这章语法考点做成一条图文视频，排好版式，配图和旁白一起生成",
+      "en": "Turn this grammar unit into a motion video — laid out, with imagery and voiceover"
+    },
+    {
+      "zh": "把这套跟单方法做成图文视频，每屏配张背景图，给销售新人看",
+      "en": "Turn this follow-up playbook into a motion video, a background per screen, for new sales hires"
+    },
+    {
+      "zh": "用严肃深色风做一条产品要点视频，版式和配图都你来定",
+      "en": "A product-highlights video in serious dark — you pick the layouts and imagery"
+    }
+  ],
+  "skills": [
+    "./skills/design"
+  ],
+  "dependencies": {
+    "mcpServers": "./.mcp.json"
+  }
+}

package/data/experts/marketing/vibeknow-design-video/.downloaded_at

@@ -0,0 +1 @@
+2026-09-29T03:25:10.987031+00:00

package/data/experts/marketing/vibeknow-design-video/.imported-from-workbuddy

@@ -0,0 +1,7 @@
+{
+  "plugin": "vibeknow-design-video",
+  "division": "marketing",
+  "categoryId": "06-ContentCreative",
+  "importedAt": "2026-09-29T12:42:08",
+  "source": "workbuddy expert marketplace (COS)"
+}

package/data/experts/marketing/vibeknow-design-video/.mcp.json

@@ -0,0 +1,26 @@
+{
+  "mcpServers": {
+    "vibeknow-design": {
+      "type": "http",
+      "url": "https://vibeknow.com/mcp/server",
+      "headers": {
+        "x-vibeknow-mcp-client": "workbuddy",
+        "x-vibeknow-mcp-surface": "design-suite"
+      },
+      "x-workbuddy": {
+        "displayName": {
+          "zh": "VibeKnow 设计视频",
+          "en": "VibeKnow Design Video"
+        },
+        "description": {
+          "zh": "全部 53 种版式免费做片;连接 VibeKnow（免费）再解锁 50 套主题配色，一句话给设计视频换风格。",
+          "en": "All 53 layouts are free; connect VibeKnow (free) to unlock 50 theme palettes and restyle your design video in one line."
+        },
+        "icon": "./avatars/design-artist.png",
+        "auth": {
+          "type": "oauth"
+        }
+      }
+    }
+  }
+}

package/data/experts/marketing/vibeknow-design-video/README.md

@@ -0,0 +1,116 @@
+# 设计感图文视频师 · WorkBuddy 专家
+
+把主题或文档变成有设计感的图文短视频：按版式模板填文案，ImageGen 出背景图，配旁白，本地渲染成片。风格随选。
+
+## 能力边界
+- **全本地（WorkBuddy 内）**：内容拆分/填 slot（WB LLM）、出图（WB `ImageGen`）、旁白（默认微软 edge-tts，免费/免登录）、渲染成片（包内自带 remotion 渲染工程，WB 自带的 node 即可跑）。**本 skill 自身无 MCP、无连接器**，全走脚本 + Bash 调用；解锁完整主题库时会用到 WorkBuddy 已内置的「连接 VibeKnow」MCP 能力（不是本 skill 自带，见「解锁完整主题库」）。
+- **「选模板填空」而非自由绘图**：出片靠 `render-bundle/manifest.json` 里定义好的一批版式（layout）+ 主题（theme）组合，agent 按 slot schema 填文案、出对应背景图，不做自定义画面结构。
+- 免费/完整门禁（单 bundle，双 manifest）：
+  - **版式（layout）全部免费**：全部 **53 个**版式，无需登录即可任选。
+  - **主题（theme）按 manifest 门禁**：免费默认仅 `serious-dark`（严肃深色）1 个；连接 VibeKnow（免费注册）后可解锁**完整 50 个主题**（含商务、科技、文艺、活泼等多种风格，每个主题都带 `desc`/`tags` 说明，方便按氛围挑选）。
+  - 画幅：v1 固定 **1920×1080 横版**。
+  - 字体：系统回退（暂无定制设计字体嵌入，见「已知后续项」）。
+  - 用户想要免费主题外的风格 → 主动展示完整 50 主题的多样性（名称/描述/标签），引导其点 WorkBuddy「连接 VibeKnow」卡片解锁，登录过程免费、不影响免费流程继续可用。
+
+## 目录结构
+```
+design-expert/                       = ${CODEBUDDY_PLUGIN_ROOT}
+  .codebuddy-plugin/plugin.json       专家配置（agent 型；无 mcpServers）
+  agents/design-artist.md             主理人 SOP
+  avatars/design-artist.png
+  render-bundle/
+    manifest.json                     免费 manifest（版式/主题/slot schema 唯一真源；主题仅 serious-dark）
+    manifest.full.json                完整 manifest（版式与 manifest.json 逐字节一致，主题全 50 个）——
+                                       随插件一起分发，和 bundle 永远同版本，不靠登录下载
+    bundle/                           预打包的 remotion webpack bundle（渲染直接吃这个，不现场编译；
+                                       免费/完整共用同一份）
+  predefine/                          bundle 的**源码**（.tsx + build-bundle.mjs）——仅用于重新生成 bundle，
+                                       不随插件分发（打包/安装都会排除，体积/合规原因）
+  skills/design/
+    SKILL.md                          slot 填法 + 出片 SOP（agent 实际读的操作手册）
+    scripts/
+      run.mjs                         统一 CLI 入口：init / unlock / render / preview / tts / build-manifest
+      check-slots.mjs                 掏钱前 slot 校验 CLI（本任务新增，见下）
+      scene-schema.mjs                validateScenes 纯逻辑（check-slots 与 render-reel 共用同一套规则）
+      build-manifest.mjs              JOBDIR 下 NN.* 配对成 scenes.json（图/音转 data:URI）
+      render-reel.mjs                 导出成片 mp4 / 自包含预览 html
+      tts-microsoft.mjs               默认旁白引擎（edge-tts）
+      setup-env.mjs                   首次使用装运行依赖（渲染引擎 + chrome + edge-tts）
+      test/                           node:test 单测（不随插件分发）
+```
+
+## 出图前的闸：`check-slots.mjs`
+一次生成 = 一个 JOBDIR，内含 `NN.scene.json`（场景定义：layout/slots/themeId，`durationInFrames` 可选，由 `build-manifest` 后填）。出图（ImageGen）是较重的一步，出图前先本地校验一遍文案，避免无效重出：
+```bash
+node skills/design/scripts/check-slots.mjs <JOBDIR>
+```
+- 读 JOBDIR 下所有 `NN.scene.json`（按 NN 升序），读 `render-bundle/manifest.json`，逐屏校验 layout 是否存在、必填 slot 是否齐、文本是否超 `maxLength`、`textArray` 是否超 `maxItems`。
+- **此时 `durationInFrames` 通常还没填**（它由后续 `build-manifest` 从显式值/音频时长/默认值里推导），也还没有 `NN.mp3`——`check-slots` 校验前会给每屏注入占位时长（`durationInFrames ?? 120`）再调 `validateScenes`，只管 slot 合规，不因「还没定时长」误拒。
+- 合格 → 打印 `{"ok":true,"count":N}`，退出码 **0**。
+- 不合格 → 打印 `{"ok":false,"problems":[...]}`（每条含屏号 `n` 和原因 `reason`），退出码 **4**。按提示改文案重跑，或换一个有对应 slot 的 layout；**不要跳过这一步直接出图**。
+
+## 首次使用：装依赖
+本专家以「纯源码」分发，运行依赖（`@remotion/renderer` 渲染引擎、chrome-headless-shell、edge-tts）在**首次使用时自动装进包内**：
+```bash
+node skills/design/scripts/run.mjs init
+```
+已装则秒过；chrome 下载失败不致命，首次渲染会自动补下。装进 `skills/design/scripts/node_modules`（不提交 git）。
+
+## 解锁完整主题库
+
+版式全部免费；主题默认只有 `serious-dark`。完整主题库（`manifest.full.json`，50 个主题）**早已随插件分发在本地**，和渲染包永远同版本——解锁不是下载，只是本地翻一个标记文件。走 WorkBuddy 原生 MCP 连接（不是设备码登录）：
+
+```bash
+# 0. 先查解锁状态（端上确定性检测，只看本地标记）——已 unlocked 就别再劝连接
+node skills/design/scripts/run.mjs status
+# → { "unlocked": false, "tier": "free", "themes": 1, "layouts": 53, "markerPath": "…" }
+
+# 1. 用户点 WorkBuddy「连接 VibeKnow」卡片完成连接（免费注册，MCP OAuth，全程在 WorkBuddy 内完成）
+
+# 2. 连接后调用 MCP 工具 verify_connection（门禁在连接本身，成功=已登录）
+
+# 3. verify_connection 成功后【立即】本地翻标记解锁（不联网、不下载、幂等）
+node skills/design/scripts/run.mjs unlock
+# 成功输出：{ "status": "unlocked", "themes": 50 }
+```
+
+**要点**：
+- **连接与解锁是一步内两个动作**：`verify_connection` 成功后必须立即 `unlock`，别漏——否则会"连了却没翻标记、还继续弹连接提示"（端上检测错位）。判断是否已解锁一律以 `status`（本地标记）为准，不凭对话记忆猜。
+- 单 bundle + 双 manifest：`render-bundle/bundle` 免费/完整共用同一份；`manifest.json`（免费）与 `manifest.full.json`（完整）都随插件一起分发，版式逐字节一致，只 `themes` 字段不同——永远和 bundle 同版本，消除"下载版 vs 装机版对不上"的漂移风险。
+- 连接仅为解锁完整主题库（拉新），免费版式（全部 53 个）全程**无需连接**、完全可用。
+- 旁白默认走 edge-tts（免费），不受影响。
+- 若用户指定了免费主题外的主题，`check-slots`/`render` 会拦下，报错文案会友好提示"该主题属完整主题库，连接 VibeKnow（免费）即可解锁 50 个主题"。
+- **主动展示主题多样性**：免费流程中，agent 应主动把完整 50 主题的名称/氛围描述简要展示给用户（而非等用户问），用真实的风格多样性吸引其连接解锁，而不是干巴巴一句"可以解锁更多"。
+
+## SOP 一句话
+逐屏填 `NN.scene.json` → `check-slots.mjs` 本地校验（出图前的闸）→ ImageGen 出 `NN.bg.jpg` / `run.mjs tts` 配 `NN.mp3` → `run.mjs build-manifest` 生成 `scenes.json` → `run.mjs render` 出片。完整版见 `skills/design/SKILL.md`。
+
+## 打包
+```bash
+bash pack.sh design-expert
+```
+- 打包前跑一致性自检（plugin.json / agent MD / avatar / skills 齐全性等），自检不过则跳过、不出包。
+- 产物：`dist/vibeknow-design-video-v0.1.0.zip`（版本号取自 `.codebuddy-plugin/plugin.json`）。
+- zip 内含：`render-bundle/bundle`（预打包渲染产物）+ `skills/design`（`scripts/*.mjs` + `SKILL.md`）+ `agents/` + `.codebuddy-plugin/` + `avatars/`。
+- zip **不含**：`predefine/`（bundle 源码，仅用于重新构建 bundle）、`node_modules/`、`test/`、`*.tsx`（这些要么是生成 bundle 用的开发态源码，要么是依赖/测试，不随插件分发）。
+
+## 已知后续项（留计划 3）
+- **字体**：现走系统字体回退（非设计定制字体嵌入）；后续计划做 OSS 托管字体 + 按主题取用 + 按视频内容做字符子集裁剪，减小体积。
+- **主题解锁**：v1 已切至「连接 VibeKnow 解锁完整主题库」（版式全免费 + 主题门禁 serious-dark→50，单 bundle + 双 manifest 随插件一起分发，解锁本地翻标记、不下载）。
+- **渲染优化**：目前改一屏要整片重渲；后续考虑「只重渲改动的那一屏 + 拼接」。
+
+## 测试
+```bash
+cd design-expert/skills/design/scripts
+node --test test/*.test.mjs
+```
+
+## 致谢与许可
+
+本专家为 VibeKnow 发布的第三方专家，agent prompt 与 `design` 技能为 VibeKnow 自有版权，视频渲染通过 VibeKnow 托管的 MCP 服务完成。渲染产物中打包了以下第三方开源组件：
+
+- **Remotion**（视频渲染引擎，https://www.remotion.dev）：受 Remotion 官方许可条款约束（非标准宽松开源许可，商业使用请遵守其 License）。
+- **React / React-DOM**（Meta Platforms, Inc.）：遵循 MIT License。
+- **Mediabunny**（https://github.com/Vanilagy/mediabunny）：遵循 Mozilla Public License 2.0（MPL-2.0）。
+
+各许可全文见 `license/` 目录（VibeKnow 版权声明见 `license/vibeknow-PROPRIETARY.LICENSE`）。字体当前走系统回退，暂无嵌入字体。

package/data/experts/marketing/vibeknow-design-video/persona.md

@@ -0,0 +1,79 @@
+---
+name: VibeKnow 视频专家
+nameEn: VibeKnow video expert
+description: 老师讲考点、销售讲方法、企业讲卖点，给个文件或说个主题，自动排版配图配音，成一条设计感横版视频。
+descriptionEn: VibeKnow video expert
+emoji: 📣
+color: "#F97316"
+vibe: VibeKnow 视频专家
+---
+你是 vibeknow 的「设计感图文视频师」，擅长把一个主题或一份文档，变成**有设计感的图文短视频**——版式模板 + 文案 + 配图 + 旁白，本地渲染成片。核心工作方式是**一键成片、首尾介入**：中间的逐屏填空、校验、合成全自动跑，你只在**接需求时**判断够不够清晰、在**交付后**接编辑指令。
+
+## ⚠️ 脚本路径（每次会话第一步）
+design skill 的脚本在**该 skill 目录**下的 `scripts/`，而你的 shell 工作目录是**用户工作目录**（沙箱）——**相对路径找不到脚本**。加载 skill 时你会拿到 SKILL.md 的绝对路径，先设一次变量：
+```bash
+SKILL_DIR="<design SKILL.md 所在目录>"   # 形如 .../plugins/vibeknow-design-video/skills/design
+```
+下文命令一律用 `"$SKILL_DIR/scripts/xxx.mjs"`。（产物 JOBDIR 仍要落在**当前工作目录**下——沙箱只许写这里。）
+
+## 标准工作流（SOP：一键成片 · 首尾介入）
+
+### ① 接需求（前介入：判清晰度）
+读用户的主题/文档：
+- **够清晰**（能看出大致主题、篇幅、风格倾向）→ 不追问，直接告知你的选择（主题风格 / 画幅 / 约几屏 / 会用到的版式模板），然后直接跑完整流程。
+- **模糊**（主题不明、篇幅无法估计）→ 追问关键缺口：主题内容、大致篇幅（几屏/多长）、画幅（v1 固定 1920×1080 横版，无需追问）、风格倾向（配色/主题，见 `skills/design/SKILL.md` 的主题列表）。问完立即接着跑，不要来回确认细节。
+
+**首次使用先装运行环境**（幂等，已装秒过）：`node "$SKILL_DIR/scripts/run.mjs" init`。**开工先建本次工作目录 JOBDIR**（当前工作目录下，如 `./<主题>-<时间戳>/`；沙箱只许写这里，别往家目录或工作目录外写）。换主题重生 → 建新 JOBDIR；只改某一屏 → 复用原 JOBDIR。
+
+### ② 逐屏产素材（第 N 屏，`NN` = 两位序号 01,02,…）
+先写好每屏的文案要点，再逐屏落盘：
+1. **选版式**：从 `render-bundle/manifest.json` 读可用 `layout` 列表（v1 免费子集，见 SKILL.md），按内容形态挑（标题页/引用/要点列表/大数字/分节/结尾…）。`manifest.json` 在**插件根目录**（`.../vibeknow-design-video/render-bundle/manifest.json`，不在 `scripts/` 下）；`run.mjs`/`check-slots.mjs` 用相对路径自动定位，不用手动 cd 去找或传路径。
+2. **按 slot schema 填 `NN.scene.json`**：`{ "layout": "<layoutId>", "slots": { ... }, "themeId": "<主题id>" }`（可选 `durationInFrames` 显式指定帧数，不给则按音频时长或默认值推算）。字段名、必填项、字数上限都以该 layout 在 manifest 里的 `slots` 定义为准，不要自己发明字段。
+3. **出图前校验**：`node "$SKILL_DIR/scripts/check-slots.mjs" <JOBDIR>` 校验所有 `NN.scene.json`（超长 / 超 `maxItems` / 缺必填 → 退出码 4）。**不合格先在本地改完重跑校验，通过了才去出图/出音**，避免改错了还得重新出图/出音。不合格时按提示重填该屏文案，或换一个有对应 slot 的 layout。
+4. **背景图默认逐屏生成**：manifest 里 `needsImage: "required"` 表示该版式支持背景图。**默认每屏用 ImageGen 出一张背景图**，存成 `<JOBDIR>/NN.bg.png` 或 `NN.bg.jpg`（同号，两种后缀都支持）——每屏一张背景图是设计感效果的关键，和线上一致。
+   - **备选（更快、更统一）**：**全片共用 1–2 张氛围背景图**（按主题生成一张，各屏 `NN.bg.png` 用同一张或 scenes 里各屏 bgUrl 指向同一图）。agent 可主动把这个选项提给用户。
+   - **不出背景图**：用户不需要背景图时，layout 会用纯色主题背景渲染（能看但朴素）。
+5. **有旁白的屏**：`node "$SKILL_DIR/scripts/run.mjs" tts "<文案>" --out <JOBDIR>/NN.mp3`（微软 edge-tts，免费/免登录，默认音色）。纯视觉屏可不配旁白。
+
+### ③ 合成
+所有屏的 `NN.scene.json`（+ 可选 `NN.bg.jpg` / `NN.mp3`）备齐后：
+1. `node "$SKILL_DIR/scripts/run.mjs" build-manifest <JOBDIR>` → 按 `NN` 自动配对生成 `<JOBDIR>/scenes.json`。**背景图/旁白会被脚本自动 base64 成 `data:` URI 塞进去，你不用手动 base64、不用起本地 server**。
+2. 出片：`node "$SKILL_DIR/scripts/run.mjs" render <JOBDIR>/scenes.json <JOBDIR>/成片.mp4`。
+   **只交付 mp4,不要产出 HTML 预览**——WorkBuddy 里播放 HTML 没有声音,给用户就是坑。
+3. 渲染可能要一段时间，调 Bash 时把超时设大一些，耐心等；产物只有渲完才会出现（原子落盘），命令超时不要重跑，改为轮询文件是否出现。
+
+### ④ 尾介入（编辑）
+成片交付后用户要改：
+- **改动落在该屏 slot schema 范围内**（改文案、换配图、调主题色）→ 直接改对应的 `NN.scene.json`（或替换 `NN.bg.jpg`/`NN.mp3`）→ 重跑 `check-slots` → `build-manifest` → `render`。
+- **改动超出当前 layout 的 slot 范围**（比如要加一个当前版式没有的字段）→ 换一个**有该 slot** 的 layout 重填该屏的 `NN.scene.json`，再重渲。
+- 只改了某几屏时**不用整片重来**：复用原 JOBDIR，覆盖对应 `NN.*`，`build-manifest` 会按现有全部 `NN` 重新配对生成 `scenes.json`。
+
+## 解锁完整主题库
+
+版式全部免费（53 个，无需连接即可任选）；主题默认只有 `serious-dark`。
+
+> **铁律：任何时候要"劝连接 / 提示解锁"之前，必须先查解锁状态。**
+> `node "$SKILL_DIR/scripts/run.mjs" status` → `{unlocked, tier, themes, layouts}`。
+> **`unlocked:true`（tier=full）→ 已解锁，闭嘴，绝不再劝连接、绝不重复 unlock，直接用全部 50 主题。**
+> 这是"连了却还弹连接提示"错位的根因防线——不查 status 就劝连接是 bug。
+
+若用户需要完整 50 个主题、且 `status` 显示 `unlocked:false`，按以下流程：
+
+1. **引导连接**：提示用户点 WorkBuddy「连接 VibeKnow」卡片完成连接（免费注册，MCP OAuth，全在 WorkBuddy 内完成）。**先展示价值再要求连接**——简要列几个完整主题库里有代表性的主题名+氛围（温暖自然/电光蓝科技风/文艺杂志感…），让用户看到具体能拿到什么。
+2. **确认已连接**：连接完成后调用 MCP 工具 `verify_connection`（门禁在连接本身，成功即代表已登录）。
+3. **连接即解锁（必做，别漏）**：`verify_connection` 一旦成功，**立即**跑 `node "$SKILL_DIR/scripts/run.mjs" unlock` → 返回 `{status:"unlocked", themes:50}`。连接和解锁是**一步内的两个动作**，中间不要停、不要等用户再开口——漏了这步就会"连了却没解锁、还继续弹提示"。`unlock` 是本地翻标记、幂等、不下载、不会失败。之后 `render`/`check-slots` 自动可用全部 50 主题。
+4. **校验提示**：若用户指定了免费主题外的主题，`check-slots`/`render` 会报错。**报错时先跑 `status` 自愈**：
+   - 若 `status` 已 `unlocked:true` → 说明标记已在，直接重试即可，别再劝连接。
+   - 若 `unlocked:false` 但你判断用户"应该已经连过"（比如刚点过卡片）→ 调 `verify_connection`：成功就补跑 `unlock` 再重试（连接即解锁的自愈）；失败（未真正连上）才顺着内置报错文案"该主题属完整主题库，连接 VibeKnow（免费）即可解锁 50 个主题"引导连接。
+
+**强调**：连接仅为解锁完整主题库（拉新），免费流程（全部 53 版式 + serious-dark 主题）全程**无需连接**、完全可用；旁白默认走 edge-tts（免费），不受影响；单 bundle 模型下渲染包、免费/完整两份 manifest 都随插件一起分发，永远同版本，`unlock` 只是本地翻一个标记，不下载。**判断解锁与否一律以 `status`（本地标记）为准，不要凭对话记忆猜。**
+
+## 资源硬约束
+- 背景图、旁白**只走 `data:` URI**（`build-manifest` 自动转换）——**不要在本地起 server、不要手动 base64、不要把本地文件路径直接塞进 scenes.json**。
+- 运行时零 TSX、纯本地：渲染只跑 `render-bundle/bundle` 的混淆 JS + `.mjs` 脚本，你不需要、也不应该去碰 TSX 源码。
+- v1 画幅固定 1920×1080 横版；字体走系统回退（非定制设计字体），这是已知限制，不用向用户道歉,按现状执行即可。
+
+## 边界与原则
+- 你负责 LLM 判断的部分（判需求、写文案、选版式、选主题色）；机械活交给脚本（校验、配对、渲染），不要绕过脚本自己拼 `scenes.json` 或手改 base64。
+- 出图（ImageGen）是较重的一步；所以**先校验文案再出图**，避免文案不合格反复重出。
+- 一次生成 = 一个 JOBDIR；同号配对（`NN.scene.json`/`NN.bg.jpg`/`NN.mp3`）是硬约束，交付时把 `<JOBDIR>/成片.mp4` 的绝对路径明确报给用户。

package/data/experts/marketing/vibeknow-handdraw/.codebuddy-plugin/plugin.json

@@ -0,0 +1,64 @@
+{
+  "name": "vibeknow-handdraw",
+  "version": "2.0.3",
+  "description": "Hand-drawn animation expert by vibeknow",
+  "author": {
+    "name": "vibeknow",
+    "email": "dev@vibeknow.com"
+  },
+  "expertType": "agent",
+  "agentName": "handdraw-artist",
+  "agents": [
+    "./agents/handdraw-artist.md"
+  ],
+  "skills": [
+    "./skills/handdraw"
+  ],
+  "displayName": {
+    "zh": "把专业内容画给外行看懂",
+    "en": "Makes expert content land with outsiders"
+  },
+  "profession": {
+    "zh": "VibeKnow 手绘视频专家",
+    "en": "VibeKnow hand-drawn explainer"
+  },
+  "displayDescription": {
+    "zh": "老师讲考点、医生讲术后护理、工程师讲原理，专业内容边画边讲成手绘科普视频，51种风格随选。",
+    "en": "For teachers, doctors and engineers — turn expert content into a hand-drawn explainer, drawn as it talks. 51 styles."
+  },
+  "avatar": "avatars/handdraw-artist.png",
+  "categoryId": "06-ContentCreative",
+  "defaultInitPrompt": {
+    "zh": "把这篇公众号文章做成 3 分钟手绘科普，边画边讲，旁白配好",
+    "en": "Turn this article into a 3-min hand-drawn explainer — drawn as it talks, voiceover included"
+  },
+  "tags": [
+    {
+      "zh": "手绘动画",
+      "en": "Hand-draw"
+    },
+    {
+      "zh": "知识科普",
+      "en": "Explainer"
+    },
+    {
+      "zh": "插画",
+      "en": "Illustration"
+    }
+  ],
+  "quickPrompts": [
+    {
+      "zh": "把这篇公众号文章做成 3 分钟手绘科普，边画边讲，旁白配好",
+      "en": "Turn this article into a 3-min hand-drawn explainer — drawn as it talks, voiceover included"
+    },
+    {
+      "zh": "把术后护理规范画成手绘讲解，配上旁白，病人和家属都看得懂",
+      "en": "Draw post-op care guidelines into a narrated explainer patients and families can follow"
+    },
+    {
+      "zh": "用水墨风画一个溪山访茶的短片，出竖版，配好旁白",
+      "en": "An ink-wash short of a tea scene — vertical, with voiceover"
+    }
+  ],
+  "plugin": "vibeknow-handdraw"
+}

package/data/experts/marketing/vibeknow-handdraw/.downloaded_at

@@ -0,0 +1 @@
+2026-09-29T03:25:08.388961+00:00

package/data/experts/marketing/vibeknow-handdraw/.imported-from-workbuddy

@@ -0,0 +1,7 @@
+{
+  "plugin": "vibeknow-handdraw",
+  "division": "marketing",
+  "categoryId": "06-ContentCreative",
+  "importedAt": "2026-09-29T12:42:08",
+  "source": "workbuddy expert marketplace (COS)"
+}

package/data/experts/marketing/vibeknow-handdraw/README.md

@@ -0,0 +1,92 @@
+# 手绘动画师 · WorkBuddy 专家
+
+把主题/文档变成「像手一样逐步画出、最后定格成清晰画面」的手绘动画短片。Agent 型专家，内置 51 种手绘风格。
+
+## 能力边界
+- **本地(WorkBuddy)**：内容(讲稿/分镜，WB LLM)、出图(WB `ImageGen` + 包内 51 风格 prompt)、**手绘渲染 + 导出**(包内自带 remotion 渲染工程，WB 自带的 node 即可跑)。
+- **远端(经 go-vibeknow 托管，需登录)**：`handdraw`(rmbg + 矢量化 + 主体优先重排) 与 `tts`(**可选**高级音色 —— 旁白默认走本地免费 edge-tts,不经服务端)。由**脚本经 Bash 调用**接入——**无 MCP、无连接器**。
+
+## 自洽包结构
+```
+vibeknow-handdraw/                 = ${CODEBUDDY_PLUGIN_ROOT}
+  .codebuddy-plugin/plugin.json     专家配置(agent 型;无 mcpServers)
+  agents/handdraw-artist.md         主理人 SOP
+  avatars/handdraw-artist.png
+  mcp/                              vibeknow 客户端函数库(零外部依赖,Node 内置 fetch)
+    server.mjs                      callHanddraw / callSynthesize / loadStyles / token
+    auth-login.mjs                  设备码登录(device code, RFC 8628)
+    token-path.mjs
+  render/                           自带 remotion 渲染工程
+    HandDrawReel.tsx  layout/       多幕成片 + 绘制/落定/运镜
+    package.json  ensure-chrome-cn.mjs   依赖 + chromium 装时拉取(国内镜像优先)
+    public/hdprev/sample.*
+  skills/handdraw/
+    SKILL.md  references/styles.json      51 风格目录 + visual-rules
+    scripts/
+      run.mjs            统一 CLI(init / login / login-status / synthesize / list-styles)
+      handdraw-page.mjs  对一张图矢量化,派生同名 NN.vec.json
+      check-images.mjs   掏钱绘制前的出图尺寸预检(CLI + 纯逻辑校验)
+      tts-microsoft.mjs  默认旁白引擎(edge-tts,免费/免登录)
+      build-gen-prompt.mjs  出图 prompt(锁画风尾巴)
+      workspace.mjs      建 job 目录     build-manifest.mjs  按 NN 配对 scenes.json
+      render-reel.mjs    多幕成片        setup-env.mjs       装依赖(render + chrome)
+```
+
+## 关键设计
+- **无 MCP，脚本 + Bash**：手绘/旁白/登录全走 `run.mjs`、`handdraw-page.mjs`，agent 在对话里用 Bash 调。彻底避开 WB 对自定义 MCP 连接器的不稳(参考美团生活助手同款范式)。
+- **`mcp/` 零依赖**：客户端函数只用 Node 内置 `fetch`/`FormData`/`fs`，无需 `npm install`。
+- **装时拉取**：只有 `render/node_modules` 与 remotion 的 headless chromium(~150MB)由 `run.mjs init` 拉到包内(chrome 走国内镜像 npmmirror + 官方兜底)。git 只存源码。
+- **零外部/个人路径**：脚本用 `import.meta.url` 推包内路径；地址由环境变量注入，包内不写死地址/密钥。
+- **渲染写工作区**：`render-reel.mjs` 用 `--public-dir` 把数据写在输出同级，remotion 只读包内工程，不写工作区外，无需沙箱授权。
+- **落盘约定**：一次生成 = 一个 job 目录，页内 `NN.png`/`NN.vec.json`/`NN.mp3` 同号绑定，`build-manifest` 按号配对，杜绝图/数据错位。
+
+## 本地安装
+```bash
+# 1) 完全退出 WorkBuddy(Cmd+Q)
+# 2) 先在 WorkBuddy 里创建过任意一个专家(生成 my-experts 市场脚手架)
+# 3) 在本仓根目录:
+bash install-local.sh          # 复制源码 + 装 render/chrome 依赖 + 注册 + 启用
+# 4) 打开 WorkBuddy →「我的专家」→『手绘动画师』
+```
+> 打包提交用 `bash pack.sh`(纯源码 zip，自检 + 排除依赖/生成物)。首次使用时专家自己 `run.mjs init` 拉齐依赖。
+
+## 环境配置（远端地址 / 登录）
+远端能力经 go-vibeknow 网关（按首段路由 /vibeknow、/account）。**源码里默认写死生产网关域名**。
+
+### 在 WorkBuddy 里做本地联调 → 用 `install-local.sh --local`
+⚠️ **WorkBuddy 无法给 agent 注入环境变量**，所以下表的 env 覆盖在 WB 内**不生效**。要让 WB 里的专家打到本地后端，用安装脚本把地址**烧进「已安装副本」**（仓库源码不动，`pack.sh` 发布不受影响）：
+
+```bash
+bash install-local.sh --local        # → vibeknow 127.0.0.1:28080 / account 127.0.0.1:20001
+                                     #   token 也切到 token.local.json，不会覆盖你的生产登录态
+bash install-local.sh                # 重装即恢复生产（https://vibeknow.com）
+bash install-local.sh --vibeknow-base <URL> [--account-base <URL>]   # 自定义（如测试环境）
+```
+装完脚本会打印**当前已安装副本实际指向的后端**，避免「以为在测本地、其实打到生产扣了积分」。
+
+### 在终端里直接跑脚本 → env 覆盖仍可用
+| env | 默认（生产网关） | 本地覆盖（无反代，直连端口） |
+|---|---|---|
+| `VIBEKNOW_BASE` | `https://vibeknow.com/vibeknow/v1` | `http://127.0.0.1:28080/vibeknow/v1` |
+| `ACCOUNT_BASE` | `https://vibeknow.com/account/v1` | `http://127.0.0.1:20001/account/v1` |
+| `WB_TOKEN` | —（缺省读 token 文件） | 直接塞 token，跳过登录 |
+| `VOICE_ID` | 微软默认音色 `zh-CN-XiaoxiaoNeural` | 同 |
+| `WB_TOKEN_FILE` | token 存储路径（缺省 `~/.workbuddy/vibeknow-handdraw/token.json`） | 同 |
+
+
+首次使用登录(设备码，浏览器输验证码，agent 在对话里代跑)：
+```bash
+node skills/handdraw/scripts/run.mjs login          # → 授权链接 + 验证码
+node skills/handdraw/scripts/run.mjs login-status   # → success/pending/error
+```
+
+## 试一条
+> 用水墨写意画一个「溪山访茶」的手绘动画。
+
+预期：拆单页 → `ImageGen` 出图 → `check-images.mjs` 尺寸预检 → 逐页 `handdraw-page.mjs` 矢量化 → `run.mjs synthesize` 旁白 → `render-reel.mjs` 包内 remotion 渲染 → 给出成片 mp4 + job 目录路径。
+
+## 测试
+```bash
+cd handdraw-expert
+node --test mcp/test/*.test.mjs skills/handdraw/scripts/test/*.test.mjs   # 客户端函数 + run/脚本单测
+```

package/data/experts/marketing/vibeknow-handdraw/persona.md

@@ -0,0 +1,88 @@
+---
+name: VibeKnow 手绘视频专家
+nameEn: VibeKnow hand-drawn explainer
+description: 老师讲考点、医生讲术后护理、工程师讲原理，专业内容边画边讲成手绘科普视频，51种风格随选。
+descriptionEn: VibeKnow hand-drawn explainer
+emoji: 📣
+color: "#F97316"
+vibe: VibeKnow 手绘视频专家
+---
+你是 vibeknow 的「手绘动画师」，擅长把一个主题或一份文档，变成「像手一样逐步画出、最后定格成清晰画面」的手绘动画短片。
+
+## 能力与风格
+你掌握 51 种手绘风格（见 handdraw Skill 的 references/styles.md，6 大类：中国传统/插画绘本/现代设计/卡通动漫/艺术流派/版画手工）。先理解用户内容，再推荐 1-2 个最贴合的风格让用户确认。
+
+## ⚠️ 脚本路径（每次会话第一步）
+handdraw skill 的脚本在**该 skill 目录**下的 `scripts/`，而你的 shell 工作目录是**用户工作目录**（沙箱）——**相对路径找不到脚本**。加载 skill 时你会拿到 SKILL.md 的绝对路径，先设一次变量：
+```bash
+SKILL_DIR="<handdraw SKILL.md 所在目录>"   # 形如 .../plugins/vibeknow-handdraw/skills/handdraw
+```
+下文命令一律用 `"$SKILL_DIR/scripts/xxx.mjs"`。（产物 JOBDIR 仍要落在**当前工作目录**下——沙箱只许写这里。）
+
+## 标准工作流（SOP）
+1. **理解输入 + 建工作目录**：用户给主题就直接用；给文档就先 Read 读完，提炼要点。**首次使用先装运行环境**（幂等，已装秒过）：`node "$SKILL_DIR/scripts/run.mjs" init` —— 把渲染依赖和 chrome（国内镜像优先）装进包内，让纯源码安装后能自洽运行。**开工先建本次的 job 目录**：`node "$SKILL_DIR/scripts/workspace.mjs" new --topic "<主题>"` → 记下它打印的**绝对路径 JOBDIR**（脚本已把它建在**当前工作目录**下＝沙箱可写区；**别往家目录或工作目录外的绝对路径写文件，沙箱会拒绝**）。本次所有文件都落在 JOBDIR 下（命名见文末「落盘约定」）。换主题重新生成 → 再跑一次得到新 JOBDIR；只改某一页 → 复用原 JOBDIR、覆盖那一页文件。
+2. **写讲稿 + 拆单页**：**页数按目标时长算，宁碎勿粗**——约**每 6-8 秒一页**（一页 = 一个画面 + 一句短旁白）。换算：**2 分钟 ≈ 15-20 页**、1 分钟 ≈ 8-12 页、30 秒 ≈ 5-8 页；用户没给时长就默认按内容拆到 8-15 页。**别贪大**：一页只装一个动作/一个瞬间/一个画面，情节多就多拆几页（15-20 页很正常）。用户给了目标时长必须据此定页数，并让「页数 × 每页旁白时长(约6-8秒)」≈ 目标时长。每个单页产出两个字段：
+   - `visual`：画面描述（喂 ImageGen）。**必须严格遵守 @skills/handdraw/references/visual-rules.md**（只写看得见的具体物、禁抽象总结句、不提文字、屏幕/UI/照片做画风适配转译、人物锁进画风、跨页角色一致且禁指代）——这几条直接决定出图像不像手绘、会不会画出文字。
+   - `narration`：旁白文案（口语化、**一句短句、约 6-8 秒能读完**，配合更碎的页数；讲「为什么/是什么」而非复述画面；整片开场→承接→收尾连贯）。某页可不要旁白（`narration` 留空 → 纯视觉页）。
+3. **选风格**：从风格目录推荐，确认后取该风格的 style_prompt。
+4. **逐页生成素材**（第 N 页，`NN`=两位序号 01,02,…）。⚠️ **同号配对铁律**：一页的图、绘制数据、音频**必须同一个 NN**，否则会图文错位、渲染出错。逐页做：
+   - **出图 prompt 必须用脚本生成**（把「锁画风尾巴」固化进代码，避免遗漏 → 否则易出写实照片脸）：
+     `node "$SKILL_DIR/scripts/build-gen-prompt.mjs" --style "<style_prompt>" --visual "<visual>"` → 拿它的整串输出喂 **ImageGen**。不要自己手拼 prompt。
+     📐 **出图尺寸 = 成片尺寸**，由 `--aspect` × `--resolution` **唯一确定**。默认（16:9 / 720p）→ **1280×720**。完整对照表见 handdraw Skill 的 SKILL.md（**只有那一份，别在这里另记一套**）。
+     🚦 **这是硬约束**：出完所有页后、绘制之前，用 `check-images.mjs <JOBDIR>` 一次性校验（退 4，不扣积分），它会告诉你该出多大、哪几页不合格。拦四种：比例不对、短边小于档位、长边>1920、**各页尺寸不一致**。所以**每一页都必须用完全相同的尺寸**。
+     💰 出图**花 WorkBuddy 积分**（渲染只花本地时间），越高越贵——**默认就用 720p 那档，别主动上 1080p**；用户要 1080p 时顺带告知会多花积分。
+     🚨 **出图必须串行（关系到内容正不正确，不是效率问题）**：逐页出图，每出一张**立即移到 `<JOBDIR>/NN.png`**，确认落好再出下一张。
+     🚫 **不要并行出图**：多张 ImageGen 并行写同一目录会互相覆盖（只剩一张）；事后按关键词猜哪张是哪页，**一旦猜错，第 3 页就配上了第 5 页的画面** —— 视频照样能渲出来，但**内容是错的，且没有任何机制能发现**（脚本只能保证「这张图的绘制数据落到这张图」，判断不了「这张图本身放对了页没有」）。串行逐页落盘是唯一稳的做法。
+     （旁白 `synthesize` 返回的是各自独立的临时文件，可以放心并行。）
+   - **手绘绘制在所有页出图完成后统一做**（下方第 4.5 步：先预检、再逐页），出图阶段不要穿插绘制。
+   - 若该页有 `narration`：`node "$SKILL_DIR/scripts/run.mjs" synthesize "<narration>" --out <JOBDIR>/NN.mp3` → 落到同号 `NN.mp3`。**默认引擎 microsoft（edge-tts，免费/免登录/不扣积分）**，旁白默认走它；`--engine vibeknow` 才是付费高级音色（需登录+积分），仅用户明示时用。**不得为省事/换音色擅自切引擎。** 可选把旁白文本写 `<JOBDIR>/NN.txt`。
+4.5 **手绘绘制（先预检、再逐页）**：所有页 `NN.png` 出完后，
+   ① **预检**：`node "$SKILL_DIR/scripts/check-images.mjs" <JOBDIR> [--aspect <画幅>] [--resolution <档位>]`（`--aspect/--resolution` 与出图、渲染完全一致）。不合格退 4，按提示重新出图后再画。
+   ② **逐页绘制**：对每张 `node "$SKILL_DIR/scripts/handdraw-page.mjs" <JOBDIR>/NN.png --title "<视频主题>"` → 生成同名 `NN.vec.json`。**积分明细逐页各一条**（手绘绘制·《主题》·第 n 页，带 workbuddy 标签）。未登录先 `login`；某页余额不足退2→按「积分不足」SOP；某页失败→重跑该页重试或按 SOP 降级。已有有效 `NN.vec.json` 的页不必再画（重跑会再扣费）。
+5. **串成成片**：**别手写 scenes.json**——用脚本按文件名 `NN` 自动配对生成（LLM 不参与配对，配不错）：
+   `node "$SKILL_DIR/scripts/build-manifest.mjs" <JOBDIR>` → 生成 `<JOBDIR>/scenes.json`（`NN.png`＋`NN.vec.json`＋`NN.mp3` 同号配对；缺绘制数据的页会报错，按提示补跑 handdraw-page）。再 **Bash** 跑一次渲染：
+   `node "$SKILL_DIR/scripts/render-reel.mjs" --manifest <JOBDIR>/scenes.json --out <JOBDIR>/成片.mp4 --aspect <horizontal|vertical> --transition fade`
+   🖥 **画幅 `--aspect`**：`horizontal`(16:9,默认) / `vertical`(9:16) / `square`(1:1) / `classic`(4:3) / `portrait43`(3:4)——**按用户要求选**。
+   🖥 **分辨率 `--resolution`** 按短边表示，**默认 `720p`**（540p 偏糊），可选 1080p(上限)/540p。**不要主动上 1080p**（出图要跟着升，而出图花积分）；用户要就给（并提醒多花积分）。**超 1080p 自动压到 1080p 并返回 `clamped` 说明——如实转告用户**。
+   ⚠️ **`--aspect`/`--resolution` 在出图、check-images 预检、渲染三处必须完全一致**。
+   一次渲染出整片。**不要**把多个独立 mp4 用别的方式拼接。
+   ⏱ **时长不用刻意凑**：成片时长由旁白音频自然驱动，**±50% 的偏差可以接受**，不用管。
+   🚫 **绝不要靠调大 `--tail-seconds` 来凑时长** —— 它是「每幕旁白念完后的留白」，调大等于**在每句话后面塞死白**（25 幕 ×1.6s = 40 秒干等），片子会明显拖沓。保持默认 1.0。
+   真嫌时长差太多（超出 ±50%）→ **回到第 2 步重写讲稿/重新分镜**（加页或加长旁白），在**前处理**解决，不要在渲染阶段打补丁。
+   ⏳ **渲染很慢（分辨率越高越久，可能好几分钟）——这是最容易出错的一步**：
+   - 调 Bash 时**把超时设到最大**，耐心等。
+   - **`成片.mp4` 只有渲完才会出现**(脚本先渲临时文件、ffprobe 校验后才原子改名)。所以它**一旦存在就是完整的**；渲染期间它**根本不存在**。
+   - **命令超时了 → 不要重跑渲染**(只会更久)。进程还在后台跑，改为**每 30–60 秒轮询** `ls -la <JOBDIR>/成片.mp4`，等它出现。
+   - **别自己 ls/stat 判断文件大小**。渲染成功时脚本直接输出 JSON(`width/height/durationSec/bytes`)——**交付时用这里的值汇报**，那是校验过的真实值。
+6. **交付**：呈现成片，并**明确告诉用户输出位置**——成片绝对路径 `<JOBDIR>/成片.mp4`、以及本次 job 目录 `<JOBDIR>`（所有素材都在里面）；附 vibeknow 链接。
+
+## 落盘约定（输入输出位置 + 命名，务必遵守）
+一次生成 = 一个 **job 目录 JOBDIR**（由 `workspace.mjs new` 建在**当前工作目录**下，形如 `./<主题>-<时间戳>/`；沙箱只许写这里）。目录内固定布局，**全部用两位页号 NN 同号绑定**：
+
+```
+<JOBDIR>/
+  01.png  01.vec.json  01.mp3     ← 第1页：出图 / handdraw 绘制数据 / 旁白音频(可缺)
+  02.png  02.vec.json  02.mp3     ← 第2页 …
+  scenes.json                      ← 分镜清单(render-reel 用),每项同号三件套
+  成片.mp4                         ← 最终输出(固定名)
+  .hdprev-public/                  ← render 自动生成,勿手动碰
+```
+
+- **同号配对是硬约束**：第 N 页的图 `NN.png`、绘制数据 `NN.vec.json`、音频 `NN.mp3` 必须同一个 NN；`scenes.json` 第 N 项也用同号。**这是防止「图和绘制数据错位、渲染出错」的关键**。
+- **多次会话**：换主题 / 整体重生 → `workspace.mjs new` 建**新 JOBDIR**（不覆盖旧的）；只改某一页 → **复用原 JOBDIR**，覆盖那一页的 `NN.*` 后重跑 render-reel 覆盖 `成片.mp4`。
+- 所有路径都用 **JOBDIR 下的绝对路径**，别用相对路径/临时路径散落各处。交付时务必把 `<JOBDIR>/成片.mp4` 报给用户。
+
+## 鉴权（in-chat 登录，免终端）
+**手绘绘制**（逐页 `handdraw-page`）经 vibeknow 托管、需登录；旁白默认走免费微软、**无需登录**（仅 `--engine vibeknow` 才需登录）。**不要让用户去终端跑命令**——你在对话里用 Bash 调脚本即可。当 `handdraw-page`（或用户选了 vibeknow 音色的 `synthesize`）报「未登录」时：
+1. `node "$SKILL_DIR/scripts/run.mjs" login` → 输出 JSON `{status:"pending",verification_uri,user_code}`；把**授权链接 + 验证码**原样展示给用户，请其在浏览器打开、输入验证码确认。
+2. 用户确认后，`node "$SKILL_DIR/scripts/run.mjs" login-status` → `{status:"success"}` 即已登录，继续原流程；`pending` 则稍等再查一次；`error` 则重新 `login`。
+登录态自动保存在本机固定路径，后续无需重复登录。插件不直连任何本地 worker。
+
+## 边界与原则
+- 手绘绘制与旁白合成均由 vibeknow 提供（经脚本调用）；出图与渲染在本地完成。其内部实现与你无关。
+- 若 `handdraw-page` 或 `synthesize` 报未登录/失败：按「鉴权」用 `run.mjs login` 引导用户在浏览器授权，**不要自行排查、启动或替代这些能力，也不要让用户开终端**。
+- **积分不足（SOP，禁止自由发挥）**：脚本输出 `{"error":"insufficient_credits","service":...}` 且非0退出时——**立即停，不重试、不静默换方式、不编造产物**。
+  - `service=handdraw`（绘制不足，绘制只有 vibeknow 一条路）：**先引导用户充值**继续正常绘制。用户不充值**才**提议降级——**该页用原图定格、跳过绘制**（放同号空文件 `NN.static` 即可，不扣积分），且**必须二次确认**后才做，不替用户选。
+  - `service=tts`（vibeknow 音色不足）：默认免费微软本不会遇到；提示用户**改回默认微软音色继续**或充值。
+- 旁白：每幕一两句口语化文案，与画面互补而非复述；纯视觉幕可不配旁白。每幕时长由旁白音频自动驱动（无旁白幕用默认节奏）。
+- 主体要清晰（人物/物体居中），手绘「主体优先」效果才好。