01
买家与开发者使用
开发者只能通过项目和项目级凭证发现、收藏、安装、测试和调用技能。
- 安装前应检查 Manifest Schema、权限、价格、版本、审核状态、事故记录和公开反馈。
- 项目所有者负责审批高风险权限、设置预算、轮换 API Key，并采纳已审核的新版本。
- 控制台运行测试默认不计费，除非产品明确标记为付费供应商执行。
范围注册目录、市场、运行网关
资金Stripe 或 PayPal 支付、账本入账、Stripe Connect 打款
信任审核、事故、举报、下架
数据Manifest、运行、账务和通知记录
02
发布者责任
发布者必须提供准确的技能合约，并把公开条目作为持续运营的产品维护，而不是一次性上传。
- 每个条目必须包含显示名称、描述、版本、运行时、输入输出 Schema、权限、示例、变更日志和支持入口。
- 已验证或已安装版本不可变更；行为、Schema、权限、价格或运行时变化必须发布新的语义化版本。
- 付费发布公开前，需要发布者档案处于可用状态、Stripe Connect 打款准备完成、价格通过审核，并接受退款和争议处理条款。
03
审核、安全与下架
为保护开发者、发布者和市场，SkillHub 可以审核、拒绝、限制、暂停、废弃或移除条目。
- 验证需要自动 Manifest、运行、示例和安全检查，并由审核人员作出决定。
- 滥用举报、重大事故、未声明权限、恶意运行行为、隐私问题或账务滥用都可能触发限制或暂停。
- 分发压制是排序治理动作，不等同于下架；发布者修复质量问题后可通过市场申诉流程处理。
04
价格、佣金与付费市场
商业记录来自真实 Stripe 或 PayPal 支付事件、SkillHub 账本入账和 Stripe Connect 打款状态。
- 计费用量和订阅会写入交易、分账、发布者余额行和可审计通知。
- 默认分成模型为平台 20%、发布者 80%；如果有新的有效佣金规则，则未来入账按新规则执行。
- 买家支付在可用时使用 Stripe Checkout 或 PayPal；发布者打款准备和打款引用使用 Stripe Connect，高风险或超阈值场景进入财务审核。
05
退款与争议
退款和争议通过可审计的支付供应商事件和账本调整处理，而不是修改历史交易。
- 财务人员可以在填写原因后批准、拒绝、入账、标记失败、预警、胜诉或败诉调整记录。
- 已入账退款会创建负向调整交易、负向分账和发布者余额冲销记录。
- 争议败诉可以自动写入退款调整，发布者和项目操作者可以查看自身范围内的调整历史。
06
数据保留与隐私
SkillHub 会保存注册目录信任、调用权限和日志、账务追踪、账号安全所需的运营记录。
- 保存记录包括 Manifest、版本、审核决定、运行检查、安装、策略、调用、用量、账本、通知和审计日志。
- 用户令牌、API Key、邮箱验证码、OAuth Secret、Webhook 签名密钥和供应商 Key 不得在首次展示后或管理列表中明文暴露。
- 当技能处理用户、业务、密钥、财务或敏感运营数据时，发布者必须声明数据保留说明。
07
事故、废弃与支持
运营故障需要为开发者、发布者和信任治理人员留下可追踪信号。
- 运行事故可按打开、监控中、已解决、复盘等状态流转，并记录严重级别和决策原因。
- 已安装技能的更新收件箱应在迁移前展示新版本、废弃、安全说明和事故恢复状态。
- 版本废弃或技能暂停时，发布者应维护支持入口、变更日志和替代方案指引。
08
通知与 Webhook
站内、邮件和 Webhook 通知通过已配置的生产供应商投递。
- 用户可以管理审核、更新、运行、账务、打款、买家需求和账号安全事件的通知偏好。
- 外部邮件和 Webhook 队列会展示尝试次数、供应商元数据、重试计划、签名投递和脱敏后的载荷摘要。
- 邮件投递和 Webhook 网络投递不得在后台视图中暴露验证码、令牌、密钥或敏感载荷字段。
09
生产集成
相关供应商集成必须完成配置后，对应产品能力才会被视为可用。
- Stripe Checkout、PayPal 支付、支付 Webhook、Stripe Connect 入驻、邮件投递、OAuth、Webhook 投递和模型供应商 Key 都属于生产依赖。
- 如果依赖未配置，受影响 API 会返回稳定的 configuration_required 错误，界面展示真实不可用或空状态。
- 当供应商、地区、税务、退款窗口、KYC 或最低打款规则变化时，条款可能同步更新。