先给结论：部署方式怎么选

想零成本上手，直接用在线版 prompt.always200.com 或装 Chrome 扩展；想私有化部署，Docker 一条命令，或者 Vercel/Cloudflare 一键部署。官方 README 的快速开始章节把在线版列为第一推荐，理由是项目纯前端、所有数据只存储在浏览器本地，直接用在线版也是安全可靠的。这个项目是什么、能做什么，见它是什么一篇，本文只管装。

方式数据归属维护成本适用场景
在线版浏览器本地（官方 README）零快速试用、轻量使用
Chrome 扩展浏览器本地接近零聊天写作时随手优化
Docker自己的服务器低，拉新镜像即升级团队共用、内网部署、需要 MCP 服务
Vercel / Cloudflare自己的云账号低，同步上游需手动个人云端私有化、无服务器运维
桌面应用本地低，安装程序自动更新连本地 Ollama、绕开浏览器跨域限制

方式一：Chrome 扩展

从 Chrome Web Store 搜索”提示词优化器”安装，装完点浏览器工具栏图标即可打开优化器，这是官方 README 给出的完整使用路径。两个注意点：README 明确提醒商店审批较慢，商店版本可能不是最新的；扩展只是入口，首次使用仍需配置模型 API Key（见下文”配置模型 API Key”一节）。适用场景是你在用任何网页版 AI 工具时，点图标调出优化器，把当前提示词丢进去改，改完贴回去，全程不离开浏览器。

方式二：Docker 部署

一条 docker run 命令完成部署，Web 界面跑在 8081 端口，MCP 服务器顺带启动。镜像名 linshen/prompt-optimizer，基础命令出自官方 README：

docker run -d -p 8081:80 --restart unless-stopped --name prompt-optimizer linshen/prompt-optimizer

需要预置 API 密钥和访问密码时，加环境变量：

docker run -d -p 8081:80 \
  -e VITE_OPENAI_API_KEY=your_key \
  -e ACCESS_USERNAME=your_username \
  -e ACCESS_PASSWORD=your_password \
  --restart unless-stopped \
  --name prompt-optimizer \
  linshen/prompt-optimizer

两个细节。第一，国内拉 Docker Hub 慢时，官方 README 给了阿里云镜像：把 linshen/prompt-optimizer 替换成 registry.cn-guangzhou.aliyuncs.com/prompt-optimizer/prompt-optimizer。第二，官方 README 警告：VITE_ 开头的变量值会暴露在浏览器资源中，公开部署不要预置 API 密钥——密钥更稳妥的给法是部署后在自己浏览器的设置界面里配，访问控制交给 ACCESS_PASSWORD。部署完成访问 http://localhost:8081。

要编排管理就用 Docker Compose，步骤出自官方 README：克隆仓库后，复制 env.local.example 为 .env 并填入密钥，然后启动：

git clone https://github.com/linshenkx/prompt-optimizer.git
cd prompt-optimizer
cp env.local.example .env
docker compose --env-file .env -f docker/docker-compose.yml up -d

Compose 部署下 Web 界面在 http://localhost:8081，MCP 服务器在 http://localhost:8081/mcp，日志用 docker compose logs -f 查看。MCP 这条路的具体玩法见MCP 服务器模式。

方式三：Vercel / Cloudflare 一键部署

两个平台都有官方部署按钮，Vercel 适合个人云端私有化，Cloudflare 适合已经在 CF 生态里的用户。

Vercel，官方 README 给两种方式：方式 1 点一键部署按钮（vercel.com/new/clone 路径，克隆仓库到你的 Vercel），方便但后续无法自动更新；方式 2 先 Fork 项目到自己的 GitHub，再在 Vercel 中导入，官方推荐这种方式，因为可以跟踪源项目更新、同步最新功能和修复。环境变量两项：ACCESS_PASSWORD 设置访问密码；VITE_OPENAI_API_KEY 等密钥变量仅用于私有部署的可选模型配置，公开前端部署不要预置（理由同上，VITE_ 变量会暴露在浏览器资源中）。详细步骤看官方 Vercel 部署指南（docs/user/deployment/vercel.md）。

