@ freeappstore/ cli (英语)

这个 fas CLI 用于 FreeAppStore 软件 创造者。 脚手架,检查,发布,管理你的免费应用.

安装

npm i -g @freeappstore/cli

需要节点22+.

快开始

fas login              # GitHub device-flow auth
fas init my-app        # scaffold from the standalone template
cd my-app
pnpm install && pnpm dev
fas check              # compliance checks
fas publish            # provisions repo + hosting + DNS
git remote add upstream https://github.com/freeappstore-online/my-app.git
git push upstream main # follow the commands printed by fas publish

在第一次成功启动密码后 https://my-app.freeappstore.online。 。 。 .

图标

fas login

通过设备授权流与 GitHub 签名 。 打开浏览器以授权CLI,然后将 GitHub 令牌交换为平台会话令牌. 两者都坚持 ~/.fas/config.json (模式) 0600) (中文(简体) ).

fas login

fas logout

清除缓存的平台会话符号 .

fas logout

fas whoami

打印当前登录用户的 GitHub 登录 。 退出非零或未认证.

fas whoami
# @yourname

fas doctor

运行本地健康检查:节点版本,git,pnpm,配置文件,已签名状态,以及API可达性.

fas doctor --offline
fas doctor --offline --verify --artifact
fas doctor --offline --json

fas init <app-id>

脚手架从建设者使用的同一种峡谷起动地基中分离出一个独立或连接的应用程序. 预设共享他们的路由,PWA,造型,和能力文件;连接在离开公共屏幕时会添加一个私有的草稿示例. 游戏由脚手架和单独出版 fgs CLI(英语:CLI). 命令替代应用身份并创建第一个 git 承诺 .

fas init my-app                        # default: standalone template
fas init my-app --template connected   # uses platform backend (KV, rooms, etc.)

fas check

在当前目录( 或) 中运行对应用的遵守性检查 --dir) (中文(简体) ). 检查内容包括:没有跟踪SDK,没有支付,没有广告,没有品牌字体存在,没有品牌标志覆盖,PWA显示有效,捆绑尺寸在限制下,没有剩余 APPNAME 占位符 。 硬故障时退出非零.

fas check              # check cwd
fas check --dir ../my-app

fas publish

为 FreeAppStore 提供并发布一个应用程序. 运行合规检查,认证,通过管理员Worker创建了GitHub repo + R2托管路由+存储前端注册条目,并注入了部署工作流程.

默认, publish 是交互式的——它要求分类、类型、单线和演示 URL。 跳过标记值的提示; 结合 --yes 在CI中迅速失败 而不是挂在缺失的地上.

fas publish                          # interactive
fas publish \
  --name my-app \
  --category Utilities \
  --type standalone \
  --oneliner "Does the thing." \
  --yes                              # non-interactive (CI)

生成的 deploy.yml 是同一个 fas init 写作。 它有两个工作: build (安装、打字、测试、建造、固定) @freeappstore/cli * 验证、编码-健康扫描——无秘密)和 deploy (单位:千美元)needs: build;下载所建的文物并同步到R2——运行无项目代码). 每一个行动都归根结底是SHA和每个 npx 到一个准确的版本.

fas list (别名) fas ls(中文(简体) )

您已发布的列表应用程序 。 显示app id, 分类, 活的 URL, 和创建日期 .

fas list               # human-readable table
fas list --json        # full JSON with per-app commit history
fas list -v            # verbose — show last 3 commits per app

fas logs <app-id>

显示最近的 GitHub 动作运行程序 。 显示状态、 时间戳和失败运行的链接 .

fas logs calculator

fas secret set|list|rm

管理应用程序的服务器侧加密 API 密钥 。 秘密被存储在平台上,并在运行时通过代理注入. 值在休息时加密; list 只显示名称, 永远不显示值 .

fas secret set OPENWEATHER_KEY --from-env OPENWEATHER_KEY
printf '%s' "$OPENWEATHER_KEY" | fas secret set OPENWEATHER_KEY
fas secret set OPENWEATHER_KEY                  # hidden interactive prompt
fas secret list                                  # list secret names
fas secret list --json                           # machine-readable
fas secret rm OPENWEATHER_KEY                    # delete a secret

所有子命令接受 --app <id> 以明确指定应用程序。 如果省略了, app id 来源于 name 当前目录中的字段 package.json。 。 。 .

fas proxy allow|list|deny

管理每个应用程序密接代理的 URL 授权列表 。 代理机从您的应用程序中截取出行的 API 调用,并注入适当的秘密(作为查询参数,头,无记名符号,或 OAuth2 客户端证书交换),以使 API 密钥永远无法到达浏览器.

