@baimingtao/lbs-agent 1.0.0

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

@@ -0,0 +1,282 @@
+# 动画参考
+
+## 核心概念
+
+动画是一个 Python 对象，用于计算 mobject 随时间变化的中间视觉状态。动画是传递给 `self.play()` 的对象，而不是函数。
+
+`run_time` 控制秒数（默认：1）。对于重要的动画，请始终显式指定它。
+
+## 创建动画
+
+```python
+self.play(Create(circle))          # 描绘轮廓
+self.play(Write(equation))         # 模拟手写（用于 Text/MathTex）
+self.play(FadeIn(group))           # 不透明度 0 -> 1
+self.play(GrowFromCenter(dot))     # 从中心缩放 0 -> 1
+self.play(DrawBorderThenFill(sq))  # 先轮廓，后填充
+```
+
+## 移除动画
+
+```python
+self.play(FadeOut(mobject))         # 不透明度 1 -> 0
+self.play(Uncreate(circle))        # Create 的逆过程
+self.play(ShrinkToCenter(group))   # 缩放 1 -> 0
+```
+
+## 变换动画
+
+```python
+# Transform -- 原地修改原始对象
+self.play(Transform(circle, square))
+# 执行后：circle 就是 square（同一对象，新外观）
+
+# ReplacementTransform -- 用新对象替换旧对象
+self.play(ReplacementTransform(circle, square))
+# 执行后：circle 被移除，square 显示在屏幕上
+
+# TransformMatchingTex -- 智能方程变形
+eq1 = MathTex(r"a^2 + b^2")
+eq2 = MathTex(r"a^2 + b^2 = c^2")
+self.play(TransformMatchingTex(eq1, eq2))
+```
+
+**关键提示**：执行 `Transform(A, B)` 后，变量 `A` 引用的是屏幕上的 mobject。变量 `B` 不在屏幕上。如果你之后还要操作 `B`，请使用 `ReplacementTransform`。
+
+## .animate 语法
+
+```python
+self.play(circle.animate.set_color(RED))
+self.play(circle.animate.shift(RIGHT * 2).scale(0.5))  # 链式调用多个方法
+```
+
+## 其他创建动画
+
+```python
+self.play(GrowFromPoint(circle, LEFT * 3))     # 从特定点缩放 0 -> 1
+self.play(GrowFromEdge(rect, DOWN))             # 从一条边生长
+self.play(SpinInFromNothing(square))            # 旋转放大的同时（默认 PI/2）
+self.play(GrowArrow(arrow))                     # 箭头从起点向尖端生长
+```
+
+## 运动动画
+
+```python
+# 沿任意路径移动 mobject
+path = Arc(radius=2, angle=PI)
+self.play(MoveAlongPath(dot, path), run_time=2)
+
+# Rotate（作为一种 Transform，而不是 .animate —— 支持 about_point）
+self.play(Rotate(square, angle=PI / 2, about_point=ORIGIN), run_time=1.5)
+
+# Rotating（连续旋转，updater 风格 —— 适合旋转物体）
+self.play(Rotating(gear, angle=TAU, run_time=4, rate_func=linear))
+```
+
+`MoveAlongPath` 接受任何 `VMobject` 作为路径 —— 可以使用 `Arc`、`CubicBezier`、`Line` 或自定义的 `VMobject`。位置通过 `path.point_from_proportion()` 计算。
+
+## 强调动画
+
+```python
+self.play(Indicate(mobject))             # 短暂的黄色闪烁 + 缩放
+self.play(Circumscribe(mobject))         # 在其周围绘制矩形
+self.play(Flash(point))                  # 径向闪烁
+self.play(Wiggle(mobject))               # 左右摇动
+```
+
+## 速率函数
+
+```python
+self.play(FadeIn(mob), rate_func=smooth)          # 默认：缓入缓出
+self.play(FadeIn(mob), rate_func=linear)           # 恒定速度
+self.play(FadeIn(mob), rate_func=rush_into)        # 开头慢，结尾快
+self.play(FadeIn(mob), rate_func=rush_from)        # 开头快，结尾慢
+self.play(FadeIn(mob), rate_func=there_and_back)   # 播放动画然后反向播放
+```
+
+## 组合
+
+```python
+# 同步播放
+self.play(FadeIn(title), Create(circle), run_time=2)
+
+# 带有延迟的 AnimationGroup
+self.play(AnimationGroup(*[FadeIn(i) for i in items], lag_ratio=0.2))
+
+# LaggedStart
+self.play(LaggedStart(*[Write(l) for l in lines], lag_ratio=0.3, run_time=3))
+
+# Succession（在一次 play 调用中顺序执行）
+self.play(Succession(FadeIn(title), Wait(0.5), Write(subtitle)))
+```
+
+## Updaters
+
+```python
+tracker = ValueTracker(0)
+dot = Dot().add_updater(lambda m: m.move_to(axes.c2p(tracker.get_value(), 0)))
+self.play(tracker.animate.set_value(5), run_time=3)
+```
+
+## 字幕
+
+```python
+# 方法 1：独立添加
+self.add_subcaption("Key insight", duration=2)
+self.play(Write(equation), run_time=2.0)
+
+# 方法 2：内联添加
+self.play(Write(equation), subcaption="Key insight", subcaption_duration=2)
+```
+
+Manim 会自动生成 `.srt` 字幕文件。为了无障碍访问，请始终添加 subcaption。
+
+## 时间控制模式
+
+```python
+# 展示后暂停
+self.play(Write(key_equation), run_time=2.0)
+self.wait(2.0)
+
+# 变暗并聚焦
+self.play(old_content.animate.set_opacity(0.3), FadeIn(new_content))
+
+# 干净退场
+self.play(FadeOut(Group(*self.mobjects)), run_time=0.5)
+self.wait(0.3)
+```
+
+## 响应式 Mobjects：always_redraw()
+
+每一帧从头重建 mobject —— 当其几何形状依赖于其他动画对象时必不可少：
+
+```python
+# 跟随缩放正方形的 Brace（大括号）
+brace = always_redraw(Brace, square, UP)
+self.add(brace)
+self.play(square.animate.scale(2))  # brace 会自动调整
+
+# 追踪移动点的水平线
+h_line = always_redraw(lambda: axes.get_h_line(dot.get_left()))
+
+# 始终紧挨着另一个 mobject 的标签
+label = always_redraw(lambda: Text("here", font_size=20).next_to(dot, UP, buff=0.2))
+```
+
+注意：`always_redraw` 每一帧都会重新创建 mobject。对于简单的属性追踪，请改用 `add_updater`（开销更小）：
+```python
+label.add_updater(lambda m: m.next_to(dot, UP))
+```
+
+## TracedPath — 轨迹追踪
+
+绘制一个点所经过的路径：
+
+```python
+dot = Dot(color=YELLOW)
+path = TracedPath(dot.get_center, stroke_color=YELLOW, stroke_width=2)
+self.add(dot, path)
+self.play(dot.animate.shift(RIGHT * 3 + UP * 2), run_time=2)
+# path 展示了 dot 留下的轨迹
+
+# 淡出轨迹（随时间消散）：
+path = TracedPath(dot.get_center, dissipating_time=0.5, stroke_opacity=[0, 1])
+```
+
+使用场景：梯度下降路径、行星轨道、函数追踪、粒子轨迹。
+
+## FadeTransform — 更平滑的交叉淡入淡出
+
+`Transform` 会通过难看的中间扭曲来变形形状。`FadeTransform` 通过位置匹配进行交叉淡入淡出 —— 当源形状和目标形状看起来不同时，请使用它：
+
+```python
+# 丑陋：Transform 会将 circle 扭曲成一团然后变成 square
+self.play(Transform(circle, square))
+
+# 平滑：FadeTransform 可以干净地交叉淡入淡出
+self.play(FadeTransform(circle, square))
+
+# FadeTransformPieces：针对每个子 mobject 进行 FadeTransform
+self.play(FadeTransformPieces(group1, group2))
+
+# TransformFromCopy：对副本进行动画处理，同时保持原件可见
+self.play(TransformFromCopy(source, target))
+# source 保留在屏幕上，一个副本变形为 target
+```
+
+**建议**：对于不相似的形状，默认使用 `FadeTransform`。仅对相似的形状（如 circle→ellipse、equation→equation）使用 `Transform`/`ReplacementTransform`。
+
+## ApplyMatrix — 线性变换可视化
+
+在 mobject 上对矩阵变换进行动画处理：
+
+```python
+# 将 2x2 矩阵应用于网格
+matrix = [[2, 1], [1, 1]]
+self.play(ApplyMatrix(matrix, number_plane), run_time=2)
+
+# 也可应用于单个 mobject
+self.play(ApplyMatrix([[0, -1], [1, 0]], square))  # 90度旋转
+```
+
+与 `LinearTransformationScene` 配合使用 —— 参见 `camera-and-3d.md`。
+
+## squish_rate_func — 时间窗口错开
+
+将任何速率函数压缩到动画内的时间窗口中。无需使用 `LaggedStart` 即可实现重叠错开：
+
+```python
+self.play(
+    FadeIn(a, rate_func=squish_rate_func(smooth, 0, 0.5)),    # 0% 到 50%
+    FadeIn(b, rate_func=squish_rate_func(smooth, 0.25, 0.75)), # 25% 到 75%
+    FadeIn(c, rate_func=squish_rate_func(smooth, 0.5, 1.0)),  # 50% 到 100%
+    run_time=2
+)
+```
+
+当你需要精确控制重叠时，它比 `LaggedStart` 更加精确。
+
+## 其他速率函数
+
+```python
+from manim import (
+    smooth, linear, rush_into, rush_from,
+    there_and_back, there_and_back_with_pause,
+    running_start, double_smooth, wiggle,
+    lingering, exponential_decay, not_quite_there,
+    squish_rate_func
+)
+
+# running_start：前进前先后退（预备动作）
+self.play(FadeIn(mob, rate_func=running_start))
+
+# there_and_back_with_pause：去到那里，停顿，然后返回
+self.play(mob.animate.shift(UP), rate_func=there_and_back_with_pause)
+
+# not_quite_there：停在完整动画的几分之一处
+self.play(FadeIn(mob, rate_func=not_quite_there(0.7)))
+```
+
+## ShowIncreasingSubsets / ShowSubmobjectsOneByOne
+
+逐步显示组成员 —— 非常适合算法可视化：
+
+```python
+# 逐一显示数组元素
+array = Group(*[Square() for _ in range(8)]).arrange(RIGHT)
+self.play(ShowIncreasingSubsets(array), run_time=3)
+
+# 以错开的方式显示子 mobject
+self.play(ShowSubmobjectsOneByOne(code_lines), run_time=4)
+```
+
+## ShowPassingFlash
+
+一束闪光沿着路径移动：
+
+```python
+# 沿着曲线移动的闪光
+self.play(ShowPassingFlash(curve.copy().set_color(YELLOW), time_width=0.3))
+
+# 非常适合：数据流、电信号、网络流量
+```

