@baimingtao/lbs-agent 1.0.0

package/extensions/skills/builtin/creative/manim-video/references/scene-planning.md

@@ -0,0 +1,118 @@
+# 场景规划参考
+
+## 叙事弧结构
+
+### 探索弧（最常见）
+1. 悬念 —— 提出问题或展示令人惊讶的结果
+2. 直觉 —— 建立视觉上的理解
+3. 形式化 —— 引入方程/算法
+4. 揭示 —— “顿悟时刻”
+5. 拓展 —— 推论或推广
+
+### 问题-解决弧
+1. 问题 —— 哪里出了错
+2. 失败的尝试 —— 显而易见的方法行不通
+3. 关键洞察 —— 行之有效的想法
+4. 解决方案 —— 实施该方案
+5. 结果 —— 展示改进效果
+
+### 对比弧
+1. 设置 —— 介绍两种方法
+2. 方法 A —— 运作方式
+3. 方法 B —— 运作方式
+4. 对比 —— 差异之处
+5. 结论 —— 哪种更好
+
+### 构建弧（架构/系统）
+1. 组件 A —— 第一个部分
+2. 组件 B —— 第二个部分
+3. 连接 —— 它们如何交互
+4. 扩展 —— 增加更多部分
+5. 全景 —— 镜头拉远（展示整体）
+
+## 场景过渡
+
+### 直接切换（默认）
+```python
+self.play(FadeOut(Group(*self.mobjects)), run_time=0.5)
+self.wait(0.3)
+```
+
+### 顺延过渡
+保留一个元素，淡出其余元素。下一个场景开始时，该元素仍保留在屏幕上。
+
+### 变形桥接
+以一个形状结束场景，并通过将其变形来开始下一个场景。
+
+## 跨场景一致性
+
+```python
+# Shared constants at file top
+BG = "#1C1C1C"
+PRIMARY = "#58C4DD"
+SECONDARY = "#83C167"
+ACCENT = "#FFFF00"
+TITLE_SIZE = 48
+BODY_SIZE = 30
+LABEL_SIZE = 24
+FAST = 0.8; NORMAL = 1.5; SLOW = 2.5
+```
+
+## 场景核对清单
+
+- [ ] 已设置背景颜色
+- [ ] 每个动画都配有字幕
+- [ ] 每次揭示后都有 `self.wait()`
+- [ ] 边缘定位的文字间距 (buff) >= 0.5
+- [ ] 无文字重叠
+- [ ] 使用了颜色常量（未硬编码）
+- [ ] 应用了透明度分层
+- [ ] 场景结束时干净退出
+- [ ] 同时可见的元素不超过 5-6 个
+
+## 时长估算
+
+| 内容 | 时长 |
+| --------- | ---------- |
+| 标题卡片 | 3-5s |
+| 概念引入 | 10-20s |
+| 方程展示 | 15-25s |
+| 算法步骤 | 5-10s |
+| 数据对比 | 10-15s |
+| “顿悟时刻” | 15-30s |
+| 结论 | 5-10s |
+
+## 规划模板
+
+```markdown
+# [Video Title]
+
+## Overview
+- **Topic**: [Core concept]
+- **Hook**: [Opening question]
+- **Aha moment**: [Key insight]
+- **Target audience**: [Prerequisites]
+- **Length**: [seconds/minutes]
+- **Resolution**: 480p (draft) / 1080p (final)
+
+## Color Palette
+- Background: #1C1C1C
+- Primary: #58C4DD -- [purpose]
+- Secondary: #83C167 -- [purpose]
+- Accent: #FFFF00 -- [purpose]
+
+## Arc: [Discovery / Problem-Solution / Comparison / Build-Up]
+
+## Scene 1: [Name] (~Ns)
+**Purpose**: [one sentence]
+**Layout**: [FULL_CENTER / LEFT_RIGHT / GRID / PROGRESSIVE]
+
+### Visual elements
+- [Mobject: type, position, color]
+
+### Animation sequence
+1. [Animation] -- [what it reveals] (~Ns)
+
+### Subtitle
+"[text]"
+```