# Allow the proxy to inject OPENWEATHER_KEY as a query param when calling the API
fas proxy allow "https://api.openweathermap.org/" \
  --secret OPENWEATHER_KEY \
  --inject "query:appid"

# Inject as a Bearer token
fas proxy allow "https://api.example.com/v1/" \
  --secret EXAMPLE_TOKEN \
  --inject bearer

# OAuth2 client credentials flow
fas proxy allow "https://api.spotify.com/v1/" \
  --secret SPOTIFY_CLIENT_ID \
  --secret2 SPOTIFY_CLIENT_SECRET \
  --inject oauth2_cc \
  --token-url "https://accounts.spotify.com/api/token"

# List current rules
fas proxy list
fas proxy list --json

# Remove a rule
fas proxy deny "https://api.openweathermap.org/"

allow 旗帜 :

fas screencheck

构建应用程序,并在设备矩阵中的每一个参考取景口(图片+地平面,从iPhone SE到iPad Pro)运行一个无头的Chrimium浏览器. 报告布局是否适合不滚动或剪接,并计算设备覆盖百分比。 需要Playwright作为应用程序项目的 dev依赖.

fas screencheck                       # build + test local dist
fas screencheck --skip-build          # test existing dist without rebuilding
fas screencheck --screenshots         # save a PNG per viewport to ./screencheck-out/
fas screencheck --url https://my-app.freeappstore.online  # test a live deployment

fas quality [app-id]

显示一个应用程序的 VCQA (VibeCode QA) 代码质量报告 。 从平台 API 获取最新报告,并显示综合分数(0-100),字母分数(A-F),每次检查分数,以及顶级问题.

若为 app-id 中,命令自动从当前目录中检测它 package.json 名称, a *.freeappstore.online 参考文献 CLAUDE.md,或目录基准名.

fas quality                  # auto-detect app id from cwd
fas quality timer            # explicit app id
fas quality timer --json     # raw JSON for scripting

配置

~/.fas/config.json (模式) 0600)持有 GitHub OAuth 令牌+平台会话令牌. fas logout 删除两者.

品牌和UI规则(授权)

每个平台上的应用程序和游戏都共享相同的视觉语言——颜色,字体,间距,因此存储前缀和细节页面保持可预见性. fas check 执行 :

fas publish 自动运行 fas check 并中止对硬故障。 该站台还先检查已建成的文物后再进行现场部署.

怎么样 fas publish 工作内容

1. 合规门: 运行与 fas check。困难失败中止.
2. 认证检查:确认一个有效的会话符号(如果过期则重新登录).
3. 备抵:POSTs到平台API,它通过服务绑定调用管理员工作. 管理员创建了空的 GitHub repo, 插入一个 D1 主机路由( subdomain → R2 前缀) , 并将应用程序附加到存储前端注册.
4. 部署工作流程: 注射数 .github/workflows/deploy.yml 如果本地缺失, 那么第一个 git push 启动 R2 部署。 报告不同的现有文件,而不是替换——通过 --update-workflow 以再生为生.
5. 所有权: 在平台 DB 中记录应用程序 fas list 返回它.
6. 产出: 打印活的 URL, repo URL, 存储前置列表 URL, 以及 git remote add + 键 git push 命令以插入新repo.

如果无法提供,命令会报告出错和退出. 没有队列, 没有打开提交表 。 在检查平台状态后重试 ; --issue 不是支持的旗帜.

为大赦国际代理

用Claude Code, Cursor, 还是另一个AI工具? 连接基于工具的 MCP 服务器 :

{
  "mcpServers": {
    "freeappstore": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.freeappstore.online/mcp"]
    }
  }
}

或者读取完整平台指南: freeappstore.在线/技能.md

许可证

麻省理工学院.

将一个已有的应用程序迁移到代号公用事业

运行 fas migrate tailwind-tokens --dir <app-repo> 预览一个统一的diff和每个文件的计数。 添加 --write 应用它。 命令扫描 web/src,为定义的 FAS 令牌添加缺失的 Tailwind 主题映射,并重写类属性和 cn编号 :clsx编号 :classnames 调用,同时保留变体和不透明。 使用半径和阴影映射 rounded-fas, (中文(简体) ), rounded-fas-sm,以及 shadow-fas。 。 。 .

被禁别名从应用程序自己的CSS中解决;相冲突的光/暗定义,周期,和未知的符号被保留下来并报告. 审查报告中剩余的CSS规则,六分法颜色,暗色覆盖和内含式计数. 应用迁移后运行应用程序构建 。 重运行命令是一次迁移的禁用操作 。 此命令不转换静态内置样式或添加 SDK @source 指令。 。 .