DEVELOPER EXAMPLES

可下载的开发者示例

每个 ZIP 都可以独立解压使用。先用资源扩展示例完成本地校验，再选择 Wasm guest 或只读 Cloud API 路径。

示例包和宿主支持范围各自独立。资源预览、Rust 构建和 Marketplace 发布分别验证不同阶段；请按每个 README 的成功条件和限制判断结果。

资源扩展：观察列表预设

从声明式 manifest 开始。它包含两个不带代码和权限的观察列表预设，并附带一个离线结构校验器。

ZIP SHA-256: 28439b436dce56e363b5ec7ef2451eb141a319c5821a7dfa892cb56a7f6a5790
Manifest SHA-256: 8ef640f1278ec0e51e64e98e11eb9730de205ba684377ab4a37dea03e8ab78cd

本地校验

unzip resource-preset.zip\ncd resource-preset\npython3 validate.py

校验成功表示该样例的 manifest 结构通过本地检查。你也可以在 TradingAI 的 Marketplace → Developer → My Extensions → Preview source directory 预览解压后的文件夹；预览会渲染安全声明，不会签名、信任、安装或执行扩展。真正安装仍要求 Marketplace 发布签名、审核通过和客户端信任的发布者密钥。

ZIP 也附带独立的 package.py，可在样例目录内校验并构建 Marketplace 格式的 .tar.gz 包。

Wasm：报价面板 crate

独立 Rust crate 演示读取宿主预载的 BTC/USD 报价和一分钟 K 线快照。当前回调记录报价 JSON，并发布一个显示输入字节数的标签；它不显示报价字段、不计算信号，也不下单。

下载 quote-panel.zip

ZIP SHA-256: e8061235ce6e79d4e94e5dc18217182618574841b702d66fa8a191bdc43a40d7
Manifest SHA-256: bb73e7b63711ab0a6eb133246257173be8ee4732f1ddde7618977ad1c2ed8dc8

在 quote-panel 文件夹内构建

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

需要已安装的 Rust 工具链和 wasm32-unknown-unknown target。生成的 Wasm 文件可复制为 manifest 同目录的 main.wasm。该 crate 的 Cargo manifest 标为 UNLICENSED；随包提供的 notice 不授予许可证、再分发权或商业使用许可，请在复用前联系 TradingAI。

构建成功后，ZIP 中的独立 package.py 可校验 manifest 与 main.wasm 并生成 Marketplace 格式的 .tar.gz 包。

Cloud API：只读 Marketplace 目录

Python 标准库脚本仅调用公开目录 GET 路由，不发送认证信息，不读取或保存令牌，也不写入响应文件。

下载 cloud-catalog.zip

ZIP SHA-256: 179901d3f317462aa05146cff5d58c97dd600e330d8c12e1229bf50b508ad3d8

列出公开扩展

unzip cloud-catalog.zip\ncd cloud-catalog\npython3 catalog.py --limit 20 --sort popular

默认 Cloud origin 为 https://newapi.tradingai.app。连接本地或自托管服务时，可设置 TRADINGAI_BASE_URL 或传入 --base-url。错误会显示 HTTP 状态以及服务返回的 JSON 错误码和消息。

查看 SDK 与运行时参考 →