codewave-openclaw-installer 1.0.2 → 2.1.1

package/skills/ppt-master/templates/layouts//351/207/215/345/272/206/345/244/247/345/255/246/design_spec.md

@@ -0,0 +1,243 @@
+# Chongqing University (重庆大学) Template - Design Specification
+
+> A distinctive design blending the layered imagery of the Mountain City with modern academic elegance.
+
+---
+
+## I. Template Overview
+
+| Property           | Description                                                          |
+| ------------------ | -------------------------------------------------------------------- |
+| **Template Name**  | Chongqing University (重庆大学)                                      |
+| **Use Cases**      | Academic defense, research reports, teaching presentations, scholarly exchange |
+| **Design Tone**    | Academically grounded · Mountain City charm · Modern minimalism      |
+| **Design Inspiration** | Chongqing's layered terrain + the gravitas of historic campus buildings + modern academic professionalism |
+
+### Design Features
+
+1. **Layered Geometry**: Diagonal color blocks simulate the terraced landscape of the Mountain City, breaking away from traditional rectangular layouts
+2. **Asymmetric Aesthetics**: Left-heavy visual balance guides reading focus
+3. **Gradient Color Bands**: Deep-to-light transitions symbolize the journey from a rich history to a bright future
+4. **Wave Patterns**: Abstract Yangtze River / Jialing River water elements
+
+---
+
+## II. Canvas Specification
+
+| Property           | Value                         |
+| ------------------ | ----------------------------- |
+| **Format**         | Standard 16:9                 |
+| **Dimensions**     | 1280 × 720 px                |
+| **viewBox**        | `0 0 1280 720`               |
+| **Page Margins**   | Left/right 60px, top/bottom 40px |
+| **Content Safe Area** | x: 60-1220, y: 100-660    |
+
+---
+
+## III. Color Scheme
+
+### Primary Colors (Extracted from Logo)
+
+| Role               | Value       | Notes                                        |
+| ------------------ | ----------- | -------------------------------------------- |
+| **CQU Blue**       | `#006BB7`   | Emblem primary color; header, titles, main elements |
+| **Deep Blue**      | `#004A82`   | Chapter page background, emphasis areas      |
+| **Sky Blue**       | `#3A9BD9`   | Accent color, gradient endpoint              |
+| **Cloud Blue**     | `#E3F2FD`   | Light background, card base color            |
+| **Dawn Gold**      | `#D4A84B`   | Decorative accents, highlights (symbolizing brightness) |
+| **Background White**| `#FAFCFF`  | Subtly blue-tinted pure white                |
+
+### Text Colors
+
+| Role               | Value       | Usage                    |
+| ------------------ | ----------- | ------------------------ |
+| **Dark Ink Text**  | `#1A2E44`   | Main titles, heading text |
+| **Primary Text**   | `#333D4A`   | Body content             |
+| **Secondary Text** | `#6B7B8C`   | Captions, annotations    |
+| **White Text**     | `#FFFFFF`   | Text on dark backgrounds |
+
+### Gradient Scheme
+
+```
+Primary gradient: #004A82 → #006BB7 → #3A9BD9 (deep → light, used for background diagonal cuts)
+Gold gradient: #C49A3D → #D4A84B → #E8C675 (decorative use)
+```
+
+---
+
+## IV. Typography System
+
+### Font Stack
+
+**Font Stack**: `"Microsoft YaHei", "微软雅黑", "PingFang SC", Arial, sans-serif`
+
+### Font Size Hierarchy
+
+| Level | Usage              | Size | Weight  | Notes              |
+| ----- | ------------------ | ---- | ------- | ------------------ |
+| H1    | Cover main title   | 48px | Bold    | Grand and dignified |
+| H2    | Page title         | 26px | Bold    |                    |
+| H3    | Chapter title      | 44px | Bold    |                    |
+| H4    | Card title         | 22px | Bold    |                    |
+| P     | Body content       | 17px | Regular |                    |
+| High  | Emphasized data    | 32px | Bold    |                    |
+| Sub   | Notes/sources      | 13px | Regular |                    |
+| XS    | Page number/copyright | 11px | Regular |                 |
+
+---
+
+## V. Core Visual Elements
+
+### 1. Diagonal Color Blocks (Mountain City Layers)
+
+The template's signature design uses diagonally divided color blocks to simulate the layered terrain of the Mountain City:
+
+```
+Cover: Large deep-blue diagonal block in the lower-left corner (approx. 40% of area)
+Chapter page: Full-screen deep blue + light diagonal accent in the upper-right
+Content page: Small diagonal accent strip at the top
+```
+
+### 2. Wave Patterns (Two Rivers Imagery)
+
+Abstract curves symbolizing the Yangtze and Jialing Rivers:
+
+```xml
+<path d="M0,700 Q320,680 640,700 T1280,680 L1280,720 L0,720 Z"
+      fill="#006BB7" fill-opacity="0.08"/>
+```
+
+### 3. Light Dot Decorations (City Lights)
+
+Small circle elements representing the nighttime lights of the Mountain City:
+
+```xml
+<circle cx="x" cy="y" r="3" fill="#D4A84B" fill-opacity="0.6"/>
+```
+
+---
+
+## VI. Page Types
+
+### 1. Cover Page (01_cover.svg)
+
+**Layout Structure**:
+- Upper-right area: Logo (using logo.png)
+- Center-left: Main title + subtitle
+- Lower-left corner: Large diagonal deep-blue color block (extending from lower-left to upper-right)
+- Bottom: Presenter info, date
+- Decorations: Wave patterns + gold light dots
+
+### 2. Chapter Page (02_chapter.svg)
+
+**Layout Structure**:
+- Full-screen deep blue background
+- Upper-right: Diagonal light area (sky blue gradient)
+- Left: Large chapter number (semi-transparent)
+- Center-left: Chapter title (white)
+- Bottom: Gold decorative line + Logo (white version)
+
+### 3. Content Page (03_content.svg)
+
+**Layout Structure**:
+- Top: Diagonal blue accent strip (approx. 80px height, higher on left, lower on right)
+- On the accent strip: Page title + Logo
+- Body: White content area (flexible layout)
+- Left: Thin gold decorative line
+- Bottom: Clean footer + wave pattern
+
+### 4. Ending Page (04_ending.svg)
+
+**Layout Structure**:
+- Center: Large-sized Logo
+- Below logo: Thank-you message
+- Bottom diagonal blue area: Contact information
+- Decorations: Wave patterns + gold light dots
+
+### 5. Table of Contents (02_toc.svg)
+
+**Layout Structure**:
+- Top diagonal accent strip + title
+- Left: Large numeric indices (vertically arranged, with gold accents)
+- Right: TOC item text
+- Bottom: Wave decoration
+
+---
+
+## VII. Logo Usage Guidelines
+
+| File | Applicable Context | Notes |
+|------|-------------------|-------|
+| `重庆大学logo.png` | Light/white backgrounds | Blue version |
+| `重庆大学logo2.png` | Dark/blue backgrounds | White version |
+
+**Recommended Logo Sizes**:
+- Cover page: Width 280-320px
+- Content page header: Width 160-200px
+- Ending page: Width 320-400px
+
+---
+
+## VIII. Spacing Specification
+
+| Element              | Value      |
+| -------------------- | ---------- |
+| Page margins         | 60px       |
+| Content block spacing | 28px      |
+| Card inner padding   | 24px       |
+| Card border radius   | 12px       |
+| Diagonal cut angle   | Approx. 8-12° |
+
+---
+
+## IX. SVG Technical Constraints
+
+### Mandatory Rules
+
+1. viewBox: `0 0 1280 720`
+2. Define gradients using `<linearGradient>` inside `<defs>`
+3. Use `fill-opacity` / `stroke-opacity` for transparency
+4. Use `<tspan>` for text wrapping
+5. Use Base64 inline or `<image>` reference for logos
+
+### Prohibited Elements
+
+- `clipPath`, `mask`, `<style>`, `class`
+- `foreignObject`, `textPath`, `animate*`
+- `rgba()` color format
+- `<g opacity="...">` (group opacity)
+
+---
+
+## X. Placeholder Specification
+
+| Placeholder          | Description            |
+| -------------------- | ---------------------- |
+| `{{TITLE}}`          | Main title             |
+| `{{SUBTITLE}}`       | Subtitle               |
+| `{{AUTHOR}}`         | Presenter name         |
+| `{{ADVISOR}}`        | Thesis advisor         |
+| `{{INSTITUTION}}`    | College/Institution    |
+| `{{DATE}}`           | Date                   |
+| `{{PAGE_TITLE}}`     | Page title             |
+| `{{CHAPTER_NUM}}`    | Chapter number         |
+| `{{CHAPTER_TITLE}}`  | Chapter title          |
+| `{{CHAPTER_DESC}}`   | Chapter description    |
+| `{{KEY_MESSAGE}}`    | Key message            |
+| `{{CONTENT_AREA}}`   | Content area           |
+| `{{PAGE_NUM}}`       | Page number            |
+| `{{THANK_YOU}}`      | Thank-you message      |
+| `{{CONTACT_INFO}}`   | Contact information    |
+| `{{TOC_ITEM_N_TITLE}}` | TOC item title       |
+| `{{TOC_ITEM_N_DESC}}`  | TOC item description  |
+
+---
+
+## XI. Design Checklist
+
+- [ ] viewBox = `0 0 1280 720`
+- [ ] Diagonal block angles are consistent (8-12°)
+- [ ] Logo version matches background
+- [ ] Colors conform to specification
+- [ ] Wave decorations are correctly positioned
+- [ ] Text is readable (>=11px)

