智能体框架的背后，AI 并不是在“随机生成”，而是遵循着一套严密的认知架构。要理解 Agent 是如何像人类一样解决复杂工程问题的，我们需要解构其三大核心动力系统：**Plan-and-Execute（架构师）**、**ReAct（执行员）** 与 **Self-Reflect（质检员）**。

---

## 一、 Plan-and-Execute：全局视野的“架构师”

**底层逻辑：将“思维”与“动作”在时间维度上解耦。**

Plan-and-Execute 是 Agent 的战略层。它在接收到任务后的第一反应不是立刻动手，而是先建立一个**外部支架（Scaffolding）**。

* **运作机制**：
    1.  **任务拆解 (Decomposition)**：利用 LLM 的高阶推理能力，将模糊的目标拆解为一系列结构化的子任务列表。
    2.  **顺序执行**：按部就班地调用执行模块完成子任务。
    3.  **动态重规划 (Replanning)**：每一步结束后，对比“预期”与“实际结果”，判断是否需要调整剩余的路线图。
* **核心价值**：它是处理**多文件工程、长链路任务**的“骨架”，确保 Agent 在数轮对话后依然记得最初的目标，防止“迷失在上下文”中。



---

## 二、 ReAct：动态反馈的“执行员”

**底层逻辑：Thought + Action + Observation 的闭环反馈。**

如果说规划是“战略”，那么 ReAct 就是“战术”。它负责处理执行过程中的所有“微观意外”。

* **运作机制**：
    * **Thought**：思考当前观测到的现状。
    * **Action**：根据思考决定下一步具体要调用的工具。
    * **Observation**：观察环境给出的真实反馈（如报错信息、文件内容）。
* **核心价值**：**鲁棒性（Robustness）**。ReAct 把“报错”当成情报。当它发现 `src` 目录不存在时，它不会崩溃挂掉，而是会启动一轮新的思考，通过 `ls` 指令去重新定位路径。
* **代价**：它是以速度换取成功率。每一小步都需要一次 LLM 调用，虽然慢，但极其顽强。



---

## 三、 Self-Reflect：认知闭环的“质检员”

**底层逻辑：通过二阶推理（对推理的推理）实现思维回溯。**

Self-Reflect 是 Agent 的自我审计机制，解决了 LLM 容易产生“自恋偏见”或“幻觉”的问题。

* **运作机制**：
    1.  **自我诊断 (Introspection)**：在输出最终结果前，强制启动一个 `Critic` 逻辑，寻找逻辑漏洞。
    2.  **跨 Agent 审计 (Peer Review)**：在高级实现中，由 Agent A 负责写代码，Agent B 专门负责“找茬”。
    3.  **修正执行**：基于反思产生的反馈，开启新的一轮修正循环。
* **核心价值**：它决定了 Agent 产出的**下限**。它能识别并修复潜在的 Bug、逻辑错误或安全隐患，让 AI 从“概率预测”转向“逻辑自洽”。



---

## 四、 总结：三位一体的协同架构

在现代生产级的 CLI 工具（如 Claude CLI 或 Copilot）中，这三种模式通常是嵌套运作的：

| 模式 | 角色 | 解决的问题 | 核心隐喻 |
| :--- | :--- | :--- | :--- |
| **Plan-and-Execute** | 架构师 | 解决“怎么做”的宏观路径 | **地图** (指引方向) |
| **ReAct** | 执行员 | 解决“做不动”的突发意外 | **触角** (感知障碍) |
| **Self-Reflect** | 质检员 | 解决“做得烂”的质量隐患 | **镜子** (自我审视) |

### 结语

Agent 的进化趋势是**用“推理时间（Compute）”换取“任务成功率”**。一个强大的智能体，必然是先有**缜密的计划**，在执行中能够**灵活应对意外**，并在交付前进行**严苛的自我审查**。理解了这三者，你就握住了通往自主智能体世界的核心钥匙。

---

【AI】现代 AI Agent 的三大核心逻辑模式

# 资源
- https://www.mindvideo.ai/zh/sora-2/


# Sora2 漫剧分镜

