yuanflow-cli 0.1.41 → 0.1.42

package/README.md

@@ -4,7 +4,7 @@ YuanFlow 的 npm 包，包含两个命令入口：
 
 - `yuanflow-cli`：社媒 API 转 CLI，覆盖完整 registry、快捷命令、schema、dry-run 和 agent-json 输出。
 - `yuanflow-skill`：把 `YuanFlow-skill` 注入到本机支持的 AI Agent skills 目录。
-- `飞书官方技能`：YuanFlow 主程序内通过受控工具托管安装并调用飞书官方 `@larksuite/cli`，npm 包只提供 Skill 说明，不复制官方 CLI 源码。
+- `飞书官方技能`：YuanFlow-main 内置环境通过受控工具托管安装并调用飞书官方 `@larksuite/cli`，npm 包只提供 Skill 说明，不复制官方 CLI 源码。
 
 ## 安装
 
@@ -65,7 +65,7 @@ yuanflow-cli list douyin
 YUANCHUANG_API_TOKEN=<你的令牌>
 ```
 
-token 优先级：`--token` > `YUANCHUANG_API_TOKEN` > 本地 `config.token`。独立 CLI 用户可以使用环境变量或 `config set-token`；在 YuanFlow 主程序内使用时，token 由主程序认证系统注入，不需要手动配置。本地图片/视频上传统一使用 YuanFlow 文件中转，不需要用户配置第三方平台 Key。
+token 优先级：`--token` > `YUANCHUANG_API_TOKEN` > 本地 `config.token`。独立 CLI 用户可以使用环境变量或 `config set-token`；在 YuanFlow-main 内置环境使用时，token 由 YuanFlow-main 内置环境注入，不需要手动配置。本地图片/视频上传统一使用 YuanFlow 文件中转，不需要用户配置第三方平台 Key。
 
 ### AI 模型命令
 
@@ -369,7 +369,7 @@ yuanflow-cli browser dry-run --platform xiaohongshu --task publish --account mai
 
 ### 生图技能
 
-`生图技能` 随 npm 包安装到 Skill bundle。YuanFlow 主程序内优先使用受控工具 `yuanflow_image_request`，自动注入当前用户 token 并缓存返回图片。
+`生图技能` 随 npm 包安装到 Skill bundle。YuanFlow-main 内置环境优先使用受控工具 `yuanflow_image_request`，自动注入当前用户 token 并缓存返回图片。
 
 - 生成图片：`/v1/images/generations`，主模型 `gpt-image-2-c`，备用模型 `gpt-image-2`，请求体使用 `prompt`。
 - 编辑图片：`/v1/images/edits`，必须使用 multipart/form-data 上传本地图片文件。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "description": "YuanFlow 自媒体 API CLI 与 Skill 安装器。",
   "type": "module",
   "license": "MIT",

package/skills/yuanflow-skill/README.md

@@ -10,7 +10,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 - `视觉理解/`：通用型图片、视频画面理解 Skill，走 `yuanflow-cli ai qwen3-vl-plus`，支持图片/视频 URL 和本地图片/视频上传。
 - `视频拆解/`：自媒体创作场景的对标视频拆解 Skill，先查自媒体知识库对标拆解规则，再用 `qwen3-vl-plus` 上传视频并按规则拆解。
 - `YuanFlow文件中转工具/`：YuanFlow 文件中转、签名链接、对象复制 Skill，内部兼容命令走 `yuanflow-cli oss`。
-- `生图技能/`：图片生成与编辑 Skill，优先走 YuanFlow 内置 `yuanflow_image_request`。
+- `生图技能/`：图片生成与编辑 Skill，优先走 YuanFlow-main 内置环境的 `yuanflow_image_request`。
 - `公众号生成与发布/`：公众号文章创作、主题预览、微信内联 HTML 排版、正文图片上传和草稿箱推送 Skill。
 - `小红书运营/`：小红书选题调研、笔记搜索、账号分析、评论采集、文案创作、发布前检查和互动操作 Skill；不建议浏览器自动发布作品，除非用户明确无视平台识别和限流风险并强制要求。
 - `视频智能剪辑/`：主音频 + B-roll 素材智能剪辑 Skill，先查自媒体知识库的视频剪辑策略，保存 `strategy_snapshot.json`，再通过 ASR/forced alignment 导入 `audio_alignment.json`，按 1 秒 1 帧抽帧并回写视觉理解，由 Agent 生成 `timeline_plan` 和 EDL，交给 `yuanflow-cli video` 校验和渲染。
@@ -55,7 +55,7 @@ YuanFlow Skill 是 `yuanflow-cli` 的 Agent Skill 仓库，用于把社媒平台
 
 这套 Skill 同时支持两种环境：
 
-- YuanFlow 主程序内：优先使用内置工具 `yuanflow_cli_call`、`yuanflow_gateway_request` 或 `yuanflow_image_request`，token 由主程序认证系统注入，不要求用户安装 npm 或配置 token。
+- YuanFlow-main 内置环境：优先使用内置工具 `yuanflow_cli_call`、`yuanflow_gateway_request` 或 `yuanflow_image_request`，token 由 YuanFlow-main 内置环境注入，不要求用户安装 npm 或配置 token。
 - 外部 Agent 内：优先使用本地 `yuanflow-cli`；如果本地没有，再通过 npm 安装。
 
 外部 Agent 独立使用时，推荐环境变量：

package/skills/yuanflow-skill/SKILL.md

@@ -47,9 +47,9 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 执行本 Skill 前，先判断当前运行环境：
 
-1. 如果当前 Agent 可用 YuanFlow 内置工具，例如 `yuanflow_cli_call`、`yuanflow_gateway_request` 或 `yuanflow_image_request`，优先使用 YuanFlow 内置工具。不要要求用户安装 npm，也不要要求用户配置 token。
-2. 如果当前不在 YuanFlow 内，且本地可执行 `yuanflow-cli --help`，使用本地 CLI。
-3. 如果当前不在 YuanFlow 内，且本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
+1. 如果当前 Agent 可用 YuanFlow-main 内置工具，例如 `yuanflow_cli_call`、`yuanflow_gateway_request` 或 `yuanflow_image_request`，优先使用 YuanFlow-main 内置工具。不要要求用户安装 npm，也不要要求用户配置 token。
+2. 如果当前不在 YuanFlow-main 内置环境，且本地可执行 `yuanflow-cli --help`，使用本地 CLI。
+3. 如果当前不在 YuanFlow-main 内置环境，且本地没有 `yuanflow-cli`，再提示用户安装 `npm install -g yuanflow-cli`。
 
 不要在回复、日志或文件中暴露 token。
 
@@ -213,7 +213,7 @@ description: 当用户需要处理自媒体平台接口工作流、平台数据
 
 - 生成图片、画图、出图、做海报、生成视觉素材。
 - 编辑图片、修改本地图片、基于已有图片做变化。
-- 调用 YuanFlow 内置图片生成或图片编辑接口。
+- 调用 YuanFlow-main 内置图片生成或图片编辑接口。
 
 子 Skill 名称：
 

package/skills/yuanflow-skill/YuanFlow/346/226/207/344/273/266/344/270/255/350/275/254/345/267/245/345/205/267/SKILL.md

@@ -10,11 +10,11 @@ emoji: 🔗
 
 ## 环境判断
 
-1. 在 YuanFlow 主程序内，优先调用内置工具 `yuanflow_cli_call`。
+1. 在 YuanFlow-main 内置环境，优先调用内置工具 `yuanflow_cli_call`。
 2. 在外部 Agent 中，如果本地有 `yuanflow-cli`，直接执行 CLI。
 3. 如果外部环境没有 CLI，再提示用户安装 `npm install -g yuanflow-cli`。
 
-不要要求用户手动填写 token。YuanFlow 主程序会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+不要要求用户手动填写 token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
 
 ## 能做什么
 
@@ -70,9 +70,9 @@ yuanflow-cli oss copy \
 - `--source-bucket`：源 bucket。
 - `--target-bucket`：目标 bucket。
 
-## YuanFlow 内置工具调用示例
+## YuanFlow-main 内置工具调用示例
 
-在 YuanFlow 主程序内，调用 `yuanflow_cli_call`，参数数组不要包含 token：
+在 YuanFlow-main 内置环境，调用 `yuanflow_cli_call`，参数数组不要包含 token：
 
 ```json
 {
@@ -95,4 +95,4 @@ yuanflow-cli oss copy \
 - 不上传密钥、cookie、账号凭据、配置文件、隐私文件。
 - 不把签名 URL 写入公开文档或长期日志。
 - 返回结果中优先说明 `bucket`、`key`、`expires_at`，只有用户确实需要访问链接时才展示 `signed_url`。
-- 在 YuanFlow 主程序中，如果工具策略限制本地文件上传，不要绕过限制，改为让用户通过受控上传入口完成。
+- 在 YuanFlow-main 内置环境中，如果工具策略限制本地文件上传，不要绕过限制，改为让用户通过受控上传入口完成。

package/skills/yuanflow-skill/yuanflow-cli/SKILL.md

@@ -22,12 +22,12 @@ emoji: ⚙️
 
 优先级如下：
 
-1. YuanFlow 内置工具：如果当前工具列表里存在 `yuanflow_cli_call`，使用它调用社媒接口。
+1. YuanFlow-main 内置工具：如果当前工具列表里存在 `yuanflow_cli_call`，使用它调用社媒接口。
 2. YuanFlow 网关工具：如果只有 `yuanflow_gateway_request`，可用它访问受控服务接口。
 3. 本地 CLI：如果当前环境可执行 `yuanflow-cli --help`，使用本地 CLI。
 4. 安装提示：只有以上都不可用时，才提示用户安装 `npm install -g yuanflow-cli`。
 
-在 YuanFlow 主程序内，不要提示用户配置 token；token 由主程序 KEY 认证注入。
+在 YuanFlow-main 内置环境，不要提示用户配置 token；token 由 YuanFlow-main 内置环境注入。
 在外部 Agent 环境中，使用环境变量 `YUANCHUANG_API_TOKEN`，也可以使用本地 `config set-token`。
 
 ## 外部 Agent 安装和更新
@@ -88,7 +88,7 @@ yuanflow-cli douyin hot-search
 
 ## Agent 调用规则
 
-给 AI Agent 使用时，先查命令和 schema，再调用接口。YuanFlow 内置环境下，优先调用 `yuanflow_cli_call`；外部 Agent 环境下，优先调用 `yuanflow-cli`。
+给 AI Agent 使用时，先查命令和 schema，再调用接口。YuanFlow-main 内置环境下，优先调用 `yuanflow_cli_call`；外部 Agent 环境下，优先调用 `yuanflow-cli`。
 
 ```powershell
 yuanflow-cli commands list
@@ -200,7 +200,7 @@ yuanflow-cli comments collect --platform douyin --target "https://v.douyin.com/x
 - `--prefer fallback`：主接口失败时切换备用接口。
 - `--extra`：JSON 字符串，用于公众号 `content_id` 等补充参数。
 
-在 YuanFlow 主程序内，用 `yuanflow_cli_call` 调用时传参数数组：
+在 YuanFlow-main 内置环境，用 `yuanflow_cli_call` 调用时传参数数组：
 
 ```json
 {
@@ -237,7 +237,7 @@ yuanflow-cli schema search.xiaohongshu.content
 yuanflow-cli schema search.instagram.users
 ```
 
-YuanFlow 主程序内使用时仍通过 `yuanflow_cli_call` 传参数数组，token 由主程序注入。
+YuanFlow-main 内置环境使用时仍通过 `yuanflow_cli_call` 传参数数组，token 由 YuanFlow-main 内置环境注入。
 
 ### 小红书
 

package/skills/yuanflow-skill//344/270/252/344/272/272/345/210/233/344/275/234/345/272/223/SKILL.md

@@ -142,9 +142,9 @@ meta/
 2. 读取对应内容和 `performance-reviews/`。
 3. 总结可复用结构、表达方式、失败点和下一次优化方向。
 
-## YuanFlow 内置使用方式
+## YuanFlow-main 内置环境使用方式
 
-在 YuanFlow 主程序内，本 Skill 是托管 CLI Skill 的一个整体目录。不要把 `library/` 下的分类当成独立 Skill 安装，也不要在子目录里创建 `SKILL.md`。
+在 YuanFlow-main 内置环境，本 Skill 是托管 CLI Skill 的一个整体目录。不要把 `library/` 下的分类当成独立 Skill 安装，也不要在子目录里创建 `SKILL.md`。
 
 如果需要写入文件，优先使用当前 Skill 的真实目录：
 

package/skills/yuanflow-skill//344/275/234/345/223/201/344/270/213/350/275/275/347/273/274/345/220/210/345/267/245/345/205/267/SKILL.md

@@ -15,7 +15,7 @@ emoji: ⬇️
 
 # 作品下载综合工具
 
-本技能把用户的“下载作品、获取播放地址、获取视频流信息”需求稳定映射到 `yuanflow-cli works download`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+本技能把用户的“下载作品、获取播放地址、获取视频流信息”需求稳定映射到 `yuanflow-cli works download`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 
 ## 什么时候使用
 
@@ -29,11 +29,11 @@ emoji: ⬇️
 
 ## 调用优先级
 
-1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `works download` 开始。
+1. YuanFlow-main 内置环境：调用 `yuanflow_cli_call`，参数数组从 `works download` 开始。
 2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli works download ...`。
 3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
 
-YuanFlow 内置调用示例：
+YuanFlow-main 内置环境调用示例：
 
 ```json
 {

package/skills/yuanflow-skill//344/275/234/345/223/201/350/257/204/350/256/272/351/207/207/351/233/206/SKILL.md

@@ -23,7 +23,7 @@ emoji: 💬
 
 # 作品评论采集
 
-本技能把用户的评论采集需求稳定映射到 `yuanflow-cli comments collect`。在 YuanFlow 主程序内，优先使用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+本技能把用户的评论采集需求稳定映射到 `yuanflow-cli comments collect`。在 YuanFlow-main 内置环境，优先使用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 
 ## 什么时候使用
 
@@ -37,11 +37,11 @@ emoji: 💬
 
 ## 调用优先级
 
-1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `comments collect` 开始。
+1. YuanFlow-main 内置环境：调用 `yuanflow_cli_call`，参数数组从 `comments collect` 开始。
 2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli comments collect ...`。
 3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
 
-YuanFlow 内置调用示例：
+YuanFlow-main 内置环境调用示例：
 
 ```json
 {

package/skills/yuanflow-skill//344/275/234/345/223/201/350/257/246/346/203/205/350/216/267/345/217/226/345/267/245/345/205/267/SKILL.md

@@ -12,7 +12,7 @@ emoji: 📄
 
 # 作品详情获取工具
 
-本技能把用户的“查询单个作品详情、解析作品链接、获取作品元数据”需求稳定映射到 `yuanflow-cli works detail`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+本技能把用户的“查询单个作品详情、解析作品链接、获取作品元数据”需求稳定映射到 `yuanflow-cli works detail`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 
 ## 什么时候使用
 
@@ -26,11 +26,11 @@ emoji: 📄
 
 ## 调用优先级
 
-1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `works detail` 开始。
+1. YuanFlow-main 内置环境：调用 `yuanflow_cli_call`，参数数组从 `works detail` 开始。
 2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli works detail ...`。
 3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
 
-YuanFlow 内置调用示例：
+YuanFlow-main 内置环境调用示例：
 
 ```json
 {

package/skills/yuanflow-skill//345/205/254/344/274/227/345/217/267/347/224/237/346/210/220/344/270/216/345/217/221/345/270/203/SKILL.md

@@ -19,7 +19,7 @@ emoji: 📰
 3. 开始输出正文之前，必须先和用户核对大概字数范围，例如 800-1200 字、1500-2000 字、3000 字以上；如果用户没有给出范围，先询问，不要直接写完整正文。
 4. 是否需要正文插图、插图数量、插图来源和大概插入位置。
    - 用户提供图片时：先梳理每张图适合插入的段落位置，再进入排版、上传和草稿箱链路。
-   - 用户要求生成正文插图时：先使用 YuanFlow 内置生图技能生成图片，再把生成图片作为正文插图素材进入上传链路。
+   - 用户要求生成正文插图时：先使用 生图技能生成图片，再把生成图片作为正文插图素材进入上传链路。
    - 用户没有要求正文插图时：不要擅自生成插图；只处理文字正文和可选封面。
 5. 排版结果使用 Markdown 还是 HTML。
    - 如果选择 HTML，会把 Markdown 转成微信公众号编辑器可粘贴的内联样式 HTML。
@@ -132,7 +132,7 @@ python scripts/wechat_draft.py \
 除非用户在本轮已明确指定某个主题 ID，否则不得直接执行 `wechat_format.py --theme ... --output ...`。正确顺序是：
 
 1. 文章正文确认或生成后，先准备 Markdown 正文。
-2. 如果当前 YuanFlow 主程序工具列表里存在 `wechat_theme_gallery_update`，必须优先调用这个受控工具，传入已确认的 `markdown` 正文或受控 `markdown_path`。该工具会直接运行主题画廊脚本并写入右侧内容创作工作台，避免 Agent 手动复制主题预览 HTML 时丢字段。
+2. 如果当前 YuanFlow-main 内置工具列表里存在 `wechat_theme_gallery_update`，必须优先调用这个受控工具，传入已确认的 `markdown` 正文或受控 `markdown_path`。该工具会直接运行主题画廊脚本并写入右侧内容创作工作台，避免 Agent 手动复制主题预览 HTML 时丢字段。
 3. 如果没有 `wechat_theme_gallery_update`，再执行主题画廊命令，基于正文生成 20 个核心主题预览：
 
 ```bash
@@ -202,7 +202,7 @@ python scripts/wechat_format.py --input article.md --theme newspaper --output di
 
 ## 封面
 
-封面不使用第三方生成接口。需要封面时，使用 YuanFlow 内置生图技能生成。
+封面不使用第三方生成接口。需要封面时，使用 生图技能生成。
 
 生成封面前同样必须先查看 `生图技能/references/image-prompt-reference.md` 的标题、目录或小节名，选择与文章定位最接近的封面、海报、知识卡、商业科技视觉或信息图方向作为参考；只需进入相近方向阅读，不需要完整扫完所有提示词。封面提示词要把文章主题、目标读者、视觉主元素、构图层级、比例、中文文字规则和负面约束写清楚，避免只写“生成一张某主题封面图”这类空泛需求。
 

package/skills/yuanflow-skill//345/205/254/344/274/227/345/217/267/347/224/237/346/210/220/344/270/216/345/217/221/345/270/203/tests/test_wechat_draft.py

@@ -0,0 +1,176 @@
+from __future__ import annotations
+
+import json
+import sys
+import unittest
+from pathlib import Path
+from tempfile import TemporaryDirectory
+from unittest.mock import patch
+
+
+ROOT = Path(__file__).resolve().parents[1]
+SCRIPTS = ROOT / "scripts"
+if str(SCRIPTS) not in sys.path:
+    sys.path.insert(0, str(SCRIPTS))
+
+import wechat_draft  # noqa: E402
+
+
+class FakeResponse:
+    def __init__(self, payload: dict, status_code: int = 200) -> None:
+        self._payload = payload
+        self.status_code = status_code
+        self.text = json.dumps(payload, ensure_ascii=False)
+
+    def json(self) -> dict:
+        return self._payload
+
+
+class WechatDraftTests(unittest.TestCase):
+    def test_push_draft_uploads_article_images_cover_and_adds_draft(self) -> None:
+        with TemporaryDirectory() as temp_dir:
+            root = Path(temp_dir)
+            article_image = root / "article.jpg"
+            cover_image = root / "cover.jpg"
+            article_image.write_bytes(b"fake-image")
+            cover_image.write_bytes(b"fake-cover")
+            article = root / "article.md"
+            article.write_text(
+                "# 测试文章\n\n正文第一段。\n\n![正文图](article.jpg)\n\n正文第二段。",
+                encoding="utf-8",
+            )
+            credentials = root / "credentials.txt"
+            credentials.write_text("AppID：wx-test\nAppSecret：secret-test", encoding="utf-8")
+            output_dir = root / "dist"
+
+            calls: list[dict] = []
+
+            def fake_request(method: str, url: str, **kwargs):
+                calls.append({"method": method, "url": url, "kwargs": kwargs})
+                if "cgi-bin/token" in url:
+                    return FakeResponse({"access_token": "token-test", "expires_in": 7200})
+                if "media/uploadimg" in url:
+                    return FakeResponse({"url": "https://mmbiz.qpic.cn/article-image.jpg"})
+                if "material/add_material" in url:
+                    return FakeResponse({"media_id": "cover-media-id", "url": "https://mmbiz.qpic.cn/cover.jpg"})
+                if "draft/add" in url:
+                    self.assertNotIn("json", kwargs)
+                    raw_body = kwargs.get("data")
+                    self.assertIsInstance(raw_body, bytes)
+                    self.assertIn("application/json; charset=utf-8", kwargs.get("headers", {}).get("Content-Type", ""))
+                    self.assertIn("测试文章".encode("utf-8"), raw_body)
+                    self.assertNotIn(b"\\u6d4b\\u8bd5", raw_body)
+                    payload = json.loads(raw_body.decode("utf-8"))
+                    content = payload["articles"][0]["content"]
+                    self.assertIn("https://mmbiz.qpic.cn/article-image.jpg", content)
+                    self.assertIn("cover-media-id", json.dumps(payload, ensure_ascii=False))
+                    self.assertLessEqual(len(payload["articles"][0]["digest"].encode("utf-8")), 54)
+                    self.assertLessEqual(len(payload["articles"][0]["title"].encode("utf-8")), 64)
+                    return FakeResponse({"media_id": "draft-media-id"})
+                raise AssertionError(f"unexpected url: {url}")
+
+            args = wechat_draft.argparse.Namespace(
+                input=str(article),
+                theme="wechat-native",
+                title="",
+                author="YuanFlow",
+                digest="",
+                content_source_url="",
+                cover_image=str(cover_image),
+                thumb_media_id="",
+                cover_material_type="image",
+                output_dir=str(output_dir),
+                credentials_file=str(credentials),
+                app_id="",
+                app_secret="",
+                push_draft=True,
+                update_draft=False,
+                draft_media_id="",
+                draft_index=0,
+                json=True,
+            )
+            with patch.object(wechat_draft.requests, "request", side_effect=fake_request):
+                result = wechat_draft.run(args)
+
+            self.assertTrue(result["ok"])
+            self.assertTrue(result["pushed"])
+            self.assertEqual(result["draft"]["media_id"], "draft-media-id")
+            self.assertEqual(result["article_images"][0]["url"], "https://mmbiz.qpic.cn/article-image.jpg")
+            self.assertTrue((output_dir / "wechat.html").exists())
+            self.assertTrue((output_dir / "draft_payload.json").exists())
+            called_urls = "\n".join(call["url"] for call in calls)
+            self.assertIn("cgi-bin/token", called_urls)
+            self.assertIn("media/uploadimg", called_urls)
+            self.assertIn("material/add_material", called_urls)
+            self.assertIn("draft/add", called_urls)
+
+    def test_update_draft_replaces_article_by_media_id_and_index(self) -> None:
+        with TemporaryDirectory() as temp_dir:
+            root = Path(temp_dir)
+            article_image = root / "article.jpg"
+            article_image.write_bytes(b"fake-image")
+            article = root / "article.md"
+            article.write_text(
+                "# 更新文章\n\n正文第一段。\n\n![正文图](article.jpg)\n\n正文第二段。",
+                encoding="utf-8",
+            )
+            credentials = root / "credentials.txt"
+            credentials.write_text("AppID：wx-test\nAppSecret：secret-test", encoding="utf-8")
+            output_dir = root / "dist"
+
+            calls: list[dict] = []
+
+            def fake_request(method: str, url: str, **kwargs):
+                calls.append({"method": method, "url": url, "kwargs": kwargs})
+                if "cgi-bin/token" in url:
+                    return FakeResponse({"access_token": "token-test", "expires_in": 7200})
+                if "media/uploadimg" in url:
+                    return FakeResponse({"url": "https://mmbiz.qpic.cn/updated-image.jpg"})
+                if "draft/update" in url:
+                    raw_body = kwargs.get("data")
+                    self.assertIsInstance(raw_body, bytes)
+                    payload = json.loads(raw_body.decode("utf-8"))
+                    self.assertEqual(payload["media_id"], "draft-media-id")
+                    self.assertEqual(payload["index"], 0)
+                    self.assertIsInstance(payload["articles"], dict)
+                    self.assertEqual(payload["articles"]["title"], "更新文章")
+                    self.assertIn("https://mmbiz.qpic.cn/updated-image.jpg", payload["articles"]["content"])
+                    self.assertNotIn("thumb_media_id", payload["articles"])
+                    return FakeResponse({"errcode": 0, "errmsg": "ok"})
+                raise AssertionError(f"unexpected url: {url}")
+
+            args = wechat_draft.argparse.Namespace(
+                input=str(article),
+                theme="wechat-native",
+                title="",
+                author="YuanFlow",
+                digest="",
+                content_source_url="",
+                cover_image="",
+                thumb_media_id="",
+                cover_material_type="image",
+                output_dir=str(output_dir),
+                credentials_file=str(credentials),
+                app_id="",
+                app_secret="",
+                push_draft=False,
+                update_draft=True,
+                draft_media_id="draft-media-id",
+                draft_index=0,
+                json=True,
+            )
+            with patch.object(wechat_draft.requests, "request", side_effect=fake_request):
+                result = wechat_draft.run(args)
+
+            self.assertTrue(result["ok"])
+            self.assertTrue(result["pushed"])
+            self.assertEqual(result["operation"], "update")
+            called_urls = "\n".join(call["url"] for call in calls)
+            self.assertIn("cgi-bin/token", called_urls)
+            self.assertIn("media/uploadimg", called_urls)
+            self.assertIn("draft/update", called_urls)
+            self.assertNotIn("draft/add", called_urls)
+
+
+if __name__ == "__main__":
+    unittest.main()

package/skills/yuanflow-skill//345/260/217/347/272/242/344/271/246/350/277/220/350/220/245/SKILL.md

@@ -42,7 +42,7 @@ emoji: 📕
 
 ## YuanFlow 调用优先级
 
-1. 当前在 YuanFlow 内时，优先使用受控工具 `yuanflow_cli_call`，不要让用户手动安装 npm，也不要暴露 token。
+1. 当前在 YuanFlow-main 内置环境时，优先使用受控工具 `yuanflow_cli_call`，不要让用户手动安装 npm，也不要暴露 token。
 2. 数据读取优先使用 `yuanflow-cli` 已有小红书接口和通用自媒体 Skill。
 3. 登录、发布、浏览器任务优先使用 YuanFlow 独立浏览器配置和自媒体浏览器自动化能力。
 4. 当前环境没有受控工具但本地存在 `yuanflow-cli` 时，再使用本地 CLI。

package/skills/yuanflow-skill//345/270/220/345/217/267/347/233/221/346/216/247/SKILL.md

@@ -6,7 +6,7 @@ emoji: 📊
 
 # 帐号监控
 
-本技能用于把“监控帐号、分析博主、采集主页、对比历史变化”的需求稳定映射到 `yuanflow-cli`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会自动注入用户 token。不要要求用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+本技能用于把“监控帐号、分析博主、采集主页、对比历史变化”的需求稳定映射到 `yuanflow-cli`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会自动注入用户 token。不要要求用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 
 ## 固定目标
 
@@ -24,7 +24,7 @@ emoji: 📊
 
 ## 缓存路径
 
-YuanFlow 主程序内默认保存到程序数据目录：
+YuanFlow-main 内置环境默认保存到程序数据目录：
 
 ```text
 <YuanFlow data dir>/runtime_tools/account-monitor/snapshots
@@ -50,7 +50,7 @@ Windows 外部 Agent 默认保存到：
 
 ### 1. 获取 sec_user_id
 
-YuanFlow 内置调用：
+YuanFlow-main 内置环境调用：
 
 ```json
 {

package/skills/yuanflow-skill//347/224/237/345/233/276/346/212/200/350/203/275/SKILL.md

@@ -27,7 +27,7 @@ emoji: 🎨
 - 如果图片只是正文插图、配图、氛围图，优先要求“无文字、无字母、无 Logo、无水印”，避免模型自行生成英文占位字。
 - 如果必须包含文字，文字内容应短、少、准确，并在提示词里逐条写出要出现的中文文字。
 
-## YuanFlow 内置环境
+## YuanFlow-main 内置环境
 
 如果当前 Agent 可用 `yuanflow_image_request`，优先使用该受控工具。它会自动注入当前用户 token，并把接口返回的 URL 或 base64 图片缓存为可预览资源。
 

package/skills/yuanflow-skill//347/273/274/345/220/210/346/220/234/347/264/242/345/267/245/345/205/267/SKILL.md

@@ -12,7 +12,7 @@ emoji: 🔎
 
 # 综合搜索工具
 
-本技能把用户的“按关键词搜索内容、视频、笔记、文章、帖子”需求稳定映射到 `yuanflow-cli search content`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+本技能把用户的“按关键词搜索内容、视频、笔记、文章、帖子”需求稳定映射到 `yuanflow-cli search content`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 
 ## 什么时候使用
 
@@ -26,11 +26,11 @@ emoji: 🔎
 
 ## 调用优先级
 
-1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `search content` 开始。
+1. YuanFlow-main 内置环境：调用 `yuanflow_cli_call`，参数数组从 `search content` 开始。
 2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli search content ...`。
 3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
 
-YuanFlow 内置调用示例：
+YuanFlow-main 内置环境调用示例：
 
 ```json
 {

package/skills/yuanflow-skill//347/273/274/345/220/210/347/224/250/346/210/267/346/220/234/347/264/242/345/267/245/345/205/267/SKILL.md

@@ -12,7 +12,7 @@ emoji: 👤
 
 # 综合用户搜索工具
 
-本技能把用户的“搜索账号、作者、用户、频道、达人”需求稳定映射到 `yuanflow-cli search users`。在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`；它会由主程序认证系统注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
+本技能把用户的“搜索账号、作者、用户、频道、达人”需求稳定映射到 `yuanflow-cli search users`。在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`；它会由 YuanFlow-main 内置环境注入 `YUANCHUANG_API_TOKEN`，不要让用户粘贴 KEY，不要在回复、日志或文件里暴露 token。
 
 ## 什么时候使用
 
@@ -26,11 +26,11 @@ emoji: 👤
 
 ## 调用优先级
 
-1. YuanFlow 主程序内：调用 `yuanflow_cli_call`，参数数组从 `search users` 开始。
+1. YuanFlow-main 内置环境：调用 `yuanflow_cli_call`，参数数组从 `search users` 开始。
 2. 外部 Agent 且本机有 CLI：执行 `yuanflow-cli search users ...`。
 3. 外部 Agent 且没有 CLI：再提示用户安装 `npm install -g yuanflow-cli`。
 
-YuanFlow 内置调用示例：
+YuanFlow-main 内置环境调用示例：
 
 ```json
 {

package/skills/yuanflow-skill//350/207/252/345/252/222/344/275/223/346/265/217/350/247/210/345/231/250/350/207/252/345/212/250/345/214/226/SKILL.md

@@ -30,7 +30,7 @@ emoji: 🧭
 
 ## 调用优先级
 
-在 YuanFlow 主程序内，优先调用受控工具：
+在 YuanFlow-main 内置环境，优先调用受控工具：
 
 ```json
 {

package/skills/yuanflow-skill//350/207/252/345/252/222/344/275/223/347/237/245/350/257/206/345/272/223/SKILL.md

@@ -12,11 +12,11 @@ emoji: 🧠
 
 ## 环境判断
 
-1. 在 YuanFlow 主程序内，优先调用内置工具 `yuanflow_cli_call`。
+1. 在 YuanFlow-main 内置环境，优先调用内置工具 `yuanflow_cli_call`。
 2. 在外部 Agent 中，如果本地有 `yuanflow-cli`，直接执行 CLI。
 3. 如果外部环境没有 CLI，再提示用户安装 `npm install -g yuanflow-cli`。
 
-不要让用户手动提供 token。YuanFlow 主程序会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+不要让用户手动提供 token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
 
 ## 能做什么
 
@@ -77,9 +77,9 @@ yuanflow-cli knowledge rules \
 
 4. 最后基于接口返回的公开规则摘要，完成创作、评估或优化。
 
-## YuanFlow 内置工具调用示例
+## YuanFlow-main 内置工具调用示例
 
-在 YuanFlow 主程序内，调用 `yuanflow_cli_call`，参数数组不要包含 token：
+在 YuanFlow-main 内置环境，调用 `yuanflow_cli_call`，参数数组不要包含 token：
 
 ```json
 {

package/skills/yuanflow-skill//350/247/206/350/247/211/347/220/206/350/247/243/SKILL.md

@@ -12,11 +12,11 @@ emoji: 👁️
 
 ## 环境判断
 
-1. 在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`。
+1. 在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。
 2. 外部 Agent 且本机有 CLI 时，直接执行 `yuanflow-cli`。
 3. 外部 Agent 没有 CLI 时，再提示用户安装 `npm install -g yuanflow-cli`。
 
-不要让用户手动提供 YuanFlow token。YuanFlow 主程序会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+不要让用户手动提供 YuanFlow token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
 
 本地图片/视频上传依赖 CLI 的 YuanFlow 文件中转能力。外部 Agent 只需要配置 YuanFlow API token；不要要求用户提供第三方平台 Key，也不要在回复里展示完整 token。
 
@@ -46,7 +46,7 @@ emoji: 👁️
 5. 调用 qwen3-vl-plus。
 6. 整理输出：先给结论，再给画面证据，再给不确定项。
 
-## YuanFlow 内置工具调用示例
+## YuanFlow-main 内置工具调用示例
 
 图片 URL：
 

package/skills/yuanflow-skill//350/247/206/351/242/221/346/212/225/346/265/201/347/255/226/347/225/245/SKILL.md

@@ -21,7 +21,7 @@ emoji: 📈
    - 如果主页作品列表已包含播放、点赞、评论、转发、收藏等统计，可以直接使用；如果字段缺失，按 `帐号监控` 的说明调用作品详情补全。
    - 采集完成后，把本次账号上下文缓存到本地，方便后续复用。
 3. 缓存本次账号投流上下文。
-   - YuanFlow 主程序内默认保存到程序数据目录：
+   - YuanFlow-main 内置环境默认保存到程序数据目录：
 
 ```text
 <YuanFlow data dir>/runtime_tools/video-ad-strategy/account-context

package/skills/yuanflow-skill//350/247/206/351/242/221/346/213/206/350/247/243/SKILL.md

@@ -18,11 +18,11 @@ emoji: 🎬
 
 ## 环境判断
 
-1. 在 YuanFlow 主程序内，优先调用受控工具 `yuanflow_cli_call`。
+1. 在 YuanFlow-main 内置环境，优先调用受控工具 `yuanflow_cli_call`。
 2. 外部 Agent 且本机有 CLI 时，直接执行 `yuanflow-cli`。
 3. 外部 Agent 没有 CLI 时，再提示用户安装 `npm install -g yuanflow-cli`。
 
-不要让用户手动提供 YuanFlow token。YuanFlow 主程序会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
+不要让用户手动提供 YuanFlow token。YuanFlow-main 内置环境会注入认证 token；外部 CLI 使用 `YUANCHUANG_API_TOKEN`。
 
 本地视频上传依赖 qwen3-vl-plus 的 YuanFlow 文件中转能力。外部 Agent 只需要配置 YuanFlow API token；不要要求用户提供第三方平台 Key。
 
@@ -54,7 +54,7 @@ emoji: 🎬
 
 必须先调用知识库，不要直接上传视频拆解。
 
-YuanFlow 内置工具示例：
+YuanFlow-main 内置工具示例：
 
 ```json
 {
@@ -104,7 +104,7 @@ yuanflow-cli knowledge entry --output-format video_breakdown --domain 自媒体
 - `youtube.com`、`youtu.be`：`--platform youtube`。
 - `ixigua.com`：`--platform xigua`。
 
-YuanFlow 内置工具示例：
+YuanFlow-main 内置工具示例：
 
 ```json
 {
@@ -162,7 +162,7 @@ ffmpeg -y -i "<解析得到的 m3u8 地址>" -c copy "D:\素材\yuanflow-video-b
 
 把知识库查询到的规则摘要压缩进 prompt。不要只让模型“分析视频”，必须告诉它按规则拆解。
 
-YuanFlow 内置工具示例：
+YuanFlow-main 内置工具示例：
 
 ```json
 {

package/skills/yuanflow-skill//350/247/206/351/242/221/346/231/272/350/203/275/345/211/252/350/276/221/SKILL.md

@@ -33,7 +33,7 @@ tags:
 6. 必查 `video_cli_validation_render_pack`，获得 EDL 校验、预览、自检和基础渲染规则。
 7. 读取每个规则包下的 `rules` 或 `rule-detail` 后，再生成 timeline plan / EDL。
 
-YuanFlow 主程序内优先用 `yuanflow_cli_call` 调用知识库，不要让用户手动提供 token：
+YuanFlow-main 内置环境优先用 `yuanflow_cli_call` 调用知识库，不要让用户手动提供 token：
 
 ```json
 {
@@ -114,9 +114,9 @@ CLI 会生成 `strategy_snapshot.json`，后续 Agent 必须基于这个快照
 - 所有中间产物进入独立剪辑项目目录。
 - 每个 EDL 片段必须有 `reason`，说明为什么选这段画面。
 - 如果素材无法支撑文案，要明确报告缺少素材，不要硬凑。
-- 在 YuanFlow 主程序内优先调用 `yuanflow_cli_call`，外部 Agent 才直接运行本地 `yuanflow-cli`。
+- 在 YuanFlow-main 内置环境优先调用 `yuanflow_cli_call`，外部 Agent 才直接运行本地 `yuanflow-cli`。
 
-## YuanFlow 主程序内调用
+## YuanFlow-main 内置环境调用
 
 使用 `yuanflow_cli_call` 时，参数数组不要包含 token：
 
@@ -350,7 +350,7 @@ yuanflow-cli video evaluate --project "D:\素材\yuanflow-video-edit" --file "D:
 yuanflow-cli video render-final --project "D:\素材\yuanflow-video-edit" --format agent-json
 ```
 
-完成后在 YuanFlow 主程序内必须调用 `artifact_files_register` 登记 `final.mp4`、`edl.json` 和 `eval_report.json`，不要只告诉用户内部路径。
+完成后在 YuanFlow-main 内置环境必须调用 `artifact_files_register` 登记 `final.mp4`、`edl.json` 和 `eval_report.json`，不要只告诉用户内部路径。
 
 ## EDL 判断要求
 

package/skills/yuanflow-skill//351/237/263/350/247/206/351/242/221/345/234/250/347/272/277/350/275/254/346/226/207/345/255/227/SKILL.md

@@ -42,7 +42,7 @@ ffmpeg -y -i "C:\path\to\input.mp4" -vn -acodec libmp3lame -ar 44100 -ac 2 "tran
 
 ## YuanFlow 文件中转
 
-YuanFlow 主程序内优先调用 `yuanflow_cli_call`，使用兼容子命令 `oss` 上传英文命名后的音频：
+YuanFlow-main 内置环境优先调用 `yuanflow_cli_call`，使用兼容子命令 `oss` 上传英文命名后的音频：
 
 ```json
 {
@@ -100,7 +100,7 @@ Content-Type: application/json
 }
 ```
 
-在 YuanFlow 主程序内优先使用 `yuanflow_gateway_request`：
+在 YuanFlow-main 内置环境优先使用 `yuanflow_gateway_request`：
 
 ```json
 {

package/skills/yuanflow-skill//351/243/236/344/271/246/345/256/230/346/226/271/346/212/200/350/203/275/SKILL.md

@@ -18,7 +18,7 @@ emoji: 🪽
 
 如果当前 Agent 可用 `lark_cli_call`，优先使用该受控工具，不要用 `execute_shell_command` 直接运行 `npx`、`npm install -g` 或全局 `lark-cli`。
 
-YuanFlow 内部会把官方 CLI 安装到本机用户数据目录的受管位置，并固定版本执行。Agent 只需要传官方 CLI 参数数组，例如：
+YuanFlow-main 内置环境会把官方 CLI 安装到本机用户数据目录的受管位置，并固定版本执行。Agent 只需要传官方 CLI 参数数组，例如：
 
 ```json
 {

package/src/cli.js

@@ -651,7 +651,7 @@ function printHelp() {
   video 命令是视频智能剪辑基础链路：规则库策略快照、主音频+B-roll、ASR 时间戳对齐、1秒1帧抽帧、视觉理解回写、Agent 生成 timeline_plan/EDL、CLI 校验和渲染。
   需要鉴权的请求都会使用 Authorization: Bearer <token>。
   token 优先级：--token > YUANCHUANG_API_TOKEN > 本地 config.token。
-  YuanFlow 主程序内使用时，token 由主程序认证系统注入，不需要手动配置。
+  YuanFlow-main 内置环境使用时，token 由 YuanFlow-main 内置环境注入，不需要手动配置。
   AI Agent 推荐使用 --format agent-json 获取稳定 JSON 外壳。
 `);
 }