Skip to content

Spot it. Save it. Free, local-first Chrome extension for images, videos and prompts. Explore 2,000+ curated cases and connect your library to AI Agents via MCP. 提示词导演

Refresh GitHub page: "Spot it. Save it." hero, demo and feature GIFs, screenshots (#36)

wchao6891012cb3f262b1
diff --git a/README.md b/README.md
index e855721..8623bd0 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,72 @@
-<p align="center"><img src="docs/assets/github-banner.svg" alt="PromptDirector — Capture, collect, organize" width="100%"></p>
+<p align="center">
+ <img src="store/brand/prompt-director-mark-source.png" alt="PromptDirector logo" width="88">
+</p>
+
+<h1 align="center">PromptDirector 提示词导演</h1>
+
+<p align="center"><strong>Spot it. Save it.</strong><br>刷到就存,要用就有</p>
+
+<p align="center">
+ <a href="https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm"><img src="https://img.shields.io/chrome-web-store/users/iahakaahijddcjjldidbclicedibgpjm?label=Chrome%20users&color=D1FE17&labelColor=101416" alt="Chrome Web Store users"></a>
+ <a href="https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm"><img src="https://img.shields.io/chrome-web-store/v/iahakaahijddcjjldidbclicedibgpjm?label=Chrome%20Web%20Store&color=D1FE17&labelColor=101416" alt="Chrome Web Store version"></a>
+ <a href="https://github.com/wchao6891/PromptDirector/releases/latest"><img src="https://img.shields.io/github/v/release/wchao6891/PromptDirector?filter=v*&label=release&color=D1FE17&labelColor=101416" alt="Latest release"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/wchao6891/PromptDirector?color=D1FE17&labelColor=101416" alt="License"></a>
+</p>
<p align="center"><strong>English</strong> · <a href="README.zh-CN.md">简体中文</a></p>
-<h1 align="center">Turn great references into your next creation.</h1>
+<p align="center">
+ <a href="https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm"><img src="https://img.shields.io/badge/Add%20to%20Chrome-It's%20free-D1FE17?style=for-the-badge&logo=googlechrome&logoColor=101416&labelColor=D1FE17&color=101416" alt="Add to Chrome — it's free" height="44"></a>
+</p>
+
+<p align="center">
+ <a href="https://www.youtube.com/watch?v=ttbNMJ7Gm7Q"><img src="docs/assets/demo.gif" alt="PromptDirector demo: browse your library, save cases in one click" width="800"></a><br>
+ <a href="https://www.youtube.com/watch?v=ttbNMJ7Gm7Q">▶ Watch the 71-second demo</a>
+</p>
+
+- **One click: image + prompt.** Save works, videos and their public prompts from Jimeng, Higgsfield, Midjourney, X, WeChat, Feishu and 20+ sites.
+- **A library you browse by eye.** An image-first case wall with tags and projects. It's local-first and needs no account.
+- **Your Agent can use it.** Codex, Claude Code and WorkBuddy can search, read and save back to your library through local MCP.
+
+<p align="center"><strong>1,000+ curated cases, ready to import:</strong> <a href="https://wchao6891.github.io/PromptDirector-Curated/en/">Browse (English)</a> · <a href="https://wchao6891.github.io/PromptDirector-Curated/">浏览(中文)</a> · <a href="https://wchao6891.github.io/PromptDirector-Curated/en/guide.html">Quick start</a></p>
+
+<p align="center"><sub>Free & open source · Local first · No account · Chrome / Edge on Windows, macOS, Linux</sub></p>
+
+---
+
+## See it in action
-<p align="center"><strong>One-click capture. A visual prompt library. Ready for your Agent.</strong><br>Collect from Jimeng, Higgsfield, X, HeyBox, WeChat articles, Feishu docs and more.<br>Keep the image, the prompt and the context — then put them to work in your next project.</p>
+**1 · Spot it, save it.** Open a Higgsfield article and capture it. PromptDirector splits it into cases, keeps each image, video and prompt together and saves them to your library.
-<p align="center"><a href="https://github.com/wchao6891/PromptDirector/releases/latest"><strong>Download the latest release</strong></a> · <a href="https://wchao6891.github.io/PromptDirector-Curated/">Explore curated cases</a> · <a href="#install-and-update">Installation guide</a></p>
+<p align="center"><img src="docs/assets/feature-capture-higgsfield.gif" alt="Capturing a Higgsfield article into separate cases with one click" width="800"></p>
-<p align="center">Free & open source · Local first · No account required · Local MCP Agent access</p>
+**2 · Turn references into a Skill.** Ask the Composer to find a creator's action cases in your library. It reads them and distills a reusable Skill.
-## Found a great reference? Start capturing in one click.
+<p align="center"><img src="docs/assets/feature-skill.gif" alt="The Composer finds action cases and distills them into a reusable Skill" width="800"></p>
+
+**3 · Create with it.** Mix reference images and the Skill in the Composer to write a shot-by-shot video prompt, then generate with your favorite model.
+
+<p align="center"><img src="docs/assets/feature-action.gif" alt="Example action sequence generated from an action-Skill prompt" width="560"></p>
+
+<table>
+<tr>
+<td width="50%"><img src="docs/assets/screens/library.jpg" alt="Image-first case library with projects"></td>
+<td width="50%"><img src="docs/assets/screens/capture-x-post.jpg" alt="Capturing an X post, including the prompt from the author's reply"></td>
+</tr>
+<tr><td align="center"><sub><b>Case wall.</b> Browse by eye, organize by project.</sub></td><td align="center"><sub><b>Capture from X.</b> Even the prompt in the author's reply.</sub></td></tr>
+<tr>
+<td width="50%"><img src="docs/assets/screens/case-detail.jpg" alt="Case detail with media, original prompt and project"></td>
+<td width="50%"><img src="docs/assets/screens/curated-packs.jpg" alt="Curated case packs ready to import"></td>
+</tr>
+<tr><td align="center"><sub><b>Case detail.</b> Media, original prompt and source in one place.</sub></td><td align="center"><sub><b>Curated packs.</b> Import 1,000+ cases in one click.</sub></td></tr>
+<tr>
+<td width="50%"><img src="docs/assets/screens/skill-center.jpg" alt="Creative Skill center"></td>
+<td width="50%"><img src="docs/assets/screens/composer.jpg" alt="Composer mixing reference cases and a Skill to write a video prompt"></td>
+</tr>
+<tr><td align="center"><sub><b>Skill center.</b> Build, import and reuse creative Skills.</sub></td><td align="center"><sub><b>Composer.</b> References + Skill → a ready-to-use prompt.</sub></td></tr>
+</table>
-**Keep the work and the creative clues behind it.** PromptDirector is a Chrome extension for visual creators. Collect images, videos, text, prompts and sources into a library you can browse visually, organize by project and bring into your next creative conversation.
+## Where you can capture
**Open a work, post or article → Capture → Preview and select → Save cases.**
@@ -26,25 +80,19 @@
| **Pinterest · Behance · ArtStation · Huaban · ZCOOL** | Bring visual work into one place to browse, search and organize. |
| **More webpages and local files** | General webpage capture, text and image selection, screenshots and local imports help gather scattered materials. |
-### One article. A collection of individual references.
-
-For articles with clear case headings or numbering, preview the detected groups under **Cases in article**, select the cases you want and save them individually. Review each image-and-prompt group before saving, or keep the whole article for context.
-
-### Keep the context that makes a reference useful.
-
-Multi-image works stay grouped, articles retain media order and Feishu tables retain their layout. Media, text, original prompts, sources and later analysis have their own place, ready to revisit or use with a model.
+**One article, many references.** For articles with clear case headings or numbering, preview the detected groups under **Cases in article**, pick the cases you want and save each one separately, or keep the whole article for context.
-Capture, browsing and organization require no AI service. Pages must be accessible and original prompts must be public; login state, lazy loading and site changes can affect results. Preview before saving. Videos are saved locally when a complete file is accessible; supported standalone players and HLS streams can play in the library. See the [capture guide](docs/CAPTURE_SUPPORT.md).
+**Context stays with the reference.** Multi-image works stay grouped, articles keep their media order and Feishu tables keep their layout. Media, text, original prompts, sources and later analysis each have their own place.
-## Your eye chooses. Your Agent takes it further.
+Capture, browsing and organization require no AI service. Pages must be accessible and original prompts must be public. Login state, lazy loading and site changes can affect results, so preview before saving. See the [capture guide](docs/CAPTURE_SUPPORT.md).
-**Connect your library to Codex, Claude Code or WorkBuddy.** Search references, read prompts, retrieve originals, capture URLs and save creative materials back to the library through your Agent conversation.
+## Let your Agent take it further
-1. Select **Copy connection request** in the extension's **Settings → Agent connection**.
-2. Paste it into an Agent with local MCP support so it can install, configure and verify the connector.
-3. Enable the connection in Chrome when prompted, then start using your library.
+Connect your library to **Codex, Claude Code or WorkBuddy**. Your Agent can search references, read prompts, retrieve originals, capture URLs and save creative materials back to the library.
-Try requests like:
+1. In the extension, open **Settings → Agent connection** and select **Copy connection request**.
+2. Paste it into an Agent with local MCP support. It installs, configures and verifies the connector.
+3. Enable the connection in Chrome when prompted.
> “Find character-poster references in my library and list a few options for me to choose.”
>
@@ -52,64 +100,41 @@ Try requests like:
>
> “Save the approved prompt and generated images back to PromptDirector.”
-**Google Chrome on Windows, macOS and Linux.** Configuration entry points are provided for Codex, Claude Code and WorkBuddy; other local MCP clients can use the generic configuration. The Agent installs a separate local connector, and the first connection requires browser authorization. Cloud-only workspaces cannot use this local flow. Creative and generation capabilities depend on your Agent and its tools. [Agent setup guide →](connector/INSTALL.md)
+Other local MCP clients can use the generic configuration. Cloud-only workspaces can't use this local flow. [Agent setup guide →](connector/INSTALL.md)
-## Build a library that grows with your creative practice
+## A library that grows with you
| What your next project needs | What your library provides |
| --- | --- |
-| **A reference you can recognize at a glance** | An image-first case wall, text search and tag filters. Browse the work and choose for yourself. |
-| **A focused collection for each project** | Nested projects, related cases and batch management to keep a creative task's materials together. |
+| **A reference you can recognize at a glance** | An image-first case wall, text search and tag filters. |
+| **A focused collection for each project** | Nested projects, related cases and batch management. |
| **Experience you can reuse** | The Composer reads selected cases and drafts editable prompts, reusable Skills and tag suggestions for your review. |
-| **Room for more than images** | Local images, videos, audio, DOCX, PDFs, Markdown, TXT, HTML, RTF and timestamped video notes. DOCX supports text, tables and embedded images; other Office files and creative source files are preserved as originals for download. |
-| **A collection you can share and preserve** | Export cases or project subtrees, create full folder backups, recover on another computer and use encrypted folder sync. |
-
-AI analysis is optional and uses your own service. Selected references help communicate the visual direction you want; only selected or explicitly requested original images are sent to a model. You can also use PromptDirector entirely as a visual reference library.
-
-## Start with curated references
-
-See the image, read the prompt and save what fits your project. Here are a few examples from the current public collection.
-
-<table>
-<tr>
-<td width="33%"><a href="https://wchao6891.github.io/PromptDirector-Curated/"><img src="https://wchao6891.github.io/PromptDirector-Curated/previews/featured-cases-vol-1/media/133a11be119a75a17b40-fe515974461558ef.webp" alt="Celestial ensemble: composition and staging reference"></a></td>
-<td width="33%"><a href="https://wchao6891.github.io/PromptDirector-Curated/"><img src="https://wchao6891.github.io/PromptDirector-Curated/previews/featured-cases-vol-1/media/a2b45b757798adb2685d-8dea3cc7d3e303fd.webp" alt="War-tent confrontation: character blocking and lighting reference"></a></td>
-<td width="33%"><a href="https://wchao6891.github.io/PromptDirector-Curated/"><img src="https://wchao6891.github.io/PromptDirector-Curated/previews/featured-cases-vol-1/media/6652ed14274cd7be008f-73367e80019b085c.webp" alt="Foxfire paper shadows: material and style reference"></a></td>
-</tr>
-<tr><td>Celestial ensemble</td><td>War-tent confrontation</td><td>Foxfire paper shadows</td></tr>
-</table>
-
-[Browse the curated library →](https://wchao6891.github.io/PromptDirector-Curated/)
+| **Room for more than images** | Local images, videos, audio, DOCX, PDFs, Markdown, TXT, HTML, RTF and timestamped video notes. |
+| **A collection you can share and preserve** | Export cases or project subtrees, full folder backups, recovery on another computer and encrypted folder sync. |
-These are curated content previews, not demonstrations of platform capture. Refer to each case's source and rights information before reusing its media.
+AI analysis is optional and uses your own service. Only selected or explicitly requested original images are sent to a model.
## Your library stays yours
-Cases, media, tags and settings are stored in your current browser by default. No account, ads or usage analytics. AI features are opt-in and use your own service keys; the interface explains what will be sent. Read the [privacy policy](store/PRIVACY_POLICY.md).
+Cases, media, tags and settings are stored in your browser by default. No account, ads or usage analytics. AI features are opt-in and use your own keys. Read the [privacy policy](store/PRIVACY_POLICY.md).
-## Install and update
+## Install
-**For a local installation, download `PromptDirector-<version>.zip` and load its extracted folder in Chrome or Edge.**
+**Recommended: [Chrome Web Store](https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm).** Updates are automatic.
<details>
-<summary>Full installation and in-place update instructions</summary>
+<summary>Install from GitHub (developer mode) and update in place</summary>
-1. Open the [latest GitHub release](https://github.com/wchao6891/PromptDirector/releases/latest) and download `PromptDirector-<version>.zip`.
-2. Extract the extension files into a permanent folder named `PromptDirector`, without a version number. `manifest.json` must be at the folder's top level.
-3. Open Chrome or Edge's extension management page, enable **Developer mode**, select **Load unpacked**, and choose that folder.
+1. Download `PromptDirector-<version>.zip` from the [latest release](https://github.com/wchao6891/PromptDirector/releases/latest).
+2. Extract it into a permanent folder named `PromptDirector` (no version number). `manifest.json` must be at the top level.
+3. Open Chrome or Edge's extension page, enable **Developer mode**, select **Load unpacked** and choose that folder.
-**Updating an existing local installation:** In Settings, check for updates and select the local upgrade action. On first use, choose and authorize the folder Chrome currently loads. Keep that existing location, even if its name contains an old version. The extension downloads, verifies and installs the update, then restarts automatically. Verify the version in Settings and run the temporary-file cleanup action if shown. Cases and media continue to use the same browser library.
-
-You can also install through the [Chrome Web Store](https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm), which manages subsequent updates.
+**Updating:** In Settings, check for updates and select the local upgrade action. On first use, authorize the folder Chrome currently loads and keep that location. The extension downloads, verifies and installs the update, then restarts. Your cases and media stay in the same browser library.
</details>
-
-
## Contribute and license
-Contributions to capture adaptations, interactions, tests and documentation are welcome. When [reporting an issue](https://github.com/wchao6891/PromptDirector/issues), describe the page type, observable behavior and reproduction steps. Remove API keys, private data and unauthorized media from examples. Run `npm run verify` before submitting code.
-
-See the [development guide](docs/DEVELOPMENT.md) to build and test contributions.
+Contributions to capture adaptations, interactions, tests and documentation are welcome. When [reporting an issue](https://github.com/wchao6891/PromptDirector/issues), describe the page type, what you saw and the reproduction steps. Remove API keys, private data and unauthorized media. Run `npm run verify` before submitting code. See the [development guide](docs/DEVELOPMENT.md).
-Code is licensed under [Apache License 2.0](LICENSE). See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for dependencies. The code license does not grant rights to third-party case media.
+Code is licensed under [Apache License 2.0](LICENSE). See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md). The code license does not grant rights to third-party case media; check each curated case's source and rights before reusing its media.
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 9de3a75..613acfe 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,18 +1,72 @@
-<p align="center"><img src="docs/assets/github-banner.svg" alt="PromptDirector — Capture, collect, organize" width="100%"></p>
+<p align="center">
+ <img src="store/brand/prompt-director-mark-source.png" alt="PromptDirector 标志" width="88">
+</p>
+
+<h1 align="center">PromptDirector 提示词导演</h1>
+
+<p align="center"><strong>刷到就存,要用就有</strong><br>Spot it. Save it.</p>
+
+<p align="center">
+ <a href="https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm"><img src="https://img.shields.io/chrome-web-store/users/iahakaahijddcjjldidbclicedibgpjm?label=Chrome%20%E7%94%A8%E6%88%B7&color=D1FE17&labelColor=101416" alt="Chrome 商店用户数"></a>
+ <a href="https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm"><img src="https://img.shields.io/chrome-web-store/v/iahakaahijddcjjldidbclicedibgpjm?label=Chrome%20%E5%95%86%E5%BA%97&color=D1FE17&labelColor=101416" alt="Chrome 商店版本"></a>
+ <a href="https://github.com/wchao6891/PromptDirector/releases/latest"><img src="https://img.shields.io/github/v/release/wchao6891/PromptDirector?filter=v*&label=release&color=D1FE17&labelColor=101416" alt="最新版本"></a>
+ <a href="LICENSE"><img src="https://img.shields.io/github/license/wchao6891/PromptDirector?color=D1FE17&labelColor=101416" alt="许可证"></a>
+</p>
<p align="center"><a href="README.md">English</a> · <strong>简体中文</strong></p>
-<h1 align="center">把好案例,变成你的创作底气。</h1>
+<p align="center">
+ <a href="https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm"><img src="https://img.shields.io/badge/%E6%B7%BB%E5%8A%A0%E5%88%B0%20Chrome-%E5%85%8D%E8%B4%B9-D1FE17?style=for-the-badge&logo=googlechrome&logoColor=101416&labelColor=D1FE17&color=101416" alt="免费添加到 Chrome" height="44"></a>
+</p>
+
+<p align="center">
+ <a href="https://www.bilibili.com/video/BV1ojeG6UE9t/"><img src="docs/assets/demo.gif" alt="PromptDirector 演示:浏览案例库、一键入库" width="800"></a><br>
+ <a href="https://www.bilibili.com/video/BV1ojeG6UE9t/">▶ 观看 71 秒完整演示(B 站)</a> · <a href="https://www.youtube.com/watch?v=ttbNMJ7Gm7Q">YouTube</a>
+</p>
+
+- **一键采集,连图带词。** 从即梦、Higgsfield、Midjourney、X、公众号、飞书等 20 多个网站,把作品、视频和公开提示词一起存下。
+- **看图找参考。** 图片优先的案例墙,配合标签和项目整理。资料存在本地,无需账号。
+- **Agent 随时调用。** Codex、Claude Code、WorkBuddy 可以通过本机 MCP 搜索、读取案例库,并把成果回存进来。
+
+<p align="center"><strong>1000+ 精选案例,一键导入:</strong><a href="https://wchao6891.github.io/PromptDirector-Curated/">浏览精选案例</a> · <a href="https://wchao6891.github.io/PromptDirector-Curated/en/">English</a> · <a href="https://wchao6891.github.io/PromptDirector-Curated/guide.html">快速上手</a></p>
+
+<p align="center"><sub>免费开源 · 本地优先 · 无需账号 · Chrome / Edge(Windows、macOS、Linux)</sub></p>
+
+---
+
+## 看看它怎么用
+
+**1 · 刷到就存。** 打开一篇 Higgsfield 文章,一键采集。提示词导演会把它拆成一个个案例,图片、视频和提示词对应保存进案例库。
-<p align="center"><strong>多网站一键采集 · 图文提示词成套收藏 · Agent 随时调用</strong><br>从即梦、Higgsfield、X,到小黑盒、微信公众号、飞书文档。<br>把你看中的画面、提示词和经验存进自己的案例库,让下一次创作从好参考开始。</p>
+<p align="center"><img src="docs/assets/feature-capture-higgsfield.gif" alt="一键采集 Higgsfield 文章,自动拆分为多个案例" width="800"></p>
-<p align="center"><a href="https://github.com/wchao6891/PromptDirector/releases/latest"><strong>下载 GitHub 最新版</strong></a> · <a href="https://wchao6891.github.io/PromptDirector-Curated/">浏览精选案例</a> · <a href="#安装与更新">安装说明</a></p>
+**2 · 案例一键变 Skill。** 让创作台在案例库里找出某位作者的动作案例,读完后提炼成可复用的 Skill。
-<p align="center">免费开源 · 本地优先 · 无需账号 · 支持本机 MCP Agent</p>
+<p align="center"><img src="docs/assets/feature-skill.gif" alt="创作台查找动作案例并提炼为可复用 Skill" width="800"></p>
-## 刷到好案例,一键开始收藏
+**3 · 动作大片一秒出。** 在创作台混合参考图和 Skill,生成分镜级视频提示词,再交给你常用的模型出片。
+
+<p align="center"><img src="docs/assets/feature-action.gif" alt="用动作 Skill 提示词生成的动作片段示例" width="560"></p>
+
+<table>
+<tr>
+<td width="50%"><img src="docs/assets/screens/library.jpg" alt="图片优先的案例库与项目管理"></td>
+<td width="50%"><img src="docs/assets/screens/capture-x-post.jpg" alt="采集 X 帖子,连作者评论里的提示词一起保存"></td>
+</tr>
+<tr><td align="center"><sub><b>案例墙。</b>看图找参考,按项目整理。</sub></td><td align="center"><sub><b>采集 X 帖子。</b>评论区里的提示词也能带走。</sub></td></tr>
+<tr>
+<td width="50%"><img src="docs/assets/screens/case-detail.jpg" alt="案例详情:媒体、原始提示词与项目"></td>
+<td width="50%"><img src="docs/assets/screens/curated-packs.jpg" alt="精选案例包,一键入库"></td>
+</tr>
+<tr><td align="center"><sub><b>案例详情。</b>媒体、原始提示词和来源放在一起。</sub></td><td align="center"><sub><b>精选案例。</b>1000+ 案例一键入库。</sub></td></tr>
+<tr>
+<td width="50%"><img src="docs/assets/screens/skill-center.jpg" alt="创作 Skill 中心"></td>
+<td width="50%"><img src="docs/assets/screens/composer.jpg" alt="创作台混合参考案例与 Skill 生成视频提示词"></td>
+</tr>
+<tr><td align="center"><sub><b>Skill 中心。</b>新建、导入、复用创作技能。</sub></td><td align="center"><sub><b>创作台。</b>参考 + Skill → 直接可用的提示词。</sub></td></tr>
+</table>
-**好画面值得留下,做出它的提示词也一样。** PromptDirector 是为视觉创作者打造的 Chrome 扩展:把网页中的图片、视频、文字、提示词和来源一起整理入库。收藏时保留创作线索,需要时看图选择参考,让积累真正进入下一次创作。
+## 能从哪里采集
**打开作品、帖子或文章 → 一键采集 → 预览勾选 → 保存案例。**
@@ -21,30 +75,24 @@
| **即梦 · Higgsfield · LiblibAI · Krea · LibTV** | 作品图片、视频,以及页面公开的提示词和创作信息。把喜欢的画面与创作线索放在一起。 |
| **Midjourney** | 保存当前作品的图片或视频、公开提示词、参数和视频封面;Explore 支持已加载作品预览。 |
| **小黑盒 · 微信公众号** | 收藏整篇图文,也可将结构清晰的多案例文章拆开,勾选其中的图片与对应提示词,分别保存。小黑盒单案例图片墙可与正文提示词成组收藏。 |
-| **飞书文档** | 保存正文、长文档和表格内图文,保留单元格位置与合并关系,让案例回到对应的位置。 |
+| **飞书文档** | 保存正文、长文档和表格内图文,保留单元格位置与合并关系。 |
| **X / Twitter · 小红书 · 微博 · Reddit** | 收集当前帖子正文和可获取的媒体,把作者分享的提示词与作品一起留下。 |
| **Pinterest · Behance · ArtStation · 花瓣 · 站酷** | 收集作品页面的视觉参考,集中浏览、搜索和整理。 |
| **更多网页与本地资料** | 通用网页采集,加上选区、选图、截图和本地文件导入,把分散的资料汇到一个库里。 |
-### 一篇文章,收藏成一组能单独使用的案例
-
-遇到十几个案例放在一起的教程或分享帖,可以在「文章内案例」中预览分组,只勾选想要的案例,分别入库;也可以保留整篇文章。支持明确案例标题或编号的图文结构,拆分后仍可核对每组图片和提示词。
-
-### 好参考,连同上下文一起留下
+**一篇文章,拆成一组案例。** 遇到十几个案例放在一起的分享帖,可以在「文章内案例」中预览分组,只勾选想要的案例分别入库;也可以保留整篇文章。
-多图作品保留成组关系,文章保留图文顺序,飞书表格保留布局。图片、正文、原始提示词、来源与后续分析各有位置,方便回看,也方便交给模型使用。
+**好参考,连同上下文一起留下。** 多图作品保留成组关系,文章保留图文顺序,飞书表格保留布局。图片、正文、原始提示词、来源与后续分析各有位置。
-采集、浏览和整理无需 AI 服务。页面需要可访问,原始提示词需要作者公开;登录、懒加载和网站变化可能影响结果,保存前可预览核对。视频在可取得完整文件时保存本地,支持的独立播放器与 HLS 流可在库内播放。详见[网页与媒体采集说明](docs/CAPTURE_SUPPORT.md)。
+采集、浏览和整理都不需要 AI 服务。页面需要可访问,原始提示词需要作者公开;登录、懒加载和网站变化可能影响结果,保存前可预览核对。详见[网页与媒体采集说明](docs/CAPTURE_SUPPORT.md)。
## 你的眼光选参考,你的 Agent 接着创作
-**把案例库交给 Codex、Claude Code、WorkBuddy 使用。** 找参考、读提示词、取原件、采集网址、回存创作材料,在 Agent 对话里串起来。你在案例墙里挑中的画面,也能成为下一次对话中明确可用的创作依据。
+**把案例库交给 Codex、Claude Code、WorkBuddy 使用**:找参考、读提示词、取原件、采集网址、回存创作材料,都能在 Agent 对话里完成。
1. 在插件「设置 → Agent 连接」点击 **复制连接指令**。
2. 粘贴给支持本机 MCP 的 Agent,让它安装连接器、配置并验证。
-3. 按提示在插件里启用授权,开始调用案例库。
-
-连接之后,可以这样下需求:
+3. 按提示在插件里启用授权。
> “从我的案例库找几组国风人物海报参考,列出来让我选。”
>
@@ -52,65 +100,41 @@
>
> “把这次确认的提示词和生成图片存回 PromptDirector。”
-**Google Chrome + Windows / macOS / Linux。** Codex、Claude Code、WorkBuddy 提供配置入口,其他本机 MCP 客户端可使用通用配置。连接器是由 Agent 安装的独立本机组件,首次连接需要浏览器授权;纯云端工作台不适用此流程。具体创作和生成能力取决于所用 Agent 及其工具。[查看 Agent 安装说明 →](connector/INSTALL.md)
+其他本机 MCP 客户端可使用通用配置;纯云端工作台不适用此流程。[查看 Agent 安装说明 →](connector/INSTALL.md)
## 越收藏,越有自己的创作资料库
| 你在创作中需要的 | 这里已经准备好 |
| --- | --- |
-| **看一眼,就知道想用哪张** | 图片优先的案例墙,配合文字搜索与标签筛选,让人直接看图做判断。 |
-| **一个项目,一套参考** | 可嵌套项目树、案例组合和批量管理,把同一任务的灵感放在一起。 |
+| **看一眼,就知道想用哪张** | 图片优先的案例墙,配合文字搜索与标签筛选。 |
+| **一个项目,一套参考** | 可嵌套项目树、案例组合和批量管理。 |
| **把经验用在下一次** | 创作台可读取选定案例,生成可编辑提示词、提炼可复用 Skill 和标签建议,由你审阅保存。 |
-| **图片之外,也装得下资料** | 本地图片、视频、音频、DOCX、PDF、Markdown、TXT、HTML、RTF,以及视频时间点笔记。DOCX 可读取正文、表格和内嵌图片;其他 Office 文档与创作源文件保留原件供下载。 |
-| **分享给别人,也留给未来的自己** | 导出案例或项目子树分享包,完整资料夹备份、换电脑恢复和加密文件夹同步。 |
-
-AI 分析按需开启,使用你自己的服务;选中的参考可以帮助模型理解这次想要的画面。原图只在你选中或明确指定时发送给模型。你也可以只把它当作一套好用的视觉案例库,随时查、随时看。
+| **图片之外,也装得下资料** | 本地图片、视频、音频、DOCX、PDF、Markdown、TXT、HTML、RTF,以及视频时间点笔记。 |
+| **分享给别人,也留给未来的自己** | 导出案例或项目分享包,完整资料夹备份、换电脑恢复和加密文件夹同步。 |
-## 从精选案例开始
-
-先看画面,再读提示词,把适合自己项目的案例保存进本地库。下面是当前公开精选库中的部分案例。
-
-<table>
-<tr>
-<td width="33%"><a href="https://wchao6891.github.io/PromptDirector-Curated/"><img src="https://wchao6891.github.io/PromptDirector-Curated/previews/featured-cases-vol-1/media/133a11be119a75a17b40-fe515974461558ef.webp" alt="天宫仙班压阵:群像与场面调度参考"></a></td>
-<td width="33%"><a href="https://wchao6891.github.io/PromptDirector-Curated/"><img src="https://wchao6891.github.io/PromptDirector-Curated/previews/featured-cases-vol-1/media/a2b45b757798adb2685d-8dea3cc7d3e303fd.webp" alt="军帐权谋对峙:人物关系与光影参考"></a></td>
-<td width="33%"><a href="https://wchao6891.github.io/PromptDirector-Curated/"><img src="https://wchao6891.github.io/PromptDirector-Curated/previews/featured-cases-vol-1/media/6652ed14274cd7be008f-73367e80019b085c.webp" alt="狐火纸影:材质与风格参考"></a></td>
-</tr>
-<tr><td>天宫仙班压阵</td><td>军帐权谋对峙</td><td>狐火纸影</td></tr>
-</table>
-
-[打开精选案例库 →](https://wchao6891.github.io/PromptDirector-Curated/)
-
-以上为精选内容预览,非平台采集演示;素材使用范围以各案例的来源和授权说明为准。
+AI 分析按需开启,使用你自己的服务;原图只在你选中或明确指定时才发送给模型。
## 你的资料,由你保管
-资料、媒体、标签和设置默认保存在当前浏览器,不需要账号,没有广告,不收集使用统计。AI 功能由你主动开启,使用你自己的服务密钥;发送范围会在界面中说明。详见[隐私政策](store/PRIVACY_POLICY.md)。
+资料、媒体、标签和设置默认保存在当前浏览器,不需要账号,没有广告,不收集使用统计。AI 功能由你主动开启,使用你自己的服务密钥。详见[隐私政策](store/PRIVACY_POLICY.md)。
-## 安装与更新
+## 安装
-**首次安装:下载 `PromptDirector-版本号.zip`,解压后在 Chrome / Edge 的扩展管理页加载。**
+**推荐:[Chrome 应用商店](https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm),之后自动更新。**
<details>
-<summary>展开完整安装与原位更新步骤</summary>
-
-
-从 [GitHub 最新发布页](https://github.com/wchao6891/PromptDirector/releases/latest) 下载 `PromptDirector-版本号.zip`。首次安装时,将包内程序文件解压到固定的 `PromptDirector` 文件夹(不带版本号),确保 `manifest.json` 位于该文件夹第一层。在 Chrome 或 Edge 的扩展管理页开启“开发者模式”,选择“加载已解压的扩展程序”,然后选择解压后的目录。
+<summary>从 GitHub 安装(开发者模式)与原位更新</summary>
-### 已安装?在原位置更新
+1. 从 [GitHub 最新发布页](https://github.com/wchao6891/PromptDirector/releases/latest) 下载 `PromptDirector-版本号.zip`。
+2. 解压到固定的 `PromptDirector` 文件夹(不带版本号),确保 `manifest.json` 位于第一层。
+3. 在 Chrome 或 Edge 扩展管理页开启“开发者模式”,选择“加载已解压的扩展程序”,然后选中该文件夹。
-在“设置”检查更新,点击“升级本地版”,首次选择 Chrome 当前加载的安装文件夹并授权,之后复用这个安装位置;授权失效时再授权。已有文件夹即使带旧版本号也可继续使用,无需重命名、移动或重新安装。插件自动下载、验证并写入新版程序,然后自动重启,重新打开设置核对版本;如出现“清理升级临时文件”,点击完成清理。案例和媒体继续使用当前浏览器中的原资料库。
-
-也可通过 [Chrome Web Store](https://chromewebstore.google.com/detail/iahakaahijddcjjldidbclicedibgpjm) 安装,由商店管理后续更新。
+**原位更新:** 在“设置”检查更新,点击“升级本地版”。首次需要选择 Chrome 当前加载的安装文件夹并授权,之后会复用这个位置。插件会自动下载、验证、写入新版并重启;案例和媒体继续保存在原资料库中。
</details>
-
-
## 参与与许可
-欢迎提交问题、改善交互、完善采集适配、补充测试与文档。[反馈问题](https://github.com/wchao6891/PromptDirector/issues)时,请说明页面类型、用户可见的问题和复现步骤;提供示例前移除 API Key、私人资料和未获授权的素材。提交代码前请运行 `npm run verify`。
-
-构建与测试说明见[开发指南](docs/DEVELOPMENT.md)。
+欢迎提交问题、改善交互、完善采集适配、补充测试与文档。[反馈问题](https://github.com/wchao6891/PromptDirector/issues)时,请说明页面类型、看到的问题和复现步骤;提供示例前请移除 API Key、私人资料和未获授权的素材。提交代码前请运行 `npm run verify`。构建说明见[开发指南](docs/DEVELOPMENT.md)。
-代码采用 [Apache License 2.0](LICENSE)。第三方组件见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。代码许可不授予第三方案例素材的使用权。
+代码采用 [Apache License 2.0](LICENSE),第三方组件见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。代码许可不授予第三方案例素材的使用权,复用前请查看各案例的来源与授权说明。
diff --git a/docs/assets/demo.gif b/docs/assets/demo.gif
new file mode 100644
index 0000000..70acd1b
Binary files /dev/null and b/docs/assets/demo.gif differ
diff --git a/docs/assets/feature-action.gif b/docs/assets/feature-action.gif
new file mode 100644
index 0000000..6496049
Binary files /dev/null and b/docs/assets/feature-action.gif differ
diff --git a/docs/assets/feature-capture-higgsfield.gif b/docs/assets/feature-capture-higgsfield.gif
new file mode 100644
index 0000000..eef3b6b
Binary files /dev/null and b/docs/assets/feature-capture-higgsfield.gif differ
diff --git a/docs/assets/feature-skill.gif b/docs/assets/feature-skill.gif
new file mode 100644
index 0000000..5bce362
Binary files /dev/null and b/docs/assets/feature-skill.gif differ
diff --git a/docs/assets/screens/capture-x-post.jpg b/docs/assets/screens/capture-x-post.jpg
new file mode 100644
index 0000000..b78a744
Binary files /dev/null and b/docs/assets/screens/capture-x-post.jpg differ
diff --git a/docs/assets/screens/case-detail.jpg b/docs/assets/screens/case-detail.jpg
new file mode 100644
index 0000000..8b8d8e9
Binary files /dev/null and b/docs/assets/screens/case-detail.jpg differ
diff --git a/docs/assets/screens/composer.jpg b/docs/assets/screens/composer.jpg
new file mode 100644
index 0000000..102ef91
Binary files /dev/null and b/docs/assets/screens/composer.jpg differ
diff --git a/docs/assets/screens/curated-packs.jpg b/docs/assets/screens/curated-packs.jpg
new file mode 100644
index 0000000..a1839d8
Binary files /dev/null and b/docs/assets/screens/curated-packs.jpg differ
diff --git a/docs/assets/screens/library.jpg b/docs/assets/screens/library.jpg
new file mode 100644
index 0000000..eea86f0
Binary files /dev/null and b/docs/assets/screens/library.jpg differ
diff --git a/docs/assets/screens/skill-center.jpg b/docs/assets/screens/skill-center.jpg
new file mode 100644
index 0000000..496fa09
Binary files /dev/null and b/docs/assets/screens/skill-center.jpg differ