3 种方式玩转提示词优化:prompt-optimizer 从浏览器到 MCP 的实战入门
【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer
场景很直接:你在网页里选中一段文字,想让它立刻变成一条结构完整、能直接喂给大模型的提示词,而不是自己重新组织语言。prompt-optimizer 就是一个干这件事的开源工具:丢进去一句随意写的大白话,它输出优化后的提示词,还能接上任意 OpenAI 兼容的模型服务。下面不按组件讲,按"你能拿到什么"讲三件事:在浏览器里选中文字就用、接上你自己的模型、让别的 AI 应用直接调用它;最后给一条命令跑起来的部署路径。
在浏览器里选中文字就能用
最轻的用法是它的浏览器扩展。装好之后选中页面上任意一段文本,右键就能唤起优化入口,不需要复制粘贴到别的页面。两个细节值得注意:
- 数据处理在本地完成。扩展的 manifest 里 permissions 字段是空的,连 storage 权限都没申请,提示词和密钥不出浏览器。
- 主流模型开箱可用。OpenAI、Gemini、DeepSeek 等配好密钥就能用,密钥存在本地,换个浏览器不用重填。
想开发的话也很简单:进packages/extension执行pnpm dev,再到 Chrome 的chrome://extensions打开开发者模式,用"加载已解压的扩展程序"指向packages/extension/dist目录,改代码看热更新。
接上你自己的模型:Ollama 本地模型接入步骤
模型是私有部署的——本机 Ollama 或公司内网服务——不用改代码,写三个环境变量就行,后缀名自己起:
VITE_CUSTOM_API_KEY_qwen3=dummy VITE_CUSTOM_API_BASE_URL_qwen3=http://localhost:11434/v1 VITE_CUSTOM_API_MODEL_qwen3=qwen3:8b规则就三条,记下来基本不会踩坑:
| 规则 | 说明 |
|---|---|
| 三项必填 | API_KEY、BASE_URL、MODEL必须成组出现,少一项模型不会出现 |
| 后缀命名 | 只能含字母、数字、下划线、连字符,点号不行,长度别超 50 |
| 可选参数 | 再加VITE_CUSTOM_API_PARAMS_后缀(JSON 字符串),注入 temperature 等请求参数 |
数量上不封顶,配几个就在模型下拉里多几个选项,后缀还会被格式化成友好名称(qwen3 显示为 Qwen3)。本地 Ollama 没有真密钥,API_KEY 填个占位值如dummy即可。完整字段说明在 docs/user/multi-custom-models.md。
让别的 AI 应用也能调用它
除了自己用,你还可以把优化能力借出去:项目内置了一个 MCP 服务器,把提示词优化能力包装成三个标准工具,任何支持 MCP 协议的客户端都能连:
optimize-user-prompt:优化用户提示词optimize-system-prompt:优化系统提示词iterate-prompt:按具体需求迭代已有提示词
以 Claude Desktop 为例,把服务地址写进配置就完事:
{ "services": [ { "name": "Prompt Optimizer", "url": "http://localhost:8081/mcp" } ] }开发者本地调试不想开 Docker 的话,装完依赖执行pnpm mcp:dev,服务起在http://localhost:3000/mcp,改完即生效。更多客户端的接入细节见 docs/user/mcp-server.md。
5 分钟跑起来:部署方式怎么选
三种方式,按用途挑:
| 方式 | 适合谁 | 一句话理由 |
|---|---|---|
| Docker | 想立刻用上的人 | 不用装 Node 环境,一条命令同时起 Web 界面和 MCP 服务 |
| Vercel | 有域名、想分享链接的人 | 前端静态构建,控制台填几个环境变量即可 |
| 本地开发 | 要改代码的人 | Node 22+ 加 pnpm,装完依赖pnpm dev就能调试 |
Docker 路径最短,建议先试它:
docker run -d -p 8081:80 \ -e VITE_OPENAI_API_KEY=你的key \ -e MCP_DEFAULT_MODEL_PROVIDER=openai \ --name prompt-optimizer \ linshen/prompt-optimizer起完后 Web 界面在http://localhost:8081,MCP 服务在http://localhost:8081/mcp。配了多个密钥时用MCP_DEFAULT_MODEL_PROVIDER指定首选,它也能填custom_qwen3这类自定义模型后缀。走 Vercel 的话,安装命令填pnpm install、构建命令填pnpm build:web,密钥类环境变量在控制台里加:
常见问题
- 没有 API 密钥能用吗?可以。接本地 Ollama 时密钥填占位值就行,请求根本不出内网。
- Node 版本有要求吗?有。工程锁定 Node 22+ 和 pnpm 10,低版本装依赖会直接报错,先升版本再折腾。
- 数据安全吗?Web 版是纯前端运行,提示词和密钥只在你浏览器里。Docker 部署注意别把 8081 端口直接挂公网,需要的话用
ACCESS_USERNAME/ACCESS_PASSWORD加一层访问控制。
现在就能做的三件事
- clone 仓库(地址:https://gitcode.com/GitHub_Trending/pro/prompt-optimizer)并
pnpm install,跑pnpm dev,把一句"帮我总结这段话"丢进优化入口,看前后差异。 - 按第二节那三行环境变量把 Ollama 模型接上,刷新页面确认下拉列表里多了一个模型。
- 用 Docker 把 MCP 服务跑起来,在 Claude Desktop 里配好服务地址,用自然语言让它帮你改一条系统提示词。
【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考