title: “Stripe Projects — Provision SaaS services + sync creds via Stripe Projects” sidebar_label: “Stripe Projects” description: “Provision SaaS services + sync creds via Stripe Projects”

{/* 本页面由 website/scripts/generate-skill-docs.py 根据技能的 SKILL.md 文件自动生成。请直接编辑源文件 SKILL.md，而非此页面。 */}

Stripe Projects

通过 Stripe Projects 功能来配置 SaaS 服务并同步凭证。

技能元数据


来源	可选 —— 使用 `hermes skills install official/payments/stripe-projects` 安装
路径	`optional-skills/payments\stripe-projects`
版本	`0.1.0`
开发者	Teknium (teknium1)、Hermes Agent
许可协议	MIT
支持平台	linux、macos
标签	`Payments`、`Stripe`、`Projects`、`Provisioning`、`Infrastructure`
相关技能	`stripe-link-cli`、`mpp-agent`

参考：完整的 SKILL.md 文件

:::info 以下是当触发该技能时 Hermes 所加载的完整技能定义。技能运行时，代理程序会依据这些内容执行操作。: ::

Stripe Projects 技能

该技能封装了 Stripe Projects 的 CLI 插件，使 Hermes 能够统一配置各类 SaaS 服务（如 Neon、Twilio、Vercel 等），生成并同步凭证到用户的 .env 文件中，同时实现跨服务提供商的账单管理。

目前仅支持 [linux, macos] 平台，因为更广泛的支付功能集群仍在 Windows 上完善中。Stripe CLI 本身是跨平台的；此限制仅为集群发展阶段的临时措施，并非硬性规定。

适用场景

触发语句：

“设置 ”，“配置 <Neon|Twilio|Vercel|…>”，“创建数据库”
“为这个项目提供一个 <Postgres|Redis|Twilio号码|…>”
“管理我的技术栈凭证”，“更换此密钥”，“升级我的套餐”
“我可以添加哪些 provider？”

即使用户已经拥有 provider 账户，该功能仍可通过 stripe projects link <provider> 将其连接起来。如果用户希望使用现有的 provider 资源，比如已有的数据库或 Vercel 项目，则需先确认该 provider 是否支持；目前许多 provider 只支持配置新资源，而不支持导入现有资源。

先决条件

已安装 Stripe CLI（在 macOS 上可使用 Homebrew，在 Linux 上可使用包管理器，或从 https://docs.stripe.com/stripe-cli/install 下载）
已安装 Stripe Projects 插件
拥有 Stripe 账户。如果用户尚未拥有账户，CLI 可以在设置过程中指导其通过浏览器完成登录或账户创建。

安装

macOS：

brew install stripe/stripe-cli/stripe
stripe plugin install projects

Linux系统：请先按照https://docs.stripe.com/stripe-cli/install中的平台专属安装指南进行操作，随后：

stripe plugin install projects

cd <project-root>
stripe projects init

这将生成 .projects/vault/vault.json 文件（用于存储加密后的凭证），并为该项目接入各类提供程序做好准备。

2. 查找可用的提供程序

stripe projects catalog

列出 Stripe Projects 支持的所有提供商——包括数据库、托管服务、身份验证、人工智能、分析工具、消息传递等功能。

3. 添加服务

stripe projects add <provider>/<service>

示例：

stripe projects add neon/postgres
stripe projects add twilio/sms
stripe projects add runloop/sandbox

该命令行工具会在用户自身的账户中通过对应服务提供商配置相关服务，生成凭证并将其同步到 .env 文件中，同时将该资源存储在安全保管库中。用户可能需要确认所选的服务层级或价格信息。

4. 验证

stripe projects list

应显示新添加的提供程序及其 .env 配置键。

5. 管理 / 升级 / 移除

stripe projects upgrade <provider>     # tier change
stripe projects remove <provider>      # deprovision
stripe projects rotate <provider>      # rotate credentials

常见陷阱

.env 文件的写入为真实写入操作。 CLI 会直接追加到项目根目录中的 .env 文件内容。如果用户的 .env 文件已被加入 .gitignore（这是常规做法），则其中的配置信息将得到安全保存；反之，该功能可能会成为敏感信息泄露的途径。务必先检查 .gitignore 文件。
状态为项目级独立存储。 .projects/vault/vault.json 中的数据是针对每个项目单独存储的。在两个不同的项目中配置相同的服务会生成两个独立的资源——进而产生两笔费用。
计费在 Stripe 端完成。 在执行 add/upgrade 操作时出现的层级选择实际上都会触发真实扣费，因此在确认操作前需向用户明确说明相关费用。
提供商的可用性可能会变化。 服务目录会不断扩展；如果用户指定的提供商未出现在列表中，应先使用 stripe projects catalog | grep <name> 命令进行查询，而非直接让 add 操作失败。
保险库中的敏感信息经过加密，但 .env 文件为明文形式。 需遵循标准的 .env 文件管理规范——绝不可将其提交到版本控制系统中。
删除服务并不一定会彻底清除底层资源。 部分提供商会在删除后仍保留处于暂停或休眠状态的资源。对于高成本服务（尤其是托管数据库），应在执行 remove 操作后查看该提供商的专用控制面板。

验证方法

stripe projects --version && stripe projects list

在已初始化的项目中，退出码为0表示该插件运行正常。

Hermes Agent Docs i18n