新增 docs/：商店文案、图标与各机型截图

Connect IQ Store 后台要填的素材都放进 docs/，代码不依赖其中任何文件。

截图
  八个屏宽各一张（218/240/260/280/360/390/416/454），外加七套主题各一张。
  全部是模拟器的真实渲染 —— 字体是 Garmin 内置的 Roboto / Bionic，和真机一致。
  preview-themes.svg 用的是网页字体，不能拿去当商店截图，docs/README.md 里
  特别提了这点。

  ⚠️ 进度环是摆拍的。模拟器的 Edit Activity Monitor Info 只能改活动分钟、
  恢复时间、呼吸和压力，改不了步数/距离/卡路里（那几个输入框是 Java 自绘的
  表格，AppleScript 也够不着），所以环在模拟器里永远全灰。截图构建把四段弧
  固定成了设计稿的填充状态。除环之外画面上每个数字都是模拟器的真实取值。

  数据位用的是日出/高低温/心率/身体电量，不是默认的日出/高低温/距离/步数 ——
  后两项在模拟器里是 0，截出来底部是 "0.0 0"。这些都写进 docs/README.md 了。

文案
  中英文各一份，含名称、简介、详细描述、关键词、以及要向用户解释的四项权限。
  详细描述按「进度环 / 四个数据位 / 七套主题 / 常亮 / OWM 选用 / 其它」组织，
  156 项字段按分类列出。

图标
  store-icon-1024.png 与 512.png，与启动图标同一套视觉（渐变环 + 橙色日期带），
  由 tools/gen_icons.py 的 launcher() 渲染。

docs/README.md 还记了后台要填但不在仓库里的项（分类、价格、隐私政策 —— 启用
OWM 时会把坐标发给 api.openweathermap.org，这点建议在描述里写明），以及发布
前必须先解决的设计稿授权问题。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

README.md

@@ -44,6 +44,7 @@ fenix8v3-watchface/
 ├── resources-chn/            #    简体中文文案
 ├── resources-icons-<宽度>/    #    ⚠️ 自动生成：按屏幕尺寸光栅化的图标
 ├── resources-launcher-<尺寸>/ #    ⚠️ 自动生成：各尺寸启动图标