Cloudflare，用 Deploy to Cloudflare 按钮，它会在你的 GitHub/GitLab 账号下创建仓库并用 Workers Builds 部署。官方 README 特别提醒一个坑：保持默认部署命令，如果 Cloudflare 面板自动填入 pnpm run build，要清空它——wrangler.jsonc 会自己构建 Web 前端，并把 packages/web/dist 发布为静态资源，手动填的构建命令反而多余。访问控制用 Cloudflare Access，访问分析用 Cloudflare Web Analytics，都在 CF 控制台配置，不需要改应用代码。

补充方式：桌面应用

要连本地 Ollama，或者用的商业 API 有严格跨域策略，桌面版是官方 README 的首推方案——原生应用没有浏览器跨域（CORS）限制，可以直接连接任何 AI 服务商。从 GitHub Releases 下载，两种格式：安装程序（.exe、.dmg、.AppImage，官方强烈推荐，支持自动更新）和压缩包（.zip，解压即用但无法自动更新）。

macOS 用户注意：应用未做 Apple 签名认证（官方 README 解释是开发者账号费用较高），首次打开可能提示”已损坏”或”无法验证开发者”，按官方给的命令移除隔离属性后重新打开：

xattr -rd com.apple.quarantine /Applications/PromptOptimizer.app

装好之后：配置模型 API Key

所有形态共用同一套配置逻辑：界面配置是推荐路径，环境变量适合 Docker。界面路径出自官方 README——点击界面右上角的”设置”，选择”模型管理”，点击要配置的模型（OpenAI、Gemini、DeepSeek、Grok 等），在弹出的配置框输入 API Key，保存即可。支持的供应商包括 OpenAI、Gemini、DeepSeek、Grok、智谱、SiliconFlow，以及自定义 API——任何 OpenAI 兼容接口都能接，本地 Ollama 就走这条路（接口地址 http://localhost:11434/v1 这类，多自定义模型的环境变量写法见官方多自定义模型配置文档）。每个模型还能用 llmParams 字段配高级参数，比如 temperature、max_tokens，键值对形式。

连不上模型的常见原因是跨域（CORS）：纯前端应用受浏览器安全策略限制，模型服务没开 CORS 就会被浏览器拦截。官方 FAQ 给的解法按场景分：本地 Ollama 设置环境变量 OLLAMA_ORIGINS=* 放行跨域请求；商业 API 受限时，改用桌面版（无跨域限制），或自部署 OneAPI、NewAPI 一类中转服务。另外在线版是 HTTPS 页面，浏览器会阻止它请求 HTTP 的本地 Ollama（混合内容策略），这种情况下桌面版或本机 Docker 部署最稳。

常见问题

提示词优化器 github 仓库在哪？

GitHub 仓库是 linshenkx/prompt-optimizer，截至 2026 年 9 月约 3.5 万 Star，README 有中文版。桌面安装包在仓库的 Releases 页面下载，部署文档在仓库 docs/user/ 目录下（Vercel、Cloudflare、MCP 各有专篇）。

提示词优化器在线版和自部署怎么选？

试用和轻量使用选在线版，长期重度使用或团队共用选自部署，两条路功能一致，差别在数据归属和维护责任。在线版零维护、数据存浏览器本地，但绑定单台设备的浏览器；自部署（Docker 或 Vercel）数据在自己控制的环境里，可以配访问密码给团队共用，代价是要自己负责升级。两条路的功能一致，部署完都从”设置→模型管理”配 Key 开始。部署只是第一步，怎么把提示词用出效果，看提示词优化方法。

部署后连不上模型怎么办？

多数是浏览器跨域限制或混合内容策略：纯前端应用直接调第三方 API，对方没配 CORS 就会被浏览器拦截。先看官方 FAQ 的三条解法——Ollama 设 OLLAMA_ORIGINS=*、商业 API 换桌面版或加 OneAPI/NewAPI 中转、HTTPS 在线版连不了 HTTP 本地模型属正常现象。密钥本身配错也会导致连不上，回”模型管理”检查 Key 和接口地址。