create-dwy 0.16.1 → 0.17.0

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0030-facts/scripts/generate_report.py

@@ -0,0 +1,189 @@
+#!/usr/bin/env python3
+"""Generate a structured Markdown research report from sub-agent results."""
+
+import json
+import sys
+import argparse
+from datetime import datetime
+from pathlib import Path
+
+
+def slugify(text: str) -> str:
+    """Convert topic to URL-safe slug."""
+    import re
+    text = text.lower().strip()
+    text = re.sub(r'[^\w\s-]', '', text)
+    text = re.sub(r'[\s]+', '-', text)
+    return text
+
+
+def generate_report(topic: str, angles_data: list[dict]) -> str:
+    """Generate the full Markdown report."""
+    today = datetime.now().strftime('%Y-%m-%d')
+    angles_list = '、'.join(a['angle'] for a in angles_data)
+
+    lines = [
+        f'# {topic}',
+        '',
+        f'> 生成时间：{today}',
+        f'> 调研角度：{angles_list}',
+        '',
+        '---',
+        '',
+        '## 目录',
+        '1. [概述](#概述)',
+    ]
+
+    for i, a in enumerate(angles_data, 2):
+        anchor = a['angle'].replace(' ', '-').replace('/', '')
+        lines.append(f'{i}. [{a["angle"]}](#{anchor})')
+
+    lines.extend([
+        f'{len(angles_data) + 2}. [参考来源](#参考来源)',
+        '',
+        '---',
+        '',
+        '## 概述',
+        '',
+    ])
+
+    # Overview section: combine all summaries
+    overview_parts = []
+    for a in angles_data:
+        overview_parts.append(f'**{a["angle"]}**：{a["summary"]}')
+    lines.append('\n\n'.join(overview_parts))
+
+    # Per-angle sections
+    for a in angles_data:
+        lines.extend([
+            '',
+            '---',
+            '',
+            f'## {a["angle"]}',
+            '',
+            a.get('details', a.get('summary', '（内容待补充）')),
+            '',
+        ])
+
+        if a.get('key_points'):
+            lines.extend(['### 关键要点', ''])
+            for kp in a['key_points']:
+                lines.append(f'- {kp}')
+            lines.append('')
+
+    # Images section
+    all_images = []
+    for a in angles_data:
+        for img in a.get('images', []):
+            all_images.append(img)
+
+    if all_images:
+        lines.extend([
+            '---',
+            '',
+            '## 图片资料',
+            '',
+            '| 序号 | 说明 | 来源 |',
+            '|------|------|------|',
+        ])
+        for i, img in enumerate(all_images, 1):
+            desc = img.get('description', '—')
+            src = img.get('source', img.get('url', '—'))
+            lines.append(f'| {i} | {desc} | [查看]({src}) |')
+        lines.append('')
+
+    # Sources section
+    academic_sources = []
+    community_sources = []
+    for a in angles_data:
+        for src in a.get('sources', []):
+            t = src.get('type', 'community')
+            if t in ('official', 'academic', 'wikipedia'):
+                academic_sources.append(src)
+            else:
+                community_sources.append(src)
+
+    lines.extend([
+        '---',
+        '',
+        '## 参考来源',
+        '',
+    ])
+
+    if academic_sources:
+        lines.append('### 官方与学术来源')
+        lines.append('')
+        for i, src in enumerate(academic_sources, 1):
+            title = src.get('title', src.get('url', '未知'))
+            url = src.get('url', '#')
+            lines.append(f'{i}. [{title}]({url})')
+        lines.append('')
+
+    if community_sources:
+        lines.append('### 社区与媒体来源')
+        lines.append('')
+        offset = len(academic_sources)
+        for i, src in enumerate(community_sources, offset + 1):
+            title = src.get('title', src.get('url', '未知'))
+            url = src.get('url', '#')
+            lines.append(f'{i}. [{title}]({url})')
+        lines.append('')
+
+    lines.extend([
+        '---',
+        '',
+        '*本报告由 AI 助手调研生成，资料来源仅供参考，请自行验证准确性。*',
+        '',
+    ])
+
+    return '\n'.join(lines)
+
+
+def generate_sources_json(angles_data: list[dict]) -> dict:
+    """Generate structured sources.json."""
+    return {
+        'generated_at': datetime.now().isoformat(),
+        'angles': [
+            {
+                'angle': a['angle'],
+                'sources': a.get('sources', []),
+                'images': a.get('images', []),
+            }
+            for a in angles_data
+        ],
+    }
+
+
+def main():
+    parser = argparse.ArgumentParser(description='Generate topic research report')
+    parser.add_argument('--topic', required=True, help='Research topic')
+    parser.add_argument('--input', required=True, help='Path to JSON file with angle data')
+    parser.add_argument('--output-dir', required=True, help='Output directory')
+    args = parser.parse_args()
+
+    with open(args.input, 'r', encoding='utf-8') as f:
+        angles_data = json.load(f)
+
+    # Handle both list format and {angles: [...]} format
+    if isinstance(angles_data, dict):
+        angles_data = angles_data.get('angles', angles_data.get('results', []))
+
+    topic = args.topic
+    out_dir = Path(args.output_dir)
+    out_dir.mkdir(parents=True, exist_ok=True)
+
+    # Generate report
+    report_md = generate_report(topic, angles_data)
+    report_path = out_dir / 'README.md'
+    report_path.write_text(report_md, encoding='utf-8')
+    print(f'Report saved to: {report_path}')
+
+    # Generate sources.json
+    sources_data = generate_sources_json(angles_data)
+    sources_path = out_dir / 'sources.json'
+    sources_path.write_text(json.dumps(sources_data, ensure_ascii=False, indent=2), encoding='utf-8')
+    print(f'Sources saved to: {sources_path}')
+
+
+if __name__ == '__main__':
+    main()

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0030-facts/templates//344/272/213/345/256/236/350/265/204/346/226/231/345/272/223.template.md

