创量智作 · 交付验收

网站 A 功能与兼容性验收报告

2026 年 10 月 22 日（北京时间） · 第 2 版

适用界面：security-center-20261022-25。保留此前 Shopify 兼容性证据，新增 GitHub 备份恢复、设备会话与安全日志验证。

一、结论与适用范围

此前 Shopify 兼容性验证与本轮新增功能验证均已有对应证据。平台商品数据在未修改的官方 Dawn 标准主题上具备正确颜色图片关联；多地点原生库存写入经过真实 Shopify 验证。测试发现的非在线履约地点选择问题已补入平台过滤。

本报告不承诺所有自定义主题、任意店铺商业配置或任意第三方插件均无需适配。本轮真实测试使用一家授权测试店（KZT），多币种及多店任务覆盖使用隔离测试；未将模拟结果写成多家真实店铺成功。

二、验证矩阵

检查项	证据类型	结果	具体内容
Shopify CSV 通用字段与数据	隔离回归 + 已导入实店读回	通过	6币种×3规格组合×草稿/启用=36组合；公开图库8图、每SKU库存、变体图片、价格、UTF-8文件；不绑定测试店域名。
SKU编号及默认规格	隔离回归 + 实际算法例子	通过	默认{spu}-{code}与可读模板；调换选项顺序不改原组合编号；覆盖1×1、2×2、5×6规格。
不同币种处理	隔离回归	通过	USD、EUR、GBP、KZT、JPY、AED的价格数值不被偷偷换汇；实际店铺币种不一致时要求明确确认。真实店铺本轮为KZT。
草稿/启用与多店独立任务	隔离浏览器与接口回归	通过	两家模拟店铺一次提交独立草稿队列、CSV实际下载；失败与重试、版本冲突和已有商品转草稿。不是两家真实店铺验收。
单地点CSV库存与配色图库	真实测试店读回	通过	四款120个SKU均100，五色对应五个独立变体媒体，图库8张；测试店实际CSV导入后的变体ID重新核对。
多地点库存写入隔离	真实Shopify API + 平台原生payload	通过	临时草稿2个SKU按选定地点写17，另一地点初始0；另一地点再写23后选定地点仍17。临时商品和地点已清理。
不可履行在线订单的地点	真实地点读取 + 隔离接口回归	通过	补齐平台过滤，仅向铺货选择返回启用且可履行在线订单的地点。
未经修改的标准主题	官方Dawn 16.0.0草稿实店	通过	官方代码上传临时未发布主题；未加选色补丁，三色点击切图正确、加购按钮正常。核心3文件与官方ZIP字节一致。
现用测试主题选色	Horizon线上实店	通过	Sage Green、Navy、Emerald连续点击与主图一致；Emerald/L购买表单SKU正确。该主题含此前明确的独立修复。
前台购买路径	真实店铺、未付款	通过	补齐SG配送后，商品进入结账页，1件99 KZT；未填写客户资料、未提交订单，测试购物车已清空。
失败商品排除与自动补齐	全量回归 + 历史实际CSV下载	通过	缺失规格/售价等按默认补齐；成功4件导出，失败2件排除；无须逐件人工审核后才能导出。
页面与权限	线上浏览器 + 隔离回归	通过	原10个页面及新增备份页面、3种风格、明暗/移动端布局；工作空间隔离、权限限制、导出下载和密钥不回显。
GitHub 源码上传与校验	用户真实私有仓库回读	通过	真实上传的 ZIP 已下载校验，128 个源码文件完整、摘要与备份当时一致；不含数据库、素材或密钥。新增代码需再做新版本备份。
恢复与失败回滚	隔离服务实际恢复 + 故障注入回归	通过	独立恢复进程实际恢复源码并重启隔离服务；维护期间写入受阻，业务表行数保持；健康失败回滚、路径与摘要检查、依赖/数据库结构兼容性检查通过。
超管设备与强制退出	两个隔离浏览器 + 线上页面	通过	指定浏览器退出后请求返回401，当前浏览器保持有效；备注/识别和按设备日志可用；真实进程重启后有效会话与设备标识保持。
安全权限与定位	专用回归 + 实际城市接口	通过	仅owner可读写；Token只存摘要，密码/正文不进日志；受信代理链取IP、防伪造、城市缓存/失败降级、权限拒绝和密码验证频率限制经过验证。
全量与针对回归	本项目独立测试数据库	通过	Shopify阶段132项全量和28项针对验证；新增功能阶段157项全量通过，随后16项安全专用回归通过（与全量部分重叠，不相加）。备份专用回归12项通过。

三、版本更新与新增能力

第 2 版补充“备份与恢复”独立页面及“系统设置 → 系统安全”。源码快照、每日计划、仓库和 Token 替换、差异预览、恢复与回滚已接入；超管设备、IP/城市、人工识别、按设备操作日志及会话撤销已接入。Shopify 商品数据规则沿用此前已验收行为。

本次文档更新未重新创建 Shopify 测试商品、主题或地点。上表 Shopify 项保留原验收事实；新增项分别标明用户实际 GitHub 回读、隔离恢复和线上页面验证。计划具备定时执行与去重测试证据，不把一次手动上传写成已经观察多天自动备份。

此前 Shopify 地点过滤修正

店铺地点读取增加 fulfillsOnlineOrders。铺货库存地点必须同时为启用且可履行在线订单的地点，避免把库存写入无法在线履约的地点后误以为可售。该修正不要求CSV用户获得额外API授权，也不新增人工审核门槛。

四、为什么商品CSV不能覆盖所有店铺配置

商品CSV负责标题、描述、图片、变体、SKU、价格和受支持的库存字段。多地点库存分配需库存CSV或API选地点；销售市场、运费、支付设置与主题交互由店铺环境决定。系统应保证标准数据正确并给出具体诊断，而不是静默更改所有店铺的运费和主题。

五、原版主题与多地点实测证据

官方Dawn源码提交：258f00f64365e2018ca4c62778a6bf55a5d3cd18（16.0.0）。临时主题保持UNPUBLISHED，测试后删除，现用Horizon主题不切换。验证layout/theme.liquid、assets/product-info.js、snippets/product-variant-picker.liquid与源码ZIP一致。

多地点测试使用临时草稿商品及临时仓库，不发布、不下单。原生平台payload选择临时地点并写入17，另一地点不被误写；另一个地点改23后原地点仍17。临时资源已清理。

六、新增功能的适用边界

GitHub 保存源码，不替代业务数据库、素材、密钥或整机备份。源码恢复保留业务数据；依赖或数据库结构不同则停止自动恢复。单次上传成功不证明未来 Token 永不过期或计划永不中断。

设备按浏览器 Cookie 识别，IP 城市为归属地参考，不能据此自动判定敌友。功能启用前的登录记录不能补录；日志保留180天；人工确认不会绕过权限。强退撤销有效会话，不替代修改泄露的密码。

七、交付后复核建议

甲方首次接入真实店铺时，先导入小批，核对币种、图片、规格和库存。
在买家实际销售国家测试加购与结账入口；配送地区必须覆盖该国家。
若使用定制主题或第三方变体插件，额外验收选色、选码、价格和购物车SKU。
正式出单后再做覆盖导入时，核对库存文件，避免把已售库存重置为初始值。
使用甲方自有私有仓库，确认一次立即备份和每日计划，并另行保存业务数据备份。
超管重新登录，备注当前设备，检查设备列表和按设备日志；陌生设备先核对再撤销。

八、证据与操作边界

新增备份和安全功能验证未调用付费模型，未修改正式商品价格、规格和库存，未产生订单或付款。测试中创建的临时Dawn主题、临时仓库和临时草稿商品均已清理。客户使用说明书不包含账号密码、Client Secret或Token。

技术证据：tests/test_shopify_compatibility.py；.backups/releases/compatibility-20261022/ 下的Dawn源码核对、浏览器记录、多地点结果与清理记录；Horizon主题修复记录位于 .backups/releases/horizon-color-fix/。

新增技术证据：.backups/releases/github-backup-20261022/（源码回读与隔离恢复）；.backups/releases/security-20261022/（完整/专用回归、部署与线上浏览器结果）。这些私有目录不进入客户文档包。

九、官方规则参考

商品CSV：https://help.shopify.com/en/manual/products/import-export/using-csv

多地点库存CSV：https://help.shopify.com/en/manual/inventory-and-locations/setup/inventory-csv

原版Dawn源码：https://github.com/Shopify/dawn

GitHub 内容权限：https://docs.github.com/en/rest/repos/contents

IP 定位说明：https://ipwhois.io/documentation