@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/creative/baoyu-comic/references/workflow.md

@@ -0,0 +1,401 @@
+# Complete 工作流
+
+生成知识漫画的完整工作流。
+
+## Progress 检查清单
+
+复制并跟踪进度：
+
+```
+Comic Progress:
+- [ ] Step 1: Setup & Analyze
+  - [ ] 1.1 Analyze content
+  - [ ] 1.2 Check existing ⚠️ REQUIRED
+- [ ] Step 2: Confirmation - Style & options ⚠️ REQUIRED
+- [ ] Step 3: Generate storyboard + characters
+- [ ] Step 4: Review outline (conditional)
+- [ ] Step 5: Generate prompts
+- [ ] Step 6: Review prompts (conditional)
+- [ ] Step 7: Generate images
+  - [ ] 7.1 Character sheet (if needed)
+  - [ ] 7.2 Generate pages
+- [ ] Step 8: Completion report
+```
+
+## Flow Diagram
+
+```
+Input → Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review Outline?] → Prompts → [Review Prompts?] → Images → Complete
+```
+
+---
+
+## Step 1: 配置 & Analyze
+
+### 1.1 Analyze Content → `analysis.md`
+
+阅读源内容，如有需要进行保存，并进行深度分析。
+
+**Actions**:
+1. **保存源内容**（如果尚未保存为文件）：
+   - 如果用户提供了文件路径：按原样使用
+   - 如果用户粘贴了内容：使用 `write_file` 将其保存到目标目录下的 `source-{slug}.md` 中，其中 `{slug}` 是用于输出目录的 kebab-case 主题 slug
+   - **备份规则**：如果 `source-{slug}.md` 已存在，在写入前将其重命名为 `source-{slug}-backup-YYYYMMDD-HHMMSS.md`
+2. 阅读源内容
+3. **深度分析**遵循 `analysis-framework.md`：
+   - 目标受众识别
+   - 为读者提供的价值主张
+   - 核心主题与叙事潜力
+   - 关键人物及其故事弧线
+4. 检测源语言
+5. **确定语言**：
+   - 如果用户指定了语言 → 使用该语言
+   - 否则 → 使用检测到的源语言或用户的对话语言
+6. 确定推荐的页数：
+   - 短篇故事：5-8 页
+   - 中等复杂度：9-15 页
+   - 完整传记：16-25 页
+7. 分析内容信号，用于提供美术/基调/布局建议
+8. 使用 `write_file` **保存至 `analysis.md`**
+
+**analysis.md Format**: YAML front matter (title, topic, time_span, source_language, user_language, aspect_ratio, recommended_page_count, recommended_art, recommended_tone) + sections for Target Audience, Value Proposition, Core Themes, Key Figures & Story Arcs, Content Signals, 推荐 Approaches. See `analysis-framework.md` for full template.
+
+### 1.2 Check Existing Content ⚠️ REQUIRED
+
+**在进入 Step 2 之前必须执行。**
+
+检查输出目录是否存在（例如，通过 `test -d "comic/{topic-slug}"`）。
+
+**如果目录已存在**，使用 `clarify`：
+
+```
+question: "Existing content found at comic/{topic-slug}. How to proceed?"
+options:
+  - "Regenerate storyboard — Keep images, regenerate storyboard and characters only"
+  - "Regenerate images — Keep storyboard, regenerate images only"
+  - "Backup and regenerate — Backup to {slug}-backup-{timestamp}, then regenerate all"
+  - "Exit — Cancel, keep existing content unchanged"
+```
+
+保存结果并进行相应处理：
+- **重新生成分镜**：跳至 Step 3，保留 `prompts/` 和图像
+- **重新生成图像**：跳至 Step 7，使用现有提示词
+- **备份并重新生成**：移动目录，从 Step 2 重新开始
+- **退出**：立即结束工作流
+
+---
+
+## Step 2: Confirmation - Style & Options ⚠️
+
+**目的**：选择视觉风格 + 决定是否在生成前审查大纲。**切勿跳过。**
+
+**首先显示摘要**：
+- 识别出的内容类型 + 主题
+- 提取的关键人物
+- 检测到的时间跨度
+- 推荐页数
+- 语言（检测到的或用户指定的）
+- **推荐风格**：[art] + [tone]（基于内容信号）
+
+**使用 `clarify` 逐个提问**，按优先级顺序：
+
+> **超时处理（关键）**：如果 `clarify` 返回 `"The user did not provide a response within the time limit. Use your best judgement..."`，这是针对单个问题的默认值，而不是一揽子同意。继续顺序中的下一个问题 —— 不要退出 Step 2。然后，在下一条用户可见的消息中，明确指出所采取的每个默认值（例如 `"Defaulted style → ohmsha, narrative focus → concept explanation, audience → developers (clarify timed out on all three). Say the word to redirect."`）。未报告的默认值对用户来说与“代理从未询问过”无法区分。
+
+### Question 1: Visual Style
+
+如果推荐了预设（见 `auto-selection.md`），请优先显示：
+
+```
+question: "Which visual style for this comic?"
+options:
+  - "[preset name] preset (Recommended) — [preset description] with special rules"
+  - "[recommended art] + [recommended tone] (Recommended) — Best match for your content"
+  - "ligne-claire + neutral — Classic educational, Logicomix style"
+  - "ohmsha preset — Educational manga with visual metaphors, gadgets, NO talking heads"
+  - "Custom — Specify your own art + tone or preset"
+```
+
+**Preset vs Art+Tone**: Presets include special rules beyond art+tone. `ohmsha` = manga + neutral + visual metaphor rules + character roles + NO talking heads. Plain `manga + neutral` does NOT include these rules.
+
+### Question 2: Narrative Focus
+
+```
+question: "What should the comic emphasize? (Pick the primary focus; mention others in a follow-up if needed)"
+options:
+  - "Biography/life story — Follow a person's journey through key life events"
+  - "Concept explanation — Break down complex ideas visually"
+  - "Historical event — Dramatize important historical moments"
+  - "Tutorial/how-to — Step-by-step educational guide"
+```
+
+### Question 3: Target Audience
+
+```
+question: "Who is the primary reader?"
+options:
+  - "General readers — Broad appeal, accessible content"
+  - "Students/learners — Educational focus, clear explanations"
+  - "Industry professionals — Technical depth, domain knowledge"
+  - "Children/young readers — Simplified language, engaging visuals"
+```
+
+### Question 4: Outline Review
+
+```
+question: "Do you want to review the outline before image generation?"
+options:
+  - "Yes, let me review (Recommended) — Review storyboard and characters before generating images"
+  - "No, generate directly — Skip outline review, start generating immediately"
+```
+
+### Question 5: Prompt Review
+
+```
+question: "Review prompts before generating images?"
+options:
+  - "Yes, review prompts (Recommended) — Review image generation prompts before generating"
+  - "No, skip prompt review — Proceed directly to image generation"
+```
+
+**响应后**：
+1. 根据用户偏好更新 `analysis.md`
+2. 根据 Question 4 的响应**存储 `skip_outline_review`** 标志
+3. 根据 Question 5 的响应**存储 `skip_prompt_review`** 标志
+4. → Step 3
+
+---
+
+## Step 3: Generate Storyboard + Characters
+
+使用 Step 2 确认的风格创建分镜和角色定义。
+
+**加载风格参考**：
+- Art style: `art-styles/{art}.md`
+- Tone: `tones/{tone}.md`
+- 如果使用预设 (ohmsha/wuxia/shoujo/concept-story/four-panel)：还要加载 `presets/{preset}.md`
+
+**生成**：
+
+1. **分镜** (`storyboard.md`)：
+   - 包含 art_style, tone, layout, aspect_ratio 的 YAML front matter
+   - 封面设计
+   - 每一页：布局、分格分解、视觉提示
+   - **使用用户偏好的语言编写**（来自 Step 1）
+   - 参考：`storyboard-template.md`
+   - **如果使用预设**：从 `presets/` 加载并应用预设规则
+
+2. **角色定义** (`characters/characters.md`)：
+   - 匹配 art style 的视觉规格（使用用户偏好的语言）
+   - 包含用于后续图像生成的 Reference Sheet Prompt
+   - 参考：`character-template.md`
+   - **如果使用 ohmsha 预设**：使用默认的 Doraemon 角色（见下文）
+
+**Ohmsha 默认 Characters**（除非用户指定自定义角色，否则使用这些）：
+
+| 角色 | Character | 视觉说明 |
+|------|-----------|-------------------|
+| Student | 大雄 (Nobita) | Japanese boy, 10yo, round glasses, black hair parted in middle, yellow shirt, navy shorts |
+| Mentor | 哆啦 A 梦 (Doraemon) | Round blue robot cat, big white eyes, red nose, whiskers, white belly with 4D pocket, golden bell, no ears |
+| Challenge | 胖虎 (Gian) | Stocky boy, rough features, small eyes, orange shirt |
+| Support | 静香 (Shizuka) | Cute girl, black short hair, pink dress, gentle expression |
+
+这些是标准的 ohmsha 风格角色。除非明确要求，否则请勿为 ohmsha 创建自定义角色。
+
+**生成后**：
+- 如果 `skip_outline_review` 为 true → 跳过 Step 4，直接进入 Step 5
+- 如果 `skip_outline_review` 为 false → 继续执行 Step 4
+
+---
+
+## Step 4: Review Outline (Conditional)
+
+如果用户在 Step 2 中选择了“No, generate directly”，则**跳过此步骤**。
+
+**目的**：用户在生成之前审查并确认分镜 + 角色。
+
+**显示**：
+- 页数和结构
+- Art style + Tone 组合
+- 逐页摘要（封面 → P1 → P2...）
+- 角色列表及简短描述
+
+**使用 `clarify`**：
+
+```
+question: "Ready to generate images with this outline?"
+options:
+  - "Yes, proceed (Recommended) — Generate character sheet and comic pages"
+  - "Edit storyboard first — I'll modify storyboard.md before continuing"
+  - "Edit characters first — I'll modify characters/characters.md before continuing"
+  - "Edit both — I'll modify both files before continuing"
+```
+
+**响应后**：
+1. 如果用户想要编辑 → 等待用户完成编辑，然后再次询问
+2. 如果用户确认 → 继续执行 Step 5
+
+---
+
+## Step 5: Generate Prompts
+
+为所有页面创建图像生成提示词。
+
+**加载风格参考**：
+- 读取 `art-styles/{art}.md` 获取渲染指南
+- 读取 `tones/{tone}.md` 获取情绪/颜色调整
+- 如果使用预设：读取 `presets/{preset}.md` 获取特殊规则
+
+**对于每一页（封面 + 页面）**：
+1. 遵循 art style + tone 指南创建提示词
+2. **内联嵌入角色描述**（从 `characters/characters.md` 复制相关特征）—— `image_generate` 仅支持提示词，因此提示词文本是保持角色一致性的唯一手段
+3. 使用 `write_file` 保存至 `prompts/NN-{cover|page}-[slug].md`
+   - **备份规则**：如果提示词文件已存在，重命名为 `prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`
+
+**提示词文件格式**：
+```markdown
+# Page NN: [Title]
+
+## Visual Style
+Art: [art style] | Tone: [tone] | Layout: [layout type]
+
+## Character Reference (embedded inline — maintain exact traits below)
+- [Character A]: [detailed visual traits from characters/characters.md]
+- [Character B]: [detailed visual traits from characters/characters.md]
+
+## Panel Breakdown
+[From storyboard.md - panel descriptions, actions, dialogue]
+
+## Generation Prompt
+[Combined prompt passed to image_generate]
+```
+
+**生成后**：
+- 如果 `skip_prompt_review` 为 true → 跳过 Step 6，直接进入 Step 7
+- 如果 `skip_prompt_review` 为 false → 继续执行 Step 6
+
+---
+
+## Step 6: Review Prompts (Conditional)
+
+如果用户在 Step 2 中选择了“No, skip prompt review”，则**跳过此步骤**。
+
+**目的**：用户在图像生成前审查并确认提示词。
+
+**显示提示词摘要表**：
+
+| Page | Title | Key Elements |
+|------|-------|--------------|
+| Cover | [title] | [main visual] |
+| P1 | [title] | [key elements] |
+| ... | ... | ... |
+
+**使用 `clarify`**：
+
+```
+question: "Ready to generate images with these prompts?"
+options:
+  - "Yes, proceed (Recommended) — Generate all comic page images"
+  - "Edit prompts first — I'll modify prompts/*.md before continuing"
+  - "Regenerate prompts — Regenerate all prompts with different approach"
+```
+
+**响应后**：
+1. 如果用户想要编辑 → 等待用户完成编辑，然后再次询问
+2. 如果用户想要重新生成 → 返回 Step 5
+3. 如果用户确认 → 继续执行 Step 7
+
+---
+
+## Step 7: Generate Images
+
+使用 Step 5/6 中确认的提示词，调用 `image_generate` 工具。该工具仅接受 `prompt` 和 `aspect_ratio`（`landscape` | `portrait` | `square`），并 **返回一个 URL** —— 它不接受参考图像，也不写入本地文件。每次调用后必须紧跟一个下载步骤。
+
+**宽高比映射** —— 将分镜的 `aspect_ratio` 映射到工具的枚举值：
+
+| Storyboard ratio | `image_generate` format |
+|------------------|-------------------------|
+| `3:4`, `9:16`, `2:3` | `portrait` |
+| `4:3`, `16:9`, `3:2` | `landscape` |
+| `1:1` | `square` |
+
+**下载流程**（在每次成功的 `image_generate` 调用后运行）：
+
+1. 从工具结果中提取 `url` 字段
+2. 获取到磁盘，例如 `curl -fsSL "<url>" -o comic/{slug}/<target>.png`
+3. 验证文件不为空（`test -s <target>.png`）；如果失败，重试一次生成
+
+### 7.1 生成 Character 参考 Sheet（按需）
+
+对于包含重复角色的多页漫画，建议生成角色表，但对于所有预设而言**并非必需**。
+
+**何时生成**：
+
+| Condition | Action |
+|-----------|--------|
+| Multi-page comic with detailed/recurring characters | Generate character sheet (recommended) |
+| Preset with simplified characters (e.g., four-panel minimalist) | Skip — prompt descriptions are sufficient |
+| Single-page comic | Skip unless characters are complex |
+
+**生成时**：
+1. 使用来自 `characters/characters.md` 的 Reference Sheet Prompt
+2. **备份规则**：如果 `characters/characters.png` 已存在，重命名为 `characters/characters-backup-YYYYMMDD-HHMMSS.png`
+3. 调用 `image_generate` 并使用 `landscape` 格式
+4. 下载返回的 URL → 保存至 `characters/characters.png`
+
+**重要说明**：下载的角色表是一个**面向人类的审查产物**（以便用户可以直观地验证角色设计），并为以后的重写或手动提示词编辑提供参考。它**不**驱动 Step 7.2 —— 页面提示词在 Step 5 中已经根据 `characters/characters.md` 中的文本描述编写完毕。`image_generate` 不能接受图像作为视觉输入，因此文本是跨页面保持一致性的唯一机制。
+
+### 7.2 Generate Comic Pages
+
+**在生成任何页面之前**：
+1. 确认每个提示词文件存在于 `prompts/NN-{cover|page}-[slug].md`
+2. 确认每个提示词都内联嵌入了角色描述（见 Step 5）。`image_generate` 仅支持提示词，因此提示词文本是唯一的一致性机制。
+
+**页面生成策略**：每个页面提示词必须内联嵌入角色描述（源自 `characters/characters.md`）。这在 Step 5 期间完成，无论在 7.1 中是否生成了 PNG 角色表都一视同仁 —— PNG 仅作为审查/重写辅助，绝不作为生成输入。
+
+**嵌入提示词示例** (`prompts/01-page-xxx.md`)：
+
+```markdown
+# Page 01: [Title]
+
+## Character Reference (embedded inline — maintain consistency)
+- 大雄：Japanese boy, round glasses, yellow shirt, navy shorts, worried expression...
+- 哆啦 A 梦：Round blue robot cat, white belly, red nose, golden bell, 4D pocket...
+
+## Page Content
+[Original page prompt body — panels, dialogue, visual metaphors]
+```
+
+**对于每一页（封面 + 页面）**：
+1. 从 `prompts/NN-{cover|page}-[slug].md` 读取提示词
+2. **备份规则**：如果图像文件已存在，重命名为 `NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`
+3. 调用 `image_generate` 并传入提示词文本和映射后的宽高比
+4. 下载返回的 URL → 保存至 `NN-{cover|page}-[slug].png`
+5. 每次生成后报告进度：“Generated X/N: [page title]”
+
+---
+
+## Step 8: Completion Report
+
+```
+Comic Complete!
+Title: [title] | Art: [art] | Tone: [tone] | Pages: [count] | Aspect: [ratio] | Language: [lang]
+Location: [path]
+✓ source-{slug}.md (if content was pasted)
+✓ analysis.md
+✓ characters.png (if generated)
+✓ 00-cover-[slug].png ... NN-page-[slug].png
+```
+
+---
+
+## Page Modification
+
+| Action | Steps |
+|--------|-------|
+| **Edit** | Update prompt → Regenerate image → Download new PNG |
+| **Add** | Create prompt at position → Generate image → Download PNG → Renumber subsequent (NN+1) → Update storyboard |
+| **Delete** | Remove files → Renumber subsequent (NN-1) → Update storyboard |
+
+**文件命名**：`NN-{cover|page}-[slug].png`（例如，`03-page-enigma-machine.png`）
+- Slugs：kebab-case，唯一，派生自内容
+- 重新编号：仅更新 NN 前缀，slug 保持不变

