更新日志

v0.3.1（2026-09-29）

• 文档：模型只有 xiangxin-latest 一个别名。

v0.3.0（2026-09-28）

• 只有一个模型：象信（xiangxin），默认模型改为 xiangxin-latest。
• 删除已下线的模型训练接口及其类型。

v0.2.1（2026-09-28）

重试策略与 TypeSafe 官方 SDK 对齐：

• 默认重试的状态码扩大为 408、429 与所有 5xx（原来是 429 / 500 / 502 / 503 / 504 / 529）。
• 指数退避单次上限从 8 秒改为 5 秒（0.5 秒起翻倍，随机扣减最多 25%）。
• 服务端建议的等待超过上限（默认 60 秒）时，改按指数退避重试，而不是直接放弃。
• 重试请求带 x-xiangxin-retry-count: n，首发请求不带。

v0.2.0（2026-09-27）

• 新增错误类 ConflictError（409）与 RequestTooLargeError（413）。

v0.1.1（2026-09-26）

• 默认超时从 30000 毫秒调整为 120000 毫秒（DEFAULT_TIMEOUT_MS）。服务端现在支持 32k token 的 state（单请求 64k），长文档加多个问题的请求可能需要数十秒；原来的 30 秒会让这类请求超时并被自动重试。
• 发布改由 GitHub Actions 自动完成（npm Trusted Publishing，附带 provenance），源码见 xiangxinai/xiangxin-sdk-js。

v0.1.0（2026-09-25）

象信 AI JavaScript / TypeScript SDK 的首个公开版本，详见 JavaScript SDK。

• XiangxinClient：封装 POST /v1/systemone（systemOne()）与 GET /v1/models（models.list()），从 XIANGXIN_API_KEY 等环境变量读取配置，默认模型 xiangxin-latest。
• noul()、choice()、score() 辅助函数；答案类型由问题自动推断。
• 按 HTTP 状态码细分的错误类，包括 402 余额不足的 InsufficientBalanceError 与 529 过载的 OverloadedError。
• 对 429、5xx、529、连接错误和超时自动指数退避重试，遵守 retry-after，可在客户端与单次调用两级配置。
• APIPromise.withResponse() 读取 HTTP 响应与请求 ID；支持 AbortSignal 取消、自定义 fetch 与日志器。
• 同时发布 ESM 与 CommonJS，附带类型声明；支持 Node.js 18+、Deno、Bun 与边缘运行时。