pack-revenue.balances模块 28平台模块
平台模块Pack revenue ledger
在任何人获得付款之前，查看每位包作者赚了多少、还欠多少，每一个最小货币单位都有账可查。
pack-revenue.balances 读取包注册表背后的收益账本。收入行被拆分一次，分为平台份额和作者份额，在退款窗口内保留，并结算为对账单。balances 显示每个作者密钥结转的金额及其收款方状态。
pack-revenue.balances模块 28在任何人获得付款之前，查看每位包作者赚了多少、还欠多少，每一个最小货币单位都有账可查。
pack-revenue.balances 读取包注册表背后的收益账本。收入行被拆分一次，分为平台份额和作者份额，在退款窗口内保留，并结算为对账单。balances 显示每个作者密钥结转的金额及其收款方状态。
没有绑定付款提供方，因此 close 写入对账单，并把每笔付款记为带原因的 paid: false。请在平面之外根据 payableMinor 向作者结算；把余额视为记录，而不是转账。
balancesauthorKeyIdunattributed。carriedForwardMinor0。terms 读取或设置 platformFeeBps、minimumPayoutMinor 和 holdDays。默认值为 500、5000 和 30，币种为 usd。
此模块的调用会改变真实状态或访问外部服务，因此共享演示不会运行它们。请登录后在您自己的工作区中运行。 pack-revenue.balances 文档
此模块的调用会改变真实状态或访问外部服务，因此共享演示不会运行它们。请登录后在您自己的工作区中运行。
一个符合 API 接受格式的请求，以及模块返回格式的示例响应。
GET /api/v1/acp/pack-revenue/balances Authorization: Bearer av_workspace_•••• → 200 { balances, currency }
结算之后读取 balances，查看谁在结转资金及原因。低于最低额的余额只会结转到下一个周期。
每份对账单都满足 broughtForwardMinor + earnedMinor - payableMinor = carriedForwardMinor，所以有争议的数字可以追溯到各行。
其密钥不被注册表认识的行会归入 unattributed 并附注，而不是计入平台份额。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
close 是幂等的：对账单按作者和周期为键，已付款的对账单会被跳过。每个金额都是以最小货币单位表示的整数。record 会拒绝负的总额；退款有其自己的路由。
收益在该行之后的 holdDays 天内保留在 heldMinor 中；对账单的 payableMinor 只计算在结算时已结清的部分。
有结转余额但该周期没有行的作者，仍会得到一份对账单，因此不再被报告的余额不会被遗忘。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/acp/pack-revenue/balances读取每位作者的结转余额和收款方状态。/api/v1/acp/pack-revenue/lines列出收入行，可按 packId 或 authorKeyId 筛选。packs.list25Signed pack registry从外部引入一个由智能体、授权和演练组成的包，并知道是谁签署的，以及途中是否有任何字节被更改。metering.snapshot21Metered usage by workspace按计量项查看平面为您的工作区计了什么数，以及每个计数对应哪个计费计量项。
payeenone、onboarding、payable 或 restricted。currencyusd。withheldbelow-minimum、no-payee、payee-not-payable、negative-balance 或 unattributed 之一。payableMinorrecord 添加一行，包含 packId、grossMinor 和 install、usage 或 adjustment 之一的 kind。它只拆分一次，并以有利于作者的方式取整。
payee 把作者密钥设为 none、onboarding、payable 或 restricted。payable 需要 account 引用，restricted 需要 reason。
close 接受 from 和 to，为每位作者写一份对账单并记录每次付款尝试。已付款的对账单绝不会被支付两次。
{
"balances": [
{
"authorKeyId": "key_9f2a41",
"carriedForwardMinor": 1840,
"payee": "onboarding"
},
{
"authorKeyId": "unattributed",
"carriedForwardMinor": 950,
"payee": "none"
}
],
"currency": "usd"
}refund 使用已应用的拆分来撤销一行。它是幂等的：第二次退款返回第一次的结果，并带有 alreadyReversed。
metering.snapshot。packs.list。paid: false，对账单依然有效。unattributed 的余额最终会到达作者。当密钥之后被信任时，代码中没有任何东西会重新分配它，因此需要手动处理。carriedForwardMinor 来自上一份对账单，而不是未结算的行。读取余额、行、对账单和付款不需要角色。写入条款或收款方，以及 record、refund 和 close，限工作区管理员。
install、usage、refund 和 adjustment。record 接受除 refund 之外的所有类型，refund 只能由 refund 路由创建。
platformFeeBps 是 0 到 10000 的整数。minimumPayoutMinor 和 holdDays 必须是非负整数。close 需要 from 和 to，且 from 必须早于 to。缺少周期返回 400。payable 而不带 account 会返回 400，restricted 不带 reason 也一样。stored。/api/v1/acp/pack-revenue/record添加一行收入并拆分它。/api/v1/acp/pack-revenue/refund精确地撤销一行，仅一次。/api/v1/acp/pack-revenue/payee读取或设置作者的付款状态。/api/v1/acp/pack-revenue/terms读取或设置费用、最低额和保留窗口。/api/v1/acp/pack-revenue/close把一个周期结算为对账单并记录付款尝试。/api/v1/acp/pack-revenue/statements列出对账单，可只列某位作者的。/api/v1/acp/pack-revenue/payouts列出每次付款尝试及其原因。此模块没有 MCP 操作。请通过 REST 从任何智能体或程序调用它。
mandates.compile03Mandate studio and replay把智能体的章程写成代码，查看它会改变谁可以做什么，并将其作为授权的下一个版本应用。civics.settings23Workspace constitution为此工作区的每种紧急程度，设定真人必须多快回答您的智能体的提问，以及谁值班。change-trains.list24Staged change trains先把变更推给集群的一部分，对照测得的信号检查，再逐阶段向前推进。lenses.run26Governance lenses对您交给它的数据运行固定的检查，得到带证据的通过或失败，每次答案都相同。attestation.policy27Artifact build attestation决定您接受哪些构建者来构建策略快照和检测器包，并拒绝受信任作者签名但由另一次构建产生的内容。