@ezzhu/ai-assethub

Windows 端 AI Asset Hub Skill 上传工具。CLI 使用 node.exe 逐个读取原始 Skill 目录中的文件，在内存中生成 ZIP 后调用 Asset Hub OpenAPI 上传。它不接受现成的 ZIP 或 RAR，也不会把解密后的 ZIP 写入磁盘。

环境要求

• Node.js 20 或更高版本。
• 公司加密软件已允许 node.exe 读取加密文件。
• 当前用户已在 AI Asset Hub 中创建 API Key。

安装

从 npmjs 安装：

npm install --global @ezzhu/ai-assethub
ai-assethub version

该包公开可下载，但采用 UNLICENSED，不授予复制、修改或再分发许可。

配置

在当前 Windows 用户目录创建 %USERPROFILE%\.ai-assethub-config\.env：

AI_ASSETHUB_API_KEY=aah_xxx_xxx
AI_ASSETHUB_BASE_URL=https://ai-assethub.company.internal

API Key 不能通过命令参数传入，也不会被打印到终端。

使用

ai-assethub doctor .\frontend-design
ai-assethub upload .\frontend-design
ai-assethub upload C:\skills\frontend-design --visibility PRIVATE

相对路径以当前终端目录为基准。Skill 目录名必须和 SKILL.md 中的 name 完全一致。

CLI 默认排除 .git、node_modules、日志和系统垃圾文件。发现 .env、 PEM、PFX 或常见私钥文件时会停止上传，并要求先清理这些文件。

CMD 上传脚本

如果公司加密软件不能向 node.exe 提供文件明文，但允许 cmd.exe 读取， 可以使用随 npm 包发布的 CMD 入口：

ai-assethub-cmd .\frontend-design
ai-assethub-cmd "C:\skills\frontend-design" PRIVATE

全局安装 npm 包后会同时注册 ai-assethub-cmd 命令；也可以直接运行包中的 upload-skill.cmd。第二个参数可选，支持 PUBLIC（默认）或 PRIVATE。 脚本读取相同的配置文件：

%USERPROFILE%\.ai-assethub-config\.env

脚本由 cmd.exe 使用输入重定向打开每个源文件，再把已解密的文件句柄交给 Node.js；Node.js 从标准输入接收原始字节并直接在内存中生成 ZIP，然后调用 /api/openapi/v1/skills。该流程不会把 .env、Skill 明文或 ZIP 写入磁盘， 也不会修改原始文件；API Key 不会出现在终端输出中。

配置文件优先按 UTF-8 读取，也兼容中文 Windows 常见的 GBK/GB18030 编码。 如果出现 CMD_FILE_READ_FAILED，请先在原生 CMD 中使用 type 确认加密软件 是否允许 cmd.exe 读取对应文件的明文。

本地开发

在仓库根目录执行：

pnpm install
pnpm cli:test
pnpm cli:build
pnpm cli:dev -- help