让产品被人看到
也被 AI 理解
基于 Cloudflare 全栈构建的 AI-native 产品可发现性平台，一周落地，月费 $1-3。覆盖产品网页、AI 选型对话、MCP 工具调用、LLM 可读索引全链路。
MVP 方案背景
AIBridge V4 方案目标：用 Cloudflare 免费资源在一周内跑通完整链路，验证「AI-native 产品可发现性」概念。
四项核心验证能力
LLM 可发现目录
通过 /llms.txt 和 /llms-ctx.txt 让 AI 爬虫（ChatGPT、Claude、Perplexity）自动发现 CONNTEK 产品目录。
结构化 REST API
外部系统通过 API 做参数搜索（电压、封装、接口）和竞品替代查询，返回 JSON 格式结果。
AI 选型对话
受保护的 /agent/chat 端点，调用 DeepSeek LLM 做智能选型推荐，支持中英文。
MCP Server
5 个工具供 Cursor、Claude Code 等 AI 开发工具直接查询产品规格，Streamable HTTP 传输。
技术选型
| 项目 | 选择 | 说明 |
|---|---|---|
| Worker 框架 | Workers + Hono + TypeScript | 单 Worker 跑全部端点 |
| 数据库 | D1 (边缘 SQLite) | 7 个产品，5 个索引 |
| MCP | @modelcontextprotocol/sdk | WebStandard Streamable HTTP 传输 |
| LLM 推理 | DeepSeek API | ~$1-3/月 |
| 前端 | VitePress → Cloudflare Pages | 静态站 + Vue 组件 |
| 认证 | Bearer Token + x-api-key | 公开/受保护接口分离 |
明确的非目标
系统架构
Design Center
AIBridge Worker
数据流向
功能展示
点击卡片可直接访问线上地址。
Design Center 首页
产品系列总览、应用方案、技术资源入口
产品页 KTH5772
规格表、Datasheet 下载、应用电路、订购信息
AI 选型助手
基于 DeepSeek 的智能对话选型，支持中英文
llms.txt
AI 爬虫专用产品目录，Markdown 格式
API 参数搜索
搜索 3.3V 兼容产品，返回 JSON
竞品替代查询
查找 TI DRV5032 的 CONNTEK 替代型号
谁在用这些数据
AI 友好度评测
由外部 AI Agent 独立测试评分，三轮迭代从 6.5 提升到 9 分。
- 新增
/llms.txt— 完整产品目录 + API 入口 + AI 助手链接 - 新增
/llms-ctx.txt— 7 产品紧凑参数 + Quick Selection Guide - 启用
/sitemap.xml— VitePress 自动生成，覆盖全部页面 - 新增
/robots.txt— 含 Sitemap 指向 - 每个产品页添加独立
meta description（含型号、参数、应用场景）
- 补建 4 个缺失产品页（KTH5701、KTH5702、KTH5721、KTH3601）
- 对齐 llms.txt、sitemap、实际页面三者一致
- sitemap 从 4 个产品扩充到 8 个产品
- llms.txt / llms-ctx.txt:
Cache-Control: public, max-age=3600 - sitemap.xml:
max-age=3600 - robots.txt:
max-age=86400
当前状态清单
产品数据现状
已上线产品
| 型号 | 分类 | 网页 | AI 数据库 | Datasheet | 负责人 |
|---|---|---|---|---|---|
| KTH5701 | 3D Hall | ✓ 在线 | ✓ 已入库 | ✓ 中/英 | zuoxinchi |
| KTH5702 | 3D Hall | ✓ 在线 | ✓ 已入库 | ✓ 中/英 | zuoxinchi |
| KTH5721 | 3D Hall | ✓ 在线 | ✓ 已入库 | ✓ 中文 | zuoxinchi |
| KTH5771 | 3D Hall | ✓ 在线 | ✓ 已入库 | ✓ | liaochongqi |
| KTH5772 | 3D Hall | ✓ 在线 | ✓ 已入库 | ✓ | liaochongqi |
| KTH5774 | 3D Hall | ✓ 在线 | ✓ 已入库 | ✓ | liaochongqi |
| KTH5791 | 3D Hall | ✓ 在线 | ✓ 已入库 | ✓ | wangchao |
| KTH3601 | Linear Hall | ✓ 在线 | Preview | Preview | liaochongqi |
待补充数据
| 产品 | 缺失项 | 负责人 |
|---|---|---|
| KTH5701 | 工作电流 (IDD)、绝对最大额定值 | zuoxinchi |
| KTH5702 | 工作电流、工作温度、绝对最大额定值、封装尺寸 | zuoxinchi |
| KTH5721 | 工作电流、绝对最大额定值、封装尺寸 | zuoxinchi |
| KTH5771 | 工作电流 | liaochongqi |
| KTH5774 | 工作电流 | liaochongqi |
| KTH5791 | 工作电流 | wangchao |
| 全部产品 | 竞品替代关系 (cross_references) | 各负责人 |
产品 Pipeline（待 AE 提供 YAML）
| 型号 | 类型 | 说明 |
|---|---|---|
| KTH5761/5762/5763 | 3D Hall | 智能手表专用，首页已提及 |
| KTH5503 | 3D Hall (I2C) | 替代 TLV493D / TMAG5373 |
| KTH5581 / KTH5502 | 待确认 | 负责人: liaochongqi |
| KTH5591 | 待确认 | 负责人: wangchao |
| KTH5565 | 待确认 | 负责人: dongfei |
| KTH31xx / KTM36xx | Linear Hall | 负责人: yangzhili |
AE 工程师指南
AE 只需要做 3 件事
填入 YAML 模板
放到指定目录
网页和 AI 更新
不需要写代码、不需要碰网页、不需要懂前端。只需关注你熟悉的产品本身。
字段优先级
没有这些产品无法上线
- product_id, name, tagline
- category, status, owner
- overview.summary
- overview.key_features (3-6个)
- specs.recommended_operating
- packages (至少一个)
- documents.datasheets (至少一份)
- metadata.created / updated
让 AI 推荐更精准
- specs.absolute_maximum_ratings
- specs.performance (采样率/精度)
- overview.advantages_table
- applications.target_markets
- applications.related_products
丰富产品页面
- documents.software (驱动/库)
- documents.hardware (参考设计)
- documents.videos (演示视频)
- applications.application_circuit
- specs.interface (接口参数)
YAML 最小示例（新产品 KTH5503）
product_id: KTH5503 name: "KTH5503 - 3D Hall Sensor (I2C)" tagline: "3D 霍尔传感器，I2C 接口，可替代 TLV493D/TMAG5373" category: 3d-hall status: preview owner: zuoxinchi overview: summary: | KTH5503 是一款 3D 霍尔传感器，支持 I2C 接口， 可作为 TLV493D 和 TMAG5373 的国产替代方案。 key_features: - title: "I2C 接口" description: "标准 I2C 通信，易于集成" - title: "3D 磁场检测" description: "X/Y/Z 三轴同时测量" specs: recommended_operating: - name: "Supply Voltage" min: 2.8 typ: 3.3 max: 5.5 unit: "V" packages: - part_number: "KTH5503AQ3QNS" package_type: "QFN3x3-16L" pin_count: 16 documents: datasheets: - name: "KTH5503 Datasheet" url: "/downloads/KTH5503/KTH5503_Datasheet_preview.pdf"
填写规则速查
不要猜参数
不确定的值写 null 并加 # TODO 注释
单位要准确
电压 V、电流 mA/uA、温度 C、频率 Hz
文件名 = 型号
KTH5772.yaml → product_id: KTH5772
tagline ≤ 80 字
一句话说清核心卖点，中文为主
PDF 放对目录
docs/public/downloads/型号/
Min ≤ Typ ≤ Max
确保数值逻辑合理
AI 时代的两种必备语言
在这个项目中，我们验证了一个关键洞察：结构化数据负责"准"，Markdown 负责"通"。 作为 AE 工程师，掌握 YAML 和 Markdown 这两种格式，是 AI 时代的基础能力。
三层信息架构模型
我们的项目已经在实践这个模型——AE 填 YAML，系统生成 Markdown 语义层，再分发到各个终端。
YAML / 数据库
存储规范化参数、枚举值、单位、状态、关系。保证"准"。
用途：参数搜索、产品对比、API 输出
维护者：AE 工程师
Markdown
存储产品定位、应用场景、选型建议、竞品说明。保证"通"。
用途：llms.txt、AI Prompt、产品页源文件
维护者：AE + 系统自动生成
HTML / JSON / Prompt
分别服务浏览器、程序、LLM。保证"达"。
用途：产品网页、REST API、Chat 回复
维护者：系统自动生成
为什么 AE 要掌握 YAML
YAML 是产品数据的事实源。我们的选型工具能按电压、温度、接口精确筛选产品， 靠的就是 YAML 中结构化的数值字段。
如果没有 YAML 的 Schema 约束，多人协作时"3.3V"、"3.3 V"、"3.3v"、"2.8-5.5V" 这些写法对人一样，但对程序和 AI 完全不同。YAML 强制统一格式，消灭歧义。
supply_voltage: min: 2.8 # 精确数值 typ: 3.3 # 有单位约束 max: 5.5 # 可做范围查询 unit: "V" # 不会写成 "伏特"
YAML 能做到、Markdown 做不到的事
- ✓
voltage=3.3精确搜索所有兼容产品 - ✓ 自动校验 Min ≤ Typ ≤ Max
- ✓ 枚举约束（status 只能是 active/preview/eol）
- ✓ 多语言字段完整性检查
- ✓ 跨产品参数对比表自动生成
- ✓ API 返回标准 JSON 格式
如果只用 Markdown 会怎样？
- ✗ "2.8-5.5V" vs "2.8 to 5.5V" — 程序无法统一解析
- ✗ 多人维护后格式漂移，一致性崩溃
- ✗ 要做搜索/对比，被迫再结构化一次
- ✗ 复杂度后移，而不是消灭
为什么 AE 要掌握 Markdown
Markdown 是信息流通的语义总线。我们的 AI 友好度从 6.5 分跳到 9 分， 核心转折点就是加了两个 Markdown 文件（llms.txt 和 llms-ctx.txt）。
LLM 的训练数据中，Markdown 是最常见的结构化文本之一。对 AI 来说， 读 Markdown 就像人读母语——零翻译成本。
## KTH5772 - Gaming Joystick 3D Hall Supply: 2.8-5.5V | IF: I2C, UART | IDD: 4mA Apps: gaming joystick, position tracking → 3 行 = 一个产品的完整画像 → 人能读、AI 能读、可直接注入 Prompt
Markdown 能做到、YAML 做不到的事
- ✓ 产品定位和应用场景的自然语言描述
- ✓ 竞品对比的人类可读叙述
- ✓ 直接作为 LLM 上下文注入
- ✓ AI 爬虫零成本消费（llms.txt）
- ✓ 同时服务人类阅读和 AI 理解
- ✓ Git diff 一目了然
同样信息，不同格式的 Token 消耗
| Markdown | ~80 tokens | 基准 |
| JSON | ~200 tokens | 2.5x |
| HTML | ~350 tokens | 4.4x |
| 无法直接输入 | ∞ |
AI 友好的 5 个本质特征
Markdown 之所以对 AI 有效，不是因为文件扩展名，而是因为它天然满足以下 5 条。理解这 5 条比记住格式更重要。
成本低
密度高
清晰
稳定
不漂移
在我们项目中的实际数据流
下图展示了产品信息如何从 AE 笔下流向 6 类消费者，以及每个环节用的格式。
给 AE 同事的一句话总结
常见问题
overview.advantages_table — 改善竞品对比回答applications.target_markets — 改善"什么场景用什么芯片"的回答specs.performance — 改善参数对比回答
1. 写在 YAML 的
overview.advantages_table 中（对比竞品名+各项优势）2. 直接告诉管理员"KTH5503 可替代 TLV493D"，管理员会录入数据库
文档维护: @liyandong | 最后更新: 2026-03-26 | CONNTEK AIBridge v1.0