这个项目用于让 Codex 帮你调研 Google Play 上的单个应用。你不需要理解底层 CLI，只需要把项目交给 Codex，并用自然语言告诉它想看哪个国家、哪个榜单、哪个产品。
如果你拿到了这个项目，请把下面这句话发给 Codex：
请阅读这个项目的 README，并按「给 Codex / AI 的指引」帮我完成初始化、登录和后续单品调研。
初始化完成后，你可以这样继续跟 Codex 说：
帮我看印尼区工具类免费热榜第二名，并生成单品分析报告。
帮我看墨西哥区 Movers & Shakers 榜单里你认为最值得关注的一个产品，并生成报告。
帮我调研这个 Bundle ID：com.lenovo.anyshare.gps，国家看印尼，时间看最近 90 天。
最终报告会生成在项目根目录，格式是 HTML。
当用户把这个项目交给你时，请把本项目当作一个可执行的单品调研工作区。你需要负责安装依赖、初始化登录、运行采集、读取结果，并生成最终 HTML 分析报告。
在项目根目录执行：
npm install然后安装 Playwright 需要控制的 Chrome 浏览器：
npm run setup:browser确认项目可用：
npm run appmarket -- --help检查本机浏览器 profile：
npm run appmarket -- profile默认会使用本机的持久化浏览器 profile 保存登录态。不要把 profile、账号密码或运行产物提交到 Git。
不需要把 CLI 注册到系统全局命令。后续统一使用 npm run appmarket -- ... 调用即可。
先检查登录状态：
npm run appmarket -- auth all如果某个平台未登录，执行对应命令，并让用户在打开的浏览器里自己登录：
npm run appmarket -- login diandian
npm run appmarket -- login sensortower
npm run appmarket -- login appgrowing
npm run appmarket -- login insightrackr登录完成后再次检查：
npm run appmarket -- auth all重要：不要询问、记录或代填用户的密码、验证码、Cookie。
如果 Codex 自动识别到了 single-product-research skill，请直接使用它。
如果没有自动识别，请主动读取：
skills/single-product-research/SKILL.md
生成最终 HTML 报告前，还必须读取：
skills/single-product-research/references/output-contract.md
skills/single-product-research/references/html-report-rules.md
report.json 只是采集执行记录，不是最终分析报告。
用户通常不会直接说 CLI 参数。你需要把用户的话转换成调研动作。
如果用户说：
帮我看印尼区热榜第二名
你应该理解为：
- 国家是印尼，国家代码是
ID。 - 先拉点点榜单。
- 只看
top_free和movers_shakers。 - 如果用户说“热榜”，通常优先理解为免费总榜
top_free。 - 取第二名对应的应用，记录它的 Bundle ID。
- 用该 Bundle ID 执行完整单品调研。
- 生成 HTML 报告。
如果用户直接给 Bundle ID，例如：
调研 com.doc.swift.all.reader，国家看日本
你可以跳过榜单选择，直接对该 Bundle ID 执行完整调研。
拉某个国家榜单：
npm run appmarket -- diandian rank --country ID对指定 Bundle ID 执行完整调研：
npm run appmarket -- research \
--bundle-id com.lenovo.anyshare.gps \
--country ID \
--duration P90D完整调研会先完成点点数据，然后并行采集 Sensor Tower、AppGrowing、InSighTrackr。单个站点内部仍按顺序执行。
采集完成后，从命令返回的 output_dir 读取数据和截图。
最终 HTML 报告必须：
- 放在项目根目录。
- 按
html-report-rules.md的结构生成。 - 展示可读图表和必要素材原图。
- 不要把执行日志当成最终报告。
- 生成后用浏览器检查桌面和窄屏显示是否正常。
你可以直接这样说：
先帮我初始化这个项目，并打开需要登录的网站。
帮我看印尼区工具免费榜第二名，生成单品报告。
帮我看墨西哥区 Movers & Shakers 里变化最明显的产品。
用 Bundle ID com.lenovo.anyshare.gps 做一次完整调研，国家看印尼。
基于最近一次跑出来的数据，重新生成 HTML 报告。
推荐通过 GitHub 仓库分享项目地址。不要分享以下本地内容：
- 平台账号密码
.appmarket.local.json- 浏览器 profile
runs/目录- 已生成的临时 HTML 报告和检查截图
当前仓库地址：
https://github.com/Disrush/appmarket