package/extensions/skills/builtin/creative/manim-video/references/troubleshooting.md

@@ -0,0 +1,135 @@
+# 故障排查
+
+## LaTeX 错误
+
+**缺少原始字符串** (头号错误)：
+```python
+# WRONG: MathTex("\\frac{1}{2}")  -- \\f is form-feed
+# RIGHT: MathTex(r"\frac{1}{2}")
+```
+
+**括号不匹配**：`MathTex(r"\frac{1}{2")` -- 缺少右括号。
+
+**未安装 LaTeX**：`which pdflatex` -- 安装 texlive-full 或 mactex。
+
+**缺少宏包**：添加到导言区：
+```python
+tex_template = TexTemplate()
+tex_template.add_to_preamble(r"\usepackage{mathrsfs}")
+MathTex(r"\mathscr{L}", tex_template=tex_template)
+```
+
+## VGroup TypeError
+
+**错误：** `TypeError: Only values of type VMobject can be added as submobjects of VGroup`
+
+**原因：** `Text()` 对象属于 `Mobject`，而不是 `VMobject`。在 Manim CE v0.20+ 版本中，将 `Text` 与图形混用在同一个 `VGroup` 中会报错。
+
+```python
+# WRONG: Text is not a VMobject
+group = VGroup(circle, Text("Label"))
+
+# RIGHT: use Group for mixed types
+group = Group(circle, Text("Label"))
+
+# RIGHT: VGroup is fine for shapes-only
+shapes = VGroup(circle, square, arrow)
+
+# RIGHT: MathTex IS a VMobject — VGroup works
+equations = VGroup(MathTex(r"a"), MathTex(r"b"))
+```
+
+**规则：** 如果 group 中包含任何 `Text()`，请使用 `Group`。如果全都是图形或全都是 `MathTex`，则使用 `VGroup` 没问题。
+
+**淡出所有元素：** 始终使用 `Group(*self.mobjects)`，而不是 `VGroup(*self.mobjects)`：
+```python
+self.play(FadeOut(Group(*self.mobjects)))  # safe for mixed types
+```
+
+## Group 不支持 save_state() / restore()
+
+**错误：** `NotImplementedError: Please override in a child class.`
+
+**原因：** `Group.save_state()` 和 `Group.restore()` 在 Manim CE v0.20+ 中未实现。只有 `VGroup` 和各个 `Mobject` 子类支持 save/restore。
+
+```python
+# WRONG: Group doesn't support save_state
+group = Group(circle, Text("label"))
+group.save_state()  # NotImplementedError!
+
+# RIGHT: use FadeIn with shift/scale instead of save_state/restore
+self.play(FadeIn(group, shift=UP * 0.3, scale=0.8))
+
+# RIGHT: or save/restore on individual VMobjects
+circle.save_state()
+self.play(circle.animate.shift(RIGHT))
+self.play(Restore(circle))
+```
+
+## letter_spacing 不是有效参数
+
+**错误：** `TypeError: Mobject.__init__() got an unexpected keyword argument 'letter_spacing'`
+
+**原因：** `Text()` 不接受 `letter_spacing` 参数。Manim 使用 Pango 进行文本渲染，并且没有在 `Text()` 中暴露字间距控制。
+
+```python
+# WRONG
+Text("HERMES", letter_spacing=6)
+
+# RIGHT: use MarkupText with Pango attributes for spacing control
+MarkupText('<span letter_spacing="6000">HERMES</span>', font_size=18)
+# Note: Pango letter_spacing is in 1/1024 of a point
+```
+
+## 动画错误
+
+**不可见的动画** -- mobject 从未添加：
+```python
+# WRONG: circle = Circle(); self.play(circle.animate.set_color(RED))
+# RIGHT: self.play(Create(circle)); self.play(circle.animate.set_color(RED))
+```
+
+**Transform 混淆** -- 执行 Transform(A, B) 后，A 在屏幕上，B 不在。如果你想保留 B，请使用 ReplacementTransform。
+
+**重复动画** -- 在同一个 play() 中对同一个 mobject 进行了两次操作：
+```python
+# WRONG: self.play(c.animate.shift(RIGHT), c.animate.set_color(RED))
+# RIGHT: self.play(c.animate.shift(RIGHT).set_color(RED))
+```
+
+**Updater 与动画冲突**：
+```python
+mob.suspend_updating()
+self.play(mob.animate.shift(RIGHT))
+mob.resume_updating()
+```
+
+## 渲染问题
+
+**输出模糊**：使用了 -ql (480p)。最终渲染时请切换到 -qm/-qh。
+
+**渲染缓慢**：在开发过程中使用 -ql。降低 Surface 分辨率。缩短 self.wait() 时长。
+
+**输出过期**：`manim -ql --disable_caching script.py Scene`
+
+**ffmpeg concat 失败**：所有片段的分辨率/帧率(FPS)/编解码器必须一致。
+
+## 常见错误
+
+**文本在边缘被裁剪**：对于 `.to_edge()`，需设置 `buff >= 0.5`
+
+**文本重叠**：请使用 `ReplacementTransform(old, new)`，而不是在其上方使用 `Write(new)`。
+
+**过于拥挤**：最多同时显示 5-6 个元素。拆分为多个场景或使用透明度分层。
+
+**没有停顿空间**：元素显示后至少需要 `self.wait(1.5)`，关键时刻需要 `self.wait(2.0)`。
+
+**缺少背景色**：在每个场景中设置 `self.camera.background_color = BG`。
+
+## 调试策略
+
+1. 渲染单帧：`manim -ql -s script.py Scene` -- 瞬间检查排版布局
+2. 隔离出错的场景 -- 只渲染那一个场景
+3. 将 `self.play()` 替换为 `self.add()` 以立即查看最终状态
+4. 打印位置：`print(mob.get_center())`
+5. 清理缓存：删除 `media/` 目录