package/skills/ppt-master/workflows/create-template.md

@@ -0,0 +1,173 @@
+---
+description: Generate a new PPT layout template based on existing project files or reference templates
+---
+
+# Create New Template Workflow
+
+> **Role invoked**: [Template_Designer](../references/template-designer.md)
+
+Generate a complete set of reusable PPT layout templates for the **global template library**.
+
+> This workflow is for **library asset creation**, not project-level one-off customization. The output must be reusable by future PPT projects and discoverable from `templates/layouts/layouts_index.json`.
+
+## Process Overview
+
+```
+Gather Brief -> Create Directory -> Invoke Template_Designer -> Validate Assets -> Register Index -> Output
+```
+
+---
+
+## Step 1: Gather Template Information
+
+Confirm the following with the user:
+
+| Item | Required | Description |
+|------|----------|-------------|
+| New template ID | Yes | Template directory / index key. Prefer ASCII slug such as `my_company`; if using a Chinese brand name, it must be filesystem-safe and match `layouts_index.json` exactly |
+| Template display name | Yes | Human-readable name for documentation |
+| Category | Yes | One of `brand` / `general` / `scenario` / `government` / `special` |
+| Applicable scenarios | Yes | Typical use cases, such as annual report / defense / government briefing |
+| Tone summary | Yes | Short tone description for recommendation, such as `Modern, restrained, data-driven` |
+| Theme mode | Yes | Theme description for recommendation, such as `Light theme (white background + blue accent)` |
+| Canvas format | Yes | Default `ppt169`; if another format is needed, specify it explicitly before generation |
+| Reference source | Optional | Existing project or template path |
+| Theme color | Optional | Primary color HEX value (can be auto-extracted from reference) |
+| Design style | Optional | Additional style notes, decorative language, brand cues |
+| Assets list | Optional | Logos / background textures / reference images to include in the template package |
+| Quick lookup tags | Optional | Tags used in `layouts_index.json > quickLookup`, such as `technology`, `finance`, `academic` |
+
+**Required outcome of Step 1**:
+
+- The template is clearly positioned as a **global library template**
+- The canvas format is fixed before SVG generation
+- The template metadata is complete enough to register into `layouts_index.json`
+
+**If a reference source is provided**, analyze its structure first:
+
+```bash
+ls -la "<reference_source_path>"
+```
+
+---
+
+## Step 2: Create Template Directory
+
+```bash
+mkdir -p "skills/ppt-master/templates/layouts/<template_id>"
+```
+
+> **Output location**: Global templates go to `skills/ppt-master/templates/layouts/`; project templates go to `projects/<project>/templates/`
+>
+> The generated directory name must match the final template ID used in `layouts_index.json`.
+
+---
+
+## Step 3: Invoke Template_Designer Role
+
+**Switch to the Template_Designer role** and generate per role definition. The role input is the finalized template brief from Step 1, not a project design spec.
+
+1. **design_spec.md** — Design specification document
+2. **4 core templates** — Cover, chapter, content, ending pages
+3. **TOC page (optional)** — `02_toc.svg`
+4. **Template assets (optional)** — Logos / PNG / JPG / reference SVG needed by the template package
+
+> **Role details**: See [template-designer.md](../references/template-designer.md)
+
+**New-template placeholder contract (mandatory for newly created library templates)**:
+
+- Cover: `{{TITLE}}`, `{{SUBTITLE}}`, `{{DATE}}`, `{{AUTHOR}}`
+- Chapter: `{{CHAPTER_NUM}}`, `{{CHAPTER_TITLE}}`
+- Content: `{{PAGE_TITLE}}`, `{{CONTENT_AREA}}`, `{{PAGE_NUM}}`
+- Ending: `{{THANK_YOU}}`, `{{CONTACT_INFO}}`
+- TOC: use indexed placeholders such as `{{TOC_ITEM_1_TITLE}}` and optional `{{TOC_ITEM_1_DESC}}`
+
+**Avoid** introducing one-off placeholder families such as `{{CHAPTER_01_TITLE}}` for new templates. If an extension placeholder is truly required, define it explicitly in `design_spec.md` and keep the naming pattern consistent.
+
+---
+
+## Step 4: Validate Template Assets
+
+```bash
+ls -la "skills/ppt-master/templates/layouts/<template_id>"
+```
+
+Run SVG validation on the template directory:
+
+```bash
+python3 skills/ppt-master/scripts/svg_quality_checker.py "skills/ppt-master/templates/layouts/<template_id>" --format <canvas_format>
+```
+
+**Checklist**:
+
+- [ ] `design_spec.md` contains complete design specification
+- [ ] All 4 core templates present
+- [ ] If TOC exists, placeholder pattern uses the canonical indexed form
+- [ ] SVG viewBox matches the chosen canvas format (for `ppt169`: `0 0 1280 720`)
+- [ ] Placeholder names are consistent with the new-template contract and `design_spec.md`
+- [ ] Asset files referenced by SVGs actually exist in the template package
+
+This step is a **hard gate**. Do not register the template into the library index until validation passes.
+
+---
+
+## Step 5: Register Template in Library Index
+
+Update `skills/ppt-master/templates/layouts/layouts_index.json`:
+
+- `meta.total`
+- `meta.updated`
+- the correct `categories.<category>.layouts` entry
+- the appropriate `quickLookup` entries
+- the new `layouts.<template_id>` metadata block
+
+`layouts_index.json` is the **source of truth** for template discovery in the main PPT generation workflow. A template directory that is not registered here is considered incomplete.
+
+If the human-facing `templates/layouts/README.md` summary table is maintained manually, sync it after updating the JSON index. The JSON index takes priority.
+
+---
+
+## Step 6: Output Confirmation
+
+```markdown
+## Template Creation Complete
+
+**Template Name**: <template_id> (<display_name>)
+**Template Path**: `skills/ppt-master/templates/layouts/<template_id>/`
+**Category**: <category>
+**Canvas Format**: <canvas_format>
+**Index Registration**: Done
+
+### Files Included
+
+| File | Status |
+|------|--------|
+| `design_spec.md` | Done |
+| `01_cover.svg` | Done |
+| `02_chapter.svg` | Done |
+| `03_content.svg` | Done |
+| `04_ending.svg` | Done |
+| `02_toc.svg` | Optional |
+```
+
+---
+
+## Color Scheme Quick Reference
+
+| Style | Primary Color | Use Cases |
+|-------|---------------|-----------|
+| Tech Blue | `#004098` | Certification, evaluation |
+| McKinsey | `#005587` | Strategic consulting |
+| Government Blue | `#003366` | Government projects |
+| Business Gray | `#2C3E50` | General business |
+
+---
+
+## Notes
+
+1. **SVG technical constraints**: See the technical constraints section in [template-designer.md](../references/template-designer.md)
+2. **Color consistency**: All SVG files must use the same color scheme
+3. **Placeholder convention**: Use `{{}}` format and the canonical new-template placeholder contract above
+4. **Discovery requirement**: New templates must be added to `layouts_index.json`, otherwise the main workflow cannot recommend them
+
+> **Detailed specification**: See [template-designer.md](../references/template-designer.md)

