提示词总写不利?prompt-optimizer 完整上手教程
2026/9/22 9:03:05 网站建设 项目流程

提示词总写不利?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_qwen3ollama必填,鉴权密钥,本地服务随便填
VITE_CUSTOM_API_BASE_URL_qwen3http://localhost:11434/v1必填,API 地址
VITE_CUSTOM_API_MODEL_qwen3qwen3:8b必填,模型名
VITE_CUSTOM_API_PARAMS_qwen3{"temperature":0.7}可选,注入请求体的参数
VITE_CUSTOM_API_HEADERS_qwen3{"x-tenant-id":"a"}可选,网关附加请求头

后缀规则只有三条:

  1. 只允许字母、数字、下划线、连字符;
  2. 长度不超过 50 个字符;
  3. 不能与 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/distVITE_*变量会打进前端产物,公开部署勿放真实密钥,建议配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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询