[RSS1102]

🤔 这个 PR 的性质是？

勾选规则:
1.只要有新增参数，就勾选”新特性提交“
2.只修改内部bug，未新增参数，才勾选”日常 bug 修复“
3.其他选项视具体改动判断

• 日常 bug 修复
• 新特性提交
• 文档改进
• 演示代码改进
• 组件样式/交互改进
• CI/CD 改进
• 重构
• 代码风格优化
• 测试用例
• 分支合并
• 其他

🔗 相关 Issue

无关联 Issue。

💡 需求背景和解决方案

当前 develop 已覆盖原 PR 的部分迁移与接入说明，本 PR 仅保留以下有效改动：

• 提供可直接运行的快速开始计数器、主题资源加载与完整国际化示例，指南代码、主题 JSON 和翻译资源与运行源码同步。
• 复用主题对象，提供默认/业务主题对比，按实际可解析的 Token 展示功能色板，支持各分类数量不等、稀疏及空配置。
• 统一指南与组件的 Flutter 预览布局，避免侧栏遮挡正文；保留 iframe 首次加载和 reload 的主题同步。
• 文档就绪后展开锚点所在折叠章节，按独立浏览器历史条目恢复阅读位置和折叠状态，补充测试及正式回归入口登记。

基于 develop 7d6e4514（已包含 #1185、#1192）；保留当前迁移指南、包内迁移副本、发布版本和主题 CSS 转换指引。旧 Spec 目录、历史截图与过期 CI 记录不再带入。与 #1185 的旧小程序转换清理互不依赖。组件库公开 API 和默认行为不变。

Spec · 验收记录

本地验证范围	结果与边界
Flutter 3.32.0 / 3.47.7	同步 #1190 前的候选：两版严格分析无诊断，示例功能测试各 23/23
回归入口和片段生成器	工具测试 36/36，生成片段 --check 通过
站点	当前候选 47/47；57 页/360 示例映射、8 份文档同步检查及生产构建通过
Linux Flutter 3.32.0 Golden	同步 #1190 前的候选：正式配置下 14/14 精确像素比对通过；本轮未更新基线或放宽容差

新增/变化的截图示例：

默认主题	业务主题

仍保持 Draft：浏览器端到端人工操作和移动设备验收尚未执行；导航由聚焦单元测试覆盖，不声称已完成人工浏览器验收。上一候选 ff20e42f909c16f753b59fb02c496aa3ff75e2ad 的历史结果：30 项检查成功，1 项条件跳过，无失败或待完成项。完整双版本验证、Linux Golden 与平台构建、站点预览与 APK 均已完成成功；文档同步、拼写、CLA、代码扫描和 CNB 同步通过。autofix 无文件变更，该候选未被自动提交改写。不沿用旧提交结果。

📝 更新日志

• 本条 PR 不需要纳入 Changelog

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项。⚠️

• 标题遵循 Conventional Commits 格式：type(<scope>?): 修改描述。
  示例：fix(TBottomTabBar): 修复 iconText 模式底部溢出
• “相关 Issue”处带上修复的 Issue 链接或无关联 Issue
• 已添加对应的 Spec 链接，或已由 Review 确认本次改动无需 Spec
• 相关文档已补充或无须补充

本轮冲突处理：提交 4df2a7fe 同步最新 develop，仅四份 Demo 规范文档发生冲突，已保留两边的设计和验收记录。相对 develop 的源码补丁与上一候选一致；站点测试 47/47、57 页/360 示例映射、8 份文档同步检查和生产构建通过。新提交的远端 CI 正在运行，上一候选的成功结果不替代本次检查。

[github-actions]

Web Demo

• web-example

APK 下载

• 下载 APK（ZIP，解压后安装）

[RSS1102]

本 PR 的有效改动已拆分承接，不再作为独立合并入口：

• docs(site): 完善可运行接入示例与 Flutter 预览 #1204：可运行接入指南、文档同步及 Flutter 预览接入，已合入 develop。
• fix(example): 按实际主题键展示功能色板 #1206：按实际主题键展示功能色板，已合入 develop。
• fix(site): 修复主题初始化与文档导航状态恢复 #1202：折叠锚点及历史阅读状态恢复，并补充迁移指南布局和链接修复；目前仍打开、尚未合并，后续交付继续在该 PR 跟进。

经对照最新 develop 和上述 PR，未发现需要从 #1156 额外搬运的独立功能，现关闭本 PR。关闭表示交付入口已被取代，不表示 #1202 已合并、上游 site-components 问题已全部解决或设备验收已完成。