DeFi Garden

🌱 DeFi Garden

平和、诚实地发现 DeFi 收益，并根据目标规划储蓄。

DeFi Garden 是一款静态 Web 应用，无需后端，也无需构建步骤。它基于 DefiLlama yields API 构建，面向谨慎的储蓄者和 DeFi 从业者，注重可信度、现实的预测和数学透明度，而非投机炒作。

---

🌟 DeFi Garden 的两大核心用途

DeFi Garden 通过内联、无闪烁的 IA 路由器（home.html 中的 window.__APP_MODE）支持两种截然不同的工作流：

1. 🪴 Garden 规划器（默认体验 — / 和 plan.html）

• 目标优先的对话式储蓄： 围绕现实生活目标（订阅、电子产品、人生里程碑）规划储蓄，而不是追逐抽象的 APY 数字。
• 收益资助模式： “直接买下来，钱就没了。把钱投入 Garden，你既保有本金，又能得到想要的东西。”
• 综合收益率： 计算诚实的“永久数字”——所需的本金金额，让持续产生的实时收益自动支付定期账单。
• 坦诚面对高风险操作： 对可变农场／奖励排放强制应用 ⅓ 衰减折扣，确保用户依据现实的长期收益规划。

2. 📊 分析与收益发现（/?token=、/?chain=、/?pool=、/?app=1）

• 多链资金池浏览器： 实时监控 50 多个区块链（Ethereum、Arbitrum、Base、Hyperliquid、Solana 等）及所有主要协议类型（借贷、质押、LP／DEX、收益耕作）的收益。
• 深入的资金池分析（PoolDetail.js）： 深入分析资金池、跟踪 30 天平均 APY、区分基础排放与奖励排放，并显示无常损失风险指标。
• 资金费率收割模块（/hype-harvest.html / /?module=hype-harvest）： 面向 Hyperliquid 永续合约的 Delta 中性现金套利资金费率计算器，支持实时跟踪基差价差，并提供双预言机偏离熔断机制。

---

🛡️ 信任保障（核心壁垒）

DeFi Garden 中呈现的所有指标均来自实时链上数据和 API 数据，并受到严格、不可妥协的信任保障机制约束：

1. APY_SANITY_LIMIT = 1000%： 异常的短期飙升绝不会进入规划方案。在分析中，异常资金池会被降级、标记为 ⚠，并强制归类为高风险。
2. DEFAULT_MIN_TVL = $100K： 低于安全底线的低流动性资金池会被过滤，以保护储蓄者免受退出流动性不足和突然弃用的影响。
3. 双预言机偏离防护： 模块会验证标记价格与预言机价格的偏离情况（熔断阈值为 $<15\text{ bps}$），以便对基差失衡和挤压风险发出警报。
4. 确定性数学层： 大模型可以叙述或解释机制，但数字、预测和复合收益均通过确定性计算得出。

---

🎨 设计系统——“Quiet”

DeFi Garden 使用 “Quiet” 设计系统——简约克制、以表格为先的界面，旨在清晰呈现信息，帮助用户专注：

• 表面令牌（--ui-*）：
  • 背景：--ui-bg（浅色 #F7F8FA / 深色 #161A20）、--ui-surface（#FFFFFF / #1E242C）、--ui-surface-muted、--ui-surface-sunken。
  • 分隔：单像素细边框（--ui-border: #E4E7EE、--ui-border-strong: #CBD2DF）。
  • 文本：高对比度层级（--ui-text: #10151F、--ui-text-secondary: #5A6478、--ui-text-muted: #8A93A6）。
  • 强调色：固定的信任蓝色调色板（--ui-accent: #3B82F6、--ui-accent-hover: #2563EB、--ui-accent-soft: #EFF5FF）。
  • 圆角：简洁的几何圆角（--ui-radius-sm: 8px、--ui-radius-md: 12px、--ui-radius-lg: 16px、--ui-radius-pill: 999px）。
• **不使用厚重阴影或拟物纹理：**通过清晰的细边框和细微的表面色调层次营造纵深感，而非使用人造的双向阴影或背景渐变。
• **真实的按压反馈：**交互控件在 :active 状态下下沉 1px（transform: translateY(1px)），并遵循 prefers-reduced-motion 设置。
• **完善的双语支持（translations.js）：**完整的英语（en）和韩语（ko）本地化，并确保所有面向用户的字符串保持同步。

---

🛠️ 架构与技术栈

• **无需构建步骤：**原生使用 Web 标准运行。React 18 UMD 通过 script 标签加载；组件使用纯 React.createElement 编写（无需 JSX 编译步骤）。
• **数据接入：**在客户端集成 https://yields.llama.fi/pools 和 Hyperliquid Info API（https://api.hyperliquid.xyz/info）。
• 状态管理：
  • 主题：localStorage.getItem('theme')，并在 <html> 上设置 data-theme="light|dark" 属性。
  • 语言：URL 参数 ?lang= + localStorage.getItem('defi-garden-lang')。
  • 已保存的计划：localStorage.getItem('garden-plan')。
• SEO 与机器可读性：
  • 自动生成动态站点地图（generate-sitemap.js）。
  • AI 上下文端点：llms.txt 和 llms-full.txt（generate-llms.js）。
  • 模型上下文协议（MCP）服务集成（mcp_server.js）。

---

📁 仓库结构

defi_garden/
├── home.html                   # Master router & analytics app shell
├── plan.html                   # Standalone Garden Planner entry
├── hype-harvest.html           # HYPE Funding Harvest module
├── planner.js                  # Conversational Garden Planner engine
├── app.js                      # Core analytics grid & pool filtering
├── PoolDetail.js               # In-depth pool analytics & calculator
├── hype-harvest.js             # HYPE funding harvest React UMD module
├── translations.js             # Bilingual dictionary (EN + KO)
├── translations.min.js         # Production-minified translation dictionary
├── style.css                   # "Quiet" design system tokens & base styles
├── planner-styles.css          # Planner-specific layout styles
├── pool-detail-styles.css      # Pool detail drawer styles
├── hype-harvest.css            # Funding harvest layout styles
├── trust-rails.js              # Shared trust-rail constants
├── canonical.js                # URL canonicalization logic
├── keeper/                     # Autonomous execution & risk keeper scripts
│   ├── keeper_engine.py        # Core risk keeper engine
│   └── hype_funding_harvest.py # Hyperliquid HYPE funding rate worker
├── tests/                      # Python unit & integration test suite
│   ├── test_keeper_engine.py
│   └── test_keeper_hype_harvest.py
└── test_*.js                   # JavaScript offline test suite (71+ test files)

---

🧪 开发与测试

DeFi Garden 无需构建流程。使用任意静态 HTTP 服务在本地运行：

# Start local server
python3 -m http.server 8000
# Open in browser: http://localhost:8000

运行测试

# Run all unit tests in fast plain mode
npm run test:fast

# Run the complete test suite (plain + browser)
npm test

# Minify production assets
npm run minify

---

📜 许可证

MIT 许可证。详情请参阅 LICENSE。