AIHub CLI 上传工具

这是什么

本站的官方命令行上传工具。把做好的软件一条命令发到本站，不用开浏览器填表单——特别适合让 AI 助手（Claude / Codex / Cursor 等）代办：它帮你想出工具，顺手就用它发布到本站。

单个文件、零依赖，电脑装有 Node.js 就能跑。

使用步骤

1. 安装 Node.js（已有可跳过）

到 nodejs.org/zh-cn 下载 LTS 版本，一路下一步装完。验证：打开终端（Windows 用 PowerShell，Mac 用「终端」）输入 node -v 显示版本号即可。

2. 下载本工具

下载本页的 aihub-cli.mjs，放到任意文件夹（比如桌面），无需安装。

3. 注册本站账号

用邮箱在本站注册一个账号（右上角「注册」），拿到邮箱和密码。

4. 配置账号

在终端里（进入 aihub-cli.mjs 所在文件夹）执行：

# Mac / Linux
export AIHUB_EMAIL=你的注册邮箱
export AIHUB_PASSWORD=你的密码

# Windows PowerShell
$env:AIHUB_EMAIL="你的注册邮箱"
$env:AIHUB_PASSWORD="你的密码"

5. 上传你的软件

# 先测一下登录（可选）
node aihub-cli.mjs whoami

# 上传！
node aihub-cli.mjs upload 我的工具.html --name "工具名字" --summary "一句话介绍" --category efficiency

上传成功会直接给你应用的访问链接。

命令速查

命令	作用
whoami	测试登录 + 查看剩余上传额度
categories	查看可选分类（efficiency / devtools / media…）
upload <文件> --name ... --summary ... --category ...	上传应用

upload 常用可选参数：

• --screenshot 截图.png（可传多张）：第一张自动作为列表页的封面图，建议一定传一张 16:9 的图，首页展示效果更好；不传则用分类渐变色块当封面
• --tags "标签1,标签2"：最多 5 个标签
• --description README.md：传文件路径，自动读文件内容当详细介绍
• --version 1.0、--changelog "首发"：版本信息

输错会提示中文原因；加 --json 输出机器可读格式（给程序/AI 解析）；node aihub-cli.mjs --help 看全部说明。

常见问题

• 提示认证失败：邮箱或密码不对，重新 export 设置一次
• 每天传不了：每账号每天最多 5 次、累计 200MB，明天再来
• 文件被拒：只收 html/htm/zip/py/js/ts/mjs/txt/md/json/csv，单文件 ≤200MB
• 提交后看不到：走审核流程（一般很快），通过后会公开显示

懒人模式：让 AI 全程代办

把本页网址发给你的 AI 助手，说一句：

照这个页面的说明，用 aihub-cli 把我的软件上传到 aihublucky

AI 会自己下载工具、配置、上传，全程你只用点「确认」。