yuanflow-cli 0.1.28 → 0.1.29

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "yuanflow-cli",
-  "version": "0.1.28",
-  "description": "YuanFlow 自媒体 API CLI 与 Skill 安装器。",
+  "version": "0.1.29",
+  "description": "YuanFlow 自媒体 API CLI 与 Skill 安装器。",
   "type": "module",
   "license": "MIT",
   "private": false,
@@ -71,5 +71,3 @@
     "douyin"
   ]
 }
-
-

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

@@ -48,6 +48,33 @@ Agent 在排版前应做结构化增强，但不能改变事实：
 
 当前 Skill 内置 `scripts/wechat_format.py`，用于把 Markdown 转成微信可粘贴的内联样式 HTML。
 
+### 主题选择强制闸门
+
+当用户要求进入排版、预览、导出 HTML 或全流程时，Agent 必须先进入 `theme_select` 主题选择态。
+
+除非用户在本轮已明确指定某个主题 ID，否则不得直接执行 `wechat_format.py --theme ... --output ...`。正确顺序是：
+
+1. 文章正文确认或生成后，先写入 Markdown 源文件。
+2. 执行主题画廊命令，基于正文生成 20 个核心主题预览：
+
+```bash
+python scripts/wechat_format.py --input article.md --theme-gallery --gallery-limit 20 --json
+```
+
+3. 使用 `content_workbench_update` 写入右侧 `内容创作` 工作台：
+   - `status`: `collecting`
+   - `activeStep`: `theme_select`
+   - `steps`: 必须包含 `主题选择`
+   - `views`: 至少包含脚本返回的 `option_grid` 主题卡片；可以同时附带 `editor_panel` 显示 Markdown 摘要。
+4. 明确告诉用户：请在右侧工作台选择一个主题，然后发送输入框上方出现的待执行任务。
+5. 只有拿到用户选择的主题后，才执行：
+
+```bash
+python scripts/wechat_format.py --input article.md --theme <selected_theme> --output dist/wechat.html --preview dist/preview.html --json
+```
+
+主题选择不是装饰步骤，是排版导出前的执行闸门。用户说“完整执行”也不能跳过，除非用户同时明确指定主题。
+
 执行方式示例：
 
 ```bash
@@ -60,6 +87,9 @@ python scripts/wechat_format.py --input article.md --theme newspaper --output di
 - `--theme`：主题名，默认 `wechat-native`。主题来自 `themes/*.json`。
 - `--output`：输出 HTML 文件路径。
 - `--json`：同时输出结构化执行结果，便于 Agent 写入右侧工作台。
+- `--list-themes`：输出所有主题元数据。
+- `--theme-gallery`：基于文章生成可写入工作台 `option_grid` 的主题画廊 JSON。
+- `--gallery-limit`：主题画廊数量，默认 20。
 
 ## 工作台展示
 
@@ -75,7 +105,7 @@ python scripts/wechat_format.py --input article.md --theme newspaper --output di
 典型展示：
 
 1. `stepper`：需求确认、内容创作、主题选择、预览、导出、草稿箱。
-2. `option_grid`：主题卡片和分类筛选结果。
+2. `option_grid`：主题卡片和文章预览结果。主题卡片必须带 `intent: select_wechat_theme`、`payload.theme` 和 `instruction`，让用户点击后形成待执行任务。
 3. `preview_frame`：手机样式 HTML 预览。
 4. `editor_panel`：Markdown 或 HTML 源码。
 5. `action_bar`：导出 HTML、推送草稿箱、继续改写等动作。

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/scripts/wechat_format.py

@@ -10,6 +10,28 @@ from typing import Any
 
 ROOT = Path(__file__).resolve().parents[1]
 THEMES_DIR = ROOT / "themes"
+CORE_THEME_IDS = [
+    "wechat-native",
+    "newspaper",
+    "magazine",
+    "sspai",
+    "github",
+    "chinese",
+    "ink",
+    "bauhaus",
+    "bytedance",
+    "sports",
+    "midnight",
+    "coffee-house",
+    "terracotta",
+    "mint-fresh",
+    "lavender-dream",
+    "fresh-card",
+    "ocean-card",
+    "warm-card",
+    "focus-gold",
+    "sunset-amber",
+]
 
 
 def _style(style_map: dict[str, Any]) -> str:
@@ -30,6 +52,94 @@ def _load_theme(theme_name: str) -> dict[str, Any]:
     return json.loads(path.read_text(encoding="utf-8"))
 
 
+def _theme_id_from_path(path: Path) -> str:
+    return path.stem
+
+
+def _load_theme_by_id(theme_id: str) -> dict[str, Any]:
+    path = THEMES_DIR / f"{theme_id}.json"
+    if not path.exists():
+        return {"name": theme_id, "description": "", "styles": {}, "colors": {}}
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def list_themes(*, core_only: bool = False, limit: int | None = None) -> list[dict[str, Any]]:
+    if core_only:
+        theme_ids = [theme_id for theme_id in CORE_THEME_IDS if (THEMES_DIR / f"{theme_id}.json").exists()]
+    else:
+        theme_ids = sorted(_theme_id_from_path(path) for path in THEMES_DIR.glob("*.json"))
+    if limit and limit > 0:
+        theme_ids = theme_ids[:limit]
+
+    items: list[dict[str, Any]] = []
+    for theme_id in theme_ids:
+        theme = _load_theme_by_id(theme_id)
+        colors = theme.get("colors") if isinstance(theme.get("colors"), dict) else {}
+        items.append(
+            {
+                "id": theme_id,
+                "name": theme.get("name") or theme_id,
+                "description": theme.get("description") or "",
+                "accent": colors.get("accent") or colors.get("primary") or "#1d4ed8",
+                "background": colors.get("background") or "#ffffff",
+            }
+        )
+    return items
+
+
+def _gallery_markdown_sample(markdown: str) -> str:
+    content = markdown.strip()
+    if len(content) <= 1200:
+        return content
+    return f"{content[:1200].rstrip()}\n\n> 预览仅截取正文开头，完整排版会使用全文。"
+
+
+def build_theme_gallery(markdown: str, title: str, *, limit: int = 20) -> dict[str, Any]:
+    sample = _gallery_markdown_sample(markdown)
+    themes = []
+    for theme_meta in list_themes(core_only=True, limit=limit):
+        theme_id = theme_meta["id"]
+        theme = _load_theme_by_id(theme_id)
+        preview_body = markdown_to_wechat_html(sample, theme)
+        preview_html = build_preview(preview_body, f"{theme_meta['name']} · 主题预览")
+        themes.append(
+            {
+                "id": theme_id,
+                "label": theme_meta["name"],
+                "title": theme_meta["name"],
+                "summary": theme_meta["description"],
+                "description": theme_meta["description"],
+                "accent": theme_meta["accent"],
+                "background": theme_meta["background"],
+                "previewHtml": preview_html,
+                "intent": "select_wechat_theme",
+                "payload": {
+                    "theme": theme_id,
+                    "themeName": theme_meta["name"],
+                    "title": title,
+                },
+                "instruction": (
+                    f"选择公众号主题「{theme_meta['name']}」（theme={theme_id}），"
+                    "继续执行排版并导出 HTML。"
+                ),
+            }
+        )
+    return {
+        "ok": True,
+        "title": title,
+        "themes": themes,
+        "views": [
+            {
+                "id": "wechat-theme-gallery",
+                "type": "option_grid",
+                "title": "选择公众号排版主题",
+                "summary": "点击一个主题卡片后，发送输入框上方的待执行任务，Agent 才能继续排版导出。",
+                "items": themes,
+            }
+        ],
+    }
+
+
 def _paragraph(text: str, styles: dict[str, Any]) -> str:
     return f'<p style="{_style(styles.get("p", {}))}">{html.escape(text)}</p>'
 
@@ -206,17 +316,43 @@ def build_preview(html_body: str, title: str) -> str:
 
 def main() -> int:
     parser = argparse.ArgumentParser(description="YuanFlow 微信公众号 Markdown 排版工具")
-    parser.add_argument("--input", required=True, help="Markdown 输入文件")
+    parser.add_argument("--input", default="", help="Markdown 输入文件")
     parser.add_argument("--theme", default="wechat-native", help="主题名称")
-    parser.add_argument("--output", required=True, help="HTML 输出文件")
+    parser.add_argument("--output", default="", help="HTML 输出文件")
     parser.add_argument("--title", default="公众号生成与发布", help="预览标题")
     parser.add_argument("--preview", default="", help="可选预览 HTML 输出文件")
+    parser.add_argument("--list-themes", action="store_true", help="输出可用主题列表")
+    parser.add_argument("--theme-gallery", action="store_true", help="基于文章生成主题选择画廊 JSON")
+    parser.add_argument("--gallery-limit", type=int, default=20, help="主题画廊数量，默认 20")
     parser.add_argument("--json", action="store_true", help="输出 JSON 执行结果")
     args = parser.parse_args()
 
+    if args.list_themes:
+        payload = {"ok": True, "themes": list_themes()}
+        print(json.dumps(payload, ensure_ascii=False))
+        return 0
+
+    if not args.input:
+        raise SystemExit("--input is required unless --list-themes is used")
+
     input_path = Path(args.input).resolve()
-    output_path = Path(args.output).resolve()
     markdown = input_path.read_text(encoding="utf-8")
+
+    if args.theme_gallery:
+        payload = build_theme_gallery(markdown, args.title, limit=args.gallery_limit)
+        if args.output:
+            output_path = Path(args.output).resolve()
+            output_path.parent.mkdir(parents=True, exist_ok=True)
+            output_path.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
+            payload["output"] = str(output_path)
+        if args.json or not args.output:
+            print(json.dumps(payload, ensure_ascii=False))
+        return 0
+
+    if not args.output:
+        raise SystemExit("--output is required for HTML export")
+
+    output_path = Path(args.output).resolve()
     theme = _load_theme(args.theme)
     html_body = markdown_to_wechat_html(markdown, theme)
     output_path.parent.mkdir(parents=True, exist_ok=True)