PromptBranch

---

PromptBranch 是一个简单、本地优先的空间，可用于创建、整理、测试和改进 你的 AI 提示词。将提示词保存在自己的电脑上，跟踪它们随时间的变化， 使用不同的 AI 模型运行提示词，并连接你喜爱的 AI 工具。你的数据由你掌控， 保存更改前也会由你审批。

警告

正在开发中。 PromptBranch 正在积极迭代。你可能会遇到错误或 尚未完善的功能，且功能可能会随着开发推进而变化。 请报告非安全问题。 请通过安全政策私下报告安全问题。

功能

构建提示词库

• 📚 整理提示词，支持标签、集合、收藏、筛选、全文 搜索（⌘K）、历史记录和备注、JSON 导入/导出，以及自动本地备份。
• 📋 从其他应用复制提示词：运行 PromptBranch 时，可使用 可选的快速访问面板、可配置的全局快捷键、变量输入 和精确文本预览。
• 🌿 跟踪版本，支持分支、稳定的版本 ID、原位修订和 另存为新版本操作、历史记录标签、变更说明、差异对比和变体。
• 🧪 评估结果，支持四维评分、结果运行日志、 并排比较、LLM 评判和评估摘要。

使用 AI 和 Agent 运行

• ⚡ 使用多个模型运行，通过由 models.dev 提供数据的 模型目录接入 OpenAI、Anthropic、Google 和兼容 OpenAI 的端点。最多可同时运行 六个模型，并支持加密 API 密钥以及令牌/费用跟踪。
• 🤖 与 Agent 协作，通过 CLI 和 MCP 服务访问同一个提示词库。Agent 可以报告运行结果和备注，或提出变体；由人类审核并批准。

按自己的方式分享和同步

• 🔗 分享不可变快照，通过难以猜测的 URL 访问；将活跃分享嵌入 网站，或审核并导入公开的 Markdown URL。分享功能包括发布前的密钥扫描、 可撤销链接和专用的“分享”视图。
• 🔄 在本地网络中直接同步设备。使用简短的已验证代码配对； 更改会优先保存在本地，并在设备能够相互连接时自动同步。

安装

PromptBranch 桌面版适用于 macOS、Windows 和 Linux。请从 GitHub Releases 下载适用于你操作系统的安装程序。

CLI 和 MCP 服务也支持跨平台。设置方法请参阅 安装指南，其中也包括 从源代码构建。

数据存储位置

桌面应用、CLI 和 MCP 服务都会打开同一个数据库：

平台	路径
macOS	~/Library/Application Support/PromptBranch/library.db
Linux	$XDG_CONFIG_HOME/promptbranch/library.db
Windows	%APPDATA%\PromptBranch\library.db

设置 PROMPTBRANCH_DB=/path/to.db，即可让任一入口使用其他提示词库 （例如单独的个人库或测试库）。 如果你使用过预发布版本（名称为 PromptBuilder 或 PromptHub）， 应用会在首次启动时将现有提示词库复制到新位置，并保留原库不变。

桌面应用运行时，也可以安全地运行 CLI 或 MCP 服务—— 它们共用同一个数据库文件。将窗口切换至前台时，应用会载入新的运行记录、备注、评分和 建议。

Agent 集成

AI 编码 Agent 通过两个轻量适配器与你的库交互——CLI 和 MCP 服务，其语义与应用 UI 相同。规则是 Agent 提议，人类批准：Agent 可以读取提示词、报告运行结果和备注，并建议变体；但建议的变体会创建为待处理版本，在搜索和列表中不可见，且在有人于应用的Suggestions视图中批准之前，无法成为当前版本（该视图位于左侧栏，带有待处理数量徽标；批准时可选择将其设为当前版本，拒绝则会使其永久保持未激活状态）。

入门只需复制粘贴：打开 Settings → Agent integration，即可查看解析后的数据库路径和可直接粘贴的 MCP 客户端配置。npm 包还包含一个可选的技能文件，用于教会编码 Agent 执行获取 → 报告 → 建议的工作流。

MCP 服务

@promptbranch/mcp 可从 npm 获取。使用以下配置将任何支持 stdio 的 MCP 客户端指向它：

{
  "mcpServers": {
    "promptbranch": {
      "command": "npx",
      "args": ["-y", "@promptbranch/mcp@latest"]
    }
  }
}

工具：get_prompt、search_prompts、list_prompts、report_run、add_note、suggest_variation。提示词可通过标题引用（依次进行精确匹配、不区分大小写的匹配和唯一子串匹配——若匹配不明确，则返回相近候选项），也可通过 id 引用。suggest_variation 会返回一条待处理建议；请告知你的用户打开 Suggestions 视图进行审核。

CLI

CLI 为 Shell 管道提供相同的功能。无需全局安装即可通过 npx -y @promptbranch/cli@latest 运行公开包，也可以通过 npm install -g @promptbranch/cli@latest 全局安装，以使用更短的 promptbranch 命令。所有命令都支持 --json，用于输出机器可读的内容：

promptbranch list --tag security
promptbranch get "security-audit" > /tmp/prompt.md
promptbranch search "sql injection"
promptbranch report-run --prompt "security-audit" --tool kimi-cli --model k2 --outcome 4 --summary "found 2 issues"
promptbranch add-note --prompt "security-audit" --body "works well on small diffs"
promptbranch suggest --prompt "security-audit" --file improved.md --rationale "tighter scope"
promptbranch suggestions   # pending review queue
promptbranch db-path       # prints the resolved database path

