用途:将你的 App 添加到 asccli.app/#app-wall 社区展示墙。流程为 fork tddworks/asc-cli、在 homepage/apps.json 添加条目并创建 PR,一条命令完成。无需 ASC 认证,只需 GitHub token。
主要命令:asc app-wall submit [options]。
常用选项:--developer-id(Apple 开发者/卖家 ID,可自动拉取其全部 App Store 应用)、--app-id(App Store Connect 应用 ID,可重复)、--app(指定 App Store URL,可重复);三者至少提供一个,否则墙上没有可展示的 App。--developer 为卡片显示名,省略时用 iTunes artist 名;--github 为 GitHub 用户名,--x 为 X/Twitter 账号。--github-token 可提供 GitHub token,也可设置 GITHUB_TOKEN 或先运行 gh auth login。
典型用法:先运行 gh auth login 或导出 GITHUB_TOKEN 完成一次 GitHub 认证,再执行 asc app-wall submit --developer "yourhandle" --developer-id "1234567890" --github "yourgithub" --x "yourx" --pretty;命令输出中的 PR URL 可在浏览器打开。两种提交模式:模式 A 按开发者 ID 提交其全部应用(推荐),开发者 ID 可在 https://apps.apple.com/us/developer/name/id<NUMBER> 查找;模式 B 指定具体 App Store URL(--app 可重复)。两者可组合。
命令内部会:用 token 认证 GitHub、fork 仓库(幂等,可重复运行)、同步 fork 到上游 main、读取 fork 中的 homepage/apps.json、按 developer 字段查重、创建分支 app-wall/<developer>、提交更新后的 apps.json、向上游 main 开 PR。JSON 输出含 prNumber、prUrl 等。
常见错误:缺少 --developer-id 和 --app 时需补一个;无 token 时传 --github-token、设 GITHUB_TOKEN 或 gh auth login;提示 Developer X is already listed 说明已提交过;等待 fork 超时(超过 24 秒)可稍后重试;GitHub API 报 422 多因分支已存在,可忽略并继续。
写入 apps.json 的字段为 developer、developerId、github、x,空值自动省略。PR 合并后,fetch-apps-data.js 会重新生成 apps-data.json,从 iTunes API 拉取你的应用。
限制:需 GitHub 账号与 token;该展示墙依赖上游仓库与 asccli.app;有关收费、价格、平台支持范围等信息暂未提供。