Главная Обзор Помощь
Вход
howard
/
Agent
1
0
Ответвить 0
Файлы Задачи 0 Запросы на слияние 0 Вики
Дерево: 62da182e4e
Ветки Метки
Agent
/
examples
/
auto_put_ad_mini
/
ARCHITECTURE.html

ARCHITECTURE.html 61 KB
История Исходник

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817 
  1. <!DOCTYPE html>
    2. 

  2. <html lang="zh-CN">
    3. 

  3. <head>
    4. 

  4. <meta charset="UTF-8">
    5. 

  5. <meta name="viewport" content="width=device-width, initial-scale=1.0">
    6. 

  6. <title>auto_put_ad_mini · 系统架构图谱</title>
    7. 

  7. <link rel="preconnect" href="https://fonts.googleapis.com">
    8. 

  8. <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
    9. 

  9. <link href="https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght,SOFT@9..144,300..900,0..100&family=IBM+Plex+Sans:wght@300;400;500;600&family=JetBrains+Mono:wght@400;500;700&family=Noto+Serif+SC:wght@400;500;700&family=Noto+Sans+SC:wght@300;400;500;700&display=swap" rel="stylesheet">
    10. 

  10. <style>
    11. 

  11. :root {
    12. 

  12.   --bg: #0E141B;
    13. 

  13.   --bg-alt: #141C26;
    14. 

  14.   --panel: #1A2330;
    15. 

  15.   --panel-hi: #212C3D;
    16. 

  16.   --border: #2A3849;
    17. 

  17.   --border-hi: #3D5066;
    18. 

  18.   --text: #E8E1D3;
    19. 

  19.   --text-dim: #B8B0A1;
    20. 

  20.   --text-muted: #7A8294;
    21. 

  21.   --grid: #1F2A38;
    22. 

  22. 

  23.   --tools: #E0A458;
    24. 

  24.   --tools-soft: #E0A45822;
    25. 

  25.   --skills: #A4B494;
    26. 

  26.   --skills-soft: #A4B49422;
    27. 

  27.   --decisions: #5BC0BE;
    28. 

  28.   --decisions-soft: #5BC0BE22;
    29. 

  29.   --rules: #F25F5C;
    30. 

  30.   --rules-soft: #F25F5C22;
    31. 

  31.   --data: #6B9FB5;
    32. 

  32.   --data-soft: #6B9FB522;
    33. 

  33.   --gold: #D4AF37;
    34. 

  34. 

  35.   --serif: "Fraunces", "Noto Serif SC", Georgia, serif;
    36. 

  36.   --sans: "IBM Plex Sans", "Noto Sans SC", system-ui, sans-serif;
    37. 

  37.   --mono: "JetBrains Mono", "SF Mono", Consolas, monospace;
    38. 

  38. }
    39. 

  39. 

  40. * { box-sizing: border-box; margin: 0; padding: 0; }
    41. 

  41. 

  42. html { scroll-behavior: smooth; }
    43. 

  43. 

  44. body {
    45. 

  45.   background: var(--bg);
    46. 

  46.   color: var(--text);
    47. 

  47.   font-family: var(--sans);
    48. 

  48.   font-weight: 400;
    49. 

  49.   line-height: 1.6;
    50. 

  50.   letter-spacing: 0.005em;
    51. 

  51.   min-height: 100vh;
    52. 

  52.   overflow-x: hidden;
    53. 

  53.   background-image:
    54. 

  54.     radial-gradient(at 20% 0%, rgba(91, 192, 190, 0.08) 0px, transparent 40%),
    55. 

  55.     radial-gradient(at 80% 100%, rgba(224, 164, 88, 0.06) 0px, transparent 50%),
    56. 

  56.     linear-gradient(0deg, var(--bg) 0%, #0A0F15 100%);
    57. 

  57. }
    58. 

  58. 

  59. /* Subtle grain overlay */
    60. 

  60. body::before {
    61. 

  61.   content: "";
    62. 

  62.   position: fixed;
    63. 

  63.   inset: 0;
    64. 

  64.   pointer-events: none;
    65. 

  65.   z-index: 1;
    66. 

  66.   opacity: 0.025;
    67. 

  67.   background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='200' height='200'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' /%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E");
    68. 

  68. }
    69. 

  69. 

  70. main { position: relative; z-index: 2; }
    71. 

  71. 

  72. /* ====== HEADER ====== */
    73. 

  73. .hero {
    74. 

  74.   padding: 80px 60px 100px;
    75. 

  75.   border-bottom: 1px solid var(--border);
    76. 

  76.   position: relative;
    77. 

  77.   overflow: hidden;
    78. 

  78. }
    79. 

  79. 

  80. .hero::before {
    81. 

  81.   content: "";
    82. 

  82.   position: absolute;
    83. 

  83.   inset: 0;
    84. 

  84.   background:
    85. 

  85.     repeating-linear-gradient(0deg, transparent 0, transparent 49px, var(--grid) 49px, var(--grid) 50px),
    86. 

  86.     repeating-linear-gradient(90deg, transparent 0, transparent 49px, var(--grid) 49px, var(--grid) 50px);
    87. 

  87.   opacity: 0.4;
    88. 

  88.   pointer-events: none;
    89. 

  89.   mask-image: radial-gradient(ellipse at 30% 50%, black 30%, transparent 80%);
    90. 

  90. }
    91. 

  91. 

  92. .hero-inner { position: relative; max-width: 1400px; margin: 0 auto; }
    93. 

  93. 

  94. .eyebrow {
    95. 

  95.   font-family: var(--mono);
    96. 

  96.   font-size: 11px;
    97. 

  97.   text-transform: uppercase;
    98. 

  98.   letter-spacing: 0.25em;
    99. 

  99.   color: var(--tools);
    100. 

  100.   margin-bottom: 28px;
    101. 

  101.   display: flex;
    102. 

  102.   align-items: center;
    103. 

  103.   gap: 12px;
    104. 

  104. }
    105. 

  105. 

  106. .eyebrow::before {
    107. 

  107.   content: "";
    108. 

  108.   display: block;
    109. 

  109.   width: 32px;
    110. 

  110.   height: 1px;
    111. 

  111.   background: var(--tools);
    112. 

  112. }
    113. 

  113. 

  114. h1.title {
    115. 

  115.   font-family: var(--serif);
    116. 

  116.   font-weight: 300;
    117. 

  117.   font-size: clamp(48px, 8vw, 112px);
    118. 

  118.   line-height: 0.95;
    119. 

  119.   letter-spacing: -0.03em;
    120. 

  120.   color: var(--text);
    121. 

  121.   margin-bottom: 24px;
    122. 

  122.   font-feature-settings: "ss01", "ss02";
    123. 

  123.   font-variation-settings: "opsz" 144, "SOFT" 30;
    124. 

  124. }
    125. 

  125. 

  126. h1.title em {
    127. 

  127.   font-style: italic;
    128. 

  128.   color: var(--tools);
    129. 

  129.   font-variation-settings: "opsz" 144, "SOFT" 100;
    130. 

  130. }
    131. 

  131. 

  132. .tagline {
    133. 

  133.   font-family: var(--serif);
    134. 

  134.   font-size: 24px;
    135. 

  135.   font-weight: 300;
    136. 

  136.   font-style: italic;
    137. 

  137.   color: var(--text-dim);
    138. 

  138.   max-width: 720px;
    139. 

  139.   margin-bottom: 48px;
    140. 

  140.   line-height: 1.4;
    141. 

  141.   font-variation-settings: "opsz" 24;
    142. 

  142. }
    143. 

  143. 

  144. .meta-grid {
    145. 

  145.   display: grid;
    146. 

  146.   grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
    147. 

  147.   gap: 32px 48px;
    148. 

  148.   padding-top: 32px;
    149. 

  149.   border-top: 1px solid var(--border);
    150. 

  150.   max-width: 1100px;
    151. 

  151. }
    152. 

  152. 

  153. .meta-item {
    154. 

  154.   display: flex;
    155. 

  155.   flex-direction: column;
    156. 

  156.   gap: 6px;
    157. 

  157. }
    158. 

  158. 

  159. .meta-label {
    160. 

  160.   font-family: var(--mono);
    161. 

  161.   font-size: 10px;
    162. 

  162.   text-transform: uppercase;
    163. 

  163.   letter-spacing: 0.18em;
    164. 

  164.   color: var(--text-muted);
    165. 

  165. }
    166. 

  166. 

  167. .meta-value {
    168. 

  168.   font-family: var(--mono);
    169. 

  169.   font-size: 14px;
    170. 

  170.   color: var(--text);
    171. 

  171.   font-weight: 500;
    172. 

  172. }
    173. 

  173. 

  174. .meta-value.accent { color: var(--tools); }
    175. 

  175. 

  176. /* ====== SECTIONS ====== */
    177. 

  177. section {
    178. 

  178.   padding: 100px 60px;
    179. 

  179.   max-width: 1400px;
    180. 

  180.   margin: 0 auto;
    181. 

  181.   border-bottom: 1px solid var(--border);
    182. 

  182. }
    183. 

  183. 

  184. .section-head {
    185. 

  185.   display: flex;
    186. 

  186.   align-items: baseline;
    187. 

  187.   justify-content: space-between;
    188. 

  188.   margin-bottom: 60px;
    189. 

  189.   gap: 40px;
    190. 

  190.   flex-wrap: wrap;
    191. 

  191. }
    192. 

  192. 

  193. .section-num {
    194. 

  194.   font-family: var(--mono);
    195. 

  195.   font-size: 13px;
    196. 

  196.   color: var(--text-muted);
    197. 

  197.   letter-spacing: 0.2em;
    198. 

  198. }
    199. 

  199. 

  200. .section-title {
    201. 

  201.   font-family: var(--serif);
    202. 

  202.   font-weight: 300;
    203. 

  203.   font-size: clamp(36px, 5vw, 64px);
    204. 

  204.   line-height: 1.05;
    205. 

  205.   letter-spacing: -0.02em;
    206. 

  206.   flex: 1;
    207. 

  207.   font-variation-settings: "opsz" 96, "SOFT" 40;
    208. 

  208. }
    209. 

  209. 

  210. .section-title em {
    211. 

  211.   font-style: italic;
    212. 

  212.   font-variation-settings: "opsz" 96, "SOFT" 100;
    213. 

  213. }
    214. 

  214. 

  215. .section-title.tools em { color: var(--tools); }
    216. 

  216. .section-title.skills em { color: var(--skills); }
    217. 

  217. .section-title.decisions em { color: var(--decisions); }
    218. 

  218. .section-title.rules em { color: var(--rules); }
    219. 

  219. .section-title.data em { color: var(--data); }
    220. 

  220. 

  221. .section-desc {
    222. 

  222.   font-family: var(--serif);
    223. 

  223.   font-style: italic;
    224. 

  224.   font-size: 16px;
    225. 

  225.   color: var(--text-dim);
    226. 

  226.   max-width: 480px;
    227. 

  227.   font-weight: 300;
    228. 

  228.   line-height: 1.5;
    229. 

  229. }
    230. 

  230. 

  231. /* ====== ARCHITECTURE LAYERS ====== */
    232. 

  232. .layer-stack {
    233. 

  233.   display: grid;
    234. 

  234.   gap: 24px;
    235. 

  235. }
    236. 

  236. 

  237. .layer {
    238. 

  238.   display: grid;
    239. 

  239.   grid-template-columns: 180px 1fr;
    240. 

  240.   gap: 32px;
    241. 

  241.   padding: 32px 36px;
    242. 

  242.   background: var(--panel);
    243. 

  243.   border: 1px solid var(--border);
    244. 

  244.   border-left-width: 3px;
    245. 

  245.   position: relative;
    246. 

  246.   transition: all 0.3s ease;
    247. 

  247. }
    248. 

  248. 

  249. .layer:hover {
    250. 

  250.   background: var(--panel-hi);
    251. 

  251.   border-left-width: 6px;
    252. 

  252. }
    253. 

  253. 

  254. .layer-1 { border-left-color: var(--tools); }
    255. 

  255. .layer-2 { border-left-color: var(--skills); }
    256. 

  256. .layer-3 { border-left-color: var(--decisions); }
    257. 

  257. .layer-4 { border-left-color: var(--rules); }
    258. 

  258. 

  259. .layer-id {
    260. 

  260.   font-family: var(--mono);
    261. 

  261.   font-size: 12px;
    262. 

  262.   letter-spacing: 0.15em;
    263. 

  263.   color: var(--text-muted);
    264. 

  264.   text-transform: uppercase;
    265. 

  265.   margin-bottom: 8px;
    266. 

  266. }
    267. 

  267. 

  268. .layer-name {
    269. 

  269.   font-family: var(--serif);
    270. 

  270.   font-size: 28px;
    271. 

  271.   font-weight: 400;
    272. 

  272.   line-height: 1.1;
    273. 

  273.   letter-spacing: -0.01em;
    274. 

  274.   font-variation-settings: "opsz" 32;
    275. 

  275. }
    276. 

  276. 

  277. .layer-content { font-size: 14px; line-height: 1.7; }
    278. 

  278. 

  279. .layer-content code {
    280. 

  280.   font-family: var(--mono);
    281. 

  281.   font-size: 12.5px;
    282. 

  282.   color: var(--tools);
    283. 

  283.   background: var(--bg-alt);
    284. 

  284.   padding: 2px 6px;
    285. 

  285.   border-radius: 2px;
    286. 

  286. }
    287. 

  287. 

  288. .layer-content ul {
    289. 

  289.   list-style: none;
    290. 

  290.   display: grid;
    291. 

  291.   grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
    292. 

  292.   gap: 12px;
    293. 

  293.   margin-top: 8px;
    294. 

  294. }
    295. 

  295. 

  296. .layer-content ul li {
    297. 

  297.   padding: 10px 14px;
    298. 

  298.   background: var(--bg-alt);
    299. 

  299.   border-left: 2px solid var(--border-hi);
    300. 

  300.   font-size: 13px;
    301. 

  301.   color: var(--text-dim);
    302. 

  302. }
    303. 

  303. 

  304. .layer-content ul li strong {
    305. 

  305.   color: var(--text);
    306. 

  306.   font-weight: 500;
    307. 

  307. }
    308. 

  308. 

  309. /* ====== PIPELINE ====== */
    310. 

  310. .pipeline {
    311. 

  311.   display: grid;
    312. 

  312.   gap: 0;
    313. 

  313.   position: relative;
    314. 

  314. }
    315. 

  315. 

  316. .pipeline-step {
    317. 

  317.   display: grid;
    318. 

  318.   grid-template-columns: 80px 1fr 280px;
    319. 

  319.   gap: 32px;
    320. 

  320.   padding: 32px 0;
    321. 

  321.   border-top: 1px solid var(--border);
    322. 

  322.   position: relative;
    323. 

  323.   transition: background 0.25s ease;
    324. 

  324. }
    325. 

  325. 

  326. .pipeline-step:hover { background: rgba(91, 192, 190, 0.03); }
    327. 

  327. 

  328. .pipeline-step:last-child { border-bottom: 1px solid var(--border); }
    329. 

  329. 

  330. .step-num {
    331. 

  331.   font-family: var(--serif);
    332. 

  332.   font-style: italic;
    333. 

  333.   font-size: 88px;
    334. 

  334.   line-height: 0.9;
    335. 

  335.   font-weight: 300;
    336. 

  336.   color: var(--decisions);
    337. 

  337.   letter-spacing: -0.04em;
    338. 

  338.   font-variation-settings: "opsz" 144, "SOFT" 80;
    339. 

  339.   opacity: 0.85;
    340. 

  340. }
    341. 

  341. 

  342. .step-body { padding-top: 16px; }
    343. 

  343. 

  344. .step-name {
    345. 

  345.   font-family: var(--serif);
    346. 

  346.   font-size: 26px;
    347. 

  347.   font-weight: 400;
    348. 

  348.   margin-bottom: 8px;
    349. 

  349.   letter-spacing: -0.01em;
    350. 

  350.   font-variation-settings: "opsz" 32;
    351. 

  351. }
    352. 

  352. 

  353. .step-tool {
    354. 

  354.   display: inline-block;
    355. 

  355.   font-family: var(--mono);
    356. 

  356.   font-size: 11.5px;
    357. 

  357.   color: var(--tools);
    358. 

  358.   background: var(--tools-soft);
    359. 

  359.   padding: 3px 10px;
    360. 

  360.   margin-bottom: 14px;
    361. 

  361.   border: 1px solid var(--tools);
    362. 

  362.   border-radius: 2px;
    363. 

  363. }
    364. 

  364. 

  365. .step-desc {
    366. 

  366.   font-size: 14.5px;
    367. 

  367.   color: var(--text-dim);
    368. 

  368.   line-height: 1.65;
    369. 

  369.   max-width: 600px;
    370. 

  370. }
    371. 

  371. 

  372. .step-io {
    373. 

  373.   padding-top: 18px;
    374. 

  374.   font-family: var(--mono);
    375. 

  375.   font-size: 11.5px;
    376. 

  376.   color: var(--text-muted);
    377. 

  377.   display: grid;
    378. 

  378.   gap: 6px;
    379. 

  379. }
    380. 

  380. 

  381. .step-io span {
    382. 

  382.   display: flex;
    383. 

  383.   gap: 8px;
    384. 

  384. }
    385. 

  385. 

  386. .step-io span::before {
    387. 

  387.   content: "→";
    388. 

  388.   color: var(--data);
    389. 

  389.   font-weight: bold;
    390. 

  390. }
    391. 

  391. 

  392. .step-io.input span::before { content: "↓"; color: var(--data); }
    393. 

  393. .step-io.output span::before { content: "↑"; color: var(--decisions); }
    394. 

  394. 

  395. /* ====== SKILLS GRID ====== */
    396. 

  396. .skills-grid {
    397. 

  397.   display: grid;
    398. 

  398.   grid-template-columns: repeat(2, 1fr);
    399. 

  399.   gap: 4px;
    400. 

  400.   background: var(--border);
    401. 

  401.   border: 1px solid var(--border);
    402. 

  402. }
    403. 

  403. 

  404. .skill-card {
    405. 

  405.   background: var(--panel);
    406. 

  406.   padding: 36px 36px 32px;
    407. 

  407.   position: relative;
    408. 

  408.   transition: all 0.3s ease;
    409. 

  409.   cursor: default;
    410. 

  410. }
    411. 

  411. 

  412. .skill-card:hover {
    413. 

  413.   background: var(--panel-hi);
    414. 

  414.   transform: translateZ(0);
    415. 

  415. }
    416. 

  416. 

  417. .skill-card.featured {
    418. 

  418.   grid-column: span 2;
    419. 

  419.   background: linear-gradient(135deg, var(--panel) 0%, #1F2A36 100%);
    420. 

  420. }
    421. 

  421. 

  422. .skill-rank {
    423. 

  423.   position: absolute;
    424. 

  424.   top: 24px;
    425. 

  425.   right: 28px;
    426. 

  426.   font-family: var(--mono);
    427. 

  427.   font-size: 11px;
    428. 

  428.   letter-spacing: 0.15em;
    429. 

  429.   color: var(--text-muted);
    430. 

  430.   text-transform: uppercase;
    431. 

  431. }
    432. 

  432. 

  433. .skill-rank.core {
    434. 

  434.   color: var(--gold);
    435. 

  435. }
    436. 

  436. 

  437. .skill-rank.core::before {
    438. 

  438.   content: "◆ ";
    439. 

  439.   color: var(--gold);
    440. 

  440. }
    441. 

  441. 

  442. .skill-name {
    443. 

  443.   font-family: var(--mono);
    444. 

  444.   font-size: 13px;
    445. 

  445.   letter-spacing: 0.1em;
    446. 

  446.   color: var(--skills);
    447. 

  447.   margin-bottom: 14px;
    448. 

  448. }
    449. 

  449. 

  450. .skill-headline {
    451. 

  451.   font-family: var(--serif);
    452. 

  452.   font-size: 28px;
    453. 

  453.   font-weight: 400;
    454. 

  454.   line-height: 1.15;
    455. 

  455.   letter-spacing: -0.01em;
    456. 

  456.   margin-bottom: 16px;
    457. 

  457.   font-variation-settings: "opsz" 32, "SOFT" 30;
    458. 

  458. }
    459. 

  459. 

  460. .skill-card.featured .skill-headline {
    461. 

  461.   font-size: 36px;
    462. 

  462.   font-style: italic;
    463. 

  463.   font-variation-settings: "opsz" 48, "SOFT" 80;
    464. 

  464. }
    465. 

  465. 

  466. .skill-meta {
    467. 

  467.   font-family: var(--mono);
    468. 

  468.   font-size: 11px;
    469. 

  469.   color: var(--text-muted);
    470. 

  470.   margin-bottom: 18px;
    471. 

  471.   letter-spacing: 0.05em;
    472. 

  472. }
    473. 

  473. 

  474. .skill-desc {
    475. 

  475.   font-size: 14px;
    476. 

  476.   color: var(--text-dim);
    477. 

  477.   line-height: 1.7;
    478. 

  478.   margin-bottom: 20px;
    479. 

  479. }
    480. 

  480. 

  481. .skill-sections {
    482. 

  482.   display: flex;
    483. 

  483.   flex-wrap: wrap;
    484. 

  484.   gap: 6px;
    485. 

  485. }
    486. 

  486. 

  487. .skill-tag {
    488. 

  488.   font-family: var(--mono);
    489. 

  489.   font-size: 10.5px;
    490. 

  490.   padding: 4px 10px;
    491. 

  491.   background: var(--bg-alt);
    492. 

  492.   color: var(--text-dim);
    493. 

  493.   border: 1px solid var(--border);
    494. 

  494.   letter-spacing: 0.03em;
    495. 

  495. }
    496. 

  496. 

  497. .skill-card.featured .skill-tag {
    498. 

  498.   border-color: var(--decisions);
    499. 

  499.   color: var(--decisions);
    500. 

  500. }
    501. 

  501. 

  502. /* ====== TOOLS NETWORK ====== */
    503. 

  503. .tools-table {
    504. 

  504.   display: grid;
    505. 

  505.   grid-template-columns: 1fr;
    506. 

  506.   gap: 0;
    507. 

  507.   border: 1px solid var(--border);
    508. 

  508.   background: var(--panel);
    509. 

  509. }
    510. 

  510. 

  511. .tools-row {
    512. 

  512.   display: grid;
    513. 

  513.   grid-template-columns: 240px 200px 1fr 140px;
    514. 

  514.   gap: 24px;
    515. 

  515.   padding: 18px 28px;
    516. 

  516.   border-bottom: 1px solid var(--border);
    517. 

  517.   align-items: center;
    518. 

  518.   transition: background 0.2s;
    519. 

  519. }
    520. 

  520. 

  521. .tools-row:last-child { border-bottom: none; }
    522. 

  522. .tools-row:hover { background: var(--panel-hi); }
    523. 

  523. 

  524. .tools-row.head {
    525. 

  525.   background: var(--bg-alt);
    526. 

  526.   border-bottom: 2px solid var(--border-hi);
    527. 

  527. }
    528. 

  528. 

  529. .tools-row.head > div {
    530. 

  530.   font-family: var(--mono);
    531. 

  531.   font-size: 10.5px;
    532. 

  532.   text-transform: uppercase;
    533. 

  533.   letter-spacing: 0.18em;
    534. 

  534.   color: var(--text-muted);
    535. 

  535. }
    536. 

  536. 

  537. .tool-file {
    538. 

  538.   font-family: var(--mono);
    539. 

  539.   font-size: 13px;
    540. 

  540.   color: var(--tools);
    541. 

  541. }
    542. 

  542. 

  543. .tool-cat {
    544. 

  544.   font-family: var(--mono);
    545. 

  545.   font-size: 11.5px;
    546. 

  546.   letter-spacing: 0.05em;
    547. 

  547.   text-transform: uppercase;
    548. 

  548. }
    549. 

  549. 

  550. .tool-cat.data { color: var(--data); }
    551. 

  551. .tool-cat.compute { color: var(--decisions); }
    552. 

  552. .tool-cat.decide { color: var(--skills); }
    553. 

  553. .tool-cat.execute { color: var(--rules); }
    554. 

  554. .tool-cat.report { color: var(--gold); }
    555. 

  555. 

  556. .tool-fn {
    557. 

  557.   font-size: 13px;
    558. 

  558.   color: var(--text-dim);
    559. 

  559.   line-height: 1.6;
    560. 

  560. }
    561. 

  561. 

  562. .tool-fn code {
    563. 

  563.   font-family: var(--mono);
    564. 

  564.   font-size: 12px;
    565. 

  565.   color: var(--text);
    566. 

  566.   background: var(--bg);
    567. 

  567.   padding: 1px 6px;
    568. 

  568.   border-radius: 2px;
    569. 

  569. }
    570. 

  570. 

  571. .tool-step {
    572. 

  572.   font-family: var(--mono);
    573. 

  573.   font-size: 11px;
    574. 

  574.   color: var(--text-muted);
    575. 

  575.   text-align: right;
    576. 

  576. }
    577. 

  577. 

  578. /* ====== DECISION FRAMEWORK ====== */
    579. 

  579. .decision-arch {
    580. 

  580.   display: grid;
    581. 

  581.   grid-template-columns: 1fr 1fr;
    582. 

  582.   gap: 60px;
    583. 

  583.   align-items: start;
    584. 

  584. }
    585. 

  585. 

  586. .decision-tower {
    587. 

  587.   display: grid;
    588. 

  588.   gap: 12px;
    589. 

  589. }
    590. 

  590. 

  591. .tier {
    592. 

  592.   position: relative;
    593. 

  593.   padding: 28px 32px;
    594. 

  594.   background: var(--panel);
    595. 

  595.   border: 1px solid var(--border);
    596. 

  596. }
    597. 

  597. 

  598. .tier::before {
    599. 

  599.   content: "";
    600. 

  600.   position: absolute;
    601. 

  601.   left: 0;
    602. 

  602.   top: 0;
    603. 

  603.   bottom: 0;
    604. 

  604.   width: 4px;
    605. 

  605. }
    606. 

  606. 

  607. .tier-1::before { background: var(--rules); }
    608. 

  608. .tier-2::before { background: var(--data); }
    609. 

  609. .tier-3::before { background: var(--decisions); }
    610. 

  610. .tier-4::before { background: var(--skills); }
    611. 

  611. 

  612. .tier-label {
    613. 

  613.   font-family: var(--mono);
    614. 

  614.   font-size: 11px;
    615. 

  615.   letter-spacing: 0.2em;
    616. 

  616.   margin-bottom: 6px;
    617. 

  617.   text-transform: uppercase;
    618. 

  618. }
    619. 

  619. 

  620. .tier-1 .tier-label { color: var(--rules); }
    621. 

  621. .tier-2 .tier-label { color: var(--data); }
    622. 

  622. .tier-3 .tier-label { color: var(--decisions); }
    623. 

  623. .tier-4 .tier-label { color: var(--skills); }
    624. 

  624. 

  625. .tier-name {
    626. 

  626.   font-family: var(--serif);
    627. 

  627.   font-size: 22px;
    628. 

  628.   font-weight: 400;
    629. 

  629.   margin-bottom: 8px;
    630. 

  630.   font-variation-settings: "opsz" 24;
    631. 

  631. }
    632. 

  632. 

  633. .tier-desc {
    634. 

  634.   font-size: 13.5px;
    635. 

  635.   color: var(--text-dim);
    636. 

  636.   line-height: 1.65;
    637. 

  637. }
    638. 

  638. 

  639. .tier-desc code {
    640. 

  640.   font-family: var(--mono);
    641. 

  641.   font-size: 12px;
    642. 

  642.   color: var(--text);
    643. 

  643.   background: var(--bg-alt);
    644. 

  644.   padding: 1px 5px;
    645. 

  645.   border-radius: 2px;
    646. 

  646. }
    647. 

  647. 

  648. /* Actions panel */
    649. 

  649. .actions-panel {
    650. 

  650.   background: var(--panel);
    651. 

  651.   border: 1px solid var(--border);
    652. 

  652.   padding: 32px;
    653. 

  653. }
    654. 

  654. 

  655. .actions-head {
    656. 

  656.   font-family: var(--serif);
    657. 

  657.   font-size: 22px;
    658. 

  658.   font-weight: 400;
    659. 

  659.   margin-bottom: 24px;
    660. 

  660.   font-variation-settings: "opsz" 24;
    661. 

  661. }
    662. 

  662. 

  663. .actions-list { display: grid; gap: 14px; }
    664. 

  664. 

  665. .action-row {
    666. 

  666.   display: grid;
    667. 

  667.   grid-template-columns: 110px 1fr;
    668. 

  668.   gap: 16px;
    669. 

  669.   padding: 12px 0;
    670. 

  670.   border-bottom: 1px solid var(--border);
    671. 

  671. }
    672. 

  672. 

  673. .action-row:last-child { border-bottom: none; }
    674. 

  674. 

  675. .action-name {
    676. 

  676.   font-family: var(--mono);
    677. 

  677.   font-size: 13px;
    678. 

  678.   letter-spacing: 0.05em;
    679. 

  679.   display: flex;
    680. 

  680.   align-items: baseline;
    681. 

  681.   gap: 8px;
    682. 

  682. }
    683. 

  683. 

  684. .action-name .dot {
    685. 

  685.   display: inline-block;
    686. 

  686.   width: 8px;
    687. 

  687.   height: 8px;
    688. 

  688.   border-radius: 50%;
    689. 

  689. }
    690. 

  690. 

  691. .action-name.pause .dot { background: var(--rules); }
    692. 

  692. .action-name.bid_down .dot { background: #FFA94D; }
    693. 

  693. .action-name.bid_up .dot { background: var(--decisions); }
    694. 

  694. .action-name.scale_up .dot { background: var(--skills); }
    695. 

  695. .action-name.creative_adjust .dot { background: var(--gold); }
    696. 

  696. .action-name.observe .dot { background: var(--data); }
    697. 

  697. .action-name.hold .dot { background: var(--text-muted); }
    698. 

  698. 

  699. .action-name code {
    700. 

  700.   color: var(--text);
    701. 

  701. }
    702. 

  702. 

  703. .action-rule {
    704. 

  704.   font-size: 13px;
    705. 

  705.   color: var(--text-dim);
    706. 

  706.   line-height: 1.55;
    707. 

  707. }
    708. 

  708. 

  709. /* ====== THRESHOLDS ====== */
    710. 

  710. .thresholds-grid {
    711. 

  711.   display: grid;
    712. 

  712.   grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    713. 

  713.   gap: 4px;
    714. 

  714.   background: var(--border);
    715. 

  715.   border: 1px solid var(--border);
    716. 

  716. }
    717. 

  717. 

  718. .threshold-card {
    719. 

  719.   background: var(--panel);
    720. 

  720.   padding: 28px;
    721. 

  721.   position: relative;
    722. 

  722.   transition: background 0.25s;
    723. 

  723. }
    724. 

  724. 

  725. .threshold-card:hover { background: var(--panel-hi); }
    726. 

  726. 

  727. .threshold-key {
    728. 

  728.   font-family: var(--mono);
    729. 

  729.   font-size: 11.5px;
    730. 

  730.   color: var(--text-muted);
    731. 

  731.   letter-spacing: 0.08em;
    732. 

  732.   margin-bottom: 14px;
    733. 

  733. }
    734. 

  734. 

  735. .threshold-value {
    736. 

  736.   font-family: var(--serif);
    737. 

  737.   font-size: 56px;
    738. 

  738.   font-weight: 300;
    739. 

  739.   line-height: 1;
    740. 

  740.   font-style: italic;
    741. 

  741.   letter-spacing: -0.03em;
    742. 

  742.   font-variation-settings: "opsz" 96, "SOFT" 100;
    743. 

  743.   margin-bottom: 6px;
    744. 

  744. }
    745. 

  745. 

  746. .threshold-value.tools { color: var(--tools); }
    747. 

  747. .threshold-value.decisions { color: var(--decisions); }
    748. 

  748. .threshold-value.rules { color: var(--rules); }
    749. 

  749. .threshold-value.skills { color: var(--skills); }
    750. 

  750. 

  751. .threshold-unit {
    752. 

  752.   font-family: var(--mono);
    753. 

  753.   font-size: 13px;
    754. 

  754.   color: var(--text-muted);
    755. 

  755.   margin-left: 6px;
    756. 

  756.   font-style: normal;
    757. 

  757.   font-weight: 400;
    758. 

  758. }
    759. 

  759. 

  760. .threshold-meaning {
    761. 

  761.   font-size: 13px;
    762. 

  762.   color: var(--text-dim);
    763. 

  763.   line-height: 1.5;
    764. 

  764.   margin-top: 14px;
    765. 

  765.   padding-top: 14px;
    766. 

  766.   border-top: 1px solid var(--border);
    767. 

  767. }
    768. 

  768. 

  769. /* ====== DATA FLOW ====== */
    770. 

  770. .flow-svg {
    771. 

  771.   width: 100%;
    772. 

  772.   height: auto;
    773. 

  773.   background: var(--panel);
    774. 

  774.   border: 1px solid var(--border);
    775. 

  775.   padding: 20px;
    776. 

  776. }
    777. 

  777. 

  778. .flow-svg text {
    779. 

  779.   font-family: var(--mono);
    780. 

  780.   font-size: 11px;
    781. 

  781.   fill: var(--text-dim);
    782. 

  782. }
    783. 

  783. 

  784. .flow-svg .node {
    785. 

  785.   fill: var(--bg-alt);
    786. 

  786.   stroke: var(--border-hi);
    787. 

  787.   stroke-width: 1;
    788. 

  788. }
    789. 

  789. 

  790. .flow-svg .node-data { stroke: var(--data); }
    791. 

  791. .flow-svg .node-tool { stroke: var(--tools); }
    792. 

  792. .flow-svg .node-decide { stroke: var(--decisions); }
    793. 

  793. .flow-svg .node-act { stroke: var(--rules); }
    794. 

  794. 

  795. .flow-svg .label-bold {
    796. 

  796.   font-family: var(--serif);
    797. 

  797.   font-size: 13px;
    798. 

  798.   fill: var(--text);
    799. 

  799.   font-weight: 500;
    800. 

  800. }
    801. 

  801. 

  802. .flow-svg .arrow {
    803. 

  803.   stroke: var(--border-hi);
    804. 

  804.   stroke-width: 1.5;
    805. 

  805.   fill: none;
    806. 

  806.   marker-end: url(#arrowhead);
    807. 

  807. }
    808. 

  808. 

  809. .flow-svg .arrow-data { stroke: var(--data); }
    810. 

  810. .flow-svg .arrow-decide { stroke: var(--decisions); }
    811. 

  811. 

  812. /* ====== DEPLOYMENT ====== */
    813. 

  813. .deploy-grid {
    814. 

  814.   display: grid;
    815. 

  815.   grid-template-columns: 1fr 1fr;
    816. 

  816.   gap: 32px;
    817. 

  817. }
    818. 

  818. 

  819. .deploy-card {
    820. 

  820.   padding: 32px;
    821. 

  821.   background: var(--panel);
    822. 

  822.   border: 1px solid var(--border);
    823. 

  823. }
    824. 

  824. 

  825. .deploy-mode {
    826. 

  826.   font-family: var(--mono);
    827. 

  827.   font-size: 11px;
    828. 

  828.   letter-spacing: 0.2em;
    829. 

  829.   color: var(--gold);
    830. 

  830.   text-transform: uppercase;
    831. 

  831.   margin-bottom: 12px;
    832. 

  832. }
    833. 

  833. 

  834. .deploy-name {
    835. 

  835.   font-family: var(--serif);
    836. 

  836.   font-size: 26px;
    837. 

  837.   font-weight: 400;
    838. 

  838.   margin-bottom: 16px;
    839. 

  839.   font-variation-settings: "opsz" 32;
    840. 

  840. }
    841. 

  841. 

  842. .deploy-desc {
    843. 

  843.   font-size: 14px;
    844. 

  844.   color: var(--text-dim);
    845. 

  845.   line-height: 1.7;
    846. 

  846.   margin-bottom: 20px;
    847. 

  847. }
    848. 

  848. 

  849. .deploy-files { display: grid; gap: 6px; }
    850. 

  850. 

  851. .deploy-files code {
    852. 

  852.   font-family: var(--mono);
    853. 

  853.   font-size: 12px;
    854. 

  854.   color: var(--text);
    855. 

  855.   display: flex;
    856. 

  856.   align-items: center;
    857. 

  857.   gap: 12px;
    858. 

  858.   padding: 8px 12px;
    859. 

  859.   background: var(--bg-alt);
    860. 

  860.   border-left: 2px solid var(--gold);
    861. 

  861. }
    862. 

  862. 

  863. .deploy-files code span {
    864. 

  864.   color: var(--text-muted);
    865. 

  865.   font-size: 11px;
    866. 

  866. }
    867. 

  867. 

  868. /* ====== FOOTER ====== */
    869. 

  869. footer {
    870. 

  870.   padding: 60px;
    871. 

  871.   text-align: center;
    872. 

  872.   border-top: 1px solid var(--border);
    873. 

  873.   color: var(--text-muted);
    874. 

  874.   font-family: var(--mono);
    875. 

  875.   font-size: 12px;
    876. 

  876.   letter-spacing: 0.1em;
    877. 

  877.   position: relative;
    878. 

  878.   z-index: 2;
    879. 

  879. }
    880. 

  880. 

  881. footer p { margin-bottom: 8px; }
    882. 

  882. 

  883. footer .stamp {
    884. 

  884.   display: inline-block;
    885. 

  885.   margin-top: 24px;
    886. 

  886.   padding: 8px 16px;
    887. 

  887.   border: 1px solid var(--border);
    888. 

  888.   font-family: var(--serif);
    889. 

  889.   font-style: italic;
    890. 

  890.   font-size: 13px;
    891. 

  891.   letter-spacing: 0.03em;
    892. 

  892.   color: var(--text-dim);
    893. 

  893. }
    894. 

  894. 

  895. /* ====== ANIMATIONS ====== */
    896. 

  896. @keyframes fadeUp {
    897. 

  897.   from { opacity: 0; transform: translateY(20px); }
    898. 

  898.   to { opacity: 1; transform: translateY(0); }
    899. 

  899. }
    900. 

  900. 

  901. .hero-inner > * {
    902. 

  902.   animation: fadeUp 0.8s ease-out backwards;
    903. 

  903. }
    904. 

  904. 

  905. .hero-inner > *:nth-child(1) { animation-delay: 0.05s; }
    906. 

  906. .hero-inner > *:nth-child(2) { animation-delay: 0.15s; }
    907. 

  907. .hero-inner > *:nth-child(3) { animation-delay: 0.25s; }
    908. 

  908. .hero-inner > *:nth-child(4) { animation-delay: 0.35s; }
    909. 

  909. 

  910. /* Responsive */
    911. 

  911. @media (max-width: 900px) {
    912. 

  912.   section, .hero { padding-left: 28px; padding-right: 28px; }
    913. 

  913.   .layer { grid-template-columns: 1fr; }
    914. 

  914.   .pipeline-step { grid-template-columns: 60px 1fr; }
    915. 

  915.   .step-io { grid-column: 1 / -1; padding-left: 0; padding-top: 8px; }
    916. 

  916.   .skills-grid, .deploy-grid { grid-template-columns: 1fr; }
    917. 

  917.   .skill-card.featured { grid-column: span 1; }
    918. 

  918.   .decision-arch { grid-template-columns: 1fr; }
    919. 

  919.   .tools-row { grid-template-columns: 1fr; gap: 4px; }
    920. 

  920.   .tools-row > div { padding: 2px 0; }
    921. 

  921.   .tool-step { text-align: left; }
    922. 

  922. }
    923. 

  923. </style>
    924. 

  924. </head>
    925. 

  925. <body>
    926. 

  926. 

  927. <main>
    928. 

  928. 

  929. <!-- ====== HERO ====== -->
    930. 

  930. <header class="hero">
    931. 

  931.   <div class="hero-inner">
    932. 

  932.     <div class="eyebrow">Reson Agent · 业务示例 · v0.4.27</div>
    933. 

  933.     <h1 class="title">auto_put_ad<em>_mini</em></h1>
    934. 

  934.     <p class="tagline">数据驱动的广告调控 Agent —— 把 ODPS 裂变数据、动态 ROI、规则候选与 LLM 综合判断,串成单向链路的 ROI 优化系统。</p>
    935. 

  935.     <div class="meta-grid">
    936. 

  936.       <div class="meta-item">
    937. 

  937.         <span class="meta-label">业务场景</span>
    938. 

  938.         <span class="meta-value">微信小程序投流</span>
    939. 

  939.       </div>
    940. 

  940.       <div class="meta-item">
    941. 

  941.         <span class="meta-label">承载类型</span>
    942. 

  942.         <span class="meta-value">MARKETING_CARRIER_TYPE_<br>MINI_PROGRAM_WECHAT</span>
    943. 

  943.       </div>
    944. 

  944.       <div class="meta-item">
    945. 

  945.         <span class="meta-label">出价模式</span>
    946. 

  946.         <span class="meta-value">BID_MODE_OCPM</span>
    947. 

  947.       </div>
    948. 

  948.       <div class="meta-item">
    949. 

  949.         <span class="meta-label">LLM 后端</span>
    950. 

  950.         <span class="meta-value accent">OpenRouter · Claude Sonnet 4.5</span>
    951. 

  951.       </div>
    952. 

  952.       <div class="meta-item">
    953. 

  953.         <span class="meta-label">数据窗口</span>
    954. 

  954.         <span class="meta-value">14 天 / 7 日均值</span>
    955. 

  955.       </div>
    956. 

  956.       <div class="meta-item">
    957. 

  957.         <span class="meta-label">执行开关</span>
    958. 

  958.         <span class="meta-value">EXECUTION_ENABLED = False</span>
    959. 

  959.       </div>
    960. 

  960.       <div class="meta-item">
    961. 

  961.         <span class="meta-label">入口</span>
    962. 

  962.         <span class="meta-value">run.py · execute_once.py</span>
    963. 

  963.       </div>
    964. 

  964.       <div class="meta-item">
    965. 

  965.         <span class="meta-label">部署</span>
    966. 

  966.         <span class="meta-value">K8s CronJob · 02:00 UTC</span>
    967. 

  967.       </div>
    968. 

  968.     </div>
    969. 

  969.   </div>
    970. 

  970. </header>
    971. 

  971. 

  972. <!-- ====== 01 · ARCHITECTURE LAYERS ====== -->
    973. 

  973. <section id="architecture">
    974. 

  974.   <div class="section-head">
    975. 

  975.     <div>
    976. 

  976.       <div class="section-num">§ 01 — 整体架构</div>
    977. 

  977.       <h2 class="section-title tools">框架与业务的<em>双层解耦</em></h2>
    978. 

  978.     </div>
    979. 

  979.     <p class="section-desc">框架(<code>agent/</code>)只关心 LLM 调度 + 工具调度 + 持久化,完全不感知业务。业务层通过 <code>@tool</code> 装饰器和 <code>.md</code> skill 单向注入,从不反向依赖。</p>
    980. 

  980.   </div>
    981. 

  981. 

  982.   <div class="layer-stack">
    983. 

  983.     <div class="layer layer-1">
    984. 

  984.       <div>
    985. 

  985.         <div class="layer-id">L1 · Framework</div>
    986. 

  986.         <div class="layer-name">Reson Agent</div>
    987. 

  987.       </div>
    988. 

  988.       <div class="layer-content">
    989. 

  989.         <p>通用 Agent 框架,只读,业务零侵入。</p>
    990. 

  990.         <ul>
    991. 

  991.           <li><strong>AgentRunner</strong> · ReAct 主循环 · new/resume/rewind</li>
    992. 

  992.           <li><strong>ToolRegistry</strong> · @tool 装饰器 + JSON Schema</li>
    993. 

  993.           <li><strong>SkillLoader</strong> · 扫 .md + frontmatter 注入 prompt</li>
    994. 

  994.           <li><strong>FileSystemTraceStore</strong> · 持久化 .trace/ + 侧分支</li>
    995. 

  995.           <li><strong>LLM 适配层</strong> · OpenRouter / Qwen / Gemini</li>
    996. 

  996.         </ul>
    997. 

  997.       </div>
    998. 

  998.     </div>
    999. 

  999. 

  1000.     <div class="layer layer-2">
    1001. 

  1001.       <div>
    1002. 

  1002.         <div class="layer-id">L2 · Skills</div>
    1003. 

  1003.         <div class="layer-name">领域知识</div>
    1004. 

  1004.       </div>
    1005. 

  1005.       <div class="layer-content">
    1006. 

  1006.         <p>4 份 markdown,启动时注入 system prompt,定义业务术语 + 决策原则 + 平台硬约束。</p>
    1007. 

  1007.         <ul>
    1008. 

  1008.           <li><strong>ad_domain</strong> · R 值人群 + 裂变变现模型</li>
    1009. 

  1009.           <li><strong>platform_rules</strong> · 腾讯平台硬约束(优先级最高)</li>
    1010. 

  1010.           <li><strong>decision_strategy</strong> · 7 action 决策框架(核心 19.5K)</li>
    1011. 

  1011.           <li><strong>posterior_wisdom</strong> · 后验经验查询入口</li>
    1012. 

  1012.         </ul>
    1013. 

  1013.       </div>
    1014. 

  1014.     </div>
    1015. 

  1015. 

  1016.     <div class="layer layer-3">
    1017. 

  1017.       <div>
    1018. 

  1018.         <div class="layer-id">L3 · Tools</div>
    1019. 

  1019.         <div class="layer-name">业务工具</div>
    1020. 

  1020.       </div>
    1021. 

  1021.       <div class="layer-content">
    1022. 

  1022.         <p>10+ 个工具组成 10 步流水线,从数据采集到决策执行单向流转。</p>
    1023. 

  1023.         <ul>
    1024. 

  1024.           <li><strong>data_query</strong> · ODPS 拉数 + 多日合并</li>
    1025. 

  1025.           <li><strong>roi_calculator</strong> · 创意聚合 + 动态 ROI</li>
    1026. 

  1026.           <li><strong>portfolio_metrics</strong> · 渠道 P50 + tier 基线</li>
    1027. 

  1027.           <li><strong>ad_decision</strong> · 候选标记 + 决策合并</li>
    1028. 

  1028.           <li><strong>guardrails</strong> · 护栏校验</li>
    1029. 

  1029.           <li><strong>execution_engine</strong> · 分级执行 + 审计</li>
    1030. 

  1030.           <li><strong>im_approval</strong> · 飞书审批 + 阻塞 polling</li>
    1031. 

  1031.           <li><strong>report_generator</strong> · Excel 决策表</li>
    1032. 

  1032.           <li><strong>feishu_doc</strong> · 飞书文档 + IM 推送</li>
    1033. 

  1033.           <li><strong>ad_api</strong> · 腾讯广告 API 封装</li>
    1034. 

  1034.         </ul>
    1035. 

  1035.       </div>
    1036. 

  1036.     </div>
    1037. 

  1037. 

  1038.     <div class="layer layer-4">
    1039. 

  1039.       <div>
    1040. 

  1040.         <div class="layer-id">L4 · Config</div>
    1041. 

  1041.         <div class="layer-name">硬约束与开关</div>
    1042. 

  1042.       </div>
    1043. 

  1043.       <div class="layer-content">
    1044. 

  1044.         <p>所有阈值、白名单、执行开关集中于 <code>config.py</code>。运行时可被数据库覆盖。</p>
    1045. 

  1045.         <ul>
    1046. 

  1046.           <li><strong>ROI 阈值</strong> · ROI_LOW_FACTOR = 0.75</li>
    1047. 

  1047.           <li><strong>调价边界</strong> · BID_FLOOR/CEILING = 0.05/1.00 元</li>
    1048. 

  1048.           <li><strong>年龄保护</strong> · COLD_START_DAYS = 3, EARLY_GROWTH_DAYS = 7</li>
    1049. 

  1049.           <li><strong>频率限制</strong> · MAX_ADJUSTMENTS_PER_AD_PER_DAY = 2</li>
    1050. 

  1050.           <li><strong>执行开关</strong> · EXECUTION_ENABLED = False</li>
    1051. 

  1051.         </ul>
    1052. 

  1052.       </div>
    1053. 

  1053.     </div>
    1054. 

  1054.   </div>
    1055. 

  1055. </section>
    1056. 

  1056. 

  1057. <!-- ====== 02 · PIPELINE ====== -->
    1058. 

  1058. <section id="pipeline">
    1059. 

  1059.   <div class="section-head">
    1060. 

  1060.     <div>
    1061. 

  1061.       <div class="section-num">§ 02 — 数据流水线</div>
    1062. 

  1062.       <h2 class="section-title decisions">十步,从 ODPS <em>到飞书</em></h2>
    1063. 

  1063.     </div>
    1064. 

  1064.     <p class="section-desc">单向链路:数据采集 → 指标计算 → 候选筛选 → LLM 推理 → 决策合并 → 护栏 → 审批 → 执行 → 报告。每步前置依赖严格。</p>
    1065. 

  1065.   </div>
    1066. 

  1066. 

  1067.   <div class="pipeline">
    1068. 

  1068.     <div class="pipeline-step">
    1069. 

  1069.       <div class="step-num">01</div>
    1070. 

  1070.       <div class="step-body">
    1071. 

  1071.         <div class="step-name">fetch_creative_data</div>
    1072. 

  1072.         <span class="step-tool">tools/data_query.py</span>
    1073. 

  1073.         <p class="step-desc">从 ODPS 表 <code>loghubods.touliu_data</code> 增量拉取 14 天创意级原始数据(消耗、首层打开数、T0 裂变数、总回流人数、总收入)。已存在的日期文件自动跳过。</p>
    1074. 

  1074.       </div>
    1075. 

  1075.       <div class="step-io">
    1076. 

  1076.         <span class="output">outputs/raw/creative_{date}.csv</span>
    1077. 

  1077.         <span class="output">outputs/ad_status/ad_status_{date}.csv</span>
    1078. 

  1078.       </div>
    1079. 

  1079.     </div>
    1080. 

  1080. 

  1081.     <div class="pipeline-step">
    1082. 

  1082.       <div class="step-num">02</div>
    1083. 

  1083.       <div class="step-body">
    1084. 

  1084.         <div class="step-name">merge_creative_data</div>
    1085. 

  1085.         <span class="step-tool">tools/data_query.py</span>
    1086. 

  1086.         <p class="step-desc">每日 raw + 广告状态做 left join,前置过滤 DELETED/SUSPEND 状态。生成单日 merged CSV。</p>
    1087. 

  1087.       </div>
    1088. 

  1088.       <div class="step-io">
    1089. 

  1089.         <span class="output">outputs/merged/merged_{date}.csv</span>
    1090. 

  1090.       </div>
    1091. 

  1091.     </div>
    1092. 

  1092. 

  1093.     <div class="pipeline-step">
    1094. 

  1094.       <div class="step-num">03</div>
    1095. 

  1095.       <div class="step-body">
    1096. 

  1096.         <div class="step-name">calculate_roi_metrics</div>
    1097. 

  1097.         <span class="step-tool">tools/roi_calculator.py</span>
    1098. 

  1098.         <p class="step-desc">加载 30 天 merged · 创意 → 广告聚合 · 计算 <code>动态ROI = 当日裂变收益率 × 裂变效率稳定因子</code> · 7 日滚动均值(min_periods=3)· 日消耗 &lt; 100 元的天数标 NaN 不入均值。<strong>含临时 TEMP 块过滤近 7 天累计消耗 = 0 的广告</strong>。</p>
    1099. 

  1099.       </div>
    1100. 

  1100.       <div class="step-io">
    1101. 

  1101.         <span class="output">outputs/metrics_{date}.csv (广告级)</span>
    1102. 

  1102.       </div>
    1103. 

  1103.     </div>
    1104. 

  1104. 

  1105.     <div class="pipeline-step">
    1106. 

  1106.       <div class="step-num">04</div>
    1107. 

  1107.       <div class="step-body">
    1108. 

  1108.         <div class="step-name">portfolio_metrics</div>
    1109. 

  1109.         <span class="step-tool">tools/portfolio_metrics.py</span>
    1110. 

  1110.         <p class="step-desc">在 calculate_roi_metrics 内自动调用。计算渠道 P25/P50/P75 ROI 基线 + 人群包(tier)级 fission/CTR/bid 均值,作为决策对比基准。</p>
    1111. 

  1111.       </div>
    1112. 

  1112.       <div class="step-io">
    1113. 

  1113.         <span class="output">outputs/portfolio_summary/portfolio_summary_{date}.json</span>
    1114. 

  1114.       </div>
    1115. 

  1115.     </div>
    1116. 

  1116. 

  1117.     <div class="pipeline-step">
    1118. 

  1118.       <div class="step-num">05</div>
    1119. 

  1119.       <div class="step-body">
    1120. 

  1120.         <div class="step-name">get_ads_for_review</div>
    1121. 

  1121.         <span class="step-tool">tools/ad_decision.py</span>
    1122. 

  1122.         <p class="step-desc">三层分类:零消耗待关停 / 候选广告 / 正常运行。计算 5 个候选标记:<code>roi_low</code>、<code>decay_signal</code>、<code>bid_up_candidate</code>(双分支)、<code>bid_down_candidate</code>、<code>scale_up_candidate</code>。年龄保护:≤3 天剔除,4-7 天屏蔽负向标记。按 audience_tier 分批返回。</p>
    1123. 

  1123.       </div>
    1124. 

  1124.       <div class="step-io">
    1125. 

  1125.         <span class="output">JSON: tier_batches[ ]</span>
    1126. 

  1126.       </div>
    1127. 

  1127.     </div>
    1128. 

  1128. 

  1129.     <div class="pipeline-step">
    1130. 

  1130.       <div class="step-num">06</div>
    1131. 

  1131.       <div class="step-body">
    1132. 

  1132.         <div class="step-name">LLM 推理(分批)</div>
    1133. 

  1133.         <span class="step-tool">主 Agent</span>
    1134. 

  1134.         <p class="step-desc">按 tier 分批调用,降低单次输入 60-80%(避免 lost in the middle)。每批 LLM 输出决策 JSON 数组(<code>action</code>/<code>dimension</code>/<code>reason</code>/<code>confidence</code>/<code>recommended_change_pct</code>)。<strong>禁止多次调 apply_decisions</strong>(后调吞前调)。</p>
    1135. 

  1135.       </div>
    1136. 

  1136.       <div class="step-io">
    1137. 

  1137.         <span class="output">JSON 累积数组(全部 tier)</span>
    1138. 

  1138.       </div>
    1139. 

  1139.     </div>
    1140. 

  1140. 

  1141.     <div class="pipeline-step">
    1142. 

  1142.       <div class="step-num">07</div>
    1143. 

  1143.       <div class="step-body">
    1144. 

  1144.         <div class="step-name">apply_decisions</div>
    1145. 

  1145.         <span class="step-tool">tools/ad_decision.py</span>
    1146. 

  1146.         <p class="step-desc">合并三类决策来源:零消耗自动关停(规则) + LLM 输出(主) + 正常运行兜底 hold(规则)。<strong>左连接 metrics CSV 补全</strong>(ad_name / ad_age_days / cost_7d_avg / 动态ROI / audience_tier 等 20+ 字段)。</p>
    1147. 

  1147.       </div>
    1148. 

  1148.       <div class="step-io">
    1149. 

  1149.         <span class="output">outputs/reports/llm_decisions_{date}.csv</span>
    1150. 

  1150.       </div>
    1151. 

  1151.     </div>
    1152. 

  1152. 

  1153.     <div class="pipeline-step">
    1154. 

  1154.       <div class="step-num">08</div>
    1155. 

  1155.       <div class="step-body">
    1156. 

  1156.         <div class="step-name">validate_decisions</div>
    1157. 

  1157.         <span class="step-tool">tools/guardrails.py</span>
    1158. 

  1158.         <p class="step-desc">护栏校验:冷启动保护、出价上下界(0.05-1.00 元)、单日调整频率(≤2 次)、单次累计变化(≤20%)、数据新鲜度(≤96h)。失败的决策会被强制改 hold + 记录原因。</p>
    1159. 

  1159.       </div>
    1160. 

  1160.       <div class="step-io">
    1161. 

  1161.         <span class="output">outputs/reports/validated_decisions_{date}.csv</span>
    1162. 

  1162.       </div>
    1163. 

  1163.     </div>
    1164. 

  1164. 

  1165.     <div class="pipeline-step">
    1166. 

  1166.       <div class="step-num">09</div>
    1167. 

  1167.       <div class="step-body">
    1168. 

  1168.         <div class="step-name">send_approval_request</div>
    1169. 

  1169.         <span class="step-tool">tools/im_approval.py · feishu_doc.py</span>
    1170. 

  1170.         <p class="step-desc">前置过滤 <code>FEISHU_EXCLUDE_ACTIONS = {hold, observe, scale_up, bid_up}</code>(消息和表格用同一份过滤后数据,数字一致)。生成审批 xlsx 上传飞书文档,带预览链接的卡片推送给操作员私聊 + 项目群,阻塞轮询 chat_history 等回复(超时 120 分钟)。</p>
    1171. 

  1171.       </div>
    1172. 

  1172.       <div class="step-io">
    1173. 

  1173.         <span class="output">飞书 sheets URL · approvals/{request_id}/</span>
    1174. 

  1174.       </div>
    1175. 

  1175.     </div>
    1176. 

  1176. 

  1177.     <div class="pipeline-step">
    1178. 

  1178.       <div class="step-num">10</div>
    1179. 

  1179.       <div class="step-body">
    1180. 

  1180.         <div class="step-name">execute_decisions + send_feishu_text_message</div>
    1181. 

  1181.         <span class="step-tool">tools/execution_engine.py · ad_api.py</span>
    1182. 

  1182.         <p class="step-desc">分级执行(tier 1 自动 / tier 2-3 审批通过)。<code>EXECUTION_ENABLED=False</code> 时仅 log 不调腾讯 API。完成后发送简单文字摘要("已执行 N 条:关停 X / 降价 Y"),不再发完整报告。</p>
    1183. 

  1183.       </div>
    1184. 

  1184.       <div class="step-io">
    1185. 

  1185.         <span class="output">outputs/execution_log/{date}.csv</span>
    1186. 

  1186.         <span class="output">飞书文字消息</span>
    1187. 

  1187.       </div>
    1188. 

  1188.     </div>
    1189. 

  1189.   </div>
    1190. 

  1190. </section>
    1191. 

  1191. 

  1192. <!-- ====== 03 · SKILLS ====== -->
    1193. 

  1193. <section id="skills">
    1194. 

  1194.   <div class="section-head">
    1195. 

  1195.     <div>
    1196. 

  1196.       <div class="section-num">§ 03 — 领域知识(Skills)</div>
    1197. 

  1197.       <h2 class="section-title skills">注入 prompt 的<em>四份手册</em></h2>
    1198. 

  1198.     </div>
    1199. 

  1199.     <p class="section-desc">.md + YAML frontmatter,框架启动时按 <code>name</code> 索引,内容拼接到 system prompt 末尾。冲突优先级:platform-rules &gt; decision-strategy &gt; posterior-wisdom &gt; ad-domain。</p>
    1200. 

  1200.   </div>
    1201. 

  1201. 

  1202.   <div class="skills-grid">
    1203. 

  1203.     <div class="skill-card featured">
    1204. 

  1204.       <span class="skill-rank core">CORE</span>
    1205. 

  1205.       <div class="skill-name">decision_strategy.md</div>
    1206. 

  1206.       <h3 class="skill-headline">决策的判断框架与 reason 输出规范</h3>
    1207. 

  1207.       <div class="skill-meta">19.5 KB · 约 570 行 · 决策 80% 重量</div>
    1208. 

  1208.       <p class="skill-desc">真正的"作战手册"。三层架构(规则候选 → LLM → 输出规范),三维对比基准(ROI 看渠道P50,裂变看同类,CTR 看同类),7 种 action 详解 × 触发前提 × 综合权衡 × pct 要求 × 禁用场景。reason 5 元组模板 + 提交前自检 5 问。</p>
    1209. 

  1209.       <div class="skill-sections">
    1210. 

  1210.         <span class="skill-tag">§一 · 角色与原则</span>
    1211. 

  1211.         <span class="skill-tag">§二 · 候选标记解读</span>
    1212. 

  1212.         <span class="skill-tag">§三 · 年龄策略</span>
    1213. 

  1213.         <span class="skill-tag">§四 · 决策思考 5 步</span>
    1214. 

  1214.         <span class="skill-tag">§五 · 7 action 详解</span>
    1215. 

  1215.         <span class="skill-tag">§六 · 多因素权衡 + 冲突表</span>
    1216. 

  1216.         <span class="skill-tag">§七 · 输出规范 + 自检</span>
    1217. 

  1217.       </div>
    1218. 

  1218.     </div>
    1219. 

  1219. 

  1220.     <div class="skill-card">
    1221. 

  1221.       <span class="skill-rank">DOMAIN</span>
    1222. 

  1222.       <div class="skill-name">ad_domain.md</div>
    1223. 

  1223.       <h3 class="skill-headline">微信小程序投流的业务模型</h3>
    1224. 

  1224.       <div class="skill-meta">6.5 KB · 业务知识基底</div>
    1225. 

  1225.       <p class="skill-desc">解释裂变变现模型("每一层都在变现",非线性漏斗)、R 值人群含义(R500/R330+/R330/R180/R100/R50/R10/R2 的带人能力 + 投放单价 + 当日 ROI 表现)、动态 ROI 公式与字段定义。</p>
    1226. 

  1226.       <div class="skill-sections">
    1227. 

  1227.         <span class="skill-tag">变现模型</span>
    1228. 

  1228.         <span class="skill-tag">R 值对照表</span>
    1229. 

  1229.         <span class="skill-tag">动态 ROI 公式</span>
    1230. 

  1230.         <span class="skill-tag">字段定义</span>
    1231. 

  1231.       </div>
    1232. 

  1232.     </div>
    1233. 

  1233. 

  1234.     <div class="skill-card">
    1235. 

  1235.       <span class="skill-rank">PLATFORM</span>
    1236. 

  1236.       <div class="skill-name">platform_rules.md</div>
    1237. 

  1237.       <h3 class="skill-headline">腾讯广告平台硬约束</h3>
    1238. 

  1238.       <div class="skill-meta">5.3 KB · 优先级最高</div>
    1239. 

  1239.       <p class="skill-desc">oCPM 学习期(前 5 转化 / 24h 内 ≤2 次调整)、调价幅度上限(单次 ≤30%)、少广告多素材策略(单广告创意数 ≥5)、素材疲劳识别、数据口径(T+1 而非实时)、API QPS 与批量限制。</p>
    1240. 

  1240.       <div class="skill-sections">
    1241. 

  1241.         <span class="skill-tag">学习期保护</span>
    1242. 

  1242.         <span class="skill-tag">调价上限</span>
    1243. 

  1243.         <span class="skill-tag">数据口径</span>
    1244. 

  1244.         <span class="skill-tag">API 约束</span>
    1245. 

  1245.       </div>
    1246. 

  1246.     </div>
    1247. 

  1247. 

  1248.     <div class="skill-card">
    1249. 

  1249.       <span class="skill-rank">POSTERIOR</span>
    1250. 

  1250.       <div class="skill-name">posterior_wisdom.md</div>
    1251. 

  1251.       <h3 class="skill-headline">后验经验查询入口</h3>
    1252. 

  1252.       <div class="skill-meta">0.8 KB · 待积累</div>
    1253. 

  1253.       <p class="skill-desc">通过 <code>ask_knowledge()</code> 查询历史投放案例。当前系统尚未积累足够后验数据,提供查询模板:周期性效应、调价效果、人群包对比、异常模式、创意冷启动等。</p>
    1254. 

  1254.       <div class="skill-sections">
    1255. 

  1255.         <span class="skill-tag">ask_knowledge</span>
    1256. 

  1256.         <span class="skill-tag">查询模板</span>
    1257. 

  1257.       </div>
    1258. 

  1258.     </div>
    1259. 

  1259.   </div>
    1260. 

  1260. </section>
    1261. 

  1261. 

  1262. <!-- ====== 04 · TOOLS ====== -->
    1263. 

  1263. <section id="tools">
    1264. 

  1264.   <div class="section-head">
    1265. 

  1265.     <div>
    1266. 

  1266.       <div class="section-num">§ 04 — 工具清单</div>
    1267. 

  1267.       <h2 class="section-title tools">十二个 <em>tool</em> · 按数据流向排序</h2>
    1268. 

  1268.     </div>
    1269. 

  1269.     <p class="section-desc">每个工具用 <code>@tool</code> 装饰注册到 ToolRegistry,JSON Schema 自动生成。隐藏参数(context、trace_id)由 Runner 注入,LLM 看不到。</p>
    1270. 

  1270.   </div>
    1271. 

  1271. 

  1272.   <div class="tools-table">
    1273. 

  1273.     <div class="tools-row head">
    1274. 

  1274.       <div>文件 / 函数</div>
    1275. 

  1275.       <div>分类</div>
    1276. 

  1276.       <div>职责</div>
    1277. 

  1277.       <div>所属步骤</div>
    1278. 

  1278.     </div>
    1279. 

  1279. 

  1280.     <div class="tools-row">
    1281. 

  1281.       <div class="tool-file">data_query.py</div>
    1282. 

  1282.       <div class="tool-cat data">DATA</div>
    1283. 

  1283.       <div class="tool-fn"><code>fetch_creative_data</code> + <code>merge_creative_data</code> · 从 ODPS 拉创意级原始数据,合并多日 + 广告状态。</div>
    1284. 

  1284.       <div class="tool-step">Step 01—02</div>
    1285. 

  1285.     </div>
    1286. 

  1286. 

  1287.     <div class="tools-row">
    1288. 

  1288.       <div class="tool-file">roi_calculator.py</div>
    1289. 

  1289.       <div class="tool-cat compute">COMPUTE</div>
    1290. 

  1290.       <div class="tool-fn"><code>calculate_roi_metrics</code> · 创意 → 广告聚合,计算动态 ROI(7 日均值 + 裂变效率稳定因子)。</div>
    1291. 

  1291.       <div class="tool-step">Step 03</div>
    1292. 

  1292.     </div>
    1293. 

  1293. 

  1294.     <div class="tools-row">
    1295. 

  1295.       <div class="tool-file">portfolio_metrics.py</div>
    1296. 

  1296.       <div class="tool-cat compute">COMPUTE</div>
    1297. 

  1297.       <div class="tool-fn"><code>_describe_group</code> + <code>_compute_daily_tier_snapshot</code> + <code>_compute_market_signal</code> · 渠道 P25/P50/P75 + tier 均值,作为决策基线。</div>
    1298. 

  1298.       <div class="tool-step">Step 04</div>
    1299. 

  1299.     </div>
    1300. 

  1300. 

  1301.     <div class="tools-row">
    1302. 

  1302.       <div class="tool-file">ad_decision.py</div>
    1303. 

  1303.       <div class="tool-cat decide">DECIDE</div>
    1304. 

  1304.       <div class="tool-fn"><code>get_ads_for_review</code> + <code>apply_decisions</code> + <code>query_ad_detail</code> + <code>modify_decisions</code> · 候选标记 + 三层分类 + LLM 决策合并。</div>
    1305. 

  1305.       <div class="tool-step">Step 05, 07</div>
    1306. 

  1306.     </div>
    1307. 

  1307. 

  1308.     <div class="tools-row">
    1309. 

  1309.       <div class="tool-file">guardrails.py</div>
    1310. 

  1310.       <div class="tool-cat decide">VALIDATE</div>
    1311. 

  1311.       <div class="tool-fn"><code>validate_decisions</code> · 冷启动 / 出价边界 / 频率 / 数据新鲜度 多重护栏校验,失败强制改 hold。</div>
    1312. 

  1312.       <div class="tool-step">Step 08</div>
    1313. 

  1313.     </div>
    1314. 

  1314. 

  1315.     <div class="tools-row">
    1316. 

  1316.       <div class="tool-file">execution_engine.py</div>
    1317. 

  1317.       <div class="tool-cat execute">EXECUTE</div>
    1318. 

  1318.       <div class="tool-fn"><code>execute_decisions</code> + <code>_classify_tier</code> · 分级执行,EXECUTION_ENABLED 控制是否真改腾讯 API。</div>
    1319. 

  1319.       <div class="tool-step">Step 10</div>
    1320. 

  1320.     </div>
    1321. 

  1321. 

  1322.     <div class="tools-row">
    1323. 

  1323.       <div class="tool-file">im_approval.py</div>
    1324. 

  1324.       <div class="tool-cat execute">EXECUTE</div>
    1325. 

  1325.       <div class="tool-fn"><code>send_approval_request</code> + <code>send_feishu_text_message</code> · 飞书审批阻塞轮询,FEISHU_EXCLUDE_ACTIONS 前置过滤。</div>
    1326. 

  1326.       <div class="tool-step">Step 09—10</div>
    1327. 

  1327.     </div>
    1328. 

  1328. 

  1329.     <div class="tools-row">
    1330. 

  1330.       <div class="tool-file">report_generator.py</div>
    1331. 

  1331.       <div class="tool-cat report">REPORT</div>
    1332. 

  1332.       <div class="tool-fn"><code>generate_report</code> · 带条件格式的 Excel 决策表(action 颜色编码)。</div>
    1333. 

  1333.       <div class="tool-step">Step 10</div>
    1334. 

  1334.     </div>
    1335. 

  1335. 

  1336.     <div class="tools-row">
    1337. 

  1337.       <div class="tool-file">feishu_doc.py</div>
    1338. 

  1338.       <div class="tool-cat report">REPORT</div>
    1339. 

  1339.       <div class="tool-fn"><code>import_to_feishu</code> · 上传 xlsx 到飞书文档,设置权限,带预览链接的 IM 卡片推送。</div>
    1340. 

  1340.       <div class="tool-step">Step 09</div>
    1341. 

  1341.     </div>
    1342. 

  1342. 

  1343.     <div class="tools-row">
    1344. 

  1344.       <div class="tool-file">ad_api.py</div>
    1345. 

  1345.       <div class="tool-cat execute">EXECUTE</div>
    1346. 

  1346.       <div class="tool-fn">腾讯广告 Marketing API v3.0 封装(/v3.0/adgroups/get / update),指数退避 + 操作幂等键。</div>
    1347. 

  1347.       <div class="tool-step">Step 10</div>
    1348. 

  1348.     </div>
    1349. 

  1349. 

  1350.     <div class="tools-row">
    1351. 

  1351.       <div class="tool-file">creative_metrics.py</div>
    1352. 

  1352.       <div class="tool-cat compute">COMPUTE</div>
    1353. 

  1353.       <div class="tool-fn">创意级数据指标聚合,服务于 ROI 计算上游。</div>
    1354. 

  1354.       <div class="tool-step">Step 03 (内部)</div>
    1355. 

  1355.     </div>
    1356. 

  1356. 

  1357.     <div class="tools-row">
    1358. 

  1358.       <div class="tool-file">odps_module.py</div>
    1359. 

  1359.       <div class="tool-cat data">DATA</div>
    1360. 

  1360.       <div class="tool-fn">ODPS 客户端封装,SQL 模板执行 + tunnel session 下载。</div>
    1361. 

  1361.       <div class="tool-step">Step 01 (内部)</div>
    1362. 

  1362.     </div>
    1363. 

  1363.   </div>
    1364. 

  1364. </section>
    1365. 

  1365. 

  1366. <!-- ====== 05 · DECISION FRAMEWORK ====== -->
    1367. 

  1367. <section id="decision">
    1368. 

  1368.   <div class="section-head">
    1369. 

  1369.     <div>
    1370. 

  1370.       <div class="section-num">§ 05 — 决策框架</div>
    1371. 

  1371.       <h2 class="section-title decisions">规则与 LLM 的<em>四层协作</em></h2>
    1372. 

  1372.     </div>
    1373. 

  1373.     <p class="section-desc">规则定"是否评估",LLM 定"如何操作"。年龄保护是硬约束,候选标记决定进入 LLM 的范围,LLM 在已限定的边界内做综合判断,兜底层覆盖未决策广告。</p>
    1374. 

  1374.   </div>
    1375. 

  1375. 

  1376.   <div class="decision-arch">
    1377. 

  1377.     <div class="decision-tower">
    1378. 

  1378.       <div class="tier tier-1">
    1379. 

  1379.         <div class="tier-label">L1 · Hard Gate</div>
    1380. 

  1380.         <div class="tier-name">年龄保护(硬约束)</div>
    1381. 

  1381.         <p class="tier-desc">≤<code>COLD_START_DAYS</code>(3 天):完全剔除,不评估。<br>4-<code>EARLY_GROWTH_DAYS</code>(7 天):屏蔽 <code>roi_low</code> / <code>decay_signal</code> / <code>bid_down_candidate</code>,只放过提价/扩量信号。</p>
    1382. 

  1382.       </div>
    1383. 

  1383.       <div class="tier tier-2">
    1384. 

  1384.         <div class="tier-label">L2 · Rule</div>
    1385. 

  1385.         <div class="tier-name">候选标记(5 个 flag)</div>
    1386. 

  1386.         <p class="tier-desc">规则层在 <code>get_ads_for_review</code> 中输出 <code>roi_low</code> / <code>decay_signal</code> / <code>bid_up_candidate</code>(双分支:唤醒沉默 + 优质放量) / <code>bid_down_candidate</code> / <code>scale_up_candidate</code>。决定哪些广告进入 LLM。</p>
    1387. 

  1387.       </div>
    1388. 

  1388.       <div class="tier tier-3">
    1389. 

  1389.         <div class="tier-label">L3 · LLM</div>
    1390. 

  1390.         <div class="tier-name">综合判断(7 action)</div>
    1391. 

  1391.         <p class="tier-desc">LLM 看候选标记 + 同类基线 + 调价历史 + tier 组合,从 7 种 action 中选一个 + 写 reason(5 元组规范)。可"越权":如规则没标但有强烈信号。</p>
    1392. 

  1392.       </div>
    1393. 

  1393.       <div class="tier tier-4">
    1394. 

  1394.         <div class="tier-label">L4 · Fallback</div>
    1395. 

  1395.         <div class="tier-name">兜底检查(规则)</div>
    1396. 

  1396.         <p class="tier-desc"><code>apply_decisions</code> 末尾,所有未被 LLM 覆盖的广告自动归 <code>hold</code>(<code>source=规则判断</code>)。确保所有候选都有决策落盘,无遗漏。</p>
    1397. 

  1397.       </div>
    1398. 

  1398.     </div>
    1399. 

  1399. 

  1400.     <div class="actions-panel">
    1401. 

  1401.       <div class="actions-head">7 种 Action 触发条件</div>
    1402. 

  1402.       <div class="actions-list">
    1403. 

  1403.         <div class="action-row">
    1404. 

  1404.           <div class="action-name pause"><span class="dot"></span><code>pause</code></div>
    1405. 

  1405.           <div class="action-rule"><code>roi_low=True</code> + LLM 综合判断(双低/调价无效);或 7 日均消耗&lt;10 自动关停。pct = 0。</div>
    1406. 

  1406.         </div>
    1407. 

  1407.         <div class="action-row">
    1408. 

  1408.           <div class="action-name bid_down"><span class="dot"></span><code>bid_down</code></div>
    1409. 

  1409.           <div class="action-rule"><code>bid_down_candidate=True</code> + 裂变低于同类 + 成熟期 + 7 日均消耗 ≥500。pct ∈ [-5%, -3%]。</div>
    1410. 

  1410.         </div>
    1411. 

  1411.         <div class="action-row">
    1412. 

  1412.           <div class="action-name bid_up"><span class="dot"></span><code>bid_up</code></div>
    1413. 

  1413.           <div class="action-rule"><code>bid_up_candidate=True</code>(仅 4-7 天)。分支 A 唤醒沉默(低消耗 + CTR 正常)/ 分支 B 优质放量(高 ROI + 高裂变)。pct ∈ [+5%, +10%]。</div>
    1414. 

  1414.         </div>
    1415. 

  1415.         <div class="action-row">
    1416. 

  1416.           <div class="action-name scale_up"><span class="dot"></span><code>scale_up</code></div>
    1417. 

  1417.           <div class="action-rule"><code>scale_up_candidate=True</code>(成熟 &gt;7 天 + 稳定 ≥7 天 + 高消耗 &gt;1000 + ROI ≥ P50×0.9)。pct = 0(由运营新增广告/创意)。</div>
    1418. 

  1418.         </div>
    1419. 

  1419.         <div class="action-row">
    1420. 

  1420.           <div class="action-name creative_adjust"><span class="dot"></span><code>creative_adjust</code></div>
    1421. 

  1421.           <div class="action-rule">ROI 达标但消耗起不来 / CTR + CVR 同跌(素材疲劳)/ 已换创意但裂变仍低。pct = 0,人工换素材。</div>
    1422. 

  1422.         </div>
    1423. 

  1423.         <div class="action-row">
    1424. 

  1424.           <div class="action-name observe"><span class="dot"></span><code>observe</code></div>
    1425. 

  1425.           <div class="action-rule">数据不充分(roi_valid_days &lt;5)/ 7 天内已调价(等效果显现)/ 信号冲突(ROI 低但裂变好)。pct = 0。</div>
    1426. 

  1426.         </div>
    1427. 

  1427.         <div class="action-row">
    1428. 

  1428.           <div class="action-name hold"><span class="dot"></span><code>hold</code></div>
    1429. 

  1429.           <div class="action-rule">无异常信号(默认兜底)。pct = 0。</div>
    1430. 

  1430.         </div>
    1431. 

  1431.       </div>
    1432. 

  1432.     </div>
    1433. 

  1433.   </div>
    1434. 

  1434. </section>
    1435. 

  1435. 

  1436. <!-- ====== 06 · THRESHOLDS ====== -->
    1437. 

  1437. <section id="thresholds">
    1438. 

  1438.   <div class="section-head">
    1439. 

  1439.     <div>
    1440. 

  1440.       <div class="section-num">§ 06 — 关键阈值</div>
    1441. 

  1441.       <h2 class="section-title rules">决策的<em>数值边界</em></h2>
    1442. 

  1442.     </div>
    1443. 

  1443.     <p class="section-desc">所有阈值集中在 <code>config.py</code>,部分可被数据库 <code>tencent_ad_autoput.config</code> 表覆盖。修改前应通过 evaluation 验证。</p>
    1444. 

  1444.   </div>
    1445. 

  1445. 

  1446.   <div class="thresholds-grid">
    1447. 

  1447.     <div class="threshold-card">
    1448. 

  1448.       <div class="threshold-key">ROI_LOW_FACTOR</div>
    1449. 

  1449.       <div class="threshold-value rules">0.75</div>
    1450. 

  1450.       <p class="threshold-meaning">关停线乘子 · 动态ROI &lt; 渠道P50×0.75 → 候选关停</p>
    1451. 

  1451.     </div>
    1452. 

  1452.     <div class="threshold-card">
    1453. 

  1453.       <div class="threshold-key">BID_DOWN_ROI_FACTOR</div>
    1454. 

  1454.       <div class="threshold-value tools">0.90</div>
    1455. 

  1455.       <p class="threshold-meaning">降价线乘子 · ROI &lt; P50×0.90 + 裂变低 → 候选降价</p>
    1456. 

  1456.     </div>
    1457. 

  1457.     <div class="threshold-card">
    1458. 

  1458.       <div class="threshold-key">BID_UP_ROI_FACTOR</div>
    1459. 

  1459.       <div class="threshold-value decisions">1.05</div>
    1460. 

  1460.       <p class="threshold-meaning">提价线乘子 · ROI &gt; P50×1.05 + 早期成长期 → 候选提价</p>
    1461. 

  1461.     </div>
    1462. 

  1462.     <div class="threshold-card">
    1463. 

  1463.       <div class="threshold-key">COLD_START_DAYS</div>
    1464. 

  1464.       <div class="threshold-value rules">3 <span class="threshold-unit">天</span></div>
    1465. 

  1465.       <p class="threshold-meaning">冷启动期 · 完全保护,不评估,不调整</p>
    1466. 

  1466.     </div>
    1467. 

  1467.     <div class="threshold-card">
    1468. 

  1468.       <div class="threshold-key">EARLY_GROWTH_DAYS</div>
    1469. 

  1469.       <div class="threshold-value skills">7 <span class="threshold-unit">天</span></div>
    1470. 

  1470.       <p class="threshold-meaning">早期成长期 · 仅允许 bid_up / scale_up</p>
    1471. 

  1471.     </div>
    1472. 

  1472.     <div class="threshold-card">
    1473. 

  1473.       <div class="threshold-key">MIN_DAILY_COST</div>
    1474. 

  1474.       <div class="threshold-value tools">100 <span class="threshold-unit">元</span></div>
    1475. 

  1475.       <p class="threshold-meaning">日消耗 &lt; 100 元 → ROI 当日数据不入 7 日滚动均值</p>
    1476. 

  1476.     </div>
    1477. 

  1477.     <div class="threshold-card">
    1478. 

  1478.       <div class="threshold-key">NO_SPEND_THRESHOLD</div>
    1479. 

  1479.       <div class="threshold-value rules">10 <span class="threshold-unit">元</span></div>
    1480. 

  1480.       <p class="threshold-meaning">7 日均消耗 &lt; 10 → 自动 pause(年龄&gt;7 天)</p>
    1481. 

  1481.     </div>
    1482. 

  1482.     <div class="threshold-card">
    1483. 

  1483.       <div class="threshold-key">BID_DOWN range</div>
    1484. 

  1484.       <div class="threshold-value tools">3 — 5<span class="threshold-unit">%</span></div>
    1485. 

  1485.       <p class="threshold-meaning">降价幅度 · 单次绝对值上限 5%(更严守)</p>
    1486. 

  1486.     </div>
    1487. 

  1487.     <div class="threshold-card">
    1488. 

  1488.       <div class="threshold-key">BID_UP range</div>
    1489. 

  1489.       <div class="threshold-value decisions">5 — 10<span class="threshold-unit">%</span></div>
    1490. 

  1490.       <p class="threshold-meaning">提价幅度 · 单次绝对值上限 10%(可放宽)</p>
    1491. 

  1491.     </div>
    1492. 

  1492.     <div class="threshold-card">
    1493. 

  1493.       <div class="threshold-key">BID_FLOOR / CEILING</div>
    1494. 

  1494.       <div class="threshold-value skills">0.05 — 1.00<span class="threshold-unit">元</span></div>
    1495. 

  1495.       <p class="threshold-meaning">出价硬边界 · 任何调整不得突破</p>
    1496. 

  1496.     </div>
    1497. 

  1497.     <div class="threshold-card">
    1498. 

  1498.       <div class="threshold-key">MAX_ADJUSTMENTS_PER_AD_PER_DAY</div>
    1499. 

  1499.       <div class="threshold-value rules">2</div>
    1500. 

  1500.       <p class="threshold-meaning">单广告每日最大调整次数 · 平台学习期防抖</p>
    1501. 

  1501.     </div>
    1502. 

  1502.     <div class="threshold-card">
    1503. 

  1503.       <div class="threshold-key">EXECUTION_ENABLED</div>
    1504. 

  1504.       <div class="threshold-value rules">false</div>
    1505. 

  1505.       <p class="threshold-meaning">执行开关 · 默认关闭,所有操作走审批不真改</p>
    1506. 

  1506.     </div>
    1507. 

  1507.   </div>
    1508. 

  1508. </section>
    1509. 

  1509. 

  1510. <!-- ====== 07 · DATA FLOW ====== -->
    1511. 

  1511. <section id="dataflow">
    1512. 

  1512.   <div class="section-head">
    1513. 

  1513.     <div>
    1514. 

  1514.       <div class="section-num">§ 07 — 数据流向</div>
    1515. 

  1515.       <h2 class="section-title data">从 ODPS 到<em>腾讯广告 API</em></h2>
    1516. 

  1516.     </div>
    1517. 

  1517.     <p class="section-desc">外部数据源 → 本地落盘 → 内存计算 → LLM 调用 → 飞书人机交互 → 腾讯广告写入。所有中间产物均落盘,可独立回放。</p>
    1518. 

  1518.   </div>
    1519. 

  1519. 

  1520.   <svg class="flow-svg" viewBox="0 0 1200 580" xmlns="http://www.w3.org/2000/svg">
    1521. 

  1521.     <defs>
    1522. 

  1522.       <marker id="arrowhead" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="6" markerHeight="6" orient="auto">
    1523. 

  1523.         <path d="M 0 0 L 10 5 L 0 10 z" fill="currentColor"/>
    1524. 

  1524.       </marker>
    1525. 

  1525.       <pattern id="grid" width="40" height="40" patternUnits="userSpaceOnUse">
    1526. 

  1526.         <path d="M 40 0 L 0 0 0 40" fill="none" stroke="#1F2A38" stroke-width="0.5"/>
    1527. 

  1527.       </pattern>
    1528. 

  1528.     </defs>
    1529. 

  1529. 

  1530.     <rect width="1200" height="580" fill="url(#grid)" opacity="0.5"/>
    1531. 

  1531. 

  1532.     <!-- Layers labels -->
    1533. 

  1533.     <text x="20" y="40" class="label-bold" fill="#94A3B0">EXTERNAL</text>
    1534. 

  1534.     <text x="20" y="170" class="label-bold" fill="#94A3B0">FILESYSTEM</text>
    1535. 

  1535.     <text x="20" y="320" class="label-bold" fill="#94A3B0">COMPUTE</text>
    1536. 

  1536.     <text x="20" y="450" class="label-bold" fill="#94A3B0">HUMAN + ACT</text>
    1537. 

  1537. 

  1538.     <!-- External data sources -->
    1539. 

  1539.     <rect x="160" y="20" width="160" height="50" class="node node-data" rx="2"/>
    1540. 

  1540.     <text x="240" y="42" text-anchor="middle" class="label-bold">ODPS</text>
    1541. 

  1541.     <text x="240" y="58" text-anchor="middle">loghubods.touliu_data</text>
    1542. 

  1542. 

  1543.     <rect x="380" y="20" width="160" height="50" class="node node-data" rx="2"/>
    1544. 

  1544.     <text x="460" y="42" text-anchor="middle" class="label-bold">腾讯广告 API</text>
    1545. 

  1545.     <text x="460" y="58" text-anchor="middle">/adgroups/get</text>
    1546. 

  1546. 

  1547.     <rect x="600" y="20" width="160" height="50" class="node node-data" rx="2"/>
    1548. 

  1548.     <text x="680" y="42" text-anchor="middle" class="label-bold">RDS MySQL</text>
    1549. 

  1549.     <text x="680" y="58" text-anchor="middle">config + whitelist</text>
    1550. 

  1550. 

  1551.     <rect x="820" y="20" width="160" height="50" class="node node-data" rx="2"/>
    1552. 

  1552.     <text x="900" y="42" text-anchor="middle" class="label-bold">飞书 IM</text>
    1553. 

  1553.     <text x="900" y="58" text-anchor="middle">app + chat_history</text>
    1554. 

  1554. 

  1555.     <!-- Filesystem layer -->
    1556. 

  1556.     <rect x="80" y="150" width="180" height="40" class="node" rx="2"/>
    1557. 

  1557.     <text x="170" y="174" text-anchor="middle">outputs/raw/</text>
    1558. 

  1558. 

  1559.     <rect x="280" y="150" width="180" height="40" class="node" rx="2"/>
    1560. 

  1560.     <text x="370" y="174" text-anchor="middle">outputs/merged/</text>
    1561. 

  1561. 

  1562.     <rect x="480" y="150" width="180" height="40" class="node" rx="2"/>
    1563. 

  1563.     <text x="570" y="174" text-anchor="middle">outputs/metrics_*.csv</text>
    1564. 

  1564. 

  1565.     <rect x="680" y="150" width="180" height="40" class="node" rx="2"/>
    1566. 

  1566.     <text x="770" y="174" text-anchor="middle">portfolio_summary/</text>
    1567. 

  1567. 

  1568.     <rect x="880" y="150" width="220" height="40" class="node" rx="2"/>
    1569. 

  1569.     <text x="990" y="174" text-anchor="middle">outputs/reports/</text>
    1570. 

  1570. 

  1571.     <!-- Compute layer -->
    1572. 

  1572.     <rect x="80" y="290" width="220" height="50" class="node node-tool" rx="2"/>
    1573. 

  1573.     <text x="190" y="312" text-anchor="middle" class="label-bold">data_query</text>
    1574. 

  1574.     <text x="190" y="328" text-anchor="middle">fetch + merge</text>
    1575. 

  1575. 

  1576.     <rect x="320" y="290" width="220" height="50" class="node node-tool" rx="2"/>
    1577. 

  1577.     <text x="430" y="312" text-anchor="middle" class="label-bold">roi_calculator</text>
    1578. 

  1578.     <text x="430" y="328" text-anchor="middle">动态 ROI 7 日均值</text>
    1579. 

  1579. 

  1580.     <rect x="560" y="290" width="220" height="50" class="node node-decide" rx="2"/>
    1581. 

  1581.     <text x="670" y="312" text-anchor="middle" class="label-bold">ad_decision</text>
    1582. 

  1582.     <text x="670" y="328" text-anchor="middle">候选标记 + 决策合并</text>
    1583. 

  1583. 

  1584.     <rect x="800" y="290" width="220" height="50" class="node node-decide" rx="2"/>
    1585. 

  1585.     <text x="910" y="312" text-anchor="middle" class="label-bold">LLM (Sonnet 4.5)</text>
    1586. 

  1586.     <text x="910" y="328" text-anchor="middle">action + reason</text>
    1587. 

  1587. 

  1588.     <!-- Human + Act layer -->
    1589. 

  1589.     <rect x="200" y="430" width="200" height="50" class="node node-act" rx="2"/>
    1590. 

  1590.     <text x="300" y="452" text-anchor="middle" class="label-bold">guardrails</text>
    1591. 

  1591.     <text x="300" y="468" text-anchor="middle">护栏校验</text>
    1592. 

  1592. 

  1593.     <rect x="450" y="430" width="200" height="50" class="node node-act" rx="2"/>
    1594. 

  1594.     <text x="550" y="452" text-anchor="middle" class="label-bold">im_approval</text>
    1595. 

  1595.     <text x="550" y="468" text-anchor="middle">飞书审批 + 阻塞</text>
    1596. 

  1596. 

  1597.     <rect x="700" y="430" width="200" height="50" class="node node-act" rx="2"/>
    1598. 

  1598.     <text x="800" y="452" text-anchor="middle" class="label-bold">execution_engine</text>
    1599. 

  1599.     <text x="800" y="468" text-anchor="middle">EXECUTION_ENABLED?</text>
    1600. 

  1600. 

  1601.     <rect x="950" y="430" width="200" height="50" class="node node-act" rx="2"/>
    1602. 

  1602.     <text x="1050" y="452" text-anchor="middle" class="label-bold">ad_api</text>
    1603. 

  1603.     <text x="1050" y="468" text-anchor="middle">/adgroups/update</text>
    1604. 

  1604. 

  1605.     <!-- Connections -->
    1606. 

  1606.     <g style="color:#6B9FB5">
    1607. 

  1607.       <path class="arrow arrow-data" d="M 240 70 L 240 145 L 170 145 L 170 150"/>
    1608. 

  1608.       <path class="arrow arrow-data" d="M 460 70 L 460 145 L 370 145 L 370 150"/>
    1609. 

  1609.     </g>
    1610. 

  1610. 

  1611.     <g style="color:#3D5066">
    1612. 

  1612.       <path class="arrow" d="M 170 190 L 170 285 L 190 290"/>
    1613. 

  1613.       <path class="arrow" d="M 370 190 L 370 290 L 430 290"/>
    1614. 

  1614.       <path class="arrow" d="M 570 190 L 570 285 L 670 290"/>
    1615. 

  1615.       <path class="arrow" d="M 770 190 L 770 285 L 870 290"/>
    1616. 

  1616.     </g>
    1617. 

  1617. 

  1618.     <!-- Compute connections -->
    1619. 

  1619.     <g style="color:#3D5066">
    1620. 

  1620.       <path class="arrow" d="M 300 315 L 320 315"/>
    1621. 

  1621.       <path class="arrow" d="M 540 315 L 560 315"/>
    1622. 

  1622.       <path class="arrow" d="M 780 315 L 800 315"/>
    1623. 

  1623.     </g>
    1624. 

  1624. 

  1625.     <!-- Compute → Output -->
    1626. 

  1626.     <g style="color:#3D5066">
    1627. 

  1627.       <path class="arrow" d="M 190 290 L 190 195"/>
    1628. 

  1628.       <path class="arrow" d="M 430 290 L 430 195"/>
    1629. 

  1629.       <path class="arrow" d="M 670 290 L 670 195"/>
    1630. 

  1630.       <path class="arrow" d="M 910 290 L 990 195"/>
    1631. 

  1631.     </g>
    1632. 

  1632. 

  1633.     <!-- LLM → guardrails / approval -->
    1634. 

  1634.     <g style="color:#5BC0BE">
    1635. 

  1635.       <path class="arrow arrow-decide" d="M 910 340 L 910 410 L 300 410 L 300 430"/>
    1636. 

  1636.       <path class="arrow arrow-decide" d="M 300 480 L 300 510 L 550 510 L 550 480"/>
    1637. 

  1637.     </g>
    1638. 

  1638. 

  1639.     <!-- approval → execution -->
    1640. 

  1640.     <g style="color:#3D5066">
    1641. 

  1641.       <path class="arrow" d="M 650 455 L 700 455"/>
    1642. 

  1642.       <path class="arrow" d="M 900 455 L 950 455"/>
    1643. 

  1643.     </g>
    1644. 

  1644. 

  1645.     <!-- Feishu connection -->
    1646. 

  1646.     <g style="color:#6B9FB5">
    1647. 

  1647.       <path class="arrow arrow-data" d="M 900 70 L 900 105 L 550 105 L 550 430"/>
    1648. 

  1648.     </g>
    1649. 

  1649. 

  1650.     <!-- ad_api → 腾讯 -->
    1651. 

  1651.     <g style="color:#F25F5C">
    1652. 

  1652.       <path class="arrow" d="M 1050 430 L 1050 105 L 460 105 L 460 70" stroke-dasharray="4 4"/>
    1653. 

  1653.     </g>
    1654. 

  1654. 

  1655.     <!-- Legend -->
    1656. 

  1656.     <g transform="translate(900, 530)">
    1657. 

  1657.       <text x="0" y="0" font-family="JetBrains Mono" font-size="10" fill="#94A3B0">EXECUTION_ENABLED=False</text>
    1658. 

  1658.       <text x="0" y="14" font-family="JetBrains Mono" font-size="10" fill="#F25F5C">→ ad_api 仅 log,不真改</text>
    1659. 

  1659.     </g>
    1660. 

  1660.   </svg>
    1661. 

  1661. </section>
    1662. 

  1662. 

  1663. <!-- ====== 08 · DEPLOYMENT ====== -->
    1664. 

  1664. <section id="deployment">
    1665. 

  1665.   <div class="section-head">
    1666. 

  1666.     <div>
    1667. 

  1667.       <div class="section-num">§ 08 — 部署形态</div>
    1668. 

  1668.       <h2 class="section-title rules">两种<em>运行模式</em></h2>
    1669. 

  1669.     </div>
    1670. 

  1670.     <p class="section-desc">本地交互(REPL,人工触发分析)+ K8s CronJob(每日 02:00 UTC 自动跑)。共享同一份代码 + skill + tool。</p>
    1671. 

  1671.   </div>
    1672. 

  1672. 

  1673.   <div class="deploy-grid">
    1674. 

  1674.     <div class="deploy-card">
    1675. 

  1675.       <div class="deploy-mode">Mode A · Interactive</div>
    1676. 

  1676.       <div class="deploy-name">run.py · REPL</div>
    1677. 

  1677.       <p class="deploy-desc">手工启动 Agent,交互式问答。适合临时分析单个广告 / 修改决策 / 调试 skill。Agent 在每轮等待用户输入,可执行任意工具。</p>
    1678. 

  1678.       <div class="deploy-files">
    1679. 

  1679.         <code><span>$</span> .venv/bin/python3 run.py</code>
    1680. 

  1680.       </div>
    1681. 

  1681.     </div>
    1682. 

  1682. 

  1683.     <div class="deploy-card">
    1684. 

  1684.       <div class="deploy-mode">Mode B · Batch</div>
    1685. 

  1685.       <div class="deploy-name">execute_once.py · 单次执行</div>
    1686. 

  1686.       <p class="deploy-desc">一次性走完 10 步流水线,自动取 T-1(昨天)作为数据日期。K8s CronJob 直接调度,可手工调试。完成后退出。</p>
    1687. 

  1687.       <div class="deploy-files">
    1688. 

  1688.         <code><span>$</span> .venv/bin/python3 execute_once.py</code>
    1689. 

  1689.         <code><span>cron</span> 0 2 * * * UTC (每日 02:00)</code>
    1690. 

  1690.       </div>
    1691. 

  1691.     </div>
    1692. 

  1692.   </div>
    1693. 

  1693. 

  1694.   <div style="margin-top: 32px; padding: 24px 28px; background: var(--bg-alt); border-left: 3px solid var(--gold); font-size: 13.5px; color: var(--text-dim); line-height: 1.7;">
    1695. 

  1695.     <strong style="color: var(--gold); font-family: var(--mono); font-size: 11px; letter-spacing: 0.15em; text-transform: uppercase; display: block; margin-bottom: 8px;">K8s 资源</strong>
    1696. 

  1696.     <span style="color: var(--text);">deployment.yaml</span> · 1 副本 + Service + PVC(挂 /app/outputs)<br>
    1697. 

  1697.     <span style="color: var(--text);">cronjob.yaml</span> · 02:00 UTC + forbidConcurrent + 2h deadline<br>
    1698. 

  1698.     <span style="color: var(--text);">configmap.yaml</span> · 公开环境变量<br>
    1699. 

  1699.     <span style="color: var(--text);">secret.yaml</span> · ODPS / Feishu / 腾讯广告 凭证<br>
    1700. 

  1700.     <span style="color: var(--text);">network-policy.yaml</span> · 限制 Pod 出入流量
    1701. 

  1701.   </div>
    1702. 

  1702. </section>
    1703. 

  1703. 

  1704. <!-- ====== 09 · 输出层 ====== -->
    1705. 

  1705. <section id="outputs">
    1706. 

  1706.   <div class="section-head">
    1707. 

  1707.     <div>
    1708. 

  1708.       <div class="section-num">§ 09 — 输出物</div>
    1709. 

  1709.       <h2 class="section-title skills">每次执行<em>留下的痕迹</em></h2>
    1710. 

  1710.     </div>
    1711. 

  1711.     <p class="section-desc">所有中间产物均落盘到 <code>outputs/</code>,可独立回放或调试。生产环境通过 PVC 持久化。</p>
    1712. 

  1712.   </div>
    1713. 

  1713. 

  1714.   <div class="tools-table">
    1715. 

  1715.     <div class="tools-row head">
    1716. 

  1716.       <div>路径</div>
    1717. 

  1717.       <div>类型</div>
    1718. 

  1718.       <div>用途</div>
    1719. 

  1719.       <div>持久化</div>
    1720. 

  1720.     </div>
    1721. 

  1721.     <div class="tools-row">
    1722. 

  1722.       <div class="tool-file">outputs/raw/</div>
    1723. 

  1723.       <div class="tool-cat data">CSV (per day)</div>
    1724. 

  1724.       <div class="tool-fn">ODPS 创意级原始数据。增量缓存,已存在跳过。</div>
    1725. 

  1725.       <div class="tool-step">14 天</div>
    1726. 

  1726.     </div>
    1727. 

  1727.     <div class="tools-row">
    1728. 

  1728.       <div class="tool-file">outputs/merged/</div>
    1729. 

  1729.       <div class="tool-cat data">CSV (per day)</div>
    1730. 

  1730.       <div class="tool-fn">合并多日 + 广告状态快照。下游 ROI 计算的输入。</div>
    1731. 

  1731.       <div class="tool-step">30 天</div>
    1732. 

  1732.     </div>
    1733. 

  1733.     <div class="tools-row">
    1734. 

  1734.       <div class="tool-file">outputs/metrics_*.csv</div>
    1735. 

  1735.       <div class="tool-fn"><code class="tool-cat compute">CSV (latest)</code></div>
    1736. 

  1736.       <div class="tool-fn">广告级指标:动态 ROI 7 日均值、cost_7d_avg、ad_age_days、creative_count 等 30+ 字段。</div>
    1737. 

  1737.       <div class="tool-step">每日</div>
    1738. 

  1738.     </div>
    1739. 

  1739.     <div class="tools-row">
    1740. 

  1740.       <div class="tool-file">outputs/portfolio_summary/</div>
    1741. 

  1741.       <div class="tool-cat compute">JSON</div>
    1742. 

  1742.       <div class="tool-fn">渠道 P25/P50/P75 + tier 级 fission/CTR/bid 均值。</div>
    1743. 

  1743.       <div class="tool-step">每日</div>
    1744. 

  1744.     </div>
    1745. 

  1745.     <div class="tools-row">
    1746. 

  1746.       <div class="tool-file">outputs/reports/llm_decisions_*.csv</div>
    1747. 

  1747.       <div class="tool-cat decide">CSV</div>
    1748. 

  1748.       <div class="tool-fn">LLM 输出 + 规则补全的完整决策表。20+ 字段。</div>
    1749. 

  1749.       <div class="tool-step">每日</div>
    1750. 

  1750.     </div>
    1751. 

  1751.     <div class="tools-row">
    1752. 

  1752.       <div class="tool-file">outputs/reports/validated_decisions_*.csv</div>
    1753. 

  1753.       <div class="tool-cat decide">CSV</div>
    1754. 

  1754.       <div class="tool-fn">护栏校验后的决策表(失败的强制改 hold)。</div>
    1755. 

  1755.       <div class="tool-step">每日</div>
    1756. 

  1756.     </div>
    1757. 

  1757.     <div class="tools-row">
    1758. 

  1758.       <div class="tool-file">outputs/approvals/{request_id}/</div>
    1759. 

  1759.       <div class="tool-cat execute">XLSX + JSON</div>
    1760. 

  1760.       <div class="tool-fn">飞书审批表 + 请求/响应缓存。</div>
    1761. 

  1761.       <div class="tool-step">永久</div>
    1762. 

  1762.     </div>
    1763. 

  1763.     <div class="tools-row">
    1764. 

  1764.       <div class="tool-file">outputs/execution_log/</div>
    1765. 

  1765.       <div class="tool-cat execute">CSV</div>
    1766. 

  1766.       <div class="tool-fn">执行审计:每条决策的 API 调用结果。</div>
    1767. 

  1767.       <div class="tool-step">永久</div>
    1768. 

  1768.     </div>
    1769. 

  1769.     <div class="tools-row">
    1770. 

  1770.       <div class="tool-file">.trace/{trace_id}/</div>
    1771. 

  1771.       <div class="tool-cat report">JSON</div>
    1772. 

  1772.       <div class="tool-fn">框架 Trace 持久化:meta + GoalTree + 所有 messages + events。</div>
    1773. 

  1773.       <div class="tool-step">永久</div>
    1774. 

  1774.     </div>
    1775. 

  1775.   </div>
    1776. 

  1776. </section>
    1777. 

  1777. 

  1778. <footer>
    1779. 

  1779.   <p>auto_put_ad_mini · system architecture map · v0.4.27</p>
    1780. 

  1780.   <p>generated by structural analysis from agent/ + examples/auto_put_ad_mini/ source</p>
    1781. 

  1781.   <span class="stamp">作为 Monitor/调控 Agent 的最小业务单元 · 后续将接入 auto_put_ad 完整体系</span>
    1782. 

  1782. </footer>
    1783. 

  1783. 

  1784. </main>
    1785. 

  1785. 

  1786. <script>
    1787. 

  1787. // Subtle scroll-triggered fade for sections
    1788. 

  1788. const observer = new IntersectionObserver((entries) => {
    1789. 

  1789.   entries.forEach(entry => {
    1790. 

  1790.     if (entry.isIntersecting) {
    1791. 

  1791.       entry.target.style.opacity = '1';
    1792. 

  1792.       entry.target.style.transform = 'translateY(0)';
    1793. 

  1793.     }
    1794. 

  1794.   });
    1795. 

  1795. }, { threshold: 0.1, rootMargin: '0px 0px -100px 0px' });
    1796. 

  1796. 

  1797. document.querySelectorAll('section').forEach(s => {
    1798. 

  1798.   s.style.opacity = '0';
    1799. 

  1799.   s.style.transform = 'translateY(30px)';
    1800. 

  1800.   s.style.transition = 'opacity 0.8s ease-out, transform 0.8s ease-out';
    1801. 

  1801.   observer.observe(s);
    1802. 

  1802. });
    1803. 

  1803. 

  1804. // Pipeline step hover effect: dim non-hovered
    1805. 

  1805. const steps = document.querySelectorAll('.pipeline-step');
    1806. 

  1806. steps.forEach(step => {
    1807. 

  1807.   step.addEventListener('mouseenter', () => {
    1808. 

  1808.     steps.forEach(s => { if (s !== step) s.style.opacity = '0.45'; });
    1809. 

  1809.   });
    1810. 

  1810.   step.addEventListener('mouseleave', () => {
    1811. 

  1811.     steps.forEach(s => { s.style.opacity = '1'; });
    1812. 

  1812.   });
    1813. 

  1813. });
    1814. 

  1814. </script>
    1815. 

  1815. 

  1816. </body>
    1817. 

  1817. </html>
    1818.