@@ -0,0 +1,55 @@
+# 事实资料库 · {主题}
+
+> **用途：** 作者深度学习；非口播定稿。  
+> **网页：** `index.html`（`build_facts_html.py`）  
+> 文内引用：`[[cite:S1]]` · 图：`![说明](images/x.png)[[cite:S1]]`  
+> 状态：ready_for_confirm | done · 日期：{YYYY-MM-DD}
+
+---
+
+## 0. 学习地图（对齐 0010 §3 内容柱，可深于成片）
+
+| 角度 | 对应 0010 内容柱 | 为何要懂 | 成片是否展开 |
+|------|------------------|----------|--------------|
+| | | | 是/否/备 |
+
+---
+
+## 1. …
+
+### 1.1 定义
+…
+
+### 1.2 机制分步
+1. …
+2. …
+
+### 1.3 例子 / 伪代码 / 公式
+…
+
+### 1.4 图
+
+![…](images/…)[[cite:S1]]
+
+> 图注：… 出处…
+
+### 1.5 边界
+…
+
+---
+
+## 8. 来源总表
+
+| ID | 权威性 | 网站 | 标题 | URL |
+|----|--------|------|------|-----|
+| S1 | | | | |
+
+（与 `sources.json` 同步）
+
+---
+
+## 9. 成片裁切备忘（可选·网页默认折叠）
+
+| 深点 | 0010 成片策略（讲/不讲） |
+|------|---------------------------|
+| | |

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0040-script/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: uc-media-0040-script
+description: |
+  脚本（0040）：读 0030 事实 + 0010 演讲地图，蒸馏脉络/分镜/口播。
+  触发词：脚本、分镜、口播、0040。
+---
+
+# uc-media-0040-script · 脚本
+
+**模板：** [`templates/脚本.template.md`](./templates/脚本.template.md)
+
+## 行为
+
+1. **必读**  
+   - `0030-facts/事实-*.md`  
+   - `0010-product/产品卡-*.md` → **§3 讲/不讲·时长** + §1 标题/钩子  
+   - `.dwy/uc-media/channel-profile.md` → 受众语气  
+2. 按 **0010 地图** 把 0030 精简成脉络·分镜·口播。  
+3. 口播深度对齐 **0010**，非 0030 全文；「不讲」不进观众口播。  
+4. 禁止编造；缺事实回 0030。
+
+**硬停：** 人审前不进 0050。
+
+## 契约
+
+| 项 | 内容 |
+|----|------|
+| **序** | 0040 |
+| **主文档** | `0040-script/脚本-*.md` |
+| **上游** | 0030 + **0010 产品卡** + 频道 |
+
+```text
+0010 = 竞品洞察 + 演讲地图
+0030 = 按地图学深
+0040 = 按地图蒸馏成片
+```

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0040-script/templates/README.md

@@ -0,0 +1,10 @@
+# 0050 模板
+
+| 文件 | 用途 |
+|------|------|
+| **`脚本.template.md`** | **主模板**：长片/短集都用；一份含脉络+分镜+口播 |
+| `骨架-v1.1.md` | 短集结构规范（读，不单独落盘第二终稿） |
+| `事实.template.md` | 给 0040 字段参考（事实步落 `research/事实-*.md`） |
+| `单集文档.template.md` | 旧短集模板；**新片请用 `脚本.template.md`**，避免多文件 |
+
+定稿路径：`{scripts_dir}/脚本-{主题}.md`

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0040-script/templates//344/272/213/345/256/236.template.md