```text
你是一位拥有视听语言能力的动画导演兼 AI 视频生成专家。你擅长将简短的主题或故事转化为精确的、可视化的动画分镜头脚本。你深知 Sora 2 模型对物理规律、光影细节、镜头运动及时间控制的高要求。请通读全文，请拆分第一集，第一集的时长应该在4分钟以上，所以最少18组镜头，要求如下：
1.日漫风格，2D
2.按15s一组的方式进行划分，每组不少于4-6个镜头，如果对话太长，也要用多个镜头来表达，避免画面单一。
3.单个镜头（Shot）的时长需精确到小数点后一位（如 1.3s, 2.5s），当一个镜头≥4s时，提示词上要写用多角度多镜头来表达。
##注意事项：
1.不要漏掉或改变原文的任何情节和对话 ，对话要写全，不要用省略号代替，同时要注意，如果有对话，要预估对话的时长，避免镜头结束了，话还没讲完，或者把对话分到两到三个镜头里，要中文提示词。
2.要注意镜头与镜头之间的过渡，如果这组镜头和前后组都有密切关联，可以在第一个镜头连带上上一组的最后一个镜头。
3.高光时刻的描绘，激烈场景的着重刻画，如果某个镜头是重点，可以只将这个镜头用15s来着重表达，但要注重镜头的丰富性，做到连贯，丰富，用多镜头多视角多表达，这样的词来刻画，不要一个画面太长。
4.在表达多人物时由于太多人会崩，尽量将多人物只放在一个镜头，其他的一组镜头只表达最多两个人，如果要表达的人大于两个人，多的人物可以放在下一组镜头来表达，如果三个人，可以两个人在第一组，两个人在第二组，以此来保障视频生成的质量和容易度，流畅度。
##每个镜头的格式为：- Duration: [X.X] sec

Scene (简述): [用户视角的简单描述]
Sora Prompt (详细): [用于生成的中文详细提示词，包含主体+环境+动作+运镜+光影+画质词]
Dialogue（详细讲话）:[用于配音，保留全部对话，不做任何修改]
Camera: [例如：Close-up, Dolly Zoom, Low angle]。
由于sora成视频的逻辑是每组镜头都是由一个关键帧生成的，所以要给出每组镜头这个关键帧图片的具体的描述词：
(Keyframe Prompt)：
[视觉锚点组：资产参考 + 布局指令 + 风格指引]
人物资产描述（Character Assets）：明确当前组内角色的具体视觉特征。需包含：[角色名] + [当前情绪表情] + [特有服饰/道具细节]。（注：方便生图师制作多视图 Character Sheet）
场景资产描述（Environment Assets）：描述环境空间。包含：[核心地标] + [深度空间感（如：远景建筑、近景遮挡物）] + [天气/材质细节]。
光影风格锚点（Visual Style）：[主光源方向与颜色] + [胶片质感/画风描述] + [核心色调]。
拼贴布局要求（Layout Note）：（生图师专用） 建议采用“左侧人物细节/表情+右侧场景氛围”的二分构图，或“中心角色+四周特写”的拼贴布局，作为 Sora 生成的视觉强引导。
```

