treg数据模型深度解析Org、Secret、Tool、Bundle核心表设计完全指南【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtregOpenRouter for agent tools的数据模型是理解这套多租户 API 代理平台的关键。本文带你从新手视角读懂它的核心表设计Org团队/租户、Secret加密凭证、Tool可调用工具、Bundle技能打包以及余额账本、调用审计等配套表。全部列定义以 src/treg/models.py 为权威来源架构背景见 docs/context/architecture/data-model.md。数据模型总览一张图看懂表关系treg 的所有租户资源都挂在org_id外键上形成清晰的团队 → 成员 → 凭证/工具层级。核心关系如下表角色关键约束Org租户团队拥有资源slug全局唯一User全局身份邮箱登录email唯一Membership用户与团队的绑定 角色 token(user_id, org_id)唯一SecretFernet 加密存储的凭证org_id索引Tool上游 URL 凭证绑定(org_id, name)唯一Bundle技能包SKILL.md Secret Tool通过bundle_id反向引用CallRecord每次代理调用的审计行全库最大的表一个容易混淆的点一个token 一个 (User, Org) 组合。同一个人加入 N 个团队就有 N 条Membership、N 个 token但User表里只有一条记录见 src/treg/models.py。Org 表多租户的根基Org是多租户的锚点字段设计很有代表性src/treg/models.pybalance_micro—— 以微美元1e-6 USD为单位的预付费余额。做成物化列而不是查询是因为它是热路径上的花费闸门一次条件 UPDATE 就能阻止并发调用把余额刷成负数spent_today_micro/spent_today_day—— 当日累计花费计数器供 fail-closed 的每日限额在每次计费调用中做单次主键查询避免扫描整天的账本previous_slug—— 团队改名后旧 slug 仍可作为别名解析避免所有已分发的密钥瞬间失效Stripe 自动充值字段autotopup_*系列—— 阈值、金额、月度上限与合规时间戳自动充值默认关闭。Secret 表凭证永不离开服务器Secret存储的是凭证本体核心设计有三点src/treg/models.pyvalue字段 Fernet 加密落盘永远不会返回给客户端kind字段选择注入器env环境变量、secret_file密钥文件、oauth、cli_auth或param非机密参数如项目 ID健康与过期是两条独立轴health_statusunknown/ok/invalid回答现在能不能用expires_at回答还能用多久——一个不可刷新的 token 会一直保持 healthy 直到悄悄失效所以必须单独展示。此外注册表 OAuth 连接还会记录provider、granted_scopes、resource_ref等元数据标注这条连接代哪个站点/账号行事。Tool 表多凭证绑定bindingsTool注册一个可调用能力 上游base_url一个凭证绑定列表src/treg/models.py。每个绑定形如{secret_id, injector, location, name, format, secret_field}表示一次凭证注入一次请求会应用该工具全部的绑定——例如 google-ads 同时需要 OAuth Bearer 头和developer-token头。其他实用字段hostbase_url 的域名建索引以支持 URL 直通解析、examples展示在仪表盘的调用示例、health_check凭证健康探针、cli本地运行treg run --local的配置文件。代理只中转relay、不建模上游且凭证在服务器端注入调用方永远不接触密钥。Bundle 表把整个技能文件夹打包Bundle就是技能纯打包概念src/treg/models.pyrecipe—— SKILL.md 的文本可分享的怎么做说明files—— JSON 字典{relpath: content}承载文件夹里其余文件参考文档、脚本、子目录于是skill install一次就能重建整个技能目录其下的 Secret 与 Tool 通过bundle_id反向引用实现注册一个技能即成组创建。运行配置treg run的两种模式统一放在Tool.cli上而不是 Bundle 侧这是后期工具侧统一重构的结果。钱与审计CreditBlock、LedgerEntry 与 CallRecord余额不是单标量而是资金块CreditBlock促销赠送与购买充值分成不同的块因为购买额度是可退的递延收入、促销额度不可退消费顺序是先促销、后最早的购买退款池因此最小化src/treg/models.py。LedgerEntry 是只追加的钱账每次余额/块变动写一行与变动同事务提交从不修改或删除——更正靠补偿性新条目。金额从团队视角带符号充值为正、扣款为负call_id关联预留 → 结算/释放对。CallRecord 是平台吞吐量的索引所在谁、何时、调了哪个工具、什么结果异步写入不阻塞代理路径。它记录cost_estimated_micro预留额、cost_observed_micro供应商实际报价、refused_by区分平台拒绝与上游失败等。官方文档特别强调(org_id, created_at)这类复合索引就是平台吞吐的一部分索引缺失会让全库查询排队直至 API 池耗尽。迁移与延伸阅读所有生产 schema 变更由 Alembic 管理迁移脚本在 src/treg/alembic/versions/0001 基线 50 余个演进版本余额、预留、结算的业务逻辑集中在 src/treg/domain/money/多租户隔离与角色门控见 docs/context/architecture/multi-tenancy.md完整表清单含 OAuth 四表、归档、容量策略等见 docs/context/architecture/data-model.md。小结新手记住三句话一切资源挂org_id——多租户隔离靠外键 会员 token而非独立数据库凭证加密落盘、服务器端注入——Secret 永不回传调用方零接触密钥钱走同步账本、日志走异步审计——LedgerEntry 绝不丢行CallRecord 允许丢弃两条纪律严格分开。掌握这三点treg 数据模型的地基就立住了。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考