@@ -0,0 +1,82 @@
+# （历史模板）事实底稿 · {主题}
+
+> **已过时作流水线真源。** 新片事实深库请用：  
+> `uc-media-0030-facts` → `{work_dir}/0030-facts/事实-*.md`（作者学习资料库）  
+> 0040 脚本从该深库 **蒸馏**，并服从 `0010-product` 演讲地图的讲/不讲与时长。  
+> 本文件仅作旧单集/字段参考。  
+> 骨架：单集 [骨架-v1.1](./骨架-v1.1.md)  
+> 日期：{YYYY-MM-DD}
+
+---
+
+## 1. 一句话定义（口播可用）
+
+> …
+
+---
+
+## 2. 本集主机制（对应 F，只保留 1 个）
+
+> …
+
+---
+
+## 3. 历史锚点（对应 T，≤4 个上镜）
+
+| 时间 | 事件 | 谁 | 可讲一句 | 来源 |
+|------|------|----|----------|------|
+| | | | | |
+| | | | | |
+
+未上镜但备查：…
+
+---
+
+## 4. 生活例子池（对应 L，脚本只取 1 主 +≤1 辅）
+
+| 例子 | 映射 | 主/备 |
+|------|------|-------|
+| | | 主 |
+| | | 辅/备 |
+
+---
+
+## 5. 边界（对应 B，按需）
+
+| 误区/风险 | 人话 | 是否本集必讲 |
+|-----------|------|----------------|
+| | | 是/否 |
+
+---
+
+## 6. 验证设计（对应 V）
+
+| 模式 | 步骤 | 真图需求 |
+|------|------|----------|
+| 动手/演示/真图 | 1… 2… 3… | 文件名 |
+
+---
+
+## 7. 本集不讲（留给其他集）
+
+| 不讲 | 留给 |
+|------|------|
+| | |
+
+---
+
+## 8. 来源
+
+| # | 类型 | 线索 |
+|---|------|------|
+| S1 | | |
+
+**〔待验证〕** …
+
+---
+
+## 9. 可说硬句（已事实锁）
+
+1.  
+2.  
+3.  

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0040-script/templates//345/215/225/351/233/206/346/226/207/346/241/243.template.md

@@ -0,0 +1,175 @@
+# 单集文档 · {编号} {主题名}
+
+> **骨架：** [骨架-v1.1](./骨架-v1.1.md)（`uc-media-0040-script/templates/`）  
+> **事实锁：** `../research/事实-{主题}.md`  
+> **时长目标：** 3–5 分钟（推荐标称 **4′**）  
+> **语气：** 并肩 · 讲故事 · 事实优先 · 真截图  
+> 状态：草稿 / 人审中 / 定稿 · 日期：{YYYY-MM-DD}
+
+---
+
+## 0. 产品卡
+
+| 项 | 内容 |
+|----|------|
+| 片名 / 标题 | |
+| 一句话主线 | |
+| 目标观众 | |
+| 看完带走（≤3 点） | |
+| 时长目标 | 约 _ 分钟 |
+| 本集不讲 | |
+| 系列位置 | 第 _ 集；单集闭环：是 |
+
+---
+
+## 0.1 本集骨架裁剪表（先填再写稿）
+
+对照 v1.1：标 **满配 / 缩 / 删 / 并入某段**。
+
+| 段 | 代号 | 本集策略 | 计划秒 | 备注 |
+|----|------|----------|--------|------|
+| 钩子 | H | 满配 | 25–35 | 必选 |
+| 历史 | T | 满配 / 缩 / 删 / 并入 H|F | ≤50 | 锚点 ≤4 |
+| 事实 | F | 满配 | 60–75 | 必选；主机制 1 个 |
+| 生活 | L | 满配 | 40–50 | 主例 1；辅例可选 |
+| 边界 | B | 满配 / 并入 F / 删 | 0–30 | 按需 |
+| 验证 | V | 动手 / 演示 / 真图 / 删 | 0–40 | 三选一 |
+| 落点 | C | 满配 | 15–25 | 必选 |
+
+**本集主机制（F 只保留这一句）：**  
+> …
+
+**落点句（C）：**  
+> …
+
+**下集钩子（若有）：**  
+> …
+
+---
+
+## 1. 表达脉络（故事线）
+
+```text
+H 场景 + 缺口
+  → T 何以至此（若保留）
+  → F 机制
+  → L 生活主例
+  → B 边界（若保留）
+  → V 验证（若保留）
+  → C 落点 + 下集
+```
+
+反转/主线一句（贯穿全片）：  
+> …
+
+---
+
+## 2. 时长表（按裁剪后改秒数）
+
+| 段 | 秒 | 画面主信息 |
+|----|-----|------------|
+| H | | |
+| T | | |
+| F | | |
+| L | | |
+| B | | |
+| V | | |
+| C | | |
+| **合计** | | 目标 180–300s |
+
+---
+
+## 3. 口播稿
+
+### H · 钩子（场景 + 认知缺口）
+
+（25–35s）
+
+### T · 历史（≤4 锚点 · 可删）
+
+（40–50s 或写「本集删除/并入…」）
+
+### F · 事实（1 个机制 · 人话）
+
+（60–75s）
+
+### L · 生活（1 主例 · 可选 1 辅）
+
+（40–50s）  
+- 主例：  
+- 辅例：（可无）
+
+### B · 边界（按需）
+
+（20–30s 或删）
+
+### V · 验证（动手 | 演示 | 真图）
+
+（30–40s 或删）  
+模式：□动手 □演示 □真图对照  
+
+步骤（≤3）：
+
+1.  
+2.  
+3.  
+
+### C · 落点 + 下集
+
+（15–25s）
+
+---
+
+## 4. 分镜表
+
+| 镜号 | 段 | 秒 | 认知增量 | 画面/素材 | 口播摘要 |
+|------|----|----|----------|-----------|----------|
+| x00 | H | | | | |
+| … | | | | | |
+
+---
+
+## 5. 花字 / 贴纸（宜少）
+
+| 段 | 文案 | 形态 |
+|----|------|------|
+| | | |
+
+---
+
+## 6. 真实素材清单
+
+目录：`../assets/_real-shots/`  
+原则：真 UI；禁止 AI 假界面冒充产品。
+
+| 文件名 | 必/选 | 内容说明 |
+|--------|-------|----------|
+| | 必 | |
+| | 选 | |
+
+Logo：优先 `shared/icons/brands/`。
+
+---
+
+## 7. 发布草稿
+
+| 项 | 文案 |
+|----|------|
+| 标题 | |
+| 封面主/副 | |
+| 简介 | |
+| 标签 | |
+
+---
+
+## 8. 人审签字
+
+- [ ] 骨架裁剪表已填，必选段齐全  
+- [ ] T 未超时、锚点 ≤4  
+- [ ] F 只有 1 个主机制  
+- [ ] 口播无说教腔；落点句可记  
+- [ ] 真截图位清晰；无假 UI  
+- [ ] 单集闭环；下集钩子不过长  
+- [ ] 可进配音 / package  
+
+审阅：________  日期：________

