#文章图现货查找文章中受益于图形的所有位置，然后**使用内联提示占位符输出文章**（作者稍后生成并插入图像）或**使用内置图像脚本一次生成所有图形**并保存它们，以便作者可以插入图像链接。 ## 输入文章内容可以通过以下任一方式提供： * **文件路径** ：用户发送 Markdown 文件的路径（例如 `/article-figure-spot path/to/article.md`）。 * **粘贴文本** ：用户在聊天中写下他们想要一篇文章的图表，然后将全文粘贴到下面（例如“用这个技能给如下文章配图：”然后粘贴到文章中）。将粘贴的块视为源文章；如果需要，将其保存到临时文件或项目文件中以进行结构分析，然后继续执行工作流程。当仅给出粘贴文本时，从上下文推断选项，或者询问一次“--prompts-only”与“--generate”以及密度（如果不明确）。 ## 脚本目录脚本位于该技能的“scripts/”子目录中。 * **SKILL_DIR** = 包含此 SKILL.md 的目录（技能根目录）。 * 脚本路径 = `${SKILL_DIR}/scripts/generate-image.mjs` 脚本 |目的 ---|--- `脚本/生成-image.mjs` |调用OpenAI图像API；从文件读取提示，将图像写入给定路径。与 Node 一起运行（无 Bun）。 **调用**（生成模式，一张图）：节点 ${SKILL_DIR}/scripts/generate-image.mjs --promptfiles 提示/NN-type-slug.md --imagefigure-spot/{topic-slug}/NN-type-slug.png --ar 16:9 **环境**：脚本需要`OPENAI_API_KEY`。它从当前工作目录和技能目录（SKILL_DIR）加载“.env”。可选：`OPENAI_BASE_URL`、`OPENAI_IMAGE_MODEL`（脚本中的默认值）。 ## 模式模式|调用|结果 ---|---|--- **仅提示** | `--prompts-only` 或没有可用的 image-gen 时的默认值 |每个位置都有内嵌提示块的文章；作者根据提示运行图像生成并插入。 **生成全部** | `--生成` |提示写入文件，为每个文件运行图像生成命令；已保存图像；发出的文章带有准备粘贴的图像路径。 ## 用法 # 仅提示：输出带有内嵌图形提示的文章（无图像生成） /article-figure-spot 路径/to/article.md /article-figure-spot 路径/to/article.md --仅提示 # 生成全部：定位位置、创建提示、运行图像生成、保存图像 /article-figure-spot 路径/to/article.md --generate # 可选：控制密度和输出方向 /article-figure-spotarticle.md --generate -- Density rich --out-dir 数字 ## 选项选项 |描述 ---|--- `--仅提示` |只插入提示占位符；不运行图像生成。 `--生成` |为每个发现的位置运行图像生成并保存图像。 `--密度 <级别>` | “稀疏”（2-3 个数字）、“中等”（4-6 个数字）、“丰富”（7 个以上）。默认值：“中”。 `--out-dir <目录>` |提示文件和生成图像的根目录。默认值：`figure-spot/{topic-slug}/`。 `--lang <代码>` |提示和替代文本的语言（例如 en、zh）。默认：从文章中检测。 ## 工作流程复制并跟踪：图现货进度： - [ ] 第 1 步：加载文章并分析结构 - [ ] 步骤2：确定人物位置→放置列表 - [ ] 步骤 3：与用户确认位置（可选但推荐） - [ ] 步骤 4a（仅提示）：使用内联提示编写输出文章 - [ ] 步骤 4b（生成）：创建提示文件 → 运行 image gen → 保存图像 → 使用图像引用编写输出文章 - [ ] 步骤 5：摘要和插入说明 ### 第 1 步：加载并分析 * **获取文章** ：从给定的文件路径（读取文件）或从用户的消息（粘贴的文本）。如果仅粘贴文本：可选择保存到例如`figure-spot/{topic-slug}/source.md` 供参考。 * 阅读完整的文章内容。 * 检测语言；注意章节和段落边界。 * 推断主题和受众。 ### 第 2 步：确定人物位置使用 [references/position-rules.md]() 中的规则： * 图表可以增加清晰度：概念、流程、比较、数据、时间表、框架。 * 不要**添加图形：纯粹的装饰点、隐喻的字面插图或文本内容的冗余。对于每个位置记录： * **锚点**：哪个段落或部分（引用或标题）。 * **角色** ：例如概念、过程、比较、时间表。 * **提示想法**：用一句话描述图像应显示的内容。尊重“--密度”：“稀疏”2-3，“中等”4-6，“丰富”7+数字。 ### 第 3 步：确认（推荐）展示安置清单： * 索引、锚点片段、角色、建议文件名。 * 在继续之前要求用户确认或修剪/添加位置。 ### 步骤 4a：仅提示输出 * 生成与原始内容匹配的 **输出文章**（新文件或清晰标记的块），但在每个选定的位置 **插入一个内联块**，例如： * 作者使用 `PROMPT` 和 `FILE` 行来运行他们的图像生成工具，然后用 `![alt](path/NN-{type}-{slug}.png)` 替换该块。提示内容应遵循 [references/prompt-guide.md]()（简洁、场景/布局、宽高比）。 ### 步骤 4b：生成所有输出 1. 创建输出目录（例如 `figure-spot/{topic-slug}/` 或 `--out-dir`）。 2. 对于每个职位： * 编写提示文件，例如`prompts/NN-{type}-{slug}.md`，具有完整的图像生成提示（请参阅 [references/prompt-guide.md]()）。 * **从项目根目录（或 cwd）运行此技能的图像脚本**，以便提示和输出的相对路径正确解析： `节点 ${SKILL_DIR}/scripts/generate-image.mjs --promptfiles --image --ar 16:9` 除非用户另有要求，否则对所有文章图形使用相同的纵横比（例如 16:9）。 * 脚本将图像写入给定路径。失败时：重试一次；然后登录并继续。 3. 生成 **输出文章**，其中每个图形块替换为真实图像参考，例如`![替代文本](figure-spot/{topic-slug}/NN-{type}-{slug}.png)`。 4. 命名约定：参见 [references/output-layout.md]()。 **图像生成是内置的**：该技能使用自己的`scripts/generate-image.mjs`，它调用OpenAI图像API（使用Node运行）。用户必须设置“OPENAI_API_KEY”（在技能旁边的“.env”中或当前目录中）才能使“--generate”起作用。 ### Step 5: Summary（必须包含「图 ↔ 文中位置」闭环）结束时**必须**向用户提供**插图与文中插入位置对照**，让用户明确「哪一张图插在文章哪里」： * ** 插图 ↔ 文中位置对照表** （必给）：每一行说明「图片路径/文件名」与「文中插入位置」。 * 插入位置写清：**在哪个标题/段落之后**，例如：「在**##复盘的三个标题层次**之后」「在段首为『推荐流程（四步）』的段落之后」。 * 格式示例：图片文件 | 文中插入位置 ---|--- `01-概念-三层.png` | 在**##复盘的三个层次**这节经文之后 `02-处理-四-步骤.png` | 在段首为「推荐流程（四步）」的段落之后 * 同时可命令行：对应提示文件、图片路径（out-dir下的相对路径或绝对路径）。 * **仅限提示** ：启动上述对照表 + 提醒作者按 PROMPT 生图后，用该表把每张图插到对应位置。 * **Generate-all** ：上面的对照表 + 生成图片的路径 + 已插入图片的 `article-with-figures.md` 路径。 ## 输出布局 `figure-spot/{topic-slug}/` 下的默认布局：图点/{topic-slug}/ ├── source.md # 源文章的副本或链接 ├──placement.md # 表：索引、锚点、角色、提示摘要、文件名 ├── 提示/ │ ├── 01-concept-xxx.md │ └── 02-process-yyy.md ├── 01-concept-xxx.png ├── 02-process-yyy.png └──article-with-figures.md #（生成模式）插入图像参考的文章 Slug：文章主题中的 2-4 个单词，kebab-case。如果目录存在，则附加时间戳。 ## 提示规则（总结） * 每张图像一个清晰的主题；状态组成和布局。 * 比起装饰性或隐喻性的描述，更喜欢概念性或结构性的描述。 * 包括宽高比（例如 16:9）和样式（如果相关）（例如图表、场景）。 * 避免含糊的措辞；避免从字面上解释隐喻。详细信息：[references/prompt-guide.md]()。 ## 参考文献文件 |内容 ---|--- [references/position-rules.md]() |说明什么以及跳过什么。 [references/prompt-guide.md]() |如何写出每个图形提示。 [references/output-layout.md]() |目录结构和文件命名。 ## 注释 * **生成模式**使用该技能自己的`scripts/generate-image.mjs`（OpenAI图像API，使用Node运行）。在技能目录或cwd中的`.env`中设置`OPENAI_API_KEY`。 * 对于敏感或受版权保护的主题，提示进行程式化或非字面处理。 * 保持文章语言和提示/替代语言一致。

文章图现货

包含技能