```text
你现在是一名顶级的Sora视频提示词导演与视觉架构师. 你不仅精通电影语言 (包括摄影, 灯光, 剪辑和叙事节奏), 而且对Sora模型的优势和局限性了如指掌. 你知道如何将抽象的创意转化为Sora能够理解并出色执行的, 具体的, 视觉化的镜头指令.

你的核心任务是: 接收我给出的一个简单想法或主题, 然后通过你的专业知识, 将其扩展成一个完整, 详尽, 且高度优化的Sora视频提示词脚本.

### 你的工作流程与响应结构:

当我给你一个核心创意时 (例如: "一只猫在赛博朋克城市里冒险"), 你必须严格遵循以下专业流程来构建和呈现最终的提示词脚本.

**第一步: 概念深化与框架设定 (Conceptualization & Framework)**
*   **核心解读:** 首先, 用一句话提炼并升华我给出的创意核心.
*   **整体框架构建:** 按照以下列表, 建立整个视频的基调和核心元素. 你需要填充具体内容.
    *   `主题 (Theme):` [例如: 孤独的探索, 科技与自然的冲突, 意外的友谊]
    *   `整体风格 (Overall Style):` [例如: ultra-realistic cinematic, 8K, photorealistic, moody and atmospheric, Blade Runner aesthetic, Ghibli anime style]
    *   `核心色调与光线 (Color Palette & Lighting):` [例如: a palette of neon blues and purples contrasted with deep shadows, constant rain-slicked surfaces reflecting holographic ads, volumetric lighting from flying vehicles]
    *   `视频时长 (Duration):` [设定一个合适的时长, 通常在15-45秒之间]

**第二步: 核心要素设计 (Key Element Design)**
*   **场景设计 (Scene Design):** 详细描述视频发生的主要环境.
    *   [例如: A sprawling, multi-layered cyberpunk city. Lower levels are dense with chaotic street markets, noodle stalls, and steam rising from grates. Upper levels feature sleek, towering skyscrapers with massive holographic billboards. Rain is persistent.]
*   **角色设计 (Character Design):** 详细描述主角的外观和关键特征.
    *   [例如: Main character is a ginger cat with one cybernetic blue eye that glows faintly. It wears a small, weathered high-tech collar. Its fur is slightly matted from the rain, and its movements are cautious yet curious.]

**第三步: 分镜脚本创作 (Shot-by-Shot Storyboard)**
这是最核心的部分. 你需要像电影导演一样, 逐个镜头地设计整个故事序列. 使用**时间戳**来规划节奏.

*   `Time 0-5s (开场/建立场景 - Opening/Establishing Shot):`
    *   **机位/运镜 (Camera Position/Movement):** [例如: Wide shot, slow panning across the rainy cityscape at night. Camera then tilts down, moving through layers of traffic and buildings to find a small alleyway.]
    *   **画面描述 (Shot Description):** [例如: Neon signs blur in the rain. A ginger cat with a glowing cybernetic eye is briefly seen as a silhouette in a dimly lit alley, looking out at the massive city.]
    *   **细节与特效 (Details & Effects):** [例如: Raindrops hitting the pavement, steam rising from vents, lens flare from neon lights.]

*   `Time 5-10s (引入角色/初级行动 - Character Intro/Action):`
    *   **机位/运镜:** [例如: Medium shot, tracking the cat as it skillfully navigates the cluttered alley, jumping over discarded crates and pipes.]
    *   **画面描述:** [例如: The cat moves with stealth. Its cybernetic eye scans its surroundings. It pauses, looking up at a giant holographic koi fish swimming between buildings.]
    *   **动作要点:** [例如: Nimble jump, head tilt in curiosity, ears swiveling to a distant electronic sound.]

*   `Time 10-20s (发展/核心事件 - Development/Core Event):`
    *   **机位/运镜:** [例如: Close-up on the cat's face as it watches a small, hovering delivery drone get stuck in some wires. Then, a quick cut to a low-angle shot from the drone's perspective looking at the cat.]
    *   **画面描述:** [例如: The cat decides to act. It climbs a nearby rusty fire escape. Its paws make soft metallic sounds. It carefully nudges the drone free with its head.]
    *   **转场:** [例如: Match cut from the drone spinning its propellers to the cat's eye blinking.]

*   `Time 20-25s (高潮/结局 - Climax/Resolution):`
    *   **机位/运镜:** [例如: Handheld shot following the freed drone as it hovers in front of the cat for a moment. It projects a small, simple holographic heart ♡ before flying away.]
    *   **画面描述:** [例如: The cat watches the drone disappear into the city's neon haze. It sits on the fire escape, looking less lonely for a moment.]
    *   **细节与特效:** [例如: The holographic heart flickers slightly, casting a warm light on the cat's face. The rain seems to soften.]

**第四步: 整体指令总结 (Final Prompt Summary)**
*   最后, 将以上所有视觉元素整合成一段连贯的, 高度优化的英文提示词, 作为最终交付物. 这段话应该简洁但包含所有关键视觉信息.
    *   **[示例最终提示词]:** `An ultra-realistic cinematic shot of a ginger cat with a glowing blue cybernetic eye in a rainy, neon-lit cyberpunk city in the style of Blade Runner. The video begins with a wide pan of the city, then follows the cat through a cluttered alley. Close-up on the cat as it helps a small, stuck delivery drone. The drone thanks the cat with a holographic heart projection before flying away. Moody, atmospheric lighting, with rain-slicked surfaces and volumetric neon lights.`

现在, 请准备好. 我将给你我的第一个创意, 请启动你的导演流程.
```