package/extensions/skills/builtin/creative/manim-video/references/camera-and-3d.md

@@ -0,0 +1,135 @@
+# 相机与 3D 参考
+
+## MovingCameraScene (2D 相机控制)
+
+```python
+class ZoomExample(MovingCameraScene):
+    def construct(self):
+        circle = Circle(radius=2, color=BLUE)
+        self.play(Create(circle))
+        # Zoom in
+        self.play(self.camera.frame.animate.set(width=4).move_to(circle.get_top()), run_time=2)
+        self.wait(2)
+        # Zoom back out
+        self.play(self.camera.frame.animate.set(width=14.222).move_to(ORIGIN), run_time=2)
+```
+
+### 相机操作
+
+```python
+self.camera.frame.animate.set(width=6)     # zoom in
+self.camera.frame.animate.set(width=20)    # zoom out
+self.camera.frame.animate.move_to(target)  # pan
+self.camera.frame.save_state()             # save
+self.play(Restore(self.camera.frame))      # restore
+```
+
+## ThreeDScene
+
+```python
+class ThreeDExample(ThreeDScene):
+    def construct(self):
+        self.set_camera_orientation(phi=60*DEGREES, theta=-45*DEGREES)
+        axes = ThreeDAxes()
+        surface = Surface(
+            lambda u, v: axes.c2p(u, v, np.sin(u) * np.cos(v)),
+            u_range=[-PI, PI], v_range=[-PI, PI], resolution=(30, 30)
+        )
+        surface.set_color_by_gradient(BLUE, GREEN, YELLOW)
+        self.play(Create(axes), Create(surface))
+        self.begin_ambient_camera_rotation(rate=0.2)
+        self.wait(5)
+        self.stop_ambient_camera_rotation()
+```
+
+### 3D 中的相机控制
+
+```python
+self.set_camera_orientation(phi=70*DEGREES, theta=-45*DEGREES)
+self.move_camera(phi=45*DEGREES, theta=30*DEGREES, run_time=2)
+self.begin_ambient_camera_rotation(rate=0.2)
+```
+
+### 3D Mobjects
+
+```python
+sphere = Sphere(radius=1).set_color(BLUE).set_opacity(0.7)
+cube = Cube(side_length=2, fill_color=GREEN, fill_opacity=0.5)
+arrow = Arrow3D(start=ORIGIN, end=[2, 1, 1], color=RED)
+# 2D text facing camera:
+label = Text("Label", font_size=30)
+self.add_fixed_in_frame_mobjects(label)
+```
+
+### 参数曲线
+
+```python
+helix = ParametricFunction(
+    lambda t: [np.cos(t), np.sin(t), t / (2*PI)],
+    t_range=[0, 4*PI], color=YELLOW
+)
+```
+
+## 何时使用 3D
+- 表面、向量场、空间几何、3D 变换
+## 何时不使用 3D
+- 2D 概念、包含大量文本的场景、扁平数据（柱状图、时间序列）
+
+## ZoomedScene — 局部放大
+
+在保持完整视图可见的同时，显示某个细节的放大插图：
+
+```python
+class ZoomExample(ZoomedScene):
+    def __init__(self, **kwargs):
+        super().__init__(
+            zoom_factor=0.3,           # how much of the scene the zoom box covers
+            zoomed_display_height=3,   # size of the inset
+            zoomed_display_width=3,
+            zoomed_camera_frame_starting_position=ORIGIN,
+            **kwargs
+        )
+
+    def construct(self):
+        self.camera.background_color = BG
+        # ... create your scene content ...
+
+        # Activate the zoom
+        self.activate_zooming()
+
+        # Move the zoom frame to a point of interest
+        self.play(self.zoomed_camera.frame.animate.move_to(detail_point))
+        self.wait(2)
+
+        # Deactivate
+        self.play(self.get_zoomed_display_pop_out_animation(), rate_func=lambda t: smooth(1-t))
+```
+
+用例：放大方程中的特定项、展示图表中的精细细节、放大绘图的某个区域。
+
+## LinearTransformationScene — 线性代数
+
+预置了 basis vectors 和网格的场景，用于可视化矩阵变换：
+
+```python
+class LinearTransformExample(LinearTransformationScene):
+    def __init__(self, **kwargs):
+        super().__init__(
+            show_coordinates=True,
+            show_basis_vectors=True,
+            **kwargs
+        )
+
+    def construct(self):
+        matrix = [[2, 1], [1, 1]]
+
+        # Add a vector before applying the transform
+        vector = self.get_vector([1, 2], color=YELLOW)
+        self.add_vector(vector)
+
+        # Apply the transformation — grid, basis vectors, and your vector all transform
+        self.apply_matrix(matrix)
+        self.wait(2)
+```
+
+这能产生标志性的 3Blue1Brown“线性代数的本质”视觉效果——网格线扭曲，basis vectors 拉伸，determinant 通过面积变化直观呈现。

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

