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 所加载的完整技能定义。技能处于激活状态时，Agent 就会看到这些指令作为操作指南。: ::

Stripe Projects 技能

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

目前仅支持 [linux, macos] 平台，因为更广泛的支付集群仍在 Windows 上完善中。Stripe CLI 本身是跨平台的；此限制只是针对集群的整体策略，并非硬性规定。

适用场景

触发语句示例：

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

即使用户已有某个提供商的账户，该技能仍可通过 stripe projects link <provider> 将其关联起来。如果用户希望使用现有的提供商资源（如现有数据库或 Vercel 项目），请先确认该提供商是否支持；目前许多提供商仅支持创建新资源，暂不支持导入现有资源。

先决条件

已安装 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