package/skills/speed-to-text/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: speed-to-text
+description: "转录音视频为文字稿。支持 DashScope、AI服务商（如AIGW）在线 API 或本地 qwen-asr-serve。触发词：转录、转写、音频转文字、视频转文字、语音识别"
+---
+
+# Speech-to-Text
+
+通过 `razel-py-cli speech-to-text` 将音视频转为文字稿。
+
+## Quick Reference
+
+| 参数 | 简写 | 说明 | 默认值 |
+|------|------|------|--------|
+| `--input-file` | `-i` | 输入文件路径或 URL | **必填** |
+| `--output-dir` | `-o` | 结果目录 | `~/.razel/speech_to_text` |
+| `--format` | `-f` | `md` / `txt` | `md` |
+| `--output-name` | `-n` | 输出基名（不含扩展名） | 输入文件名 |
+| `--save-srt` | `-srt` | 额外生成 SRT 字幕 | 关 |
+| `--context` | `-c` | 上下文提示文本 | `""` |
+| `--provider` | | `auto` / `aigw` / `dashscope` / `local` | `auto` |
+| `--aigw` | `-a` | `auto` 时优先走 AIGW | 关 |
+| `--fallback-order` | | 仅 `auto` 生效，如 `aigw,dashscope,local` | `aigw,dashscope,local` |
+| `--num-threads` | `-j` | 并行线程数 | `8` |
+| `--vad-segment-threshold` | `-d` | 长音频 VAD 切分目标时长（秒） | `120` |
+| `--silence` | `-s` | 静默模式 | 关 |
+
+## 决策树
+
+```
+用户想转录音视频
+├─ 有本地文件 → razel-py-cli speech-to-text -i /path/to/file
+├─ 有在线 URL → razel-py-cli speech-to-text -i <url>
+└─ Provider 选择
+   ├─ 默认 auto → 按 fallback-order 依次尝试
+   ├─ 指定 --provider aigw|dashscope|local → 只走该通路
+   └─ 本地服务 → 需在 ~/.razel/config.json 中配置 local_server
+```
+
+## 使用示例
+
+```bash
+# 默认 auto（按 aigw -> dashscope -> local 依次尝试）
+razel-py-cli speech-to-text -i audio.mp4
+
+# 强制 AIGW
+razel-py-cli speech-to-text -i audio.mp4 --provider aigw
+
+# 指定输出目录和格式
+razel-py-cli speech-to-text -i meeting.mp3 -o /tmp/out -f txt
+
+# 生成 SRT 字幕
+razel-py-cli speech-to-text -i video.mp4 --save-srt
+
+# 自定义 auto 兜底顺序
+razel-py-cli speech-to-text -i audio.mp4 --provider auto --fallback-order local,aigw,dashscope
+```
+
+## Common Mistakes
+
+| 错误 | 正确做法 |
+|------|----------|
+| `--provider local` 但未配置 `local_server` | 在 `~/.razel/config.json` 中配置 local_server 地址 |
+| `auto` 下所有 provider 都不可用 | 检查 `~/.razel/config.json` 中的密钥配置或本地服务是否可达 |
+| 缺少 `~/.razel/config.json` | 先运行 `razel-py-cli init` 生成模板并填写密钥 |