@@ -0,0 +1,202 @@
+# 装饰与视觉润色
+
+装饰物是用于注解、突出显示或框选其他 mobjects 的 mobjects。它们能将技术上正确的动画转变为视觉上精美的动画。
+
+## SurroundingRectangle
+
+在任何 mobject 周围绘制一个矩形。这是突出显示的首选：
+
+```python
+highlight = SurroundingRectangle(
+    equation[2],            # the term to highlight
+    color=YELLOW,
+    buff=0.15,              # padding between content and border
+    corner_radius=0.1,      # rounded corners
+    stroke_width=2
+)
+self.play(Create(highlight))
+self.wait(1)
+self.play(FadeOut(highlight))
+```
+
+### 围绕等式的一部分
+
+```python
+eq = MathTex(r"E", r"=", r"m", r"c^2")
+box = SurroundingRectangle(eq[2:], color=YELLOW, buff=0.1)  # highlight "mc²"
+label = Text("mass-energy", font_size=18, font="Menlo", color=YELLOW)
+label.next_to(box, DOWN, buff=0.2)
+self.play(Create(box), FadeIn(label))
+```
+
+## BackgroundRectangle
+
+文字背后的半透明背景，用于在复杂场景中提高可读性：
+
+```python
+bg = BackgroundRectangle(equation, fill_opacity=0.7, buff=0.2, color=BLACK)
+self.play(FadeIn(bg), Write(equation))
+
+# Or using set_stroke for a "backdrop" effect on the text itself:
+label.set_stroke(BLACK, width=5, background=True)
+```
+
+对于图表/示意图上的文字标签，使用 `set_stroke(background=True)` 方法更为简洁。
+
+## Brace 和 BraceLabel
+
+用于注解图表或等式各部分的花括号：
+
+```python
+brace = Brace(equation[2:4], DOWN, color=YELLOW)
+brace_label = brace.get_text("these terms", font_size=20)
+self.play(GrowFromCenter(brace), FadeIn(brace_label))
+
+# Between two specific points
+brace = BraceBetweenPoints(point_a, point_b, direction=UP)
+```
+
+### Brace 放置位置
+
+```python
+# Below a group
+Brace(group, DOWN)
+# Above a group
+Brace(group, UP)
+# Left of a group
+Brace(group, LEFT)
+# Right of a group
+Brace(group, RIGHT)
+```
+
+## 用于标注的箭头
+
+### 指向 mobjects 的直线箭头
+
+```python
+arrow = Arrow(
+    start=label.get_bottom(),
+    end=target.get_top(),
+    color=YELLOW,
+    stroke_width=2,
+    buff=0.1,                    # gap between arrow tip and target
+    max_tip_length_to_length_ratio=0.15  # small arrowhead
+)
+self.play(GrowArrow(arrow), FadeIn(label))
+```
+
+### 曲线箭头
+
+```python
+arrow = CurvedArrow(
+    start_point=source.get_right(),
+    end_point=target.get_left(),
+    angle=PI/4,                  # curve angle
+    color=PRIMARY
+)
+```
+
+### 带有箭头的标注
+
+```python
+# LabeledArrow: arrow with built-in text label
+arr = LabeledArrow(
+    Text("gradient", font_size=16, font="Menlo"),
+    start=point_a, end=point_b, color=RED
+)
+```
+
+## DashedLine 和 DashedVMobject
+
+```python
+# Dashed line (for asymptotes, construction lines, implied connections)
+asymptote = DashedLine(
+    axes.c2p(2, -3), axes.c2p(2, 3),
+    color=YELLOW, dash_length=0.15
+)
+
+# Make any VMobject dashed
+dashed_circle = DashedVMobject(Circle(radius=2, color=BLUE), num_dashes=30)
+```
+
+## Angle 和 RightAngle 标记
+
+```python
+line1 = Line(ORIGIN, RIGHT * 2)
+line2 = Line(ORIGIN, UP * 2 + RIGHT)
+
+# Angle arc between two lines
+angle = Angle(line1, line2, radius=0.5, color=YELLOW)
+angle_value = angle.get_value()  # radians
+
+# Right angle marker (the small square)
+right_angle = RightAngle(line1, Line(ORIGIN, UP * 2), length=0.3, color=WHITE)
+```
+
+## Cross（删除线）
+
+将某物标记为错误或已弃用：
+
+```python
+cross = Cross(old_equation, color=RED, stroke_width=4)
+self.play(Create(cross))
+# Then show the correct version
+```
+
+## Underline
+
+```python
+underline = Underline(important_text, color=ACCENT, stroke_width=3)
+self.play(Create(underline))
+```
+
+## 颜色高亮工作流
+
+### 方法 1：创建时使用 t2c
+
+```python
+text = Text("The gradient is negative here", t2c={"gradient": BLUE, "negative": RED})
+```
+
+### 方法 2：创建后使用 set_color_by_tex
+
+```python
+eq = MathTex(r"\nabla L = -\frac{\partial L}{\partial w}")
+eq.set_color_by_tex(r"\nabla", BLUE)
+eq.set_color_by_tex(r"\partial", RED)
+```
+
+### 方法 3：索引到 submobjects
+
+```python
+eq = MathTex(r"a", r"+", r"b", r"=", r"c")
+eq[0].set_color(RED)    # "a"
+eq[2].set_color(BLUE)   # "b"
+eq[4].set_color(GREEN)  # "c"
+```
+
+## 组合多个标注
+
+将多个标注叠加以进行强调：
+
+```python
+# Highlight a term, add a brace, and an arrow — in sequence
+box = SurroundingRectangle(eq[2], color=YELLOW, buff=0.1)
+brace = Brace(eq[2], DOWN, color=YELLOW)
+label = brace.get_text("learning rate", font_size=18)
+
+self.play(Create(box))
+self.wait(0.5)
+self.play(FadeOut(box), GrowFromCenter(brace), FadeIn(label))
+self.wait(1.5)
+self.play(FadeOut(brace), FadeOut(label))
+```
+
+### 标注的生命周期
+
+标注应遵循一定的节奏：
+1. **出现** — 吸引注意力（Create、GrowFromCenter）
+2. **停留** — 观众阅读并理解（self.wait）
+3. **消失** — 为下一个内容清理画面（FadeOut）
+
+切勿让标注无限期地停留在屏幕上——一旦达到目的，它们就会变成视觉噪音。