@tier0/sdk-v2 0.6.1 → 0.6.3

package/docs/acceptance-2026-10-22.md

@@ -1,90 +0,0 @@
-# SDK v2 安装包与开发环境验收
-
-日期：2026-10-22。包：`@tier0/sdk-v2@0.1.0`。
-
-> 历史记录：以下结果仅适用于当时版本。2026-10-27 已退役 Stream 就绪探针及逐 Key Control scopes/codes；当前 SDK 不再导出该探针。不得将下文历史 403 当作 Stream 故障或按旧授权模型要求扩权。后续验收见 [Tier0-doc 新版架构专题](https://github.com/FREEZONEX/Tier0-doc/blob/main/docs/新版架构/03-Cloud新版改造/112-Stream控制就绪探针退役.md)。
-
-验收对应 SDK 提交 `5d30d5154354bac94bbbe88402a8303d6c43526d` 的安装包。报告提交时远端已合入其他功能（至 `78f5168`）；下列测试数量和业务结论不覆盖那些新增功能。
-
-结论：安装包和本地自动化通过；多组真实业务操作通过，但不能宣称“所有功能已可用”。追加验收已完成真实站内通知发送、Stream 发布、当前 release 的真实执行、停用及归档。Source 创建预检、Control 权限、Stream 能力查询、Agent 真实用户身份及文件大分片传输仍有阻断或限制。
-
-## 测试对象与方法
-
-- 测试 Workspace：`374897752781296`。网页 `https://dev.tier0.cn`，SDK API Host **`https://api-dev.tier0.cn`**。
-- 使用用户提供的 service Key，先以 `system.whoami()` 验证 Workspace。凭据仅进入测试进程环境，没有写入文件、安装包或 Git。
-- 后端契约固定版本：`1e93620522caa47869d67e9aea1491a8cda71fa5`。未修改后端或部署配置。
-- `npm pack` 后在独立 consumer 中安装 `.tgz`。真实环境脚本从这个 consumer 加载 SDK；Skill 工作流提取的是安装包中的 Markdown 代码。
-- 写入仅针对本次生成的 SDK 验收资源。Source 只做创建预检；追加测试发布了无 Source 绑定、无外部写入的独立 timer Stream，随后停用并归档。经用户指定，向成员 `tier0` 发送了一条“SDK 验收”站内通知。
-
-## 安装包检查
-
-| 检查 | 结果 |
-| --- | --- |
-| 源码行为测试 | 580 / 580，15 个文件 |
-| 安装后行为测试 | 580 / 580，同套断言，导入目标为包内 dist |
-| 全部生成操作路由 | 50 个 v1 + 98 个 v2，每个实际请求本地 HTTP fixture |
-| Skills | 11 个；62 个 TypeScript 示例对源码及包内声明类型检查通过 |
-| 使用形式 | ESM、CommonJS、声明导出、独立包安装、浏览器 bundle 通过 |
-| 调试映射 | JS map 内嵌源码；不再提供指向包外源码的声明 map |
-
-路由 smoke 检查证明方法、路径和基本传输可用，不证明每个业务字段或每种服务端状态已验收。已有测试另外覆盖无损整数、超时/取消、写入结果未知、不自动重试、凭据隔离、对象存储无平台凭据以及 Skill 的主要生命周期。
-
-## 真实环境结果
-
-| 功能 | 结果与范围 |
-| --- | --- |
-| 系统、成员、能力发现 | whoami、info、Workspace 成员列表、capabilities.discover 通过 |
-| Source 查询 | 协议列表、配置列表、原生文档列表通过；读到 7 个现有 Source |
-| Source 创建 | 原生文档 dryRun 返回 HTTP 503 / TEMPORARILY_UNAVAILABLE，消息 `cloud lifecycle service unavailable`；未继续提交创建，因此修改/删除/连接采集未验收 |
-| Stream | 读取原有 9 个 Stream；独立 timer 草稿 CRUD 通过。追加的发布、当前 release 执行完成、停用、归档通过，证据见下文 |
-| Stream runtime capabilities | HTTP 403 / FORBIDDEN，`API key operation not allowed`；不代表所有 Stream 接口都不可用 |
-| UNS 集合与记录 | 创建、读取、修改、删除/归档、恢复和最终清理通过；执行包内 Skill 示例 |
-| UNS 目录与 Topic | 创建、读回、修改、归档、恢复、再次归档通过 |
-| UNS 采样与查询 | 采样追加、历史、最新值、聚合、范围删除及空结果核对；记录 count/distinct 通过 |
-| UNS 并发和事务 | 记录加锁、续租、解锁；事务 dryRun、提交和读回；changes poll 通过 |
-| 文件普通上传 | 上传测试文本、签名 URL、下载内容逐字比对、删除通过 |
-| 文件分片 | 6 MiB、两片测试未完成。初始化和签名 API 返回 200，第一片向 OSS S3 endpoint 的 PUT 在 30 秒和诊断用 60 秒期限内均未完成；错误为 AbortError，尚不能区分网络与服务配置根因。两次未完成会话均已 abort 成功 |
-| MQTT | 使用同一 service Key 连接 `wss://mqtt-dev.tier0.cn:8084/mqtt` 成功，已断开 |
-| Control | discover 返回 HTTP 403 / CONTROL_FORBIDDEN；未调用实际控制设备 |
-| Agent | library/results/canvases 列表通过；当前画布列表为空，未构造虚假 canvasId 测卡片。jobs.list 返回业务码 100012：任务管理需要真实用户身份，内部服务虚拟负责人不能代替 |
-| 通知 | 向用户指定的 `tier0` 成员发送一条 live inbox 通知，channels=[]，无邮件/短信；发送返回 accepted，随后状态查询为 sent。未验证收件人已读 |
-
-Source 的 503 是后端返回的统一生命周期错误。对固定版本代码的检查表明它可包装多种内部失败，因此本报告不把它进一步断言为某个具体服务宕机或数据库故障。SDK 正确抛出了服务端错误。
-
-## 追加验收与修复判断
-
-追加测试仍从已安装的 `.tgz` 加载 SDK，Workspace 不变。只读检查 ACK `tier0-dev-ack`；当时 unssvr、syssvr、gwsvr 镜像 tag 为 `feature-cloud-new-architecture-migration-ab88c067-20261022-204`，对应提交 `ab88c0674f8362780bd685743fe064aa22143e64`。这是部署版本，不能与 SDK 固定契约版本混同。
-
-- 通知：messageId `375221818446704`，收件人 `tier0`，标题“SDK 验收”，查询状态 `sent`，errorCode 为空。只发送一次；sent 是服务端状态，不等同于用户已读。
-- Stream：测试 ID `375222335204848`，activeVersion `375222336562672`，activeRelease `1`。本次 release 的执行 `delivery:375222339446256` 和 `delivery:375222337334768` 均为 `completed`。随后确认 activeRelease=0，再删除归档。首次补测脚本误读 `runs.list`，已修正为契约规定的 `runs.items`，并重新创建隔离流验证；两次测试流均已清理。
-- 保存后的通用脚本再次实跑通过：Stream `375222824547824`，activeVersion `375222826821104`，release `1` 的 `delivery:375222827312624` 为 `completed`，最后停用并归档。脚本语法检查和 `git diff --check` 通过；本次未修改 SDK 运行时代码。
-- 此前通知因未指定收件人而未发送；Stream 发布运行属于上一轮测试覆盖遗漏。能力查询 403 不构成停止测试发布运行接口的理由。
-
-| 阻断 | 已确认事实 | 修复方向与边界 |
-| --- | --- | --- |
-| Source 创建 503 | 当前镜像仍复现；requestId `8b0197c1-3479-4277-ba70-89e131512437`。错误映射将多种内部错误合并为 `cloud lifecycle service unavailable`，现有日志未能将根因关联到此请求 | 服务端在 Source 管理身份刷新、租户解析、凭据绑定预检、事务写入边界增加不含凭据的阶段码和 requestId 关联，再针对确切失败修复。暂不能声称重启、加权限或迁库能解决。未修改部署或数据库 |
-| 大文件分片 PUT 超时 | 追加对照中 1 KiB 的 PUT=200、complete=200；5 MiB 首片仍超过 20 秒。原测试 30/60 秒同样超时；额外把 Blob 转为 Uint8Array 发送，60 秒仍超时。小文件完成后的下载 URL 查询另遇连接错误，文件已删除，大分片会话已 abort | 签名对小分片有效，替换 Blob 发送体未解决。仍需上传路径/OSS 服务端证据定位；仅增大 timeout 不能算修复，须以两片上传、合并及下载 hash 比对为验收 |
-| 当时的 Control 与 runtime capabilities 403 | 当时部署代码将能力查询放在旧 Control 权限分支 | 历史原因，不适用当前版本。探针现已退役，实际调用归入统一权限，不再要求逐 Key Control scopes/codes |
-| Agent jobs 身份限制 | 当前是 service Key；任务管理明确要求真实用户 | 使用有任务权限的真实成员 personal Key 或该功能支持的会话身份。扩大 service Key scope 不能把它变成真实用户 |
-
-ACK 日志另有 `UNS control metadata requires explicit migration before startup`，但尚未证实属于本 Workspace 或此次 Source 请求，不能把该日志当成本次 503 的根因。部署、重启、授权变更和数据库迁移均未执行。
-
-## 未验收范围
-
-不能从上述通过项推断 Source 探测/启用/真实采集、Source 绑定 Stream 的端到端数据链、Stream 回滚、MQTT 发布订阅消息闭环及凭证创建撤销、通知已读、邮件/短信通道、Control 执行、Agent 任务/卡片/即时分析写入已经可用。React/Vue 完成类型和打包检查，未在实际应用页面中进行组件交互验收。
-
-全量业务验收需要先解决 Source 和分片阻断，并提供相应功能允许的身份、权限和测试对象。权限失败不能通过 SDK 绕过；当前 service Key 不应被当作真实用户身份。
-
-## 清理与复现
-
-最终以 SDK 按测试前缀检索，活跃 Source、Stream、集合、目录、Topic 均为 0。创建过的业务资源使用平台归档语义清理，归档历史保留；测试文本对象已删除，未完成分片会话已终止。
-
-复现入口：
-
-- `npm run check`：自动打包、安装并执行包内行为测试，不触及线上。
-- `scripts/check-live-readonly.mjs`：仅查询，检查 Workspace 绑定，报告不保存原始业务响应。
-- `scripts/check-live-workflows.mjs`：需显式 `--write-test-fixtures`，可用 `TIER0_TEST_DOMAINS=uns,extended` 选择扩展 UNS 验收。
-- `scripts/check-live-transports.mjs`：普通 API 鉴权、分片传输和 MQTT 连接诊断；只记录状态、耗时与存储 origin，不记录签名查询字符串。
-- `scripts/check-live-stream-runtime.mjs <consumer> <workspace> <report> --write-test-fixtures`：从安装包创建独立 timer 流，发布后按当前 release 检查 completed 记录，最后停用并归档；需进程环境中的 API Host 和 Key。
-
-本次安装包用于本地分发与验收，未发布到 npm。