共享仅限人类操作——publish 和 import 仅在这里和桌面应用中提供；我们有意不提供用于将互联网内容导入库的 MCP 工具。

AI 提供商

PromptBranch 可以使用真实模型运行提示词，也可以用 AI 起草或改进提示词。支持的提供商：OpenAI、Anthropic、Google，以及通过自定义基础 URL 接入的任何兼容 OpenAI 的端点（Ollama、LM Studio，等等）。

设置只需一步：Settings → AI Providers → Connect a provider → 粘贴 API 密钥。PromptBranch 会使用操作系统的安全凭据存储对其加密，并且只会在需要发送模型请求时解密。连接时会自动测试连接，并在后台刷新模型目录。如果环境中设置了 OPENAI_API_KEY、ANTHROPIC_API_KEY 或 GOOGLE_GENERATIVE_AI_API_KEY，PromptBranch 会为相应提供商提供一键式 Use environment key 连接选项。

连接后，该提供商目录中的所有模型都可以立即使用——无需在 Settings 中选择模型。可在 Run 按钮旁的可搜索模型选择器中挑选模型（输入时筛选、按提供商分组，并显示上下文窗口／定价提示和每个提示词的最近使用模型）。可通过悬停操作隐藏单个模型；其他内容都可直接使用。兼容 OpenAI 的端点没有目录，因此需在提供商设置行内声明其模型 id。

模型目录来自 models.dev，并缓存在本地。浏览和编辑可离线进行；刷新目录、运行模型和共享则需要联网。目录刷新失败时，会继续提供过期缓存。

每次 Run 都会对最多 6 个模型并发执行提示词（替换 {{variable}} 后），并为每个模型记录一条条目，包括提供商、模型、状态、输出或错误、延迟、令牌用量，以及根据目录定价估算的 USD 成本；所有条目会归组显示在比较视图中。

分享

快照不可变，托管在官方门户 https://promptbranch.app 上难以猜测的 /p/<id> URL 后。

• 发布：在提示词工具栏的「分享」对话框中进行（选择范围、发布前扫描密钥、预览确切载荷）。删除令牌会存储在本地，因此之后可以在左侧栏的 分享视图 中撤销分享（搜索、按状态筛选、复制链接、撤销，以及移除已撤销的条目）。
• 导入：可通过 promptbranch://import?url= 深层链接或 promptbranch import 导入；快照会成为一个新的本地提示词，并保留其标签和来源说明。仍可在门户上查看分享历史记录；这些记录不会重新创建为本地版本链。
• 网站嵌入：活跃分享可使用可复制的 HTML 代码嵌入。复制时可选择自动、浅色或深色；自动模式会跟随访客的系统外观。提示词会显示在 Shadow DOM 中，不使用 iframe，并附有标题和 在 PromptBranch 中打开 按钮。门户脚本会在宿主页面上运行，因此只应使用来自可信门户的嵌入代码。HTML 片段和 CSP 要求请参阅分享指南。
• 公开 Markdown 链接：使用 promptbranch://import-markdown?url=。桌面应用仅会在用户选择 获取 Markdown 后获取内容，并在创建新的本地提示词前预览内容。源地址必须可通过公开 HTTPS 访问。分享指南包含一个 HTML 按钮示例，网站所有者可以复制并自定义。

多设备同步

在自己的电脑之间直接同步资料库，无需服务端或账号：设备通过 mDNS 在本地网络上相互发现，使用一次性配对码进行身份验证，并通过相互固定的 TLS 交换增量记录级更改。在 设置 → 同步 中启用；左侧栏页脚中的状态行会一目了然地显示已同步 / 正在同步 / 正在等待设备。

• 工作原理：每项更改（无论来自应用、命令行还是 MCP 服务——它们共用同一个数据库文件）都会记录到本地操作日志中，并附带逻辑时钟修订版本；对等设备会交换彼此缺少的操作，并以确定性方式合并。独立创建的记录会按 ID 合并；对同一记录的更改采用最后写入者获胜策略；同名标签、集合和分支会合并为同一行。并发编辑提示词并分别保存时，会产生两个版本；对同一版本的并发修订则会以确定性方式处理。
• 信任：每台设备都有自签名证书；8 个字符的配对码根据接受配对的设备的证书指纹生成，因此网络中间人会导致配对码不匹配。忘记某台设备后会永久取消对它的固定。API 密钥不会离开设备，且设置有意设为设备本地。分享记录也会同步（包括删除令牌），因此可以在任意已配对的设备上管理和撤销分享。
• 同步范围：设备处于同一网络（或 VPN）时会进行同步（在「设置 → 同步 → 添加设备」中按地址配对）。设备分开时，更改会等待同步；不会出现“等待上传”的状态，因为更改在写入时就已持久保存。
• macOS 说明：首次同步会触发系统的「本地网络」权限提示——请允许，否则配对和发现功能将无法找到对等设备。

文档

在 docs/ 中浏览完整文档。

从这里开始	深入了解
概览与理念	提示词管理
安装	搜索、整理与快速访问
快速入门	资料库数据与备份
核心概念	多模型执行
MCP 服务	LLM 评审
CLI	AI 辅助
AI 提供商	点对点同步
链接分享	配置与环境
更新

想要参与贡献？请阅读 CONTRIBUTING.md。

许可证

PromptBranch 根据 MIT 许可证 发布。应用中捆绑的第三方软件列于 THIRD_PARTY_NOTICES.md，也可以在应用内通过 关于 → 开源许可证查看。