package/extensions/skills/builtin/creative/manim-video/references/updaters-and-trackers.md

@@ -0,0 +1,260 @@
+# Updaters 与 Value Trackers
+
+## Updaters 解决的问题
+
+普通的动画是离散的：`self.play()` 从状态 A 变化到状态 B。但如果你需要持续的关联关系呢——比如一个始终悬浮在移动点上方的标签，或者一条始终连接两个点的线？
+
+如果没有 updaters，你必须在每次 `self.play()` 之前手动重新定位每个依赖对象。移动一个点的五次动画意味着要为标签进行五次手动重定位调用。漏掉一次，它就会停留在错误的位置。
+
+Updaters 让你只需声明一次这种关系。Manim 会在每一帧（根据画质不同，为 15-60 fps）调用 updater 函数来维持这种关系，无论同时还在发生什么其他事情。
+
+## ValueTracker：隐形的方向盘
+
+ValueTracker 是一个不可见的 Mobject，用于存储一个单精度浮点数。它永远不会出现在屏幕上。它的存在是为了让你可以对其进行动画处理，同时让其他对象根据它的值做出反应。
+
+把它想象成一个滑块：将滑块从 0 拖到 5，每个连接到它的对象都会实时响应。
+
+```python
+tracker = ValueTracker(0)        # 不可见，存储 0.0
+tracker.get_value()              # 读取：0.0
+tracker.set_value(5)             # 写入：立即跳转到 5.0
+tracker.animate.set_value(5)     # 动画：平滑过渡到 5.0
+```
+
+### 三步模式
+
+每个 ValueTracker 的使用都遵循以下步骤：
+
+1. **创建 tracker**（隐形的滑块）
+2. **通过 updaters 创建读取 tracker 状态的可见对象**
+3. **为 tracker 制作动画** —— 所有依赖对象都会自动更新
+
+```python
+# 步骤 1：创建 tracker
+x_tracker = ValueTracker(1)
+
+# 步骤 2：创建依赖对象
+dot = always_redraw(lambda: Dot(axes.c2p(x_tracker.get_value(), 0), color=YELLOW))
+v_line = always_redraw(lambda: axes.get_vertical_line(
+    axes.c2p(x_tracker.get_value(), func(x_tracker.get_value())), color=BLUE
+))
+label = always_redraw(lambda: DecimalNumber(x_tracker.get_value(), font_size=24)
+    .next_to(dot, UP))
+
+self.add(dot, v_line, label)
+
+# 步骤 3：为 tracker 制作动画 —— 万物皆跟随
+self.play(x_tracker.animate.set_value(5), run_time=3)
+```
+
+## Updaters 的类型
+
+### Lambda updater（最常见）
+
+每帧运行一个函数，并传入 Mobject 本身：
+
+```python
+# 标签始终位于点的上方
+label.add_updater(lambda m: m.next_to(dot, UP, buff=0.2))
+
+# 直线始终连接两个点
+line.add_updater(lambda m: m.put_start_and_end_on(
+    point_a.get_center(), point_b.get_center()
+))
+```
+
+### 基于时间的 updater（带有 dt）
+
+第二个参数 `dt` 是距离上一帧的时间（在 60fps 下约为 0.017 秒）：
+
+```python
+# 连续旋转
+square.add_updater(lambda m, dt: m.rotate(0.5 * dt))
+
+# 连续向右漂移
+dot.add_updater(lambda m, dt: m.shift(RIGHT * 0.3 * dt))
+
+# 震荡
+dot.add_updater(lambda m, dt: m.move_to(
+    axes.c2p(m.get_center()[0], np.sin(self.time))
+))
+```
+
+在物理模拟、连续运动和依赖于时间的效果中使用 `dt` updaters。
+
+### always_redraw：每帧完全重建
+
+每一帧都从零开始创建一个新的 Mobject。这比 `add_updater` 开销更大，但它适用于 Mobject 结构发生变化（而不仅仅是位置/颜色变化）的情况：
+
+```python
+# 跟随调整大小的正方形的 Brace
+brace = always_redraw(Brace, square, UP)
+
+# 随着函数变化而更新的曲线下面积
+area = always_redraw(lambda: axes.get_area(
+    graph, x_range=[0, x_tracker.get_value()], color=BLUE, opacity=0.3
+))
+
+# 重新构造其文本的标签
+counter = always_redraw(lambda: Text(
+    f"n = {int(x_tracker.get_value())}", font_size=24, font="Menlo"
+).to_corner(UR))
+```
+
+**何时使用哪种：**
+- `add_updater` —— 位置、颜色、不透明度的变化（开销小，首选）
+- `always_redraw` —— 当形状/结构本身发生变化时（开销大，谨慎使用）
+
+## DecimalNumber：显示实时数值
+
+```python
+# 追踪 ValueTracker 的计数器
+tracker = ValueTracker(0)
+number = DecimalNumber(0, font_size=48, num_decimal_places=1, color=PRIMARY)
+number.add_updater(lambda m: m.set_value(tracker.get_value()))
+number.add_updater(lambda m: m.next_to(dot, RIGHT, buff=0.3))
+
+self.add(number)
+self.play(tracker.animate.set_value(100), run_time=3)
+```
+
+### Variable：带标签的版本
+
+```python
+var = Variable(0, Text("x", font_size=24, font="Menlo"), num_decimal_places=2)
+self.add(var)
+self.play(var.tracker.animate.set_value(PI), run_time=2)
+# 显示：x = 3.14
+```
+
+## 移除 updaters
+
+```python
+# 移除所有 updaters
+mobject.clear_updaters()
+
+# 暂时挂起（在执行会与 updater 冲突的动画时）
+mobject.suspend_updating()
+self.play(mobject.animate.shift(RIGHT))
+mobject.resume_updating()
+
+# 移除特定的 updater（如果你保存了它的引用）
+def my_updater(m):
+    m.next_to(dot, UP)
+label.add_updater(my_updater)
+# ... 稍后 ...
+label.remove_updater(my_updater)
+```
+
+## 基于动画的 updaters
+
+### UpdateFromFunc / UpdateFromAlphaFunc
+
+这些是动画（传递给 `self.play`），而不是持久的 updaters：
+
+```python
+# 在动画的每一帧调用一个函数
+self.play(UpdateFromFunc(mobject, lambda m: m.next_to(moving_target, UP)), run_time=3)
+
+# 使用 alpha（0 到 1）—— 适用于自定义插值
+self.play(UpdateFromAlphaFunc(circle, lambda m, a: m.set_fill(opacity=a)), run_time=2)
+```
+
+### turn_animation_into_updater
+
+将一次性动画转换为持续运行的 updater：
+
+```python
+from manim import turn_animation_into_updater
+
+# 这通常只会播放一次 —— 现在它会永远循环
+turn_animation_into_updater(Rotating(gear, rate=PI/4))
+self.add(gear)
+self.wait(5)  # 齿轮旋转 5 秒
+```
+
+## 实用模式
+
+### 模式 1：追踪函数的点
+
+```python
+tracker = ValueTracker(0)
+graph = axes.plot(np.sin, x_range=[0, 2*PI], color=PRIMARY)
+dot = always_redraw(lambda: Dot(
+    axes.c2p(tracker.get_value(), np.sin(tracker.get_value())),
+    color=YELLOW
+))
+tangent = always_redraw(lambda: axes.get_secant_slope_group(
+    x=tracker.get_value(), graph=graph, dx=0.01,
+    secant_line_color=HIGHLIGHT, secant_line_length=3
+))
+
+self.add(graph, dot, tangent)
+self.play(tracker.animate.set_value(2*PI), run_time=6, rate_func=linear)
+```
+
+### 模式 2：动态的曲线下面积
+
+```python
+tracker = ValueTracker(0.5)
+area = always_redraw(lambda: axes.get_area(
+    graph, x_range=[0, tracker.get_value()],
+    color=PRIMARY, opacity=0.3
+))
+area_label = always_redraw(lambda: DecimalNumber(
+    # 数值积分
+    sum(func(x) * 0.01 for x in np.arange(0, tracker.get_value(), 0.01)),
+    font_size=24
+).next_to(axes, RIGHT))
+
+self.add(area, area_label)
+self.play(tracker.animate.set_value(4), run_time=5)
+```
+
+### 模式 3：连接图
+
+```python
+# 可以移动的节点，以及自动跟随的边
+node_a = Dot(LEFT * 2, color=PRIMARY)
+node_b = Dot(RIGHT * 2, color=SECONDARY)
+edge = Line().add_updater(lambda m: m.put_start_and_end_on(
+    node_a.get_center(), node_b.get_center()
+))
+label = Text("edge", font_size=18, font="Menlo").add_updater(
+    lambda m: m.move_to(edge.get_center() + UP * 0.3)
+)
+
+self.add(node_a, node_b, edge, label)
+self.play(node_a.animate.shift(UP * 2), run_time=2)
+self.play(node_b.animate.shift(DOWN + RIGHT), run_time=2)
+# 边和标签自动跟随
+```
+
+### 模式 4：参数探索
+
+```python
+# 探索参数如何改变曲线
+a_tracker = ValueTracker(1)
+curve = always_redraw(lambda: axes.plot(
+    lambda x: a_tracker.get_value() * np.sin(x),
+    x_range=[0, 2*PI], color=PRIMARY
+))
+param_label = always_redraw(lambda: Text(
+    f"a = {a_tracker.get_value():.1f}", font_size=24, font="Menlo"
+).to_corner(UR))
+
+self.add(curve, param_label)
+self.play(a_tracker.animate.set_value(3), run_time=3)
+self.play(a_tracker.animate.set_value(0.5), run_time=2)
+self.play(a_tracker.animate.set_value(1), run_time=1)
+```
+
+## 常见错误
+
+1. **Updater 与动画冲突：** 如果一个 Mobject 有一个设定其位置的 updater，而你又试图在别处对其进行动画处理，updater 会在每一帧生效。请先挂起更新。
+
+2. **将 always_redraw 用于简单的移动：** 如果你只需要重新定位，请使用 `add_updater`。`always_redraw` 每一帧都会重建整个 Mobject —— 对于位置追踪来说开销既大又没有必要。
+
+3. **忘记添加到场景中：** Updaters 只在场景中的 Mobject 上运行。`always_redraw` 创建了 Mobject，但你仍然需要 `self.add()`。
+
+4. **Updater 在不清理的情况下创建新 Mobject：** 如果你的 updater 每一帧都创建 Text 对象，它们会累积。请使用 `always_redraw`（它会处理清理工作）或原地更新属性。