package/skills/tencent-meeting/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: tencent-meeting
+description: "腾讯会议回放嗅探：区分三类输出（video/doc/summary）。默认 `pick=video`；video/doc 会落盘，`pick=summary` 只打印会议总结给其他 skill 读取。触发词：会议回放下载、腾讯会议下载、meeting.tencent.com、下载回放、视频嗅探、会议摘要、会议时间轴、会议逐字稿"
+---
+
+# Tencent Meeting Download
+
+通过 `razel-cli tencent-meeting` 嗅探腾讯会议回放页，获取视频直链、智能纪要、时间轴、逐字稿等数据。
+
+## 命令选择决策树
+
+```
+用户要操作腾讯会议回放
+├─ 只嗅探获取数据（不落盘） → razel-cli tencent-meeting sniff
+└─ 需要下载文件到本地 → razel-cli tencent-meeting download
+```
+
+## Quick Reference
+
+### 子命令
+
+| 子命令 | 说明 |
+|--------|------|
+| `sniff` | 结果以 JSON 打印到 stdout，不落盘 |
+| `download` | `pick=video` 或 `doc` 时写入文件；`pick=summary` 时行为与 sniff 类似 |
+
+### 共用选项
+
+| 选项 | 短选项 | 说明 | 必需 | 默认值 |
+|------|--------|------|------|--------|
+| `--url` | `-u` | 会议回放页 URL | 是 | - |
+| `--pick` | - | `video` \| `doc` \| `summary` | 否 | sniff 默认 `summary`，download 默认 `video` |
+| `--output` | `-o` | 输出目录（需要落盘时使用） | 否 | ~/.razel/popo/doc-output 文件夹 |
+| `--name` | `-n` | 输出文件基础名 | 否 | 自动命名 |
+| `--doc-format` | `-f` | `md` \| `txt`，仅 `download --pick doc` 生效 | 否 | `md` |
+| `--show-browser` | `-b` | 使用有界面 Chromium（便于登录/调试） | 否 | `false` |
+
+## 使用示例
+
+```bash
+# 嗅探纪要（默认 pick=summary）
+razel-cli tencent-meeting sniff -u "https://meeting.tencent.com/cw/xxxx"
+
+# 嗅探视频 URL 列表（JSON，不落盘）
+razel-cli tencent-meeting sniff -u "https://..." --pick video
+
+# 下载视频到指定目录
+razel-cli tencent-meeting download -u "https://..." -o ~/Downloads
+
+# 下载文字稿为 Markdown
+razel-cli tencent-meeting download -u "https://..." --pick doc -f md -n 我的会议稿
+
+# 有界面模式（登录或调试）
+razel-cli tencent-meeting sniff -u "https://..." -b
+```
+
+## Common Mistakes
+
+| 错误 | 正确做法 |
+|------|----------|
+| 会议回放看不到对应内容 | 检查该账号是否对回放可见（是否需密码/申请权限） |
+| sniff 后想下载但用错子命令 | sniff 只输出 JSON 不落盘；要下载文件用 download |
+| 未指定 `-o` 时找不到输出文件 | 查看默认输出目录，或显式指定 `-o` |
+| 需要会议总结给其他 skill | 使用 `sniff --pick summary` 或 `download --pick summary`，stdout 输出 JSON |
+| `--show-browser` 与 `-h` 混淆 | 帮助是 `-h/--help`，有界面模式是 `-b/--show-browser` |