GUIDES / BUILD AND CONNECT
选择你的开发路径
资源包适合从清单开始;Wasm 适合需要受限 guest 逻辑的扩展;Cloud REST 适合查询扩展目录与发布状态。
构建 Wasm quote panel
示例读取 TradingAI 宿主预载的报价和一分 K 线快照;输出标签显示输入的字节长度,不显示报价字段或计算交易信号。它不会自行发起网络请求,也不执行交易。下载quote panel Wasm 示例,其中包含示例 crate、SDK 源码和清单。
- 准备工具链。安装 Rust,并确保已安装
wasm32-unknown-unknowntarget。SDK crate 是本地路径依赖,不从 crates.io 获取。 - 在解压目录构建。进入
quote-panel文件夹并运行下方命令;Cargo 缓存、临时文件和构建输出均写在这个文件夹中。 - 准备包目录。下方命令把根清单和编译结果放进只含这两个文件的 .package-staging 目录。
- 预览清单。客户端源目录预览可以检查声明并显示模拟报价;它不会执行这份 Wasm 文件。
mkdir -p .cargo-home .local-target .tmp
CARGO_HOME="$PWD/.cargo-home" \
CARGO_TARGET_DIR="$PWD/.local-target" \
TMPDIR="$PWD/.tmp" TMP="$PWD/.tmp" TEMP="$PWD/.tmp" \
cargo build --manifest-path Cargo.toml \
--target wasm32-unknown-unknown --release --offline --locked
mkdir -p .package-staging
cp manifest.json .package-staging/manifest.json
cp .local-target/wasm32-unknown-unknown/release/tradingai_extension_quote_panel_example.wasm .package-staging/main.wasm该命令要求已安装 Rust 和 wasm32-unknown-unknown target;下载包已包含本地 SDK 依赖(--offline)。这一步只构建 guest 并准备包目录;用随包提供的打包脚本生成归档,具体步骤见发布指南,再通过客户端签名并提交审核。
只读查询 Marketplace 目录
公开目录 GET 可匿名读取。当前客户端源码的默认 Cloud origin 为 https://newapi.tradingai.app,下例使用该地址;这不代表此环境已完成生产验收。自托管环境请将变量改成自己的 Cloud origin。
TRADINGAI_BASE_URL="https://newapi.tradingai.app"
curl --fail --silent --show-error "$TRADINGAI_BASE_URL/api/marketplace/plugins?sort=popular&limit=50&offset=0"下载Python 只读目录示例,解压后进入 cloud-catalog 目录运行:
python3 catalog.py --limit 20 --sort popular默认 origin 是 https://newapi.tradingai.app,已于 2026-10-08 用下载脚本完成公开目录请求;可通过 TRADINGAI_BASE_URL 或 --base-url 指定本地或自托管 Cloud。更多参数、响应格式和访问范围见 Cloud REST API 参考。
公开 GET
目录列表、分类和搜索等公开读取不需要 Bearer token。
登录接口
发布者与用户接口使用正常 Cloud 登录取得的 access token,以 Bearer 方式发送。不要将 token 写入扩展包、网页静态代码或提交到版本库。
登录与访问令牌
需要登录的接口使用 Authorization: Bearer <access_token>。令牌来自正常 TradingAI Cloud 登录会话;本地开发时通过你自己的安全环境注入临时令牌,不要从客户端本地存储中提取凭据。这里没有独立的开发者 API key 申请流程。
curl --fail --silent --show-error -H "Authorization: Bearer $TRADINGAI_ACCESS_TOKEN" "https://newapi.tradingai.app/api/marketplace/publisher/me/submissions"目录读取示例不需要 access token。若受保护请求返回未授权,重新登录并使用当前会话令牌;发布接口还受发布者验证和部署开关约束。