xxtouch脚本授权系统
这是一个用于 Antigravity / VS Code 的脚本上传扩展,可以把 .xxt 或 .xpa 脚本包上传到 XXTouch 授权系统,并发布新的脚本版本。
功能
- 上传
.xxt / .xpa 脚本包
- 填写新版本号和更新说明
- 保存服务器地址、项目 ID、上传 Token
- 显示当前服务器版本号
- 支持侧边栏上传、命令面板上传、资源管理器右键上传
- 支持通过 CLI 或扩展命令给 AI / 自动化工具调用
使用说明
- 在授权系统中打开目标项目。
- 生成或复制该项目的“上传 Token”。
- 在 Antigravity / VS Code 中打开命令面板。
- 执行“XXTouch 授权系统:打开脚本上传”。
- 填写服务器地址、项目 ID、上传 Token。
- 点击“刷新”确认当前服务器版本号。
- 选择
.xxt 或 .xpa 脚本包。
- 填写新版本号和更新说明。
- 点击“上传并发布”。
上传成功后,客户端会通过授权系统的下载地址获取最新脚本包。
配置项
| 配置项 |
说明 |
xxtUploader.serverUrl |
授权系统服务器地址,例如 https://example.com |
xxtUploader.projectId |
授权系统项目 ID |
xxtUploader.uploadToken |
长期有效的脚本上传 Token |
上传 Token 会保存在编辑器的用户设置中。请不要把包含 Token 的设置文件提交到公开仓库。
命令
| 命令 |
说明 |
xxtUploader.open |
打开脚本上传界面 |
xxtUploader.uploadFile |
上传当前选中的 .xxt / .xpa 文件 |
xxtUploader.uploadByArgs |
通过参数上传脚本包,供自动化工具调用 |
CLI 上传
扩展内置 cli-upload.js,可以给 Antigravity AI、脚本或终端直接调用。
node /path/to/extension/cli-upload.js \
--server "https://example.com" \
--project "<项目ID>" \
--token "<上传Token>" \
--file "/path/to/package.xpa" \
--ext xpa \
--version "100" \
--notes "更新说明"
也可以通过环境变量传入固定配置:
XXT_UPLOAD_SERVER="https://example.com" \
XXT_UPLOAD_PROJECT_ID="<项目ID>" \
XXT_UPLOAD_TOKEN="<上传Token>" \
node /path/to/extension/cli-upload.js \
--file "/path/to/package.xpa" \
--ext xpa \
--version "100" \
--notes "更新说明"
扩展命令上传
在可以访问 VS Code API 的环境中,可以直接调用扩展命令:
await vscode.commands.executeCommand('xxtUploader.uploadByArgs', {
serverUrl: 'https://example.com',
projectId: '<项目ID>',
uploadToken: '<上传Token>',
filePath: '/path/to/package.xpa',
ext: 'xpa',
version: '100',
updateLog: '更新说明'
});
服务端接口
上传接口:
POST /xxtstudio/script-upload-api
版本查询接口:
GET /xxtstudio/script-upload-api/status?project_id=<项目ID>
请求头:
X-Script-Upload-Token: <上传Token>
上传接口使用 multipart/form-data,字段如下:
| 字段 |
说明 |
file |
.xxt 或 .xpa 脚本包 |
project_id |
项目 ID |
ext |
xxt 或 xpa |
version |
新版本号 |
update_log |
客户端可见的更新说明 |