package/templates/ai-tools/skills//350/207/252/345/252/222/344/275/223/uc-media-0040-script/templates//350/204/232/346/234/254.template.md

@@ -0,0 +1,69 @@
+# 脚本 · {主题}
+
+| 项 | 内容 |
+|----|------|
+| 状态 | 草稿 / 人审中 / 定稿 |
+| 日期 | {YYYY-MM-DD} |
+| 时长目标 | |
+| 事实来源 | `../0030-facts/事实-{主题}.md` |
+| 产品卡（竞品+地图） | `../0010-product/产品卡-{主题}.md` |
+| 频道档案 | `<project_root>/.dwy/uc-media/channel-profile.md` |
+| 受众/语气（摘自频道） | |
+| 预制型 id | overview_stations / short_story_v1_1 / … |
+
+---
+
+## 1. 表达脉络
+
+**主线一句话：**  
+> …
+
+**章序**
+
+| 章 | 标题 | 记住一句 | 目标秒 |
+|----|------|----------|--------|
+| A | | | |
+| B | | | |
+
+**本集不讲：**  
+- …
+
+（短集可在此写 H→C 故事线与骨架裁剪说明，见 `骨架-v1.1.md`。）
+
+---
+
+## 2. 分镜总表（无图）
+
+| shot_id | 章 | 秒 | 认知增量（≤8字） | 画面意图（纯文字一句） | reveal | builds_on |
+|---------|----|----|------------------|------------------------|--------|-----------|
+| A00 | A | 2 | | | hold | — |
+| A01 | A | | | | | A00 |
+
+规则：一镜一增量；全片镜号唯一；**不写图层/文件名/生图说明**。
+
+**合计预估秒：** …
+
+---
+
+## 3. 逐镜口播
+
+### A00 · {镜标题}
+
+（全文，可念）
+
+### A01 · {镜标题}
+
+（全文，可念）
+
+<!-- 按分镜表顺序继续；每镜一节，标题含 shot_id -->
+
+---
+
+## 4. 人审签字
+
+- [ ] 脉络 OK，章序讲得通  
+- [ ] 口播可念、无说教腔；事实锁 research  
+- [ ] 镜号与 §3 一一对应  
+- [ ] **可进 0050 design**（风格/技术）  
+
+审阅：________  日期：________