package/extensions/skills/builtin/creative/manim-video/references/visual-design.md

@@ -0,0 +1,124 @@
+# 视觉设计原则
+
+## 12 个核心原则
+
+1. **几何先于代数** — 先展示形状，其次展示方程。
+2. **透明度分层** — PRIMARY=1.0, CONTEXT=0.4, GRID=0.15。通过亮度引导注意力。
+3. **每个场景仅一个新概念** — 每个场景只准确引入一个概念。
+4. **空间一致性** — 相同的概念始终占据相同的屏幕区域。
+5. **颜色即意义** — 将颜色分配给概念，而不是 mobjects。如果速度用蓝色表示，就始终保持蓝色。
+6. **渐进式展示** — 先展示最简单的版本，再逐步增加复杂度。
+7. **变换而非替换** — 使用 Transform/ReplacementTransform 来展示关联。
+8. **留白空间** — 展示新内容后至少 `self.wait(1.5)`。
+9. **视觉重力平衡** — 不要将所有元素堆叠在同一侧。
+10. **一致的运动词汇** — 选择少量动画类型并复用它们。
+11. **深色背景，浅色内容** — #1C1C1C 到 #2D2B55 的背景能最大化对比度。
+12. **刻意的留白** — 至少保留 15% 的画面空白。
+
+## 布局模板
+
+### FULL_CENTER
+一个主元素居中，标题在上方，注释在下方。
+适用于：单个方程、单个图表、标题卡。
+
+### LEFT_RIGHT
+两个元素并排，位于 x=-3.5 和 x=3.5。
+适用于：方程+可视化、前/后对比、比较。
+
+### TOP_BOTTOM
+主元素位于 y=1.5，辅助内容位于 y=-1.5。
+适用于：概念+示例、定理+案例。
+
+### GRID
+通过 `arrange_in_grid()` 排列多个元素。
+适用于：对比矩阵、多步骤流程。
+
+### PROGRESSIVE
+元素逐一出现，以 aligned_edge=LEFT 向下排列。
+适用于：算法、证明、分步流程。
+
+### ANNOTATED_DIAGRAM
+中心图表带有通过箭头连接的浮动标签。
+适用于：架构图、带注释的图表。
+
+## 配色方案
+
+### Classic 3B1B
+```python
+BG="#1C1C1C"; PRIMARY=BLUE; SECONDARY=GREEN; ACCENT=YELLOW; HIGHLIGHT=RED
+```
+
+### Warm Academic
+```python
+BG="#2D2B55"; PRIMARY="#FF6B6B"; SECONDARY="#FFD93D"; ACCENT="#6BCB77"
+```
+
+### Neon Tech
+```python
+BG="#0A0A0A"; PRIMARY="#00F5FF"; SECONDARY="#FF00FF"; ACCENT="#39FF14"
+```
+
+## 字体选择
+
+**所有文本均使用等宽字体。** Manim 的 Pango 文本渲染器在所有尺寸和分辨率下，使用比例字体（Helvetica、Inter、SF Pro、Arial）都会产生字间距问题。字符会发生重叠，间距也不一致。这是 Pango 的基本限制，而不是 Manim 的 bug。
+
+等宽字体具有固定的字符宽度——从设计上就消除了字距问题。
+
+### 推荐字体
+
+| 用例 | 字体 | 回退字体 |
+| ---------- | ------ | ---------- |
+| **所有文本（默认）** | `"Menlo"` | `"Courier New"`, `"DejaVu Sans Mono"` |
+| 代码、标签 | `"JetBrains Mono"`, `"SF Mono"` | `"Menlo"` |
+| 数学公式 | 使用 `MathTex`（通过 LaTeX 而非 Pango 渲染） | — |
+
+```python
+MONO = "Menlo"  # define once at top of file
+
+title = Text("Fourier Series", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
+label = Text("n=1: (4/pi) sin(x)", font_size=20, color=BLUE, font=MONO)
+note = Text("Convergence at discontinuities", font_size=18, color=DIM, font=MONO)
+
+# Math — always use MathTex, not Text
+equation = MathTex(r"\nabla L = \frac{\partial L}{\partial w}")
+```
+
+### 比例字体适用的情况
+
+大号标题文本（font_size >= 48）且为短字符串（1-3 个词）时，可以使用比例字体而不会出现明显的字距问题。对于其他情况——标签、描述、多词文本、小号尺寸——请使用等宽字体。
+
+### 字体可用性
+
+- **macOS**: Menlo (预装), SF Mono
+- **Linux**: DejaVu Sans Mono (预装), Liberation Mono
+- **跨平台**: JetBrains Mono (从 jetbrains.com 安装)
+
+`"Menlo"` 是最安全的默认字体——在 macOS 上预装，Linux 系统会回退到 DejaVu Sans Mono。
+
+### 细粒度文本控制
+
+`Text()` 不支持 `letter_spacing` 或字距参数。要进行精细控制，请使用带有 Pango 属性的 `MarkupText`：
+
+```python
+# Letter spacing (Pango units: 1/1024 of a point)
+MarkupText('<span letter_spacing="6000">HERMES</span>', font_size=18, font="Menlo")
+
+# Bold specific words
+MarkupText('This is <b>important</b>', font_size=24, font="Menlo")
+
+# Color specific words
+MarkupText('Red <span foreground="#FF6B6B">warning</span>', font_size=24, font="Menlo")
+```
+
+### 最小字号
+
+`font_size=18` 是在任何分辨率下保证文本可读的最小字号。低于 18 时，字符在 `-ql` 下会变得模糊，即使是在 `-qh` 下也几乎无法阅读。
+
+## 视觉层级清单
+
+对于每一帧：
+1. 唯一需要关注的是什么？（最亮/最大）
+2. 什么是上下文？（变暗至 0.3-0.4）
+3. 什么是结构性的？（变暗至 0.15）
+4. 是否有足够的留白？（>15%）
+5. 所有文本在手机尺寸下是否可读？

package/extensions/skills/builtin/creative/manim-video/scripts/setup.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+G="\033[0;32m"; R="\033[0;31m"; N="\033[0m"
+ok() { echo -e "  ${G}+${N} $1"; }
+fail() { echo -e "  ${R}x${N} $1"; }
+echo ""; echo "Manim Video Skill — Setup Check"; echo ""
+errors=0
+command -v python3 &>/dev/null && ok "Python $(python3 --version 2>&1 | awk '{print $2}')" || { fail "Python 3 not found"; errors=$((errors+1)); }
+python3 -c "import manim" 2>/dev/null && ok "Manim $(manim --version 2>&1 | head -1)" || { fail "Manim not installed: pip install manim"; errors=$((errors+1)); }
+command -v pdflatex &>/dev/null && ok "LaTeX (pdflatex)" || { fail "LaTeX not found (macOS: brew install --cask mactex-no-gui)"; errors=$((errors+1)); }
+command -v ffmpeg &>/dev/null && ok "ffmpeg" || { fail "ffmpeg not found"; errors=$((errors+1)); }
+echo ""
+[ $errors -eq 0 ] && echo -e "${G}All prerequisites satisfied.${N}" || echo -e "${R}$errors prerequisite(s) missing.${N}"
+echo ""