package/extensions/skills/optional/creative/blender-mcp/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: blender-mcp
+description: 通过与 blender-mcp 插件的 socket 连接，直接从 Hermes 控制 Blender。创建 3D 对象、材质、动画，并运行任意 Blender Python (bpy) 代码。当用户想要在 Blender 中创建或修改任何内容时使用。
+version: 1.0.0
+requires: Blender 4.3+ (需要桌面实例，不支持 headless 模式)
+author: alireza78a
+tags: [blender, 3d, animation, modeling, bpy, mcp]
+platforms: [linux, macos, windows]
+---
+
+# Blender MCP
+
+通过 TCP 端口 9876 上的 socket，从 Hermes 控制正在运行的 Blender 实例。
+
+## 配置 (一次性)
+
+### 1. 安装 the Blender addon
+
+    curl -sL https://raw.githubusercontent.com/ahujasid/blender-mcp/main/addon.py -o ~/Desktop/blender_mcp_addon.py
+
+在 Blender 中：
+    Edit > Preferences > Add-ons > Install > 选择 blender_mcp_addon.py
+    启用 "Interface: Blender MCP"
+
+### 2. Start the socket server in Blender
+
+在 Blender 视图中按 N 键打开侧边栏。
+找到 "BlenderMCP" 标签页并点击 "Start Server"。
+
+### 3. 验证 connection
+
+    nc -z -w2 localhost 9876 && echo "OPEN" || echo "CLOSED"
+
+## Protocol
+
+通过 TCP 传输纯 UTF-8 JSON -- 没有长度前缀。
+
+Send:     {"type": "<command>", "params": {<kwargs>}}
+Receive:  {"status": "success", "result": <value>}
+          {"status": "error",   "message": "<reason>"}
+
+## Available Commands
+
+| type | params | description |
+| ------------------------- | ------------------- | --------------------------------- |
+| execute_code | code (str) | 运行任意 bpy Python 代码 |
+| get_scene_info | (none) | 列出场景中的所有对象 |
+| get_object_info | object_name (str) | 特定对象的详细信息 |
+| get_viewport_screenshot | (none) | 当前视图的屏幕截图 |
+
+## Python Helper
+
+在 execute_code 工具调用中使用以下代码：
+
+    import socket, json
+
+    def blender_exec(code: str, host="localhost", port=9876, timeout=15):
+        s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
+        s.connect((host, port))
+        s.settimeout(timeout)
+        payload = json.dumps({"type": "execute_code", "params": {"code": code}})
+        s.sendall(payload.encode("utf-8"))
+        buf = b""
+        while True:
+            try:
+                chunk = s.recv(4096)
+                if not chunk:
+                    break
+                buf += chunk
+                try:
+                    json.loads(buf.decode("utf-8"))
+                    break
+                except json.JSONDecodeError:
+                    continue
+            except socket.timeout:
+                break
+        s.close()
+        return json.loads(buf.decode("utf-8"))
+
+## 常用 bpy 模式
+
+### Clear scene
+    bpy.ops.object.select_all(action='SELECT')
+    bpy.ops.object.delete()
+
+### Add mesh objects
+    bpy.ops.mesh.primitive_uv_sphere_add(radius=1, location=(0, 0, 0))
+    bpy.ops.mesh.primitive_cube_add(size=2, location=(3, 0, 0))
+    bpy.ops.mesh.primitive_cylinder_add(radius=0.5, depth=2, location=(-3, 0, 0))
+
+### Create and assign material
+    mat = bpy.data.materials.new(name="MyMat")
+    mat.use_nodes = True
+    bsdf = mat.node_tree.nodes.get("Principled BSDF")
+    bsdf.inputs["Base Color"].default_value = (R, G, B, 1.0)
+    bsdf.inputs["Roughness"].default_value = 0.3
+    bsdf.inputs["Metallic"].default_value = 0.0
+    obj.data.materials.append(mat)
+
+### Keyframe animation
+    obj.location = (0, 0, 0)
+    obj.keyframe_insert(data_path="location", frame=1)
+    obj.location = (0, 0, 3)
+    obj.keyframe_insert(data_path="location", frame=60)
+
+### Render to file
+    bpy.context.scene.render.filepath = "/tmp/render.png"
+    bpy.context.scene.render.engine = 'CYCLES'
+    bpy.ops.render.render(write_still=True)
+
+## Pitfalls
+
+- 运行前必须检查 socket 是否打开 (nc -z localhost 9876)
+- Addon server 必须在每个会话中在 Blender 内部启动 (N 面板 > BlenderMCP > Connect)
+- 将复杂场景拆分为多个较小的 execute_code 调用，以避免超时
+- Render 输出路径必须是绝对路径 (/tmp/...) 而不是相对路径
+- shade_smooth() 要求对象已被选中且处于 object mode