它能做什么
“出发前我需要准备什么？”是旅行领域仅次于“我需要签证吗？”的第二大高频问题。现有答案——千篇一律的“国际打包清单”PDF、AI 生成的榜单文、旅行社宣传册——都有同一个毛病：与访客具体的目的地 + 护照组合毫无关联。
Orizn 旅行清单小组件用两个 ISO3 输入（目的地、护照）和一个数字（行程时长）即时组装一份清单。证件板块沿用签证查询器的签证图谱，疫苗来自 WHO IHR + CDC 旅行健康通告，装备板块采用气候感知的打包模板，货币板块接入当地货币数据。
小组件自挂载，勾选状态持久化到 localStorage（无第三方 cookie，符合 GDPR），并自带打印导出 PDF 按钮。把两行代码放到每篇国家攻略底部，你就拥有了一条高转化的行前准备流——读者出发前会多次回访，每次回访都是联盟指南 CTA 的又一次转化机会。
小组件构建器
下方的小组件运行的正是你将粘贴到自己网站上的生产脚本。每个选项都会即时更新预览和代码——语言、主题、颜色、白标——调好后复制两行代码即可。
Live preview · updates as you type
The widget above runs the exact production script you would paste on your own site — async, zero dependencies, scoped CSS. Every option on the left maps to a data-* attribute in the snippet.
功能特性
具体、有数据来源的功能——不是空泛的勾选项。以下每一条今天都已在生产版小组件中上线。
两个 ISO3 输入即可重建整份清单：该护照所需的证件、目的地强制的疫苗、匹配气候的行李，以及针对当地货币的用钱建议。
证件、健康、行李、货币。每个板块可折叠。每一项都有可点击的勾选标记，状态持久化到 localStorage，访客随时可以回来继续。
健康板块从 WHO IHR 和 CDC 旅行健康通告拉取强制及推荐疫苗，每周刷新。黄热病条目会明确标注证书要求。
拖动 1 天到 60 天的滑块，行李清单随之重算：更多换洗衣物、更多充电器、更多出入境文件副本。不再是一成不变的“度假打包清单”。
沿用签证查询小组件的同一签证图谱。如果目的地需要签证，清单会自动加入“申请签证”一项并附使馆 URL。
一键生成含访客勾选状态的单页可打印 PDF。对喜欢纸质副本的年长旅行者尤其实用。
清单底部的 CTA 指向完整的目的地指南。设置 data-affiliate 后，每次转化的 50% 归你。
纯原生 JS，异步加载。清单状态仅保存在本地——无第三方跟踪、无指纹采集，默认即符合 GDPR。
最佳场景
小组件是通用的，但以下四类用户使用最多。只要你符合其中任何一类，粘贴代码后几分钟内就能见效。
在每篇目的地文章末尾嵌入。正在做行前准备的读者在联盟 CTA 上的转化率是冷流量的 3-5 倍。
把小组件放进“为旅行做准备”系列的网页版。订阅者逐项完成清单，转化归因到你的联盟代码。
顶部放签证查询小组件，底部放清单小组件。同一页面在一个漏斗里同时回答“要不要签证”和“怎么准备”。
置顶在 /resources/first-trip。40 项个性化清单能消解“我是不是忘了什么”的焦虑——这是旅行领域转化率最高的情绪触发点。
数据从何而来
证件板块来自 Orizn 签证图谱（200+ 使馆数据源）。疫苗来自 WHO《国际卫生条例》与 CDC 旅行健康通告，每周刷新。行李基于以 Open-Meteo 30 年气候平均值为键的气候感知模板。用钱建议来自人工整理的 195 国数据集（银行卡受理度、ATM 可用性、常见骗局）。
参考
每个选项都是容器 div 上的一个 data-* 属性。无需任何 JavaScript 配置——粘贴、设置想要的属性、上线。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
data-destination | ISO3 | "" | 清单所针对的目的地国家（如 VNM）。 |
data-passport | ISO3 | "" | 访客的护照（如 FRA）。决定签证与证件部分的内容。 |
data-lang | string | "auto" | 覆盖浏览器语言自动检测。支持 16 种语言：en、fr、es、de、it、pt、ja、ko、zh、ru、ar、hi、th、vi、tl、tr（阿拉伯语以 RTL 呈现）。 |
data-theme | string | "auto" | 强制主题："auto"（跟随系统）、"light" 或 "dark"。 |
data-affiliate | string | "" | 你的 ORIZN-XXXXX 或 aff_… 联盟代码（两种格式均可），用于获得指南销售的 50/50 分成。 |
data-color | hex | #2563EB | 进度条、勾选标记和 CTA 的强调色。仅接受十六进制色值（会做安全过滤）。 |
data-branding | string | "on" | 设为 "off" 即可白标：隐藏“Powered by Orizn”页脚、JSON-LD 结构化数据以及分享文案中的 orizn.app 字样。 |
data-radius | int | 16 | 小组件卡片和输入框的圆角半径（px）。 |
data-font | string | "system-ui" | 整个小组件使用的字体族。任何 CSS 字体栈均可。 |
集成
同样的两行代码，不同技术栈的粘贴路径略有差异。各 CMS 的分步指南：
变现
在容器 div 上添加 data-affiliate="ORIZN-XXXXX" 即可——ORIZN-… 和 aff_… 两种代码格式均可。读者通过小组件购买的每份指南在点击后 30 天内归因到你，收益每月通过 Stripe 结算。无最低门槛、无追回条款，联盟后台数据完全透明。
常见问题
来自集成小组件的开发者、博主和联盟营销者的真实问题。如果没找到你的问题，/embed/getting-started 的文档覆盖了更长尾的内容。
相关小组件
五个小组件共享同一运行时，因此在页面上再加一个不产生任何额外开销。整个套件就是为组合而设计的。