Desire Page Protocol
让页面成为智能体的一等公民

01三层接入，一分钟上线

按投入从低到高，三个层级随时可用、可以叠加（高层级覆盖低层级）：

02声明什么：views · actions · events

一个典型的 L3 声明长这样（来自演示商店）：

desire.expose({
  views: {
    products: { item: ".card[data-sku]",
      fields: { title: ".name", price: {selector: ".price", type: "price"},
                sku: {selector: ".", attr: "data-sku"} } }
  },
  actions: {
    "add-to-cart": { params: {sku: {type: "string", required: true}},
                     run: [{click: ".card[data-sku='{sku}'] button.add"}],
                     effects: "persist" },
    checkout: { run: [{click: "#checkout-btn"}], effects: "outbound" }
  },
  events: { "order-placed": {watch: ".toast.order"} }
});

• views —— 结构化数据视图：选择器 + 字段类型（price/number/url/date 自动转换），pageExtract("products") 一次读全，支持 paged / infinite 自动翻页。
• actions —— 声明式动作：pageAction("add-to-cart", {sku})； effects: "outbound" 的动作（下单、提交）会先向用户请求批准，危险操作不静默。
• events —— 事件唤起： watched 的 DOM 事件发生时（如订单落定），智能体被自动唤醒处理。
• ignore —— 噪音区：广告位、推荐流标上 data-dpp-ignore，智能体视而不见。

03L3 SDK：一行脚本，全量能力

在任意页面引入：

<script defer src="https://desire.mankong.icu/desire-sdk.js"></script>

SDK 提供类型化字段抽取、动作执行器、事件观察与自动化翻页；与 Desire 的信任分级 （站点声明 < 页面声明 < 用户显式指令）天然协同——声明只描述能力，执行永远经过用户的 访问等级与审批闸门。

隐私边界：声明与抽取全部在本机完成，页面数据不上传；跨源 iframe 的声明聚合与 定向提取在宿主侧实现，页面之间互相不可见。

04演示商店：真实请求的活样本

desire.mankong.icu/demo/ 是一个按 DPP 接入的迷你商店：购物车与下单是真实请求（写入演示服务的内存，非真实交易）。用 Desire 打开后对智能体说：

• 「列出商品」→ pageExtract("products") 读结构化数据（价格已转数字、SKU 可加购）
• 「把 sku 是 kb-01 的商品加入购物车，再来一把」→ pageAction("add-to-cart", …)
• 「去结算」→ pageAction("checkout")——该动作声明了 effects: "outbound"，会先向你请求批准
• 下单成功的那一刻 → 订单列表出现新行，order-placed 事件自动唤起智能体

页面右下角的虚线框是 data-dpp-ignore 标注的噪音横幅——智能体会绕开它。

05兼容性与边界

• 非 Desire 浏览器完全无感：声明只是页面里的静态数据，不执行任何行为。
• 同源 iframe 的声明与提取已支持；跨源 iframe 已完成可行性验证（宿主侧聚合与定向提取），后续版本交付。
• 单页应用：SPA 路由变化会触发重新解析，声明可随时更新。
• well-known 支持登录态指引（loginUrl 等），帮助智能体在需要时引导用户登录。