+├── docs/                     #    上架素材：商店文案、图标、各机型截图
 └── bin/                      #    编译产物（已 gitignore）
 ```
 
@@ -380,6 +381,16 @@ python3 tools/gen_preview_svg.py
 
 ---
 
+## 12.5 上架素材
+
+商店后台要填的文案、图标和截图都在 `docs/`，见 `docs/README.md`。
+
+截图是模拟器的真实渲染（Garmin 内置字体），八个屏宽各一张，外加七套主题各一张。
+其中**进度环是摆拍的** —— 模拟器灌不进步数和距离，环会全灰，具体说明在
+`docs/README.md` 里写清楚了。
+
+---
+
 ## 13. 设计稿版权
 
 `design/` 内的 SVG、tokens 与 `rebuild.py` 来自 `watchface-kit`，版权归原作者所有。本仓库是按该设计稿实现的 Monkey C 表盘。

docs/README.md

@@ -0,0 +1,72 @@
+# 上架素材
+
+Connect IQ Store 后台要填的东西都在这个目录里。代码不依赖这里的任何文件。
+
+```
+docs/
+├── store-listing-zh.md      中文商店文案（名称 / 简介 / 详细描述 / 关键词 / 权限说明）
+├── store-listing-en.md      英文商店文案
+├── store-icon-1024.png      商店图标（大）
+├── store-icon-512.png       商店图标（小）
+└── screenshots/
+    ├── 218x218.png ~ 454x454.png    八个屏宽各一张
+    └── theme-01-ember.png ~ theme-07-kelp.png   七套主题（454px）
+```
+
+## 截图是怎么来的
+
+全部是 **Connect IQ 模拟器的真实渲染**，不是网页预览图 —— 字体是 Garmin 内置的
+Roboto / Bionic，和真机一致。`preview-themes.svg` 那张用的是网页字体，**不要**拿去
+当商店截图。
+
+每个屏宽各挑了一台代表机型：
+
+| 尺寸 | 机型 | 尺寸 | 机型 |
+|------|------|------|------|
+| 218 | FR255S | 360 | Venu 2S |
+| 240 | fenix 7S | 390 | Vivoactive 5 |
+| 260 | fenix 7 | 416 | fenix 8 43mm |
+| 280 | Enduro 3 | 454 | fenix 8 47mm |
+
+截图里显示的数据位是 **日出 / 最高最低气温 / 心率 / 身体电量** ——
+这四项在模拟器里有真实取值，不是默认配置（默认是日出 / 高低温 / 距离 / 步数）。
+换掉后两项是因为模拟器灌不进步数和距离，默认配置截出来底部是 `0.0` 和 `0`。
+
+### ⚠️ 进度环是摆拍的
+
+模拟器的「Edit Activity Monitor Info」对话框只能改活动分钟、恢复时间、呼吸和
+压力，**改不了步数 / 距离 / 卡路里**（那几个输入框是 Java 自绘的表格，
+脚本也够不着）。所以进度环在模拟器里永远是全灰的，截图没法看。
+
+截图构建把四段弧固定成了设计稿的填充状态（右上 21/21、左上 10/21、
+右下 9/21、左下 14/21）。**除进度环外，画面上每个数字都是模拟器的真实取值**，
+没有伪造。
+
+如果要出完全真实的截图，把 `.prg` 侧载到真机戴一天再拍。
+
+## 重新生成
+
+图标：
+
+```bash
+python3 tools/gen_icons.py     # 顺带产出 store-icon 用的同款视觉
+```
+
+截图：本目录下的 PNG 是用模拟器抓的，流程见提交记录里的 `shot.sh` / `theme.sh`
+（脚本在临时目录，没有入库 —— 它们依赖具体的窗口位置，换台机器就要重调）。
+手工重做的话：编译 → `monkeydo` 载入 → 截模拟器窗口 → 按日期带定位裁出表盘圆形区。
+
+## 后台还要填但不在这里的
+
+- **分类**：Watch Faces
+- **支持的机型**：55 款，以 `manifest.xml` 的 `<iq:products>` 为准
+- **价格**：免费 / 付费自行决定
+- **隐私政策**：如果启用 OpenWeatherMap，需要说明会把**坐标**发给
+  `api.openweathermap.org`。不填 key 时完全不联网，这一点建议在描述里写清楚
+- **联系邮箱 / 支持链接**
+
+## ⚠️ 发布前必须先解决
+
+表盘的视觉是对第三方 `watchface-kit` 设计稿的 1:1 还原（见仓库根目录的
+`LICENSE` 与 `README.md` 第 13 节）。**以自己的名义上架前，需要先取得原作者
+授权，或把视觉部分替换成原创设计。** 这是法律问题，不是技术问题。

docs/store-listing-en.md

@@ -0,0 +1,90 @@
+# Connect IQ Store listing (English)
+
+## App name
+
+```
+Fenix 8 V3
+```
+
+## Short description
+
+```
+A dense data watch face: four progress arcs, four configurable slots, 156 data
+fields to choose from, seven colour themes.
+```
+
+## Full description
+
+```
+Fenix 8 V3 packs a lot of information onto the dial without making it feel
+crowded.
+
+■ Four progress arcs
+The rim is split into four independent arcs. Each one tracks a metric of your
+choosing - steps, calories, distance, floors, move bar, active minutes or body
+battery - so a glance tells you where the day stands. Every tick is
+individually coloured, so the arc shifts hue as it fills.
+
+■ Four data slots, 156 fields
+Top-left, top-right, bottom-left and bottom-right. Each can show any of:
+
+  · Date & time   seconds, UTC, two alternate time zones, week number
+                  (ISO or calendar), custom time and date formats
+  · Activity      steps, calories, distance, floors, ascent, active minutes,
+                  plus week-to-date, 7-day and 28-day totals
+  · Body          heart rate, resting HR, stress, pulse ox, respiration,
+                  body battery, weight, BMI, recovery time, VO2 max
+  · System        battery, battery in days, alarms, notifications, do not
+                  disturb, bluetooth, solar intensity
+  · Environment   altitude, pressure, sunrise/sunset, next sun event, moon age
+                  and illumination, civil/nautical/astronomical twilight,
+                  golden hour, blue hour
+  · Weather       temperature, feels-like, high/low, humidity, precipitation,
+                  wind speed and direction, UV index, visibility, dew point
+  · From watch    next calendar event, training status, race and pace
+                  predictors (5k/10k/half/marathon), weekly run and bike
+                  distance, and complications published by your other apps
+  · Custom        three custom text lines, event countdown
+
+The captions under the bottom two slots follow whatever you pick - no separate
+setting to keep in sync.
+
+■ Seven themes
+Ember, Aurora, Brass, Voltage, Reef, Acid and Kelp. Each carries its own arc
+gradient, date band colours and time-digit gradient.
+
+■ Always-on display
+On AMOLED watches the face switches to a low-power layout while asleep: the
+date band fill and the progress ring are dropped, the time and date are dimmed,
+and the whole layout drifts a few pixels each minute to avoid burn-in.
+
+■ OpenWeatherMap (optional)
+Add your own OpenWeatherMap API key for 30 further weather fields, including
+air quality (AQI, PM2.5, PM10, CO) and the next two days' forecast. Without a
+key the watch face never touches the network.
+
+■ Also
+· English and Simplified Chinese - weekday, month and field captions all follow
+  the watch language
+· Temperature unit can be forced to Celsius or Fahrenheit; distance and
+  12/24-hour follow the watch
+· The bluetooth glyph dims when the phone is out of range
+```
+
+## Keywords / tags
+
+```
+data field, progress ring, complications, always-on, AMOLED, weather,
+heart rate, body battery, sunrise sunset, chinese
+```
+
+## Permissions to explain to users
+
+```
+· UserProfile - resting heart rate, weight, VO2 max
+· SensorHistory - pulse ox, body battery
+· Communications + Background - only used to fetch weather, and only when an
+  OpenWeatherMap API key has been entered
+· ComplicationSubscriber - calendar, training status, and data published by
+  other apps
+```

docs/store-listing-zh.md

@@ -0,0 +1,75 @@
+# Connect IQ Store 上架文案（简体中文）
+
+## 应用名称
+
+```
+Fenix 8 V3
+```
+
+## 一句话简介（短描述）
+
+```
+多指标数据表盘：四段进度环 + 四个可自由配置的数据位，156 项数据任选，七套配色。
+```
+
+## 详细描述
+
+```
+Fenix 8 V3 是一款信息密度高、但不拥挤的数据表盘。
+
+■ 四段进度环
+表盘外圈是四段独立的进度弧，各自绑定一项指标（步数、卡路里、距离、楼层、
+动动条、活动分钟、身体电量），一眼就能看出今天的完成度。每根刻度的颜色都
+是渐变的，进度越高颜色越靠近弧段末端的色相。
+
+■ 四个数据位，156 项数据任选
+左上、右上、左下、右下四格，每格都能从 156 项数据里任选：
+
+  · 时间日期  秒、UTC、第二时区 ×2、周数（ISO / 日历）、自定义时间与日期格式
+  · 活动     步数、卡路里、距离、楼层、爬升、活动分钟，以及本周 / 近 7 天 /
+             近 28 天累计
+  · 身体     心率、静息心率、压力、血氧、呼吸、身体电量、体重、BMI、
+             恢复时间、最大摄氧量
+  · 系统     电量、剩余天数、闹钟、通知、勿扰、蓝牙、太阳能强度
+  · 环境     海拔、气压、日出日落、下一太阳事件、月龄月相，
+             以及民用 / 航海 / 天文晨昏蒙影、黄金时刻、蓝调时刻
+  · 天气     气温、体感、最高最低、湿度、降水概率、风速风向、紫外线、
+             能见度、露点
+  · 手表数据 下一个日程、训练状态、完赛与配速预测（5k/10k/半马/全马）、
+             本周跑步与骑行距离、以及其它 App 发布的复杂功能
+  · 自定义   三段自定义文字、事件倒计时
+
+底部两格的小标签会跟着所选数据自动变化，不用另外设置。
+
+■ 七套配色
+余烬、极光、黄铜、电压、珊瑚礁、酸绿、海藻。每套都有自己的进度环渐变、
+日期带配色和时间数字渐变。
+
+■ 常亮显示
+AMOLED 机型支持常亮。常亮时自动切换到低功耗版面：去掉日期带底色和进度环，
+时间与日期压暗，整个画面每分钟在几个像素内轻微游走以避免烧屏。
+
+■ OpenWeatherMap（选用）
+填入自己的 OpenWeatherMap API key 后，可额外获得 30 项天气数据，包括空气质量
+（AQI、PM2.5、PM10、CO）与未来两日预报。不填则完全不联网。
+
+■ 其它
+· 简体中文 / 英文双语，表盘上的星期、月份、数据标签都会跟随手表语言
+· 温度单位可强制摄氏或华氏，距离与时间制式跟随手表设置
+· 手机断连时蓝牙图标自动压暗
+```
+
+## 关键词 / 标签
+
+```
+数据表盘, 进度环, 数据字段, 常亮, AMOLED, 天气, 心率, 身体电量, 日出日落, 中文
+```
+
+## 需要向用户说明的权限
+
+```
+· 用户档案 —— 用于静息心率、体重、最大摄氧量
+· 传感器历史 —— 用于血氧、身体电量
+· 通信与后台 —— 仅在填写了 OpenWeatherMap API key 时用于拉取天气
+· 复杂功能订阅 —— 用于日程、训练状态、以及其它 App 发布的数据
+```