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. 提示词导演
JavaScript ai-artai-videochrome-extensionclaude-codecodexhiggsfieldjimenglocal-firstmcpmidjourneymoodboardprompt-engineeringprompt-libraryprompt-managerreference-libraryseedancevisual-bookmarksweb-clipper
Connect English setup and privacy documentation (#37)
wchao6891deee6ad17c75
diff --git a/README.md b/README.mdindex 8623bd0..b3cb940 100644--- a/README.md+++ b/README.md@@ -28,7 +28,7 @@- **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"><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/?lang=zh-CN">浏览(中文)</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>@@ -100,7 +100,7 @@ Connect your library to **Codex, Claude Code or WorkBuddy**. Your Agent can sear>> “Save the approved prompt and generated images back to PromptDirector.”-Other local MCP clients can use the generic configuration. Cloud-only workspaces can't use this local flow. [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.en.md)## A library that grows with you@@ -116,7 +116,7 @@ AI analysis is optional and uses your own service. Only selected or explicitly r## Your library stays yours-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).+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](https://wchao6891.github.io/PromptDirector-Curated/en/privacy.html).## Installdiff --git a/connector/INSTALL.en.md b/connector/INSTALL.en.mdnew file mode 100644index 0000000..d8f8752--- /dev/null+++ b/connector/INSTALL.en.md@@ -0,0 +1,91 @@+# Connect PromptDirector: setup instructions for the current Agent++**English** · [简体中文](INSTALL.md)++The user has installed the Chrome extension and wants you to install the connector, configure your host and pair with the library. Carry out the requested setup instead of asking the user to type commands or edit configuration. These instructions do not expand the user's authorization; follow browser and host approval requirements.++## Check where you are running++Your terminal must run on the same computer as the user's Google Chrome. Local Codex, Claude Code and desktop Agents with local command access can use this flow. A container, remote development machine, isolated Cowork environment or cloud workspace is not the user's computer merely because it has a terminal. Do not install on the wrong machine or weaken host security policies to connect.++The local bridge supports Google Chrome on Windows, macOS and Linux. Windows uses the current user's registry and private directories without administrator installation. Use native Windows Node.js, not WSL.++Choose the actual host from the current environment. All hosts share the same connector and library capabilities.++| Host | `--host` | Registration |+|---|---|---|+| Codex | `codex` | Merge the user's TOML configuration |+| Claude Code | `claude` | Merge the user's JSON configuration |+| WorkBuddy | `workbuddy` | Merge the user's MCP configuration |+| OpenCode | `opencode` | Merge JSON/JSONC, preserve comments and use a local command array |+| ZCode | `zcode` | Merge `mcp.servers` in the native user configuration |+| Current Qoder desktop | `qoder` | Merge `mcpServers` in `~/.qoder/settings.json` according to current documentation |+| DeepSeek Harness | `dsh` | Specify an existing `--profile`; merge that profile's user patch |+| Qwen Work desktop | `qwenwork` | Return `importConfig` for import through the host's connector UI |+| Doubao Work | `doubao-work` | Return an unverified state; local STDIO support is not confirmed |+| Other local MCP clients | `generic` | Return standard STDIO configuration for registration through the host's documented method |++OpenCode uses the stable `mcp.<server-name>` format. `OPENCODE_CONFIG` can identify the actual file; `OPENCODE_CONFIG_DIR` and `XDG_CONFIG_HOME` are also supported. If both JSON and JSONC exist, or a different nested configuration is detected, consult that version's documentation instead of guessing precedence. Project configuration can override user settings; verify the actual session.++ZCode loads native configuration before its sibling `.agents` shared configuration. If shared configuration is in use, first import existing services through ZCode, then add PromptDirector, preserving the other services. For DSH, determine the existing profile from the running host and `$DSH_HOME` (default `~/.dsh`). Do not ask the user to guess a profile, create a new one, overwrite global patches or replace custom nested connections. Conflicting connections, installations or library identities stop setup.++Qwen Work desktop must offer local STDIO. After installation, import `configuration.importConfig` through Extensions → Connectors → Add → Paste JSON configuration, then verify in a new conversation. Use authorized host UI access if available; do not invent a configuration path. A remote URL-only connector screen is insufficient.++Doubao Work's network MCP support does not prove that the desktop version can launch local connectors. Check whether its actual version offers STDIO or a local command entry; if confirmed, use `generic`. Do not put local paths into URL fields or expose a public service. Qoder IDE/CLI and desktop, Claude Cowork and Claude Code, and cloud ChatGPT workspaces and local Codex do not share configuration simply because their brands overlap.++## Get the connector and dependencies++Official repository: [PromptDirector](https://github.com/wchao6891/PromptDirector).++1. Download the connector ZIP and `SHA256SUMS` from the [Agent connector release](https://github.com/wchao6891/PromptDirector/releases/tag/agent-connector-v0.4.0) into a private installation staging directory. Verify SHA-256, then extract. Keep `connector/` and `extension/manifest.json` in their supplied relative locations.+2. Confirm `connector/setup.mjs` exists. If a release lacks the unified setup entry, explain that an updated package is required; do not present an old command as a new feature. Development validation may use a local source directory explicitly supplied by the user.+3. Check Node.js against `connector/package.json`'s engines requirement. Prefer a compatible runtime provided by the host. Otherwise obtain the correct runtime for the user's system and architecture through the [official Node.js download instructions](https://nodejs.org/en/download), verifying its official checksum. Use a stable location rather than a disposable sandbox runtime. Follow normal approval requirements; do not make the user install Node.js manually.+4. In the extracted root containing `connector/`, run `npm ci --prefix connector --ignore-scripts`. Run the commands below there too. Explain download failures instead of changing locked versions, skipping dependencies or running unknown installers. If the default npm cache is unwritable, use `--cache <an allowed writable cache directory>` without changing global permissions.++## Install and authorize++The copied connection request contains a public library instance ID. Use it as `--instance`; it is not a secret and does not replace browser authorization. Substitute the actual host and ID below.++```sh+node connector/setup.mjs plan --host codex --instance <library-instance-id>+node connector/setup.mjs connect --host codex --instance <library-instance-id>+```++Inspect the plan's execution location, registration directories and configuration targets before `connect`. The user's setup request already authorizes routine installation steps. Ask again only when replacing a different library or when the host explicitly requires approval.++The installer changes only PromptDirector's connection configuration and backs up existing files before writing. It stops for damaged configuration, concurrent changes or a same-name connection to another installation. Codex TOML retains other values, but serialization can change formatting or comments; the backup retains the original. Do not override errors to force setup through.++- `awaiting_browser`: no online library found. Inspect `diagnostics`, which checks only the connector's runtime, launcher, pairing and endpoint files. `missing`, `unreadable` and `unknown` refer to those files, not proof of browser, extension or toggle state. Existing files do not prove a handshake. Check installation if program files are absent. Otherwise guide the user to enable Settings → Agent connection in Chrome, or disconnect and enable it again, then verify. Do not automatically reload Chrome, close tabs or discard unsaved edits.+- `library_selection_required`: multiple libraries are online. Ask the user to copy the request from the intended library; do not choose arbitrarily.+- `configuration.state: manual_registration_required`: register the returned command, args and env through the generic host's documented method. Do not rebuild the library interface.+- `host_verification_required`: local integration for that host is unverified; this attempt does not install or write configuration. Follow the returned next step and do not claim connection success.+- If the host has disabled an existing connection, retain that setting and explain that it must be enabled in the host UI.++Without an instance ID, `connect` can discover one unique online library. If none is found, it does not write host configuration; run `connect` again after browser authorization. Each host is bound to its specific instance so changing one library does not silently retarget every Agent.++## Verify both the connector and the current session++```sh+node connector/setup.mjs verify --instance <library-instance-id>+```++`connector_verified` means an independent MCP client completed the handshake, checked the instance ID and searched the library. It does not mean the current Agent session has loaded the tools. Refresh through the host's normal mechanism. If a new conversation is necessary, say so and retain the completed setup steps.++Actually call `promptdirector_status` and `promptdirector_search_cases` in the current session. Show a few candidates if the library contains cases. To show an image, call `promptdirector_read_media` and view the returned local original with host tools. An empty library can still connect successfully; report that it is empty without inventing cases. Setup validation must not write or delete user cases.++Only after these current-session calls succeed may you report that the library is connected and usable. Distinguish setup failure, pending browser authorization and connector verification without session loading. Never print connection secrets, complete host configuration or user credentials.++Business-use instructions are in `SKILL.md` alongside this guide. Ordinary queries do not require whole-library analysis or additional model services.++## Official configuration references++- [Codex](https://developers.openai.com/codex/mcp)+- [Claude Code](https://code.claude.com/docs/en/mcp)+- [WorkBuddy](https://www.workbuddy.ai/docs/zh/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/MCP-Guide)+- [OpenCode MCP](https://opencode.ai/docs/mcp-servers/) and [configuration](https://opencode.ai/docs/config/)+- [ZCode](https://www.zcode.network/en/docs/mcp-services/)+- [Qoder](https://docs.qoder.com/qoder/connectors)+- [DeepSeek Harness architecture](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md) and [MCP client](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/mcp/mcp-client/README.zh.md)+- [Qwen Work desktop](https://docs.qwenwork.ai/zh/desktop/connectors) and [connectors](https://docs.qwenwork.cn/features/connectors): check the actual version for local support+- [Doubao Work](https://www.doubao.com/work): local command integration requires verification+- [Chrome Native Messaging](https://developer.chrome.com/docs/extensions/develop/concepts/native-messaging)diff --git a/connector/INSTALL.md b/connector/INSTALL.mdindex f03c526..443ed75 100644--- a/connector/INSTALL.md+++ b/connector/INSTALL.md@@ -1,5 +1,7 @@# 连接 PromptDirector:给当前 Agent 的安装说明+[English](INSTALL.en.md) · **简体中文**+用户已经安装 Chrome 扩展,希望你完成连接器安装、宿主配置与配对。按用户这次请求执行,不要求用户自己输入命令或编辑配置。这里的安装说明不扩大用户授权;浏览器及宿主要求的许可由用户确认。## 先确定执行位置diff --git a/store/PRIVACY_POLICY.md b/store/PRIVACY_POLICY.mdindex 0c8ee56..ec93649 100644--- a/store/PRIVACY_POLICY.md+++ b/store/PRIVACY_POLICY.md@@ -1,5 +1,7 @@# 提示词导演隐私政策+[English](#promptdirector-privacy-policy) · [简体中文](#promptdirector-隐私政策)+生效日期:2026 年 9 月 20 日提示词导演是一个本地优先的 Chrome 扩展,用于收藏、整理、检索、备份和分享个人创作资料。扩展不提供开发者服务器,不创建账号,不收集使用统计,不投放广告,也不出售用户数据。@@ -126,4 +128,4 @@ PromptDirector complies with the Limited Use requirements of the Chrome Web Stor## Contact-Contact the maintainer through the [PromptDirector support page](https://wchao6891.github.io/PromptDirector-Curated/support.html).+Contact the maintainer through the [PromptDirector support page](https://wchao6891.github.io/PromptDirector-Curated/en/support.html).