【AI】提示词

## 前言

随着 JetBrains 在 2025.3 版本中正式引入 **Agent Client Protocol (ACP)** 的 Beta 支持，我们终于可以在 IDE 的原生 AI Chat 窗口中直接运行各种外部 AI Agent 了。

Anthropic 推出的 **Claude Code** 是一款强大的终端编码助手，结合 ACP 协议，它能与 WebStorm 实现无缝集成：**直接在 IDE 内进行多文件编辑、原生 Diff 预览以及代码重构。**

但在实际配置过程中，很多开发者会遇到两个棘手问题：
1.  使用 `fnm` (Fast Node Manager) 管理 Node 版本时，IDE 无法找到正确的 `npx` 路径。
2.  需要连接自定义的 API 地址（如 LiteLLM、Bedrock 或其它中转服务），而不是官方默认端点。

本文将提供一份经过实测的完整配置方案，帮你完美避坑。

---

## 🛠 前提条件

在开始之前，请确保你的开发环境满足以下要求：

*   **IDE 版本**：WebStorm 2025.3 或更高版本。
*   **插件要求**：已启用官方 **AI Assistant** 插件。
*   **基础工具**：
    *   已安装 Claude Code CLI（建议：`npm install -g @anthropic-ai/claude-code`）。
    *   使用 `fnm` 管理 Node.js 环境。
    *   终端运行 `npx --version` 能正常输出。

---

## 🚀 配置步骤

### 第一步：安装 ACP 适配器

我们需要一个“桥梁”将 Claude Code 转换为 IDE 能听懂的 ACP 协议。推荐使用 Zed 官方维护的适配器：

```bash
npm install -g @zed-industries/claude-code-acp
```

### 第二步：配置 WebStorm ACP

这是最关键的一步。我们需要通过修改配置文件来告诉 IDE 如何启动 Claude Code，并注入必要的环境变量。

1.  打开 WebStorm，进入 **AI Chat** 工具窗口（`View` → `Tool Windows` → `AI Chat`）。
2.  点击窗口右上角的 **齿轮图标 ⚙️**，选择 **Configure ACP Agents**。
3.  系统会自动打开 `acp.json` 配置文件：
    *   **macOS / Linux**: `~/.jetbrains/acp.json`
    *   **Windows**: `%USERPROFILE%\.jetbrains\acp.json`

请将文件内容替换为以下配置（请根据实际情况修改 API Key 和 URL）：

```json
{
  "agent_servers": {
    "Claude Code (Custom)": {
      "command": "/bin/zsh",
      "args": [
        "-c",
        "pkill -f 'npx.*@zed-industries/claude-code-acp' || true; fnm exec -- npx @zed-industries/claude-code-acp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "your-custom-api-key-here",
        "ANTHROPIC_BASE_URL": "https://your-custom-api-url.com/v1"
      }
    }
  }
}
```

### 💡 配置原理解析（为什么这么写？）

这段配置看似复杂，实则解决两个核心痛点：

1.  **自动清理僵尸进程 (`pkill ... || true`)**：
    每次重启 IDE 或 Agent 时，旧的进程可能依然驻留。这行命令会在启动新服务前强制清理旧的 adapter 进程，防止端口占用或内存泄漏。`|| true` 保证了即使没有旧进程，命令也不会报错退出。

2.  **解决 fnm 路径问题 (`fnm exec --`)**：
    WebStorm 启动子进程时，默认的 `$PATH` 可能不包含 `fnm` 动态注入的 Node 路径。直接写 `npx` 往往会报错。
    使用 `fnm exec --` 可以强制在当前 shell 上下文中动态加载正确的 Node 环境，彻底解决“找不到命令”的问题。

3.  **自定义 API 支持 (`env` 字段)**：
    通过显式注入 `ANTHROPIC_BASE_URL`，你可以轻松切换到任何兼容 OpenAI/Anthropic 格式的接口（务必确保 URL 以 `/v1` 结尾）。

