xxtouch脚本授权系统
这是一个用于 Antigravity / VS Code 的脚本上传扩展,可以把 .xxt 或 .xpa 脚本包上传到 XXTouch 授权系统,并发布新的脚本版本。
版本: 1.0.4 | 大小: 67 KB | 安全: ✅ 无用户配置打包
📦 快速安装
VS Code
code --install-extension xxtouch-auth-1.0.4.vsix
Antigravity IDE
cp xxtouch-auth-1.0.4.vsix ~/.antigravity-ide/extensions/xxtouch-auth/
UI 安装 (VS Code/Cursor)
Cmd+Shift+P / Ctrl+Shift+P
Extensions: Install from VSIX...
- 选择
xxtouch-auth-1.0.4.vsix
🚀 快速开始
首次配置(参考 CONFIGURATION.md)
- 填写服务器地址
- 填写项目 ID
- 填写上传 Token
打开上传面板
- 点击侧边栏 xxtouch 图标
- 或
Cmd+Shift+P 执行 "XXTouch 授权系统:打开脚本上传"
上传脚本
- 选择
.xxt 或 .xpa 文件
- 填写新版本号
- 填写更新说明
- 点击"上传并发布"
功能
- 上传
.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 |
客户端可见的更新说明 |