@acosmi/sdk-ts 1.1.0 → 1.3.0

package/CHANGELOG.md

@@ -5,6 +5,76 @@ All notable changes to `@acosmi/sdk-ts` will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] — 2026-05-20
+
+### Added
+
+- **Compliance SDK client** — 新增 `client.compliance` 子客户端，覆盖电子证据、
+  时间章、证据包、报告、签署 envelope、用印审批和 provider request 脱敏状态轮询。
+- **`Config.complianceBaseURL` / `Client.complianceURL(path)`** — compliance API 使用
+  独立 base URL，未配置时默认 `${serverURL}/admin-api`，不复用既有 `/api/v4`
+  模型网关路径。
+- **Compliance public types** — 新增 `src/compliance-types.ts`，只暴露 Acosmi 公共领域
+  DTO；不包含 provider product/user/transaction/project/seal-provider 字段，不包含证书、
+  私钥、keystore、provider raw payload、storage key、subject snapshot 或 billing commit 内部字段。
+- **Compliance error classification** — 新增 `src/compliance-errors.ts`，把 Java 数值业务错误码
+  映射到 SDK symbolic key，并提供 `classifyComplianceError` / `isComplianceBusinessError`。
+- **Compliance status helpers** — 新增稳定状态与错误码辅助函数，供前端区分 step-up、
+  gate closed、provider not configured、local verify failed、billing not committable 等状态。
+- **Compliance scopes** — 新增 12 个细粒度 compliance scope 常量和 `complianceScopes()`。
+- **Examples and docs** — 新增 `docs/compliance.md` 以及 3 个示例：
+  `examples/compliance-read.ts`、`examples/compliance-evidence-timestamp.ts`、
+  `examples/compliance-envelope.ts`。
+- **Tests** — 新增 compliance client 与 compliance scopes 单元测试，覆盖 URL 拼接、
+  `Authorization`、`Idempotency-Key`、GET 401 refresh retry、write no-retry/no-401-replay、
+  CommonResult 解包、数值错误码分类、隐私边界和 polling 终态。
+
+### Changed
+
+- `README.md` 增加 compliance 快速开始、scope 申请、base URL 配置、evidence +
+  timestamp/report 示例、provider request polling、step-up/gate closed 错误处理、
+  idempotency key 持久化和安全禁止项说明。
+- Packed tarball smoke test 覆盖 `client.compliance`，确保 consumer 视角能解析新增
+  declaration merging 和导出的 compliance 类型。
+- `package.json.files` 现在包含 `docs/compliance.md` 和 `examples/`，npm 包随附用户文档
+  与可运行示例；开发手册仍保留在仓库中，不随包发布。
+
+### Safety
+
+- Compliance write methods do not auto retry and do not refresh/replay on 401.
+  GET read methods still allow one safe 401 refresh retry.
+- All compliance write methods accept `Idempotency-Key` through `ComplianceWriteOptions`；
+  callers should persist keys and reuse the same key when resuming the same business action.
+- SDK code, docs, tests, examples, and package files do not include provider materials,
+  credentials, real provider endpoints, signing containers, archives, jars, passwords,
+  or raw provider payloads.
+
+---
+
+## [1.2.0] — 2026-05-18
+
+### Added
+
+- **`ManagedModel.inputModalities`** — 新增可选字段, 类型 `Array<'text' | 'image'>`, 描述模型可接收的用户输入模态; 'image' 表示模型可直接接收 screenshot/image 输入. listModels / listModelsWithStatus 在写缓存与返回前会归一化上游 snake_case 字段名 `input_modalities` → camelCase `inputModalities` (兼容老网关), camelCase 与 snake_case 同时存在时 camelCase 胜.
+
+- **`ModelCapabilities.supports_desktop_visual_understanding`** — 新增可选字段, 标识模型适合作为桌面截图解析 sidecar (输入 screenshot, 输出结构化 UI 描述, 供非多模态主模型消费). 与 `inputModalities=['image']` 是正交两件事: 前者描述"模型能不能吃图", 后者描述"运营是否把该模型标为桌面 UI 解析专用 sidecar". `zeroModelCapabilities()` 显式置 `false`, 避免 `undefined` 导致调用方误判.
+
+- **`InputModality`** 类型导出 — `'text' | 'image'`.
+
+- **Model catalog helpers (4 个)** — CrabCode desktop automation / computer-use 选模型用, 严格按 SDK 字段, 禁止模型名 substring 推断:
+  - `modelSupportsInputModality(model, modality): boolean`
+  - `modelSupportsImageInput(model): boolean`
+  - `findFirstModelByInputModality(models, modality): ManagedModel | null` — 按 catalog 顺序, 跳过 `isEnabled === false`
+  - `findDesktopVisualUnderstandingModel(models): ManagedModel | null` — 选择规则: isEnabled !== false + capabilities.supports_desktop_visual_understanding === true + inputModalities 含 'image' + isDefault 优先 / 否则 catalog 顺序第一个
+
+### Notes
+
+- 上游 `ManagedModel` 缺失 `inputModalities` 时, SDK 保留 `undefined` 不自动补 `['text']` — 调用方必须保守按 text-only / unknown 处理, 严禁默认假设支持 image.
+- 客户端不应硬编码模型名, 应完全依赖 SDK catalog 能力字段做模型选择.
+- 23 新单测全绿 (8 listModels 归一化 + 15 helpers); 全量 79/79 passed, typecheck/lint/build clean.
+
+---
+
 ## [1.1.0] — 2026-05-06
 
 ### Added
@@ -128,6 +198,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 36/36 vitest 全绿,源码 typecheck/lint/build 0 错误
 - 翻车机制:`prepublishOnly` 仅跑源码 typecheck/vitest/build,不验证 packed product 在 consumer 视角能否解析
 
+[1.3.0]: https://github.com/acosmi/sdk-ts/releases/tag/v1.3.0
+[1.2.0]: https://github.com/acosmi/sdk-ts/releases/tag/v1.2.0
 [1.1.0]: https://github.com/acosmi/sdk-ts/releases/tag/v1.1.0
 [1.0.2]: https://github.com/acosmi/sdk-ts/releases/tag/v1.0.2
 [1.0.1]: https://github.com/acosmi/sdk-ts/releases/tag/v1.0.1

package/README.md

@@ -7,9 +7,9 @@
 ## 状态
 
 - 端口源：[acosmi-sdk-go](https://github.com/acosmi/acosmi-sdk-go) v1.0.0（与 Go SDK 联动稳定测试版）
-- 当前版本：**1.1.0**（新增 SDK-facing Agent Runs 公开 API；详见 [CHANGELOG](./CHANGELOG.md)）
-- 测试：56/56 vitest 全绿，typecheck/lint/build 0 错误；packed-tarball smoke (`npm run test:pack`) 在 prepublishOnly 闸内
-- 包链接：[npm](https://www.npmjs.com/package/@acosmi/sdk-ts/v/1.1.0) · [tarball](https://registry.npmjs.org/@acosmi/sdk-ts/-/sdk-ts-1.1.0.tgz) · [GitHub Release](https://github.com/acosmi/sdk-ts/releases/tag/v1.1.0)
+- 当前版本：**1.3.0**（新增 `client.compliance`、`complianceBaseURL`、合规域 types/errors/status/scopes、示例与文档；详见 [CHANGELOG](./CHANGELOG.md)）
+- 测试：发布前需通过 typecheck/lint/vitest/build/packed-tarball smoke (`npm run test:pack`)
+- 包链接：[npm](https://www.npmjs.com/package/@acosmi/sdk-ts) · [GitHub Releases](https://github.com/acosmi/sdk-ts/releases)
 
 ## 安装
 
@@ -22,7 +22,7 @@ npm install @acosmi/sdk-ts
 ```ts
 import { Client, allScopes } from '@acosmi/sdk-ts';
 
-const client = new Client({ serverURL: 'https://acosmi.com' });
+const client = new Client({ serverURL: process.env.ACOSMI_SERVER_URL! });
 await client.login('My App', allScopes());
 
 const resp = await client.chat('claude-opus-4-7', {
@@ -87,7 +87,7 @@ for await (const ev of stream) {
 ```ts
 import { Client, allScopes } from '@acosmi/sdk-ts';
 
-const client = new Client({ serverURL: 'https://acosmi.com' });
+const client = new Client({ serverURL: process.env.ACOSMI_SERVER_URL! });
 await client.login('CrabDesign', allScopes());
 
 const run = await client.agentRuns.create({
@@ -155,7 +155,7 @@ const token = await client.ensureToken();      // 拿到当前有效 access toke
 ```ts
 import { discover, register, authorize, exchangeCode } from '@acosmi/sdk-ts';
 
-const meta = await discover('https://acosmi.com');
+const meta = await discover(process.env.ACOSMI_SERVER_URL!);
 const reg = await register(meta, 'My CLI', allScopes());
 const result = await authorize(meta, reg, allScopes(), {
   onEvent: (ev) => console.log(ev.type, ev.url),
@@ -169,7 +169,7 @@ const tokens = await exchangeCode(meta, reg, result.code, result.codeVerifier);
 import { Client, FileTokenStore, LocalStorageTokenStore } from '@acosmi/sdk-ts';
 
 // Node — 默认 ~/.acosmi/tokens.json，可自定义路径
-const client = new Client({ serverURL: 'https://acosmi.com', tokenStore: new FileTokenStore('./my-tokens.json') });
+const client = new Client({ serverURL: process.env.ACOSMI_SERVER_URL!, store: new FileTokenStore('./my-tokens.json') });
 
 // 浏览器 — 自动用 LocalStorage（无 LocalStorage 时退化为内存）
 ```
@@ -181,7 +181,7 @@ const client = new Client({ serverURL: 'https://acosmi.com', tokenStore: new Fil
 | **Chat**     | `chat`, `chatStream`, `chatStreamWithUsage`                                          |
 | **Agent Runs** | `agentRuns.create`, `agentRuns.stream`, `agentRuns.run`, `agentRuns.cancel`, `agentRuns.get`, `agentRuns.listArtifacts`, `agentRuns.downloadArtifact`, `agentRuns.submitLocalToolResult`, `agentRuns.runWithLocalTools` |
 | **Auth**     | `login`, `logout`, `ensureToken`, `forceRefresh`, `discover`, `authorize`, `exchangeCode`, `refreshToken` |
-| **Models**   | `listModels`, `listModelsWithStatus`, `getModelCapabilities`, `getQuotaSummary`      |
+| **Models**   | `listModels`, `listModelsWithStatus`, `getModelCapabilities`, `getQuotaSummary`, `modelSupportsInputModality`, `modelSupportsImageInput`, `findFirstModelByInputModality`, `findDesktopVisualUnderstandingModel` |
 | **Skills**   | `browseSkills`, `browseSkillsList`, `getSkillDetail`, `resolveSkill`, `installSkill`, `downloadSkill`, `uploadSkill`, `generateSkill`, `optimizeSkill`, `validateSkill` |
 | **Tools**    | `listTools`, `getTool`                                                               |
 | **Wallet**   | `getWalletStats`, `getWalletTransactions`                                            |
@@ -190,6 +190,7 @@ const client = new Client({ serverURL: 'https://acosmi.com', tokenStore: new Fil
 | **Notifications** | `listNotifications`, `getUnreadCount`, `markNotificationRead`, `registerDevice`, `listNotificationPreferences` |
 | **Bug Report** | `submitBugReport`, `getBugReport`                                                  |
 | **Web Search** | `newWebSearchTool` (factory)                                                       |
+| **Compliance** | `compliance.createEvidenceAsset`, `compliance.issueTimestamp`, `compliance.waitForTimestampVerified`, `compliance.buildEvidencePackage`, `compliance.createReport`, `compliance.downloadReport`, `compliance.createSigningEnvelope`, `compliance.signEnvelope`, `compliance.getProviderRequest`, `compliance.waitForProviderRequestTerminal` |
 
 完整签名见 `dist/node/index.d.ts`，IDE 自带补全。
 
@@ -198,7 +199,7 @@ const client = new Client({ serverURL: 'https://acosmi.com', tokenStore: new Fil
 ```ts
 import { Client } from '@acosmi/sdk-ts';
 
-const client = new Client({ serverURL: 'https://acosmi.com' });
+const client = new Client({ serverURL: process.env.ACOSMI_SERVER_URL! });
 
 // 公共端点 — 无需登录
 const result = await client.browseSkills(
@@ -230,6 +231,38 @@ const resp = await client.chat('claude-opus-4-7', {
 
 `AllowedDomains` / `BlockedDomains` 互斥，同时传入抛 `Error`。
 
+### 示例：桌面视觉理解 sidecar 选模型（CrabCode desktop automation / computer-use）
+
+```ts
+import {
+  Client,
+  findDesktopVisualUnderstandingModel,
+  modelSupportsImageInput,
+} from '@acosmi/sdk-ts';
+
+const client = new Client({ serverURL: process.env.ACOSMI_SERVER_URL! });
+const models = await client.listModels();
+
+// 1) 主模型是否能直接吃截图？
+const primaryCanSeeImages = modelSupportsImageInput(
+  models.find((m) => m.modelId === 'deepseek-v4') ?? null,
+);
+
+// 2) 不能 → 走桌面视觉 sidecar：截图先送 sidecar 解析为结构化 UI 描述，再喂主模型
+const sidecar = findDesktopVisualUnderstandingModel(models);
+if (!sidecar) {
+  throw new Error('No desktop visual understanding model available — 让管理员在网关启用一个 sidecar 模型');
+}
+console.log('sidecar →', sidecar.modelId);
+```
+
+红线：
+
+- `ManagedModel.inputModalities` 用于客户端判断模型可接收的用户输入类型（'text' | 'image'）。
+- `capabilities.supports_desktop_visual_understanding` 用于选择专门解析桌面截图的视觉 sidecar 模型，与 `inputModalities` 是正交两件事（普通视觉模型不一定擅长 UI 解析）。
+- 客户端不应硬编码模型名做能力推断，应完全依赖 SDK catalog 字段。
+- 上游未下发 `inputModalities` 时 SDK 保持 `undefined`，调用方必须保守按 text-only / unknown 处理。
+
 ### 示例：钱包 + 余额 + 流量包购买
 
 ```ts
@@ -265,15 +298,16 @@ const view = await client.getBugReport(result.feedback_id);
 
 所有方法 `throw` 类型化错误（不是 Go 风格多返回值）：
 
-| 错误类型             | 触发                                         |
-| -------------------- | -------------------------------------------- |
-| `HTTPError`          | 4xx/5xx，含 `status` / `body` / `requestID`  |
-| `NetworkError`       | TCP/DNS/TLS 失败                             |
-| `StreamError`        | SSE 流解析失败                               |
+| 错误类型             | 触发                                                                   |
+| -------------------- | ---------------------------------------------------------------------- |
+| `HTTPError`          | 4xx/5xx，含 `statusCode` / `body` / `type` / `retryAfter`              |
+| `NetworkError`       | TCP/DNS/TLS 失败                                                       |
+| `StreamError`        | SSE 流解析失败                                                         |
 | `AgentRunStreamError` | Agent Runs 流返回 `error` 事件（默认抛出；可设 `throwOnError:false` 自行消费） |
-| `BusinessError`      | 网关返回 `code !== 0`，含 `code` / `bizMsg`  |
-| `RateLimitError`     | 429（含 `retryAfter`）                       |
-| `OrderTerminalError` | `waitForPayment` 终态失败                    |
+| `BusinessError`      | 网关返回 `code !== 0`，含 `code` (number) / `message` (字符串)         |
+| `RateLimitError`     | 429（含 `retryAfter`）                                                 |
+| `OrderTerminalError` | `waitForPayment` 终态失败                                              |
+| `CompliancePollError` | `waitForTimestampVerified` / `waitForProviderRequestTerminal` 终态失败或超时 |
 
 ```ts
 import { HTTPError, BusinessError } from '@acosmi/sdk-ts';
@@ -281,12 +315,146 @@ import { HTTPError, BusinessError } from '@acosmi/sdk-ts';
 try {
   await client.chat(...);
 } catch (e) {
-  if (e instanceof HTTPError && e.status === 401) await client.login(...);
-  if (e instanceof BusinessError) console.error(e.code, e.bizMsg);
+  if (e instanceof HTTPError && e.statusCode === 401) await client.login(...);
+  if (e instanceof BusinessError) console.error(e.code, e.message);
   throw e;
 }
 ```
 
+### Compliance 错误分类
+
+合规域使用 Java 数值错误码（1-031-xxx-xxx），SDK 通过 `classifyComplianceError` 把
+`BusinessError` 映射到 symbolic key，便于分支判断：
+
+```ts
+import { BusinessError, classifyComplianceError, isComplianceBusinessError } from '@acosmi/sdk-ts';
+
+try {
+  await client.compliance.publishReport(reportId, { idempotencyKey });
+} catch (e) {
+  if (e instanceof BusinessError && isComplianceBusinessError(e)) {
+    const info = classifyComplianceError(e);
+    if (info.stepUpRequired) {
+      // 引导用户重新做 OAuth introspection / 重新登录后用同一 idempotency-key 再试
+    } else if (info.terminal) {
+      // 终态错误（gate closed / provider not configured 等），不要 retry，用新 key 重发
+    }
+  }
+  throw e;
+}
+```
+
+## Compliance (时间章 / 电子证据 / 合同签署)
+
+合规域走独立子客户端 `client.compliance.*`，使用独立 base URL。**SDK 永远不接触
+provider endpoint、证书/密钥材料、provider raw payload / callback billing commit**；
+所有 provider 选择由服务端按配置决定，调用方不传 `provider` 字段。
+
+完整 API 指南见 [docs/compliance.md](./docs/compliance.md)。
+
+```ts
+import { Client, complianceScopes } from '@acosmi/sdk-ts';
+
+// 1. 配置 — complianceBaseURL 默认 ${serverURL}/admin-api
+const client = await Client.create({
+  serverURL: process.env.ACOSMI_SERVER_URL!,
+  // complianceBaseURL: process.env.ACOSMI_COMPLIANCE_BASE_URL,  // 独立 ingress 时显式覆盖
+});
+
+// 2. 登录 — OAuth scope 申请按业务最小集合
+await client.login('My App', complianceScopes());
+
+// 3. 申请时间章（写操作；strongly recommended 持久化 idempotency-key）
+const idempotencyKey = `ts-${orderId}-${Date.now()}`;
+await persistKey(idempotencyKey);
+const token = await client.compliance.issueTimestamp(
+  { name: 'release-artifact', hashAlgorithm: 'sha256', digest: sha256Hex },
+  { idempotencyKey },
+);
+
+// 4. 轮询到本地 verify 通过
+const verified = await client.compliance.waitForTimestampVerified(token.id, {
+  timeoutMs: 60_000,
+});
+
+// 5. 公开 verify — 不要求登录、不暴露 PII / 合同原文
+const result = await client.compliance.verifyEvidencePublic({ evidenceNo: 'EV-001' });
+console.log(result.manifestOfflineVerify);
+```
+
+### 写操作幂等与 401 策略
+
+合规域写操作有别于普通 API：
+
+- **Idempotency-Key**：所有 POST 写操作支持 `Idempotency-Key` header；调用方必须**持久化**
+  key（重启后仍可用）。同一 key 重发等价于"对账查询同一业务结果"，避免 provider 侧重复
+  请求 / 重复扣费。
+- **401 不自动重放**：写操作 401 直接抛 `HTTPError`，**不会自动 refresh + replay**。
+  调用方需要重新登录后用**同一 idempotency-key** 调用同一方法。GET 读操作仍走单次 401
+  refresh 重试。
+- **5xx / timeout 不自动重试**：合规域写操作完全禁用自动重试。
+- **step-up 错误（`COMPLIANCE_STEP_UP_REQUIRED`，code=1031000013）**：通过
+  `classifyComplianceError` 识别后引导用户重新做 OAuth introspection / 升级 token 等级。
+- **gate closed / provider not configured / unknown**：terminal 错误，禁止自动重发原请求。
+
+### 隐私边界
+
+`verifyEvidencePublic` 返回字段：`evidenceNo` / `assetType` / `hashAlgorithm` / `contentHash` /
+`size` / `manifestHash` / `packageHash` / `manifestOfflineVerify` / `verifiedAt`。**不暴露**
+PII / 合同原文 / storage bucket+key / subject snapshot / provider raw / TSA 证书内部字段。
+
+### 完整 API 列表
+
+```ts
+client.compliance.createEvidenceAsset(req, options?)
+client.compliance.getEvidenceAsset(id, signal?)
+client.compliance.verifyEvidencePublic(req, signal?)
+
+client.compliance.issueTimestamp(req, options?)
+client.compliance.issueTimestampForAsset(assetId, options?)
+client.compliance.getTimestamp(id, signal?)
+client.compliance.verifyTimestamp(req, options?)
+client.compliance.waitForTimestampVerified(id, opts?)
+
+client.compliance.buildEvidencePackage(assetId, timestampTokenId?, options?)
+
+client.compliance.createReport(req, options?)
+client.compliance.getReport(id, signal?)
+client.compliance.publishReport(id, options?)    // step-up
+client.compliance.downloadReport(id, signal?)    // 离线复核 hash 视图
+
+client.compliance.createSigningEnvelope(req, options?)
+client.compliance.getSigningEnvelope(envelopeId, signal?)
+client.compliance.signEnvelope(envelopeId, req, options?)            // step-up + gate
+client.compliance.createH5SigningUrl(envelopeId, req, options?)      // step-up + gate
+client.compliance.syncSigningEnvelopeStatus(envelopeId, options?)
+
+client.compliance.submitSealApproval(req, options?)
+client.compliance.approveSealApproval(id, query, options?) // step-up
+client.compliance.rejectSealApproval(id, query, options?)
+client.compliance.cancelSealApproval(id, query, options?)
+client.compliance.listPendingSealApprovals(signal?)
+client.compliance.getSealApproval(id, signal?)
+
+client.compliance.getProviderRequest(id, signal?)
+client.compliance.waitForProviderRequestTerminal(id, opts?)
+```
+
+### 示例
+
+`examples/` 下提供 3 份可直接运行的端到端示例，并随 npm 包一起发布：
+
+- `examples/compliance-read.ts` — 只读 / public verify 流程
+- `examples/compliance-evidence-timestamp.ts` — hash-only evidence + timestamp + package 链路
+- `examples/compliance-envelope.ts` — envelope 创建 / 错误正确处理（step-up / gate closed）
+
+### 后端边界
+
+- Java compliance 后端负责 provider 集成、受控材料、provider raw payload、local verify、
+  billing 状态机和对外 public DTO 收敛。
+- Go OAuth/JWKS 层负责 token 签发、scope 与 step-up/introspection 语义。
+- TS SDK 只申请 scope、发送公共 DTO、传递 `Idempotency-Key`、分类公开错误码并轮询脱敏状态视图。
+
 ## AbortSignal
 
 每个异步方法都接 `signal?: AbortSignal`，用于取消请求或流：
@@ -314,7 +482,9 @@ npm run build
 
 | 版本 | 状态 | 概要 |
 | --- | --- | --- |
-| 1.1.0 | 当前稳定版 | 新增 SDK-facing `agentRuns` 网关客户端，覆盖 create/stream/cancel/get/artifacts/local-tool-result，并提供本地只读工具桥协议。 |
+| 1.3.0 | 当前稳定版 | 新增 compliance SDK client、base URL、types/errors/status/scopes、docs/examples/tests，并明确 idempotency/no-retry/no-401-replay 与 provider material 安全边界。 |
+| 1.2.0 | 稳定版 | 新增 `ManagedModel.inputModalities`、桌面视觉理解 sidecar capability 与 4 个 catalog helpers。 |
+| 1.1.0 | 稳定版 | 新增 SDK-facing `agentRuns` 网关客户端，覆盖 create/stream/cancel/get/artifacts/local-tool-result，并提供本地只读工具桥协议。 |
 | 1.0.2 | 稳定版 | 修复多进程共享 token refresh rotation 竞态。 |
 | 1.0.1 | 历史稳定版 | 修复 1.0.0 双层 broken packaging:tsup 输出 `.mjs+.cjs` 与 exports 字段对齐;9 处 `declare module` 绑包名 `@acosmi/sdk-ts` 让 d.ts augmentation 在 consumer 视角合并;prepublishOnly 加 packed-tarball 烟测拦截"源码过 / 打包后 broken"。 |
 | 1.0.0 | **deprecated** | 双层 broken:(1) `package.json.exports` 8 处 `.mjs` 引用与 tsup 默认 `.js+.cjs` 错位 → bun/Node ESM `Cannot find module`;(2) 9 处 `declare module` 用相对路径,consumer 视角断链 → 50+ 方法 TS2339。`npm install @acosmi/sdk-ts` 自动跳到 1.0.1。 |