Skip to content
Back to search

adlink-ad-middleware

SkillWorks with Claude CodeGitHub

Operate AdLink enterprise ad-data middleware — bridge isolated official ad-platform APIs/MCPs with customized enterprise person-account governance, project classification, caliber reconciliation, creative workload attribution, opt-in ad creation (disabled by default with mandatory user ask & risk warning), and two-tier login (Official MCP Auth Bridge + relabeling, or API account list + custom project bootstrap).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zyfjacksonchen-source--adlink/badge.svg)](/listings/zyfjacksonchen-source--adlink)

HTML

<a href="/listings/zyfjacksonchen-source--adlink"><img src="/api/listings/zyfjacksonchen-source--adlink/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 24 lines
  1. ---
  2. name: adlink-ad-middleware
  3. description: Operate AdLink enterprise ad-data middleware — bridge isolated official ad-platform APIs/MCPs with customized enterprise person-account governance, project classification, caliber reconciliation, creative workload attribution, opt-in ad creation (disabled by default with mandatory user ask & risk warning), and two-tier login (Official MCP Auth Bridge + relabeling, or API account list + custom project bootstrap).
  4. ---
  5. # AdLink Skill for AI Agents
  6. Why AdLink even when ad platforms offer official MCPs: AdLink bridges raw single-platform APIs/MCPs and **highly customized internal enterprise management** (`人-户关系`, `项目分类`, `消耗/业绩/自定义口径`, `创意工时归因`), dramatically cutting custom FDE engineering & maintenance cost.
  7. When helping a user operate or deploy **AdLink**:
  8. 1. **Always check live state & creation policy first** with `adlink_health_check` and `adlink_creation_status_and_risks`.
  9. 2. **Use the Two-Tier Login / Auth Strategy**:
  10. - **Optimal (Tier 1)**: If the platform already provides an Official MCP authentication endpoint, reuse it (`auth_strategy = "official_mcp_bridge"`), call `adlink_discover_platform_accounts`, and call `adlink_relabel_account_governance` to freely re-label (`重标`) `人-户关系` and `项目归属` inside AdLink.
  11. - **Fallback (Tier 2)**: If using headless Marketing API credentials, guide secret env vars inside `config/adlink.local.toml`, call `adlink_discover_platform_accounts` to fetch the authorized sub-account list, and call `adlink_fallback_bootstrap_project` to create a custom project and link selected sub-accounts + owners.
  12. - **Compliance for `xhs_pugongying` & `bilibili_huahuo`**: Explain honestly that no open public self-serve MAPI exists; guide whitelisted gateway setup or `adlink_ingest_external_records` CSV/JSON import preserving `note_id` / `bvid`.
  13. 3. **MANDATORY Ad Creation (`创编`) Safety Protocol**:
  14. - `ad_creation.enabled` is **`false` by default**.
  15. - **ALWAYS ask the user** whether they want to opt into Ad Creation (`创编`) AND disclose all 5 financial/policy/unit-conversion risks returned by `adlink_creation_status_and_risks`.
  16. - Never recommend enabling `[ad_creation]` without explicit user confirmation of the risks. Even once enabled (`enabled = true`, `risk_acknowledged = true`), ALWAYS run `adlink_ad_create` with `dry_run: true` first to inspect `platform_payload_preview` before passing `preview_confirmed: true, dry_run: false`.
  17. 4. **Always clarify metric calibers**:
  18. - Reconcile `gross_media_cost_yuan` (账面消耗), `cash_cost_yuan` (现金消耗), `net_after_rebate_cost_yuan` (返点后净消耗), `full_funnel_cost_yuan` (全域成本), `agency_net_revenue_yuan` (代理商净营收), `platform_gmv_yuan` (平台 GMV), and user-defined custom calibers via `adlink_reconcile_calibers` and `adlink_define_custom_caliber`.
  19. 5. **Enforce safety on ad mutations**:
  20. - Always preview `adlink_ad_mutate` with `dry_run: true` and an explicit `reason` before user-confirmed `dry_run: false`.
README.md · README · 253 lines
  1. # AdLink — 广告投放数据底座与 AI-Native MCP 中间件
  2. > **数字化是 AI Native 的前提。** AdLink(Apache-2.0 开源可商用)是一个用 **Rust** 构建的高性能、高度解耦的广告数据治理与 MCP 中间件,打通 **8 大主流国内广告/内容营销平台(10 个逻辑连接器)** 与企业内部数据、人户治理及多端 AI Agent 生态。
  3. [English README](README.en.md) · [Agent API 接入引导手册 (AGENT_GUIDE)](AGENT_GUIDE.md) · [Agent Skill (SKILL.md)](SKILL.md) · [官方 API 逐字段核对表](docs/platform-api-mapping.md) · [架构设计](docs/architecture.md) · [插件二开指南](docs/plugin-development.md)
  4. ---
  5. ## 1. 项目目的与行业意义
  6. 广告主与代理商在推进 **FDE(Forward Deployed Engineer / 商业数字化交付)与 AI 化转型** 时,往往卡在最底层的工程现实:
  7. 1. **媒体协议碎片化、字段不统一**:腾讯、巨量、快手、小红书、B站、支付宝各平台单位不一致(分 vs 元 vs 厘)、时间跨度上限不同(1天/7天/30天/90天)、鉴权迥异(OAuth2 / Bearer+X-Call-Source / RSA2 签名)。
  8. 2. **只拉流水进不了生产环境**:没有理清 **人-户关系(含生效期与分摊权重)**、**项目类型分类**、**创意类型分类与内部创作者工时归因**、以及 **消耗口径 / 业绩口径 / 自定义口径** 的数据,AI Agent 拿到的只是一堆无法对账的脏表。
  9. 3. **跨 Agent 重复造轮子**:WorkBuddy、KimiWork、TraeWork、豆包工作、千问办公、Claude Code、Codex、Antigravity、Cursor、GrokBot、Muse、Dots 以及自建 Agent 需要统一、可控、带安全护栏的 MCP 底座。
  10. ---
  11. ## 2. 为什么媒体平台已有官方 MCP,企业还需要 AdLink?
  12. > **核心一句话**:官方平台 MCP 只解决了「单个媒体接口能不能被 AI 调通」;**AdLink 解决的是「多家媒体原始数据」与「企业高度定制化人-户关系、项目归属、财务口径、创意工时归因等内部管理体系」之间的连接问题,彻底免去每个团队重复开发定制中间件的高昂成本。**
  13. | 维度 | 仅接各家媒体官方 MCP | 使用 **AdLink 企业底座 + 官方 MCP** |
  14. | :--- | :--- | :--- |
  15. | **登录与鉴权成本** | 每家单独做 OAuth、Token 刷新、密钥管理 | **双层策略(最优直接复用官方 MCP 登录鉴权接口,降级直连 API 拉取账户列表)** |
  16. | **人-户与项目归属** | 仅见媒体账户 ID,不知归属哪个优化师/项目/客户 | **支持自由重标「人-户关系」(含分摊权重/生效期)与项目归类,或一键自建项目绑定子账户** |
  17. | **多平台财务与口径** | 各报各的单位(分/元/厘),无返点/服务费/赠款概念 | **统一精确转 `Fen`,区分账面/现金/净消耗/全域成本与代理商净营收,支持自定义 AST 口径** |
  18. | **创意与内部创作归因** | 缺乏企业自建文案钩子分类与编导/剪辑工时核算 | **全量归因 `gmv_per_work_hour_yuan`,并打通 `note_id`/`bvid` 种草+付费加热闭环** |
  19. | **写操作与创编安全** | 裸露创建/改价接口,Agent 易误操作烧预算 | **创编默认关闭 (`enabled=false`),默认询问用户并强提醒 5 类风险;强制 `PAUSED` + `dry_run` + 硬上限审计** |
  20. ---
  21. ### 双层登录鉴权架构(官方 MCP 复用优先 + API 降级兜底)
  22. ```mermaid
  23. flowchart LR
  24. A["接入媒体账号 / 开始初始化"] --> B{"媒体侧是否有官方 MCP?"}
  25. B -- "是 · 最优方案 (Tier 1)" --> C["直接调用官方 MCP 登录鉴权接口<br/>(`auth_strategy = official_mcp_bridge`)"]
  26. C --> D["`adlink_discover_platform_accounts`<br/>同步已鉴权账户列表"]
  27. D --> E["`adlink_relabel_account_governance`<br/>在 AdLink 自由重标人-户关系与项目归属"]
  28. B -- "否 · 降级方案 (Tier 2)" --> F["直连媒体 OpenAPI 拉取账户/子账户列表<br/>(`auth_strategy = direct_api_account_discovery`)"]
  29. F --> G["`adlink_fallback_bootstrap_project`<br/>自行创建企业项目并一键关联选中子账户与优化师"]
  30. E --> H["统一口径对账 · 创意归因 · 24 个通用 MCP 工具"]
  31. G --> H
  32. ```
  33. ---
  34. ## 3. 适用人群
  35. | 角色 | 核心诉求 | AdLink 提供的核心能力 |
  36. | :--- | :--- | :--- |
  37. | **品牌/广告主 FDE 与 AI 转型负责人** | 搭建企业投放数据基座,让办公/代码 Agent 安全查数与调价 | 一站式容器部署 + MCP 三协议接入 + 安全护栏(默认 `dry_run` + 预算封顶 + 审计日志) |
  38. | **广告代理商技术 / 运营 / 媒介负责人** | 理清优化师/媒介人-户绑定、返点、服务费、现金/赠款、项目毛利 | 人户关系时效分摊 + 项目类型分类 + 消耗/业绩/自定义口径自动对账 |
  39. | **创意/内容团队负责人** | 量化编导/拍摄/剪辑/设计工时投入与投放 ROI,打通种草+加热 | 创意分类打标 + `note_id`/`bvid` 跨平台归因 + 创作者单小时产出 GMV |
  40. | **广告媒体研发人员** | 快速对接官方 Marketing API、长日期并发拉数与二次开发 | 官方字段映射零丢失保留 (`raw_fields`) + 纯 Rust 支付宝 RSA2 签名 + 插件化二开 |
  41. ---
  42. ## 4. 核心架构图 (DeepSeek-Harness / Cordis 微内核思路)
  43. ```mermaid
  44. flowchart TB
  45. subgraph Agents["多端 AI Agents & 客户端层"]
  46. A1["国内办公 Agent: WorkBuddy · KimiWork · TraeWork · 豆包工作 · 千问办公"]
  47. A2["国际编程 Agent: Claude Code · Codex · Antigravity · Cursor"]
  48. A3["Personal & 自建 Agent: GrokBot · Muse · Dots · Dify/Coze"]
  49. A4["用户自定义前端: Web 控制台 (web-starter/) · 微信/UniApp 小程序 SDK"]
  50. end
  51. subgraph Transport["统一协议与入口层 (adlink-mcp + adlink-api)"]
  52. T1["MCP Stdio (纯 stderr 日志)"]
  53. T2["MCP Streamable HTTP (/mcp, 兼容有状态与无状态)"]
  54. T3["MCP Legacy SSE (/sse + /messages)"]
  55. T4["Headless REST /api/v1/* + OpenAPI 3.1 + UI Schema"]
  56. T5["Bearer / X-Api-Key 鉴权中间件"]
  57. end
  58. subgraph Kernel["微内核插件总线 (adlink-kernel · Cordis 理念)"]
  59. K1["PluginContext 作用域依赖注入 (ServiceRegistry)"]
  60. K2["可逆副作用栈 (EffectScope 自动回滚)"]
  61. K3["HookPipeline: BeforeApiRequest / AfterNormalizeRow / BeforeAdMutate / BeforeAdCreate"]
  62. K4["GuardrailPlugin: 创编默认关闭与询问 · 风险确认 · 预算/出价上限 · 审计记录"]
  63. end
  64. subgraph Engine["高并发引擎与治理计算 (adlink-engine + adlink-domain + adlink-storage)"]
  65. E1["日期切片器 DateRangeChunker (1d/7d/30d/90d)"]
  66. E2["分级令牌桶 RateLimiterPool (平台级 + 账户级)"]
  67. E3["断点续传 SyncCoordinator + 重试退避 RetryPolicy"]
  68. E4["安全公式 AST 引擎 (消耗口径 / 业绩口径 / 自定义口径)"]
  69. E5["SQLite WAL 事务批量写入 + 归因查询引擎"]
  70. end
  71. subgraph Connectors["8 大媒体官方连接器插件层 (adlink-connectors)"]
  72. C1["腾讯社交广告 AMS v3.0"]
  73. C2["小红书聚光 & 乘风"]
  74. C3["小红书蒲公英 (合规白名单/导表)"]
  75. C4["B站三连/起飞 & 花火商单"]
  76. C5["快手磁力引擎 v1"]
  77. C6["巨量引擎 AD & 本地推 v3.0"]
  78. C7["支付宝灯火 (纯 Rust RSA2)"]
  79. end
  80. Agents --> Transport
  81. Transport --> Kernel
  82. Kernel --> Engine
  83. Engine --> Connectors
  84. ```
  85. ### 企业数据治理模型(人-户关系 · 项目分类 · 创意归因)
  86. ```mermaid
  87. erDiagram
  88. ORGANIZATION ||--o{ PERSON : employs
  89. ORGANIZATION ||--o{ AD_ACCOUNT : owns
  90. ORGANIZATION ||--o{ PROJECT : manages
  91. PERSON ||--o{ PERSON_ACCOUNT_BINDING : "分摊权重 + 生效区间"
  92. AD_ACCOUNT ||--o{ PERSON_ACCOUNT_BINDING : bound_to
  93. PROJECT ||--o{ PROJECT_ACCOUNT_LINK : allocates
  94. AD_ACCOUNT ||--o{ PROJECT_ACCOUNT_LINK : linked
  95. PROJECT ||--o{ CREATIVE_ASSET : contains
  96. CREATIVE_ASSET ||--o{ CREATIVE_PLATFORM_LINK : "entity_id / note_id / bvid"
  97. CREATIVE_ASSET ||--o{ CREATIVE_PRODUCTION_CONTRIBUTION : "工时 + 功劳权重"
  98. PERSON ||--o{ CREATIVE_PRODUCTION_CONTRIBUTION : creates
  99. AD_ACCOUNT ||--o{ UNIFIED_REPORT : generates
  100. AD_ACCOUNT ||--o{ DAILY_FUND_STATEMENT : reconciles
  101. ```
  102. ---
  103. ## 5. 支持的 8 大主流媒体平台与官方字段对齐
  104. > 逐字段实时拉取核验(含请求参数约束、创编接口支持级别与官方限制):参见 **[docs/platform-api-mapping.md](docs/platform-api-mapping.md)**。
  105. | 平台 | 连接器 ID | 接入性质 | 官方基础域名 / 协议 | 货币单位归一化 | 最大单次切片 | 核心官方字段保留 |
  106. | :--- | :--- | :--- | :--- | :--- | :--- | :--- |
  107. | **腾讯社交广告** | `tencent_ads` | 公开 MAPI v3.0 | `https://api.e.qq.com/v3.0` (OAuth2) | 分 -> `Fen` | 90 天 | `cost`, `view_count`, `valid_click_count`, `conversions_count`, `cheout_fd`, `cheout_pv_1d`, `group_by` |
  108. | **小红书聚光** | `xhs_juguang` | 合作方 OpenAPI | `https://adapi.xiaohongshu.com` (`Access-Token`) | 分/元字符串 -> `Fen` | 30 天 | `fee`, `impression`, `click`, `interaction`, `note_id`, `convert_cnt` |
  109. | **小红书乘风** | `xhs_chengfeng` | 合作方 OpenAPI | `https://adapi.xiaohongshu.com` (`Access-Token`) | 分/元字符串 -> `Fen` | 30 天 | `fee`, `impression`, `click`, `deal_order_num`, `deal_order_gmv`, `note_id` |
  110. | **小红书蒲公英** | `xhs_pugongying` | 白名单 / 导表合规打通 | Partner API 或 `/api/v1/ingest` | 分 -> `Fen` | 30 天 | `order_id`, `note_id`, `kol_quote_fee`, `platform_service_fee`, `read_cnt`, `like_cnt`, `collect_cnt` |
  111. | **B站三连/起飞** | `bilibili_sanlian` | 合作方 MAPI | `https://cm.bilibili.com/takumi/api` (`Bearer` + `X-Call-Source`) | 分 -> `Fen` | 30 天 | `cost`, `impression`, `click`, `play_cnt`, `like_cnt`, `coin_cnt`, `fav_cnt`, `bvid` |
  112. | **B站花火平台** | `bilibili_huahuo` | 白名单 / 导表合规打通 | Partner API 或 `/api/v1/ingest` | 分 -> `Fen` | 30 天 | `huahuo_order_id`, `bvid`, `order_amount`, `platform_fee`, `blue_link_click_cnt`, `gmv` |
  113. | **快手磁力引擎** | `kuaishou` | 公开 MAPI v1 | `https://ad.e.kuaishou.com/rest/openapi` (`Access-Token`) | 报表**元**/创编**厘** -> `Fen` | 7 天 | `charge`, `show`, `photo_click`/`aclick`, `form_count`/`submit`, `event_pay`, `event_pay_purchase_amount`, `photo_id` |
  114. | **巨量引擎 AD** | `ocean_engine_ad` | 公开 MAPI v3.0 | `https://api.oceanengine.com/open_api/v3.0` (`Access-Token`) | **元 -> 精确转分** | 30 天 | `stat_cost`, `show_cnt`, `click_cnt`, `convert_cnt`, `pay_order_count`, `pay_order_amount`, `material_id` (`MATERIAL_DATA`) |
  115. | **巨量本地推** | `ocean_engine_local` | 公开 MAPI v3.0 | `https://api.oceanengine.com/open_api/v3.0/local` | **元 -> 精确转分** | 30 天 | `stat_cost`, `show_cnt`, `click_cnt`, `pay_order_amount`, `poi_id`, `local_life_verify_cnt` |
  116. | **支付宝灯火** | `alipay_denghuo` | 公开 OpenAPI | `https://openapi.alipay.com/gateway.do` (**纯 Rust RSA2**) | 分 -> `Fen` | 7 天 (小时1天) | `cost`, `impression`, `click`, `conv_result`, `conversion_data_list`, `biz_date` |
  117. > **合规与完整性承诺**:小红书蒲公英与 B站花火目前均无公开免审批自助 API,AdLink **严禁任何违规爬虫或绕过风控手段**,诚实采用「官方白名单接口 + 结构化结算导出打通」双路径,所有原始字段均无损留存于 `unified_reports.raw_fields_json`。
  118. ---
  119. ## 6. 一站式快速安装与部署
  120. ### 方式 A:源码编译运行(5 分钟体验全量模拟数据)
  121. ```bash
  122. git clone https://github.com/zyfjacksonchen-source/adlink.git
  123. cd adlink
  124. # 编译 Release 二进制
  125. cargo build --release -p adlink-cli
  126. # 启动一体化服务(REST API + Streamable HTTP /mcp + Legacy SSE /sse + Web 控制台)
  127. # 自动播种「星图智投」全套人户关系/项目分类/创意归因及 30 天 10 平台模拟数据
  128. ./target/release/adlink serve --config config/adlink.mock.toml --seed-mock
  129. ```
  130. 启动后访问:
  131. - **Web 控制台**:`http://127.0.0.1:8787/`
  132. - **MCP Streamable HTTP**:`http://127.0.0.1:8787/mcp`
  133. - **MCP Legacy SSE**:`http://127.0.0.1:8787/sse`
  134. - **OpenAPI 3.1 规范**:`http://127.0.0.1:8787/api/v1/openapi.json`
  135. - **Schema-Driven UI 契约**:`http://127.0.0.1:8787/api/v1/ui/schema`
  136. ### 方式 B:Docker 一键部署
  137. ```bash
  138. cp config/adlink.example.toml config/adlink.local.toml
  139. # 在 .env 中填入 ADLINK_API_KEY 及各媒体凭据(或先用 mock 模式跑通)
  140. docker compose up -d --build
  141. ```
  142. ### 常用 CLI 命令
  143. ```bash
  144. # 诊断配置、SQLite WAL、内核插件与连接器状态
  145. adlink doctor --config config/adlink.mock.toml
  146. # 并发回溯 180 天历史数据
  147. adlink sync --config config/adlink.mock.toml --start 2026-05-01 --end 2026-10-27 --concurrency 16
  148. # 一键生成任意客户端 MCP 配置 (workbuddy/kimiwork/traework/doubao/qianwen/claude-code/codex/antigravity/cursor/grokbot/muse/dots)
  149. adlink mcp-config --client workbuddy
  150. adlink mcp-config --client codex
  151. ```
  152. ---
  153. ## 7. 国内外主流 Agent MCP 适配矩阵
  154. AdLink 同时支持 **Stdio**、**Streamable HTTP (2025/2026 有状态 & 无状态)**、**Legacy SSE**,开箱适配:
  155. | 客户端类型 | 代表产品 | 推荐接入模式 | 现成配置模板 |
  156. | :--- | :--- | :--- | :--- |
  157. | **国内办公/工作台 Agent** | WorkBuddy、KimiWork、TraeWork、豆包工作、千问办公 | Streamable HTTP (`/mcp`) / Legacy SSE (`/sse`) / Stdio | [streamable-http-clients.json](config/agents/streamable-http-clients.json) |
  158. | **海外主流 AI 编程工具** | Claude Code、Codex、Antigravity、Cursor | `adlink mcp-stdio` 或 `/mcp` | [stdio-desktop-clients.json](config/agents/stdio-desktop-clients.json) · [codex.toml](config/agents/codex.toml) |
  159. | **Personal Agent** | GrokBot、Muse、Dots | Streamable HTTP (`/mcp`) / Stdio | `adlink mcp-config --client grokbot` |
  160. | **企业自建 Agent / 编排** | Dify、Coze、FastGPT、LangGraph、自研 Agent | `/mcp` 或 `/api/v1/openapi.json` | [openapi.rs](crates/adlink-api/src/openapi.rs) |
  161. ### 引导用户 Agent 连接真实媒体 API
  162. 部署完成后,您的 AI Agent 可直接读取项目内置的 **[AGENT_GUIDE.md](AGENT_GUIDE.md)** 与 **[SKILL.md](SKILL.md)**,或调用 MCP 工具(共 **24 个工具**):
  163. 1. `adlink_platform_catalog` & `adlink_onboard_guide` — 获取全部平台逐字段映射、认证步骤与创编能力说明。
  164. 2. `adlink_discover_platform_accounts` — 最优走官方 MCP 鉴权桥接、降级走媒体 API 直接拉取授权子账户列表。
  165. 3. `adlink_relabel_account_governance`(重标人-户-项目关系)与 `adlink_fallback_bootstrap_project`(降级自建项目关联子账户)。
  166. ### 广告创编(`[ad_creation]`):默认关闭 · 主动询问 · 风险强提醒
  167. AdLink 已接入多平台广告创编能力(`adlink_creation_status_and_risks`、`adlink_ad_create` 与 `POST /api/v1/ad-creation/create`),但出于企业资金与合规安全原则,**默认恒为关闭**:
  168. - **默认行为**:`[ad_creation]` 中 `enabled = false`、`risk_acknowledged = false`;未授权调用创编时直接拦截并要求 Agent **先询问用户『是否需要接入广告创编(新建计划/单元/创意)能力?』**。
  169. - **强制 5 项风险提示**:(1)真实资金消耗与跨平台单位差异(快手创编用**厘**、腾讯/小红书用**分**、巨量用**元**);(2)素材/文案审核拒审与账户封禁风险;(3)定向/落地页/归因错配风险;(4)媒体架构与白名单差异(腾讯 AMS v3.0 两层架构、小红书/B站需白名单、支付宝灯火/蒲公英/花火无公开自助创编 API);(5)即便显式开启,仍强制 `initial_status = "PAUSED"` 暂停态创建、强制先过 `dry_run = true` 预览、受预算/出价硬上限保护并全量写入不可变审计日志。
  170. 详见逐字段核对表:[docs/platform-api-mapping.md](docs/platform-api-mapping.md)。
  171. ---
  172. ## 8. 口径治理与创作工作量归因体系
  173. - **消耗口径(Spend Calibers)**:
  174. - `账面总消耗` = 现金消耗 + 赠款消耗
  175. - `现金消耗` = 仅计算真实现金扣款(对照日结资金流水)
  176. - `返点后净消耗` = 账面消耗 × `(1 - rebate_rate)`
  177. - `全域投入成本` = 账面消耗 + 达人商单费 + 平台服务费 + 内部创作成本
  178. - **业绩口径(Performance Calibers)**:
  179. - `代理商毛流水`、`代理商净营收`(媒体返点 + 客户服务费)、`平台回传 GMV`、`品牌净 ROI`
  180. - **自定义口径(Custom AST DSL)**:支持安全的纯 Rust AST 公式解析,例如:
  181. ```text
  182. safe_div(gmv_yuan, net_after_rebate_yuan + kol_order_fee_yuan + platform_service_fee_yuan)
  183. ```
  184. - **内部创作工作量与投放数据打通**:支持为每条创意记录编导/拍摄/剪辑/设计的 `work_hours` 与 `credit_weight`,自动聚合出每个创作者的 `gmv_per_work_hour_yuan`(单小时产出 GMV)和 `spend_per_work_hour_yuan`;同时通过 `note_id`(蒲公英+聚光/乘风)与 `bvid`(花火+三连起飞)实现种草+付费加热闭环归因。
  185. ---
  186. ## 9. 网页与小程序多端自定义 (Headless + Schema-Driven UI)
  187. AdLink 内置零构建依赖的 `web-starter/` 控制台与 `web-starter/miniprogram-sdk/adlink-mp.js` 小程序 SDK:
  188. - 更换自定义前端只需将您的 React / Vue / Next.js 构建产物目录通过 `--web-dir ./my-dist` 传入即可;
  189. - 前端通过 `GET /api/v1/ui/schema` 动态获取口径选项、导航菜单与平台列表,实现真正的后端解耦多端定制。
  190. ---
  191. ## 10. 开源协议
  192. 本项目采用 **[Apache License 2.0](LICENSE)** 开源,可放心用于商业交付、企业自建及二次开发。详见 [LICENSE](LICENSE) 与 [NOTICE](NOTICE)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.