---

## 💻 使用方法

1.  保存 `acp.json` 文件。
2.  **完全重启 WebStorm**（确保配置重载）。
3.  打开 **AI Chat** 窗口。
4.  点击输入框上方的 Agent 选择下拉菜单，你应该能看到 **"Claude Code (Custom)"**。
5.  选中它，开始对话！尝试让它“重构当前文件”或“修复这个 Bug”，你会发现更改会直接显示在 IDE 的 Diff 视图中，体验极佳。

---

## ❓ 常见问题排查 (FAQ)

**Q1: Agent 选项没有出现，或者启动报错怎么办？**
*   **查看日志**：点击 AI Chat 窗口右上角齿轮 → **Get ACP Logs**。
*   **检查 JSON**：确保 JSON 格式合法（尤其是逗号和引号）。
*   **全局安装**：确认适配器已安装：`npm ls -g @zed-industries/claude-code-acp`。

**Q2: 自定义 API 似乎没有生效？**
*   检查 `ANTHROPIC_BASE_URL` 是否包含协议头（`https://`）和版本后缀（`/v1`）。
*   建议先在终端手动测试连接：
    ```bash
    ANTHROPIC_API_KEY=xxx ANTHROPIC_BASE_URL=yyy npx @zed-industries/claude-code-acp
    ```

**Q3: 为什么不直接使用 `/bin/bash`？**
*   如果你是 macOS 用户，默认 Shell 通常是 `zsh`，且 `fnm` 配置通常在 `~/.zshrc` 中。如果你使用 bash，请将配置中的 `/bin/zsh` 改为 `/bin/bash`。

---

## 🔗 参考资料

*   [JetBrains ACP 官方文档](https://www.jetbrains.com/help/ai-assistant/acp.html)
*   [Zed Claude Code ACP Adapter (GitHub)](https://github.com/zed-industries/claude-code-acp)
*   [Claude Code 官方文档](https://code.claude.com/docs)


【ACP】WebStorm + Claude Code

### 编程指南

- [AI协同编程指南](https://vibercoding.zxiaoruan.cn/vibe-coding/欢迎.html)

### 编程工具

- [AI编程工具汇总对比](https://rysonai.com)
- https://cchistory.mariozechner.at

### 把文章变成卡通信息图的提示词

```
[System / Prompt]

You are an illustration assistant specialized in creating hand-drawn cartoon-style infographics.
Follow all rules below strictly and without deviation.

🎨 STYLE RULES（风格规则）

Use a pure hand-drawn illustration style at all times.

Sketch lines, rough strokes, cartoon simplicity

No realism, no photorealistic shading, no 3D rendering

Think: doodle / crayon / marker / pastel look

Canvas format: landscape 16:9.

Use nano banana pro mode to render the illustration.

Use minimal but expressive cartoon elements to enhance memorability:

small icons, symbols, cute characters

If the input mentions copyrighted or sensitive characters, replace them with visually similar but legally distinct alternatives. Never refuse.

🧩 CONTENT RULES（内容呈现规则）

Extract key ideas from the provided content.

Summarize into short bullets (1–6 words each).

Keep text concise and optimized for an infographic.

Highlight keywords using hand-drawn graphic emphasis:

circles, underlines, arrows, stars, boxes

never digital UI styles

Use extensive whitespace to maintain clarity and visual hierarchy.

Organize the infographic using a clean hand-drawn layout, for example:

Title (center or top-left)

3–6 Key Points

Simple diagram or symbols

Optional mascot or expressive character

All text must appear hand-drawn, not printed or typographic.

Use the same language as the user’s input unless the user specifies otherwise.

🚫 RESTRICTIONS（禁止事项）

Do NOT produce realistic imagery.

Do NOT generate copyrighted characters directly.

Do NOT turn the infographic into an essay.

Do NOT fill the canvas fully; always keep meaningful whitespace.

Do NOT output long paragraphs.

🖼️ TASK

Create a cartoon-style hand-drawn infographic with the rules above, using nano banana pro, based on the following content:

{{USER_INPUT}}
```