# 04 - 决策日志 ## 决策记录模板 每次做出关键判断时，按以下格式追加： ```text 日期： 问题： 结论： 依据： 风险： 下一步： ``` ## 2026-05-29 日期：2026-05-29 问题：第一阶段应该先从完整平台/独立站搭建开始，还是从第一笔交易验证开始？ 结论：先从第一笔真实海外交易验证开始。 依据：独立站缺少自然流量；Amazon/Walmart/SHEIN/TikTok Shop US 等平台入驻和履约门槛较重；Gumroad/eBay/轻量 landing page 更适合低摩擦验证。 风险：过于追求低门槛可能导致验证的市场代表性不足。数字商品成功不一定能迁移到实物跨境电商。 下一步：预检 Gumroad payout、eBay 卖家收款、Temu 中国/香港卖家入口。 ## 2026-05-29 渠道初筛 日期：2026-05-29 问题：第一轮渠道应优先哪些？ 结论：优先 Gumroad，其次 eBay；Temu 进入研究池但不直接作为第一实验入口；SHEIN、Walmart、TikTok Shop US、Amazon、Etsy 暂缓。 依据：Gumroad 无月费且支持数字商品；eBay 可轻量实物测试；Temu 官方有 seller center 但卖家路径和履约模式需拆解；SHEIN 明显要求成熟商家材料。 风险：Gumroad payout 路径可能因国家/KYC 受限；eBay 可能存在账号和收款验证摩擦。 下一步：做渠道准入预检，而不是马上制作商品。 ## 2026-05-29 支付与资质路径初筛 日期：2026-05-29 问题：独立站第一轮交易实验应优先研究哪条收款路径？ 结论：优先预检 PayPal 中国商家账户和 MoR checkout；暂缓 Stripe 直连中国大陆主体、Shopify Payments 中国大陆主体和 Payoneer Checkout 作为第一轮默认入口。 依据：Shopify 官方说明大陆 Shopify Payments 不可用；Stripe 全球可用国家不含中国大陆；PayPal 中国提供商家收款能力；Gumroad/Paddle/Lemon Squeezy 等 MoR 更适合数字商品轻量验证；Payoneer Checkout 中文官方页显示更偏成熟商家和香港法人路径。 风险：PayPal/MoR 的实际 KYC、风控、payout 和商品限制仍需后台实测；官方公开页不能替代真实账户开通结果。 下一步：执行 PayPal 中国商家账户预检、MoR payout 预检、第三方 PSP 资料要求清单。 ## 2026-05-29 支付路径优先级修正 日期：2026-05-29 问题：用户已有 Airwallex 商户和香港公司资质后，独立站第一轮收款路径是否需要调整？ 结论：需要调整。Airwallex + 香港公司升为第一优先；PayPal 中国商家账户变为备用路径；Stripe 香港路径列为可选项；Shopify Payments 香港路径观察但不默认优先。 依据：Airwallex 官方香港公司资料页列出香港公司开户/验证所需资料；Airwallex Payments 官方文档支持 Online Payments、Payment Links、Hosted Checkout、Shopify/WooCommerce plugins；Shopify 官方说明香港 Shopify Payments 需要香港实体、物理运营和 HKD 香港银行账户；Stripe 香港路径仍需对应主体和验证资料。 风险：用户已有 Airwallex 商户可能是应用/游戏业务，目标独立站电商品类可能需要补充审核、网站资料、商品说明、物流/退款政策、reserve 或风控审查。 下一步：执行 Airwallex 当前账户能力预检，确认 Online Payments、目标品类、Payment Links、Hosted Checkout、Shopify/WooCommerce plugin、结算币种和争议规则。 ## 2026-05-29 支付接入商决策边界 决策：不把 Adyen、Checkout.com、Mollie、Authorize.Net 作为第一轮独立站默认支付接入路径。 理由：当前目标是快速验证第一笔成功交易。用户已有 Airwallex 商户和香港公司资质，Airwallex 的边际开通成本最低。其他 PSP 或偏企业级、或偏区域市场、或需要额外商户账户/公司路径，适合作为放量后或目标市场明确后的分支。 保留条件：若 Airwallex 无法支持目标商品类目、审核周期过长、费率/储备金不可接受，Stripe HK 与 PayPal/Braintree 进入主线备选。 ## 2026-05-29 美国公司暂不进入执行 决策：暂不马上开美国公司。 理由：当前项目目标是快速完成第一笔真实海外交易。用户已有香港公司和 Airwallex 商户，优先验证 Airwallex HK 路线的成本更低。美国公司会引入注册代理、EIN、银行 KYC、Form 5472、联邦/州税务、sales tax、产品与进口合规等新复杂度。 触发条件：Airwallex/HK 路线被明确卡住，或 Stripe US / Braintree US / Shopify Payments US / 美国 3PL / importer of record / 融资路线带来明确收益时，再进入美国公司设立执行。 ## 2026-05-29 美国公司触发条件决策树 决策：将美国公司分支拆分为三条路线：不开美国公司、美国 LLC、Delaware C-Corp。 当前路线：不开美国公司，继续 HK 公司 + Airwallex。 LLC 触发条件：支付、银行、美国履约、进口、信任任一方面出现明确瓶颈。 C-Corp 触发条件：融资、股权、期权、SaaS/AI Agent 产品资本化。 理由：外国人可以开美国公司，但卖到美国不必然需要美国公司。过早设立会引入 Form 5472、ECI、sales tax、PSP/KYC、进口和产品合规等复杂度。 ## 2026-05-29 营业额梯度触发模型 决策：引入营业额梯度触发权重模型，但不把营业额作为唯一触发器。 当前状态：T0/T1，不执行美国公司设立。 触发规则：美国月营业额超过 $10k 或美国订单连续 3 个月稳定增长时，启动 CPA/PSP/银行/3PL 预检；美国月营业额超过 $30k 且美国订单占比超过 60% 时，正式评估美国 LLC。 ## 2026-05-29 研究共享方案 决策：采用三层共享架构。 - 本地 Markdown/HTML：Source of Truth。 - Notion：Partner Portal。 - NotebookLM：Research Copilot。 理由：创业伙伴需要低摩擦阅读、评论和讨论，Notion 适合作为共享入口；NotebookLM 更适合围绕资料问答和消化，不适合作为唯一知识库。 ## 2026-05-29 Notion Partner Portal 试运行 决策：开始试运行 Notion 共享入口。 已创建页面： - 海外电商独立站研究项目 - 伙伴入口：https://www.notion.so/36fcc6ad6fa481f7a335f51b5155a15e - 研究共享索引：https://www.notion.so/36fcc6ad6fa481539c46dded236ac036 - 待验证问题与伙伴分工：https://www.notion.so/36fcc6ad6fa48157a951d556fb598a54 边界：Notion 作为 Partner Portal，本地 Markdown/HTML 仍为 Source of Truth。第一轮只分享给 1-2 位可信伙伴，权限建议 Can comment。 ## 2026-05-29 共享层策略与套餐判断 决策：Notion 作为研究同步共享层，HTML 继续作为阅读/交互层，本地 Markdown/HTML 作为 Source of Truth。 当前不升级 Notion 付费套餐。理由：当前仅需 1-2 位可信伙伴试运行，Free plan 的页面、共享、Basic sites、10 个 guest 和 5MB 单文件上传限制足够。 HTML 共享策略：不直接分享本机 `file://` 路径；如果伙伴需要交互式 HTML，则后续使用 GitHub Pages、Cloudflare Pages 或 Netlify 发布静态站。 ## 2026-05-29 引入 Cloudflare Pages 作为 HTML 发布层 决策：如果 Notion 不满足 HTML 交互浏览需求，引入 Cloudflare Pages 作为 HTML 发布层。 执行：已创建 `site/` 发布目录、`site/index.html` 入口页、`site/_headers` 基础响应头，以及 `scripts/build-cloudflare-pages-site.sh` 构建脚本。 边界：不发布项目根目录，不发布敏感资料。Cloudflare Pages 只承载可共享 HTML 阅读层；Notion 继续作为 Partner Portal；本地 Markdown/HTML 继续作为 Source of Truth。 ## 2026-05-29 Cloudflare Pages 推送实践与链接治理 决策：由 Codex 辅助 Cloudflare Pages 发布时，优先使用 Wrangler Direct Upload + `site/` 白名单目录 + API Token 环境变量。 链接治理：源文件可保持中文命名，但发布到 `site/` 时使用英文 slug，降低公网 URL、Notion 粘贴和伙伴转发的摩擦。Atlas 发布版不链接本地 `research/*.md`，避免公网 404 和源仓库误发布。 后续升级：更新频率变高后，再接 GitHub/GitLab 与 Cloudflare Pages Git integration 自动部署。 ## 2026-05-29 Cloudflare Pages 部署试运行 结果：部署未完成。 进展：Node/npm 已通过 Homebrew 安装完成，Wrangler 已能启动。 阻塞：Codex 执行环境读取不到 `CLOUDFLARE_API_TOKEN`，Wrangler 在非交互环境中要求该变量存在。 处理：已让 `scripts/deploy-cloudflare-pages.sh` 支持读取本地 `.cloudflare-pages.env`，并将 `.cloudflare-pages.env` 加入 `.gitignore`。用户可在该文件中本地保存 token，然后再次运行部署。 ## 2026-05-29 Cloudflare Pages 域名策略 决策：Pages 部署成功后，暂时使用 Cloudflare Pages 默认 `*.pages.dev` 链接，不配置自定义域名。 理由：当前目标是验证 HTML 共享层是否适合伙伴阅读，不需要提前引入域名、DNS、品牌化和访问控制复杂度。部署成功后只需把 Pages 链接回填到 Notion 伙伴入口、研究共享索引和 Cloudflare Pages 说明页。 ## 2026-05-29 Cloudflare Pages 首次部署成功 结果：Cloudflare Pages 首次部署成功。 - Project：`ecommerce-research-portal` - 生产入口：https://ecommerce-research-portal.pages.dev/ - 本次部署预览：https://f21d3df9.ecommerce-research-portal.pages.dev - 上传文件数：18 已将 Pages 链接回填到 Notion 伙伴入口、研究共享索引和 Cloudflare Pages 说明页。当前暂不配置自定义域名。 ## 2026-05-29 Notion 与 Cloudflare 共享链路经验沉淀 结论：本项目完成了从本地研究沉淀到可共享研究系统的第一次闭环。 最终分工：本地 Markdown/HTML 作为 Source of Truth，Notion 作为 Partner Portal，Cloudflare Pages 作为 HTML Reading Layer，NotebookLM 后续作为 Research Copilot。 当前生产入口：https://ecommerce-research-portal.pages.dev/ 准则：共享层不等于源仓库；先可用再优雅；先白名单发布再自动化；敏感内容默认不发布；Notion 负责讨论，Pages 负责阅读。 ## 2026-06-03 Markdown 源文档纳入 Pages 决策：将经过白名单筛选的 Markdown 源文档发布到 Cloudflare Pages，解决合作伙伴无法查看源文档的问题。 执行：构建脚本复制当前可共享 Markdown 到 `site/research/`，并生成 `site/research/index.html` 作为文档索引。 边界：不直接发布整个 `research/` 目录；未来敏感 Markdown 默认不进入白名单。 ## 2026-06-03 Markdown 源文档部署成功 结果：Cloudflare Pages 已重新部署成功，Markdown 源文档已上线。 - Markdown 文档索引：https://ecommerce-research-portal.pages.dev/research/index.html - 本次部署预览：https://b44c0471.ecommerce-research-portal.pages.dev - 上传统计：40 个文件，其中 29 个新上传，11 个已存在 Notion 已回填 Markdown 索引链接。合作伙伴现在可以通过 Pages 查看源 Markdown 文档。 ## 2026-06-03 进入选品方法论与技术实现阶段 决策：支付与主体资质已达到阶段性充分，下一主线进入选品调研方法论与技术实现。 当前方法：将选品定义为可验证交易假设，而不是找爆品。先建立交易假设卡、六维评分模型、证据分层和最小实验，再考虑 Agent 自动化。 技术边界：先做半自动研究台，后续再演进为 Agent 工作流。 ## 2026-06-03 选品方法论专题上线 结果：选品调研方法论与技术实现路线已发布到 Cloudflare Pages，并同步到 Notion。 - HTML：https://ecommerce-research-portal.pages.dev/product-research-methodology.html - Markdown：https://ecommerce-research-portal.pages.dev/research/25-选品调研方法论与技术实现路线.md 下一步：建立商品机会池，目标是先收集 10 个商品假设，再筛出 3 个候选评分，最后选择 1 个进入最小交易实验。 ## 2026-06-03 选品从方法论转向结果交付 决策：选品阶段不再只交付抽象方法论，必须交付商品机会池、信号证据、竞品拆解、重构方案、货源与定价、风险过滤和最小实验建议。 下一步：创建 `商品机会池 v1`，先收集 10 个机会线索，再选 3 个深挖，最后推荐 1 个最小交易实验。 ## 2026-06-03 选品交付流水线专题上线 结果：选品交付流水线与结果模板已发布到 Cloudflare Pages，并同步到 Notion。 - HTML：https://ecommerce-research-portal.pages.dev/product-research-delivery-pipeline.html - Markdown：https://ecommerce-research-portal.pages.dev/research/26-选品交付流水线与结果模板.md 修正：从“选品方法论”推进到“选品结果交付”。下一步应创建商品机会池 v1，先交付 10 个商品机会线索。