提示词总写不利?prompt-optimizer 完整上手教程
【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer
prompt-optimizer 是一款提示词优化工具:输入一段提示词,输出一段更好用的提示词。它用 AI 重写你的提示词,补上缺失的上下文、约束与结构,并用改写后的版本直接实测。整个应用是纯客户端架构——你的 prompt 与 API 密钥留在本地,不经过任何中间服务器,因此可以放心把真实的提示词交给它。
为什么敢把 prompt 交给它 🛡️
先看架构,再看功能。prompt-optimizer 没有后端中转:数据存在浏览器本地,密钥也只存在本地。两个文件细节可以佐证:
- 扩展的 manifest.json 中
"permissions": []——没有申请 storage、tabs 等任何权限; - 同一文件里
"offline_enabled": true,扩展可以离线加载。
也就是说,提示词优化全程发生在你的设备内。
选择使用入口:四种形态怎么选
同一套能力,四种入口,按场景挑一种即可:
- Chrome 扩展:在浏览器里顺手优化,适合日常使用;
- Web 应用:打开即用,适合快速体验;
- 桌面端:脱离浏览器的本地形态;
- Docker:团队共享一台私有服务器。
新手推荐从扩展开始。浏览器扩展安装步骤如下:
git clone https://gitcode.com/GitHub_Trending/pro/prompt-optimizer cd prompt-optimizer pnpm install pnpm build:ext接着打开chrome://extensions/,开启右上角"开发者模式",点击"加载已解压的扩展程序",选择packages/extension/dist。在扩展里填好模型密钥,选中一段提示词即可开始优化。若不想本地构建,直接到 Chrome 应用商店安装即可,上面四行命令可以全省。
左侧是原始提示词与优化结果,右侧测试区可以直接看到改写后输出质量的变化。
接入自有模型:Ollama 自定义端点
结论在前:默认模型(OpenAI、Gemini、DeepSeek)够用就直接跳过本节。需要挂本地或内网的 OpenAI 兼容端点时——比如 Ollama、公司网关——用VITE_CUSTOM_*系列环境变量描述。数量不设上限,每个模型一组带后缀的变量(以 Ollama 为例):
| 变量 | 示例值 | 说明 |
|---|---|---|
VITE_CUSTOM_API_KEY_qwen3 | ollama | 必填,鉴权密钥,本地服务随便填 |
VITE_CUSTOM_API_BASE_URL_qwen3 | http://localhost:11434/v1 | 必填,API 地址 |
VITE_CUSTOM_API_MODEL_qwen3 | qwen3:8b | 必填,模型名 |
VITE_CUSTOM_API_PARAMS_qwen3 | {"temperature":0.7} | 可选,注入请求体的参数 |
VITE_CUSTOM_API_HEADERS_qwen3 | {"x-tenant-id":"a"} | 可选,网关附加请求头 |
后缀规则只有三条:
- 只允许字母、数字、下划线、连字符;
- 长度不超过 50 个字符;
- 不能与 openai、deepseek 等内置模型名撞车。
另外,三个必填变量缺一个,该模型会被整体跳过;想要第二个模型,换一组后缀照配一遍即可。完整规则见 docs/user/multi-custom-models.md。
这是一次用自定义模型完成的优化:一句粗略的诉求被补写成了要素完整的创作指南。
MCP 服务器启动与接入 🚪
MCP 服务器是 prompt-optimizer 为其他 AI 应用留的门:把三个动作封装成标准工具——optimize-user-prompt(优化用户提示词)、optimize-system-prompt(优化系统提示词)、iterate-prompt(针对具体问题迭代已有提示词)。Claude Desktop 这类支持 MCP 的客户端接入后,对话中就能直接调用。
MCP 服务器接入只需一条命令。Docker 镜像里 MCP 服务随 Web 应用一起启动:
docker run -d -p 8081:80 \ -e VITE_OPENAI_API_KEY=your-key \ -e MCP_DEFAULT_MODEL_PROVIDER=openai \ linshen/prompt-optimizer其中MCP_DEFAULT_MODEL_PROVIDER指定 MCP 调用走的模型,可选 gemini、deepseek、custom 等。启动后 Web 界面在http://localhost:8081,MCP 服务在http://localhost:8081/mcp。在 Claude Desktop 的 services 配置里加一行即可:
{ "name": "Prompt Optimizer", "url": "http://localhost:8081/mcp" }托管三选一:Vercel、Docker 还是本地 pnpm
| 方式 | 适合 | 启动 | 注意 |
|---|---|---|---|
| Vercel | 公开分享、快速上线 | pnpm install+pnpm build:web,产物为packages/web/dist | VITE_*变量会打进前端产物,公开部署勿放真实密钥,建议配ACCESS_PASSWORD访问保护 |
| Docker | 私有服务器、团队共享 | 上一节的docker run命令 | 一个 8081 端口同时提供 Web 与/mcp |
| 本地 pnpm | 自研、改代码 | pnpm install && pnpm dev | 需要 Node 22 和 pnpm 10 |
下一步
clone 仓库 →pnpm build:ext→ 把dist拖进chrome://extensions/→ 右键选中一段写不利的提示词,点优化。项目预留了自定义模型、llmParams等配置级扩展点,更深层的插件接口以 docs/ 目录下的开发者文档为准。
【免费下载链接】prompt-optimizerAn AI prompt optimizer for writing better prompts and getting better AI results.项目地址: https://gitcode.com/GitHub_Trending/pro/prompt-optimizer
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考