@henjicc/ai-sdk 0.6.1 → 0.6.2

package/dist/llm/streaming.js

@@ -1,3 +1,5 @@
+import { drainSseEvents } from '../protocols/sse-events.js';
+import { AiRuntimeError } from '../runtime/AiRuntimeError.js';
 import { fetchProvider } from '../providers/provider-fetch.js';
 import { applyProviderRequestBodyQuirks, resolveProviderExtraAuthHeaders, } from './providerProtocolCore.js';
 import { applyProviderReasoningRequestBody } from './providerReasoningRequest.js';
@@ -78,7 +80,7 @@ export async function streamOpenAiCompatibleChat(options) {
     if (!response.body) {
         throw new Error('LLM streaming response body is empty');
     }
-    return await readSseStream(response.body, options.emit);
+    return await readSseStream(response.body, options);
 }
 export function serializeMessage(message) {
     const serialized = { role: message.role };
@@ -138,7 +140,8 @@ function serializeContentPart(part) {
     }
     return next;
 }
-async function readSseStream(body, emit) {
+async function readSseStream(body, options) {
+    const { emit, signal } = options;
     const reader = body.getReader();
     const decoder = createUtf8StreamDecoder();
     let pending = '';
@@ -147,68 +150,84 @@ async function readSseStream(body, emit) {
     let usage = null;
     let finishReason = null;
     const toolCalls = new Map();
-    let streamDone = false;
-    while (!streamDone) {
-        const result = await reader.read();
-        if (result.done) {
-            streamDone = true;
-            continue;
-        }
-        pending += decoder.decode(result.value, { stream: true });
-        const parsed = drainSseEvents(pending);
-        pending = parsed.remaining;
-        for (const event of parsed.events) {
-            const chunk = parseSseData(event);
-            if (chunk.done) {
-                return {
-                    output,
-                    reasoningOutput,
-                    usage,
-                    finishReason,
-                    truncated: isOutputTruncated(finishReason),
-                    toolCalls: [...toolCalls.values()],
-                };
-            }
-            usage = chunk.usage ?? usage;
-            finishReason = chunk.finishReason ?? finishReason;
-            mergeToolCallDeltas(toolCalls, chunk.toolCalls);
-            if (chunk.reasoning) {
-                reasoningOutput += chunk.reasoning;
-                emit({ type: 'ReasoningToken', data: chunk.reasoning });
+    let eof = false;
+    let stage = 'read';
+    let cancellation;
+    const cancelReader = () => {
+        // Cleanup may reject on an already errored stream. It must not replace the
+        // original protocol/transport failure or delay settlement on a custom host.
+        cancellation ??= reader.cancel().catch(() => undefined);
+    };
+    const checkAbort = () => {
+        if (signal.aborted)
+            throw Object.assign(new Error('LLM stream cancelled'), { name: 'AbortError' });
+    };
+    const complete = () => {
+        stage = 'completion';
+        checkAbort();
+        if (!finishReason)
+            throw new AiRuntimeError('STREAM_INCOMPLETE', 'Chat stream ended without finish_reason');
+        return { output, reasoningOutput, usage, finishReason,
+            truncated: isOutputTruncated(finishReason, options.providerId), toolCalls: [...toolCalls.values()] };
+    };
+    signal.addEventListener('abort', cancelReader, { once: true });
+    try {
+        checkAbort();
+        for (;;) {
+            stage = 'read';
+            const result = await reader.read();
+            checkAbort();
+            if (result.done) {
+                eof = true;
+                // SSE dispatch requires a blank line. Do not manufacture a final event
+                // from an unterminated block at EOF.
+                return complete();
             }
-            if (chunk.content) {
-                output += chunk.content;
-                emit({ type: 'Token', data: chunk.content });
+            pending += decoder.decode(result.value, { stream: true });
+            const parsed = drainSseEvents(pending);
+            pending = parsed.remaining;
+            for (const event of parsed.events) {
+                checkAbort();
+                stage = 'parse';
+                const chunk = parseSseData(event, options.providerId);
+                if (chunk.done)
+                    return complete();
+                if (finishReason && (chunk.content || chunk.reasoning || chunk.toolCalls?.length
+                    || (chunk.finishReason && chunk.finishReason !== finishReason))) {
+                    throw new AiRuntimeError('INVALID_STREAM_RESPONSE', 'Chat result changed after finish_reason');
+                }
+                usage = chunk.usage ?? usage;
+                finishReason = chunk.finishReason ?? finishReason;
+                mergeToolCallDeltas(toolCalls, chunk.toolCalls);
+                stage = 'emit';
+                if (chunk.reasoning) {
+                    reasoningOutput += chunk.reasoning;
+                    emit({ type: 'ReasoningToken', data: chunk.reasoning });
+                    checkAbort();
+                }
+                if (chunk.content) {
+                    output += chunk.content;
+                    emit({ type: 'Token', data: chunk.content });
+                }
             }
         }
     }
-    const flushed = decoder.decode();
-    if (flushed) {
-        pending += flushed;
-    }
-    const parsed = drainSseEvents(`${pending}\n\n`);
-    for (const event of parsed.events) {
-        const chunk = parseSseData(event);
-        usage = chunk.usage ?? usage;
-        finishReason = chunk.finishReason ?? finishReason;
-        mergeToolCallDeltas(toolCalls, chunk.toolCalls);
-        if (chunk.reasoning) {
-            reasoningOutput += chunk.reasoning;
-            emit({ type: 'ReasoningToken', data: chunk.reasoning });
-        }
-        if (chunk.content) {
-            output += chunk.content;
-            emit({ type: 'Token', data: chunk.content });
+    catch (error) {
+        if (error instanceof AiRuntimeError) {
+            throw new AiRuntimeError(error.code, 'Chat streaming response failed', {
+                providerId: options.providerId, modelId: options.payload.model,
+                protocol: 'openai-chat-sse', stage, receivedFinish: finishReason !== null,
+                ...(error.details?.finishReason === 'network_error' ? { finishReason: 'network_error' } : {}),
+            });
         }
+        throw error;
+    }
+    finally {
+        signal.removeEventListener('abort', cancelReader);
+        if (!eof)
+            cancelReader();
+        reader.releaseLock();
     }
-    return {
-        output,
-        reasoningOutput,
-        usage,
-        finishReason,
-        truncated: isOutputTruncated(finishReason),
-        toolCalls: [...toolCalls.values()],
-    };
 }
 function applyStructuredOutputRequestBody(request, providerId, body) {
     const output = request.structuredOutput;
@@ -282,47 +301,68 @@ function resolveMaxOutputTokens(request) {
 function invalidRequest(code, message) {
     return Object.assign(new Error(message), { code, statusCode: 400 });
 }
-function isOutputTruncated(finishReason) {
-    return finishReason === 'length' || finishReason === 'max_tokens' || finishReason === 'max_output_tokens';
-}
-function drainSseEvents(input) {
-    const events = [];
-    let remaining = input;
-    let hasSeparator = true;
-    while (hasSeparator) {
-        const separator = findNextSeparator(remaining);
-        if (!separator) {
-            hasSeparator = false;
-            continue;
-        }
-        if (separator) {
-            events.push(remaining.slice(0, separator.index));
-            remaining = remaining.slice(separator.index + separator.length);
-        }
-    }
-    return { events, remaining };
-}
-function findNextSeparator(input) {
-    const crlf = input.indexOf('\r\n\r\n');
-    const lf = input.indexOf('\n\n');
-    if (crlf === -1 && lf === -1)
-        return undefined;
-    if (crlf !== -1 && (lf === -1 || crlf < lf))
-        return { index: crlf, length: 4 };
-    return { index: lf, length: 2 };
+function isOutputTruncated(finishReason, providerId) {
+    return finishReason === 'length' || finishReason === 'max_tokens' || finishReason === 'max_output_tokens'
+        || (providerId === 'bigmodel' && finishReason === 'model_context_window_exceeded');
 }
-function parseSseData(event) {
+function parseSseData(event, providerId) {
+    const eventName = event.split(/\r\n|\r|\n/)
+        .filter(line => line.startsWith('event:')).at(-1)?.slice(6).trim();
     const data = event
-        .split(/\r?\n/)
-        .map((line) => line.trim())
+        .split(/\r\n|\r|\n/)
         .filter((line) => line.startsWith('data:'))
         .map((line) => line.slice(5).trim())
         .join('\n');
+    if (eventName === 'error' && !data)
+        throw new AiRuntimeError('PROVIDER_STREAM_ERROR', 'Server error event');
     if (!data)
         return { done: false };
-    if (data === '[DONE]')
+    if (data === '[DONE]' && (!eventName || eventName === 'message'))
         return { done: true };
-    const json = JSON.parse(data);
+    if (eventName && !['message', 'chat.completion.chunk', 'error'].includes(eventName))
+        return { done: false };
+    let json;
+    try {
+        json = JSON.parse(data);
+    }
+    catch {
+        if (eventName === 'error')
+            throw new AiRuntimeError('PROVIDER_STREAM_ERROR', 'Server error event');
+        throw new AiRuntimeError('INVALID_STREAM_RESPONSE', 'Invalid SSE JSON');
+    }
+    if (eventName === 'error' || (isRecord(json) && json.error != null)) {
+        const error = isRecord(json) && isRecord(json.error) ? json.error : json;
+        const code = isRecord(error) && typeof error.code === 'string' && /^[\w.-]{1,80}$/.test(error.code)
+            ? error.code : 'PROVIDER_STREAM_ERROR';
+        throw new AiRuntimeError(code, 'Server error event');
+    }
+    // BigModel's documented SDK consumer permits status-only chunks without
+    // choices. This does not make them completion evidence or allow wrong types.
+    const statusOnlyAllowed = providerId === 'bigmodel';
+    if (statusOnlyAllowed && isRecord(json) && json.choices === undefined) {
+        return { done: false, usage: readUsage(json) };
+    }
+    if (!isRecord(json) || !Array.isArray(json.choices)) {
+        throw new AiRuntimeError('INVALID_STREAM_RESPONSE', 'Chat chunk has no choices array');
+    }
+    if (json.choices.length === 0) {
+        if (!statusOnlyAllowed && !isRecord(json.usage))
+            throw new AiRuntimeError('INVALID_STREAM_RESPONSE', 'Empty choices without usage');
+        return { done: false, usage: readUsage(json) };
+    }
+    const first = json.choices[0];
+    if (!isRecord(first) || !isRecord(first.delta)
+        || (first.finish_reason != null && (typeof first.finish_reason !== 'string' || !first.finish_reason.trim()))) {
+        throw new AiRuntimeError('INVALID_STREAM_RESPONSE', 'Invalid Chat choice');
+    }
+    if (providerId === 'bigmodel' && first.finish_reason === 'network_error') {
+        throw new AiRuntimeError('PROVIDER_STREAM_ERROR', 'Model inference failed', { finishReason: 'network_error' });
+    }
+    for (const field of ['content', 'reasoning_content', 'reasoning']) {
+        if (first.delta[field] != null && typeof first.delta[field] !== 'string') {
+            throw new AiRuntimeError('INVALID_STREAM_RESPONSE', 'Invalid Chat text delta');
+        }
+    }
     const delta = readDelta(json);
     return {
         done: false,

package/dist/protocols/sse-events.d.ts

@@ -0,0 +1,4 @@
+export declare function drainSseEvents(input: string): {
+    events: string[];
+    remaining: string;
+};

package/dist/protocols/sse-events.js

@@ -0,0 +1,31 @@
+// Dispatch only complete SSE events; an EOF does not imply a blank line.
+export function drainSseEvents(input) {
+    const events = [];
+    let remaining = input;
+    let hasSeparator = true;
+    while (hasSeparator) {
+        const separator = findNextSeparator(remaining);
+        if (!separator) {
+            hasSeparator = false;
+            continue;
+        }
+        if (separator) {
+            events.push(remaining.slice(0, separator.index));
+            remaining = remaining.slice(separator.index + separator.length);
+        }
+    }
+    return { events, remaining };
+}
+function findNextSeparator(input) {
+    // CRLF is one line ending, including when it crosses transport chunks.
+    const endings = /\r\n|\r|\n/g;
+    let previous = null;
+    let current;
+    while ((current = endings.exec(input)) !== null) {
+        if (previous && previous.index + previous[0].length === current.index) {
+            return { index: previous.index, length: previous[0].length + current[0].length };
+        }
+        previous = current;
+    }
+    return undefined;
+}

package/docs/consumers.md

@@ -1,107 +1,119 @@
-# SDK 消费项目清单
-
-本清单是 `@henjicc/ai-sdk` 消费方的唯一维护入口，用于 SDK 发布后的跨仓升级协调。
-绝对路径仅描述当前开发机上的仓库位置，不进入 SDK 运行时代码、发布包或用户配置。
-
-最后核对日期：2026-09-24
-
-`0.6.0` 已发布：新增 MiMo 2.6、GLM-5.3-FlashX、KIE HappyHorse 1.1、火山 Seedream 5.0 Flash 和百炼 Qwen Audio 3.1 ASR；补齐 MiMo Responses 思考事件与 ASR JSON/说话人解析。SDK 79 个测试文件 / 933 项测试、类型构建、可移植性、49 个公开入口和受限宿主验证通过；痕迹 AI 目录、参数组合、模型发现与旧配置兼容验证通过。MiMo 思考事件、ASR JSON 回退、HappyHorse 图生字段的修复撤销验证均检测到失败，恢复后通过。未执行付费请求。发布提交 `d08ea8fa` 的必需 CI [35904531000](https://github.com/henjicc/Henji-AI/actions/runs/35904531000) 全部通过，npm 网页认证后发布固定候选包；公共索引可读后，隔离配置、缓存与令牌的仓外匿名安装、包校验、新模型请求探针、Vite 49 入口和受限宿主验证全部通过。
-
-本轮消费影响：Henji-AI 自动组合新增 generation pack，无需新增助手工具；三个仓内示例精确依赖同步到 `0.6.0`，均在仓外从公共 npm 匿名安装，minimal-node dry-run、llm-chat dry-run / bundle 边界和 form-renderer 构建 / 五类模型表单输出通过。外部 `say-it` 仍需先完成 `0.5.0` 文件上传桥迁移；当前未引入这批模型，不机械升级。`henji-ai-ps` 本机未定位，不声称已完成外部宿主升级。
-
-- `0.6.0` tarball：[公共 npm 包](https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.6.0.tgz)
-- `0.6.0` shasum：`2d02f956d6addc9fb92580cda323bc9d0904607e`
-- `0.6.0` integrity：`sha512-GzhWnVkdv2NNZjf0diI9dRBRkc/cH0O5nCjbiQrast54f+ik4Q4LbKjytrMhyMawxaSkCoHVeNQuEUwnCDkcnA==`
-
-Henji-AI 安装包的 GPT Image 2.5 高分辨率报错归属：宿主智能比例预处理曾忽略联动过滤，将 `smart` 转成 KIE 仅限 1K 的 `27:16`，SDK 在请求前正确拒绝。修复位于应用公共预处理，按当前分辨率/渠道的合法选项匹配；Flare/Sunburst 的 1K/2K/4K 及 APIMart、Grsai 同类筛选已有定向覆盖。无需放宽 SDK 契约或发布 SDK；安装包需随应用更新才包含修复，现有版本可手动选合法比例规避。
-
-当前仓内及公共 npm SDK：`0.6.0`（2026-09-24 已发布并完成公共匿名回装）。以下为历史发布证据。
-
-`0.5.2` 完善轻量 `@henjicc/ai-sdk/llm/streaming`：正式类型支持文本、JSON Object 与 JSON Schema，Chat Completions 的最终请求体写入 `response_format`，OpenAI 输出上限写入 `max_completion_tokens`；结构化输出、思考模式和模型能力的非法组合会在请求前返回结构化错误。流式正文与思考继续分离，保留外部 `AbortSignal`，不设置默认总时限；未显式配置输出上限时不再注入 4096，服务端以 `length` 等原因结束时返回 `truncated: true`。发布前 77 个测试文件 / 909 项测试、可移植性、构建、49 个 Vite 公开入口和受限宿主门禁通过；故意撤销结构化参数、输出上限、OpenAI 字段映射和截断标记后，8 项定向断言失败，恢复后通过。公共索引可读后，已使用隔离 npm 配置和缓存匿名安装精确版本，并从已发布的轻量入口验证最终请求体包含 JSON Schema、思考强度和 24,000 token 上限，SSE 正文/思考事件分离且未截断。
-
-- `0.5.2` tarball：https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.5.2.tgz
-- `0.5.2` shasum：`f1c06ae12c9240b203f3ad310c4eec35b755db13`
-- `0.5.2` integrity：`sha512-ljb50njJ0bXWxwNmlgZ1+YDBoBgPiLhoNEDjsbhPbe4pc7aVZGcfvpDLh+zGdx9KsB7g7Xp3mqVM4MLpVQm15g==`
-
-`0.5.1` 将 Grsai GPT Image 2.5 未指定变体时的默认值从官方公告仍在维护的 Flare 改为 Standard，并同步默认价格；显式选择 Flare / Sunburst 的调用保持兼容。公共 DTO、请求协议、宿主边界和其余模型未变。发布前 77 个测试文件 / 899 项测试、可移植性、构建、49 个 Vite 公开入口和受限宿主门禁通过；公共索引可读后，已在隔离用户 npm 配置的仓外目录匿名安装并完成 ESM 导入。
-
-- `0.5.1` tarball：https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.5.1.tgz
-- `0.5.1` shasum：`40087e680f1b7de63a601d12758acb7280de305f`
-- `0.5.1` integrity：`sha512-+L/mAmFU6zgJ0gdsIwy0T1Z9TDOABaxO3HgLsEvMUNbRQhs9K55golF1472EgSJsIDysScnUulFJfBVg0xsNBg==`
-
-`0.5.0` 发布运行时代码提交 `1333422e`，补充边界回归提交 `da37e4bc`；后者必需 CI `35535140722` 全部成功。12组修复撤销验证均检测到失败，恢复后定向测试通过。固定候选包经仓外回装后发布，公共 registry 匿名安装的 shasum/integrity 与候选包一致；Vite公开入口和无TextEncoder/TextDecoder的受限宿主消费通过。npm网页登录与发布二次验证已完成；发布后等待公共索引可读才执行匿名验证，没有重复发布。
-
-- tarball：https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.5.0.tgz
-- shasum：`1b66a7c54f4f86a01b73fdca68b1c63e53dcbe10`
-- integrity：`sha512-MaPS87wDnvGdeAkGZOQHV+q/XPsQv9WZSPKYTYhqYrDhLbGUKS+m6h1sQ2oPM0GVXuZXKsos9BTJH61NSHjzag==`
-
-本轮按用户SDK范围交付可安装包及宿主调整依据；未升级或修改外部say-it/Photoshop仓库。say-it必须实现新流式/原生文件上传桥并完成Tauri集成验收后再升级；不能只改10 MiB常量。
-
-`0.5.0` 文件 ASR：四族九模型已核对。SDK 新增 describe/readChunk + fetchStream 的有界请求体消费，百炼异步 media-ref 必须通过 uploadFile 原生直传 OSS；旧宿主 read 兼容路径不得提升原内存阈值。structured media_too_large 保留实际字节、上限与可得时长。官方 Qwen 编码后10 MB对应原始7,500,000字节，Fun Flash 2,000,000,000字节/5分钟，Groq附件25,000,000，硅基流动50,000,000，百炼临时上传取min(1,000,000,000,凭证MB×1,000,000)。
-
-本次完成SDK精确回归、12组修复撤销反向验证、全量发布门禁与真实QuickJS 64 MiB堆探针（50 MB multipart、7.5/12 MB JSON）；未执行付费请求。say-it 当前 Host API 虽有分块，适配器仍拼回完整Uint8Array，请求体也仍缓冲，必须接入新契约后才可调整分块总文件上限；原生OSS单独受凭证限制。当前任务交付SDK及宿主调整依据，未改写该外部仓库或声称完成Tauri验收。Henji-AI/Photoshop现有生成媒体读取未迁移到新ASR接口，不机械增加未使用能力。
-
-2026-09-14 候选增量：安全网络失败在端点尝试耗尽后按 1/3/8 秒退避，每次失败重新判断重放安全性，取消立即结束退避。SDK 873 项测试、主进程定向测试与类型检查、可移植性及仓外 Vite／受限宿主消费通过；故意移除重试安全复核后，未知提交状态测试失败，恢复后通过。真实 Electron 主进程对本地服务及 KIE 无凭据只读查询，Node 与 Chromium 两栈均得到 HTTP 200；只证明当时连通，不代表付费生成成功，也未复现之前断连的外部原因。宿主增加关联原请求的脱敏 DNS／代理诊断，不更换网络栈。本机 npm 身份仍返回 401，本次候选变更尚未公共发布或同步外部消费者；下方旧候选包校验值仅对应此前版本内容。
-
-`0.4.2`：共享 transport 将 Node 明确的 TLS 建立前 ECONNRESET 识别为未发送，允许备用端点切换；GET/HEAD 的瞬态断连也允许切换，提交状态不明的写请求仍禁止重放。错误附带脱敏端点、阶段、耗时和提交状态，Henji-AI 生成与继续查询日志保留这些字段。SDK 870 项测试、宿主 7 项定向测试、可移植性、类型构建、仓外 Node ESM / 严格 TypeScript / Vite 49 入口与受限宿主回装通过；故意放行普通 ECONNRESET 重放会被 3 项写请求测试检测，恢复后全量通过。未执行真实付费请求。外部宿主使用不同 transport，需按其错误契约核对影响，不能将 Node 连接前分类视为所有宿主均已实测。
-
-修复提交 `5bf36dce` 已推送，CI `34758299265` 已启动。本机 npm 身份检查返回 `401 Unauthorized`，认证恢复且必需 CI 通过前不得发布；未声称完成公共回装或外部消费者升级。候选包 shasum 为 `dafaae4787798c3f22e5615fe8f5d60f4545c0a2`。宿主 Electron 类型检查与重启通过。上一提交 `45bb50b5` 的 CI 已存在两项画布能力引用相等断言失败，与本次网络修复无关，未夹带修改。
-
-`0.4.1`：修复 KIE GPT Image 2 / 2.5 的视频参考误标签，图片生成、编辑、多图输入及请求契约保持不变。109 个生成模型的跨模态视频标签检查、67 项定向测试、SDK 862 项全量测试、可移植性、类型构建及仓外公开入口/受限宿主回装通过。外部消费者登记版本为 `0.2.8`：say-it 不使用图片模型，不受影响；henji-ai-ps 的 KIE GPT Image 2 标签消费情况需在该项目可访问时核实，尚未升级。
-
-修复提交 `ef2be83f` 的必需 CI `34575686946` 已全部通过。正式包与固定候选包 shasum 一致：`32b8dd00f3e320822999b626b8e95a50b6a8ff2f`。发布后在仓外隔离 npm 配置并移除令牌环境变量，已从公共 npm 匿名安装精确版本；Node ESM、严格 TypeScript、49 个 Vite 入口及无 TextEncoder/TextDecoder 的受限宿主验证通过。仓内 workspace 与三个示例 manifest 已锁定 `0.4.1`；未执行真实付费生成或外部消费项目升级。
-
-- `0.4.1` tarball：`https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.4.1.tgz`
-- `0.4.1` integrity：`sha512-HtOoOlJWGR6m15wIvqI2VMJFk+ijHntXl2oZAqEA6Ri12gWqaa3JhPthisTj+epO7GwGcuGX4gW3a8qIDd4vAw==`
-
-`0.4.0`：新增硅基流动聊天预设与分类模型发现，提交 `a678dab6` 已推送，必需 CI `34565921443` 全部通过。SDK 861 项测试、宿主配置 15 项测试、类型构建、49 个公开入口及受限宿主候选包回装通过；未执行真实付费推理。移除服务端分类参数的断牙验证使 4 项测试失败，恢复后全量通过。
-
-账号网页二次验证已完成，正式包与候选包校验值一致。已在仓外隔离 npm 配置并移除令牌环境变量，从公共 npm 匿名安装精确版本：Node ESM、严格 TypeScript、Vite 49 个入口及无 TextEncoder/TextDecoder 的受限宿主验证通过，包含硅基流动动态模型发现。仓内 workspace 与三个示例 manifest 已锁定 `0.4.0`；现有外部消费者未新增硅基流动聊天使用，暂不升级。
-
-- tarball：`https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.4.0.tgz`
-- shasum：`29a267d8a9f8375ac08b5af94569939473ab6a17`
-- integrity：`sha512-4D2gHakuo7Fhhh3a987qrObqJd78k8mIhXPL9dgE3A5uywBi4ebHj7U4XVLUcbjv/HO34wH/+8kFlE5JMOGD0g==`
-
-`0.3.0` 已发布：新增四家 GPT Image 2.5 pack、五家文本 embedding / 四家 rerank，DeepSeek 官方默认模型更新为 `deepseek-flash`。发布提交 `a2dc5bc4` 的必需 CI 门禁全部通过（运行 `34532267703`），SDK 全量 839 项测试和候选包回装通过。正式包已在隔离 npm 配置、无用户令牌的仓外环境从公共 npm 安装，标准 Vite 48 个入口与受限宿主验证通过；正式包校验值与候选包一致。未运行真实付费模型请求。
-
-Henji-AI workspace 与三个仓内示例 manifest 均锁定 `0.4.0`；下表原有示例运行记录仅代表 `0.2.8` 历史证据，本次未完成三个示例的独立全套回装复验。`say-it` 已在 `D:/VibeCode/说吧` 定位，仍锁定公共 npm `0.2.8`，实际按需使用 ASR、translation 与 LLM modules，未使用本次新增硅基流动聊天能力，无需机械升级；未运行其真实宿主验收。`henji-ai-ps` 的下表路径为另一台开发机记录，本机未定位该路径，不声称本次完成外部升级。
-
-## 判定口径
-
-- **消费者**：package manifest / lockfile 声明 SDK，或源码、构建入口实际导入 SDK。
-- **内部消费验证面**：位于 SDK 主仓库内，但有独立 manifest 和可运行构建的示例；它们不是外部仓库，仍需跟随发布版本验证。
-- **非消费者证据**：README、任务交接、迁移记录中的文字引用，以及没有进入实际构建的声明，不单独算消费者。
-- 扫描范围为 `/Users/henji/Documents/VibeCode` 下一级项目，排除了 `.git`、`node_modules`、`dist`、`target`、`build`、`coverage` 和缓存目录。
-
-## 独立宿主
-
-| 仓库 / 开发路径 | 宿主类型 | 当前精确版本 | SDK 入口与构建方式 | 凭据 / transport 责任 | 需同步的变更类型 | 验证命令 | 同步证据与边界 | 最后核对 |
-|---|---|---|---|---|---|---|---|---|
-| `Henji-AI`<br>`D:/VibeCode/Henji-AI` | Electron 42 主进程 + React/Vite；SDK 主开发、首发验证宿主 | workspace 源码与公共 npm 均为 `0.6.0` | 包根、`provider-packs/*`、`tool-packs/*`；根构建先执行 `build:sdk`，再构建 Electron | Electron 主进程注入 HTTP transport、凭据、媒体读取、日志、trace、取消与落盘；渲染层不直接持有密钥 | 公共类型/目录、provider preset、凭据坐标、transport、媒体、包导出、LLM/生成执行协议 | SDK 发布门禁、相关宿主 Vitest、渲染层/主进程类型检查与模型 i18n | `d08ea8fa`；必需 CI `35904531000` 成功，SDK 933 项测试、公开入口及受限宿主验证通过；公共包匿名安装及校验值一致，未执行付费请求 | 2026-09-24 |
-| `henji-ai-ps`<br>`/Users/henji/Documents/VibeCode/henji-ai-ps` | Photoshop UXP 插件 + React/Vite IIFE（pnpm） | manifest/lock 均精确锁定公共 npm `0.2.8`；lock integrity 与上方正式产物一致 | `generation/core`、单模型/供应商 pack、LLM streaming；Vite 构建与 UXP smoke bundle | UXP 宿主注入受限 `fetch`、provider 凭据、媒体编码读取和脱敏日志；SDK 不读取 Node/文件系统 | 生成 pack/exports、受限环境可移植性、RuntimeContext、凭据 scope、媒体与流式 LLM；不因版本同步自动引入 GLM | `pnpm typecheck:uxp-smoke && pnpm check:uxp-sdk && pnpm smoke:uxp:build && pnpm check:uxp-smoke`；完整 `pnpm check` | `e509716`；无用户 npm 凭据的 frozen lock 安装通过；Node 22 下四项门禁通过，正式产品仍仅 39 个 generation/erase packs，网络调用与受限环境风险均为 0 | 2026-08-31 |
-| `say-it`<br>`/Users/henji/Documents/VibeCode/say-it` | Tauri 2 + Rust 管理 QuickJS；WebView 不运行 SDK | manifest/lock 均精确锁定公共 npm `0.2.8`；resolved、shasum、integrity 与上方正式产物一致 | 按需打包 capability、Bailian/火山实时 ASR、SiliconFlow/Groq 文件 ASR、translation、LLM modules 为相互隔离 IIFE；Rust 加载 bundle | Rust Host API 注入 HTTP 字节流、WS、media-ref、CredentialStore、日志/trace、Abort/timeout/cancel；QuickJS/插件/WebView 不直取密钥 | capability/LLM 协议、按需 exports、descriptor source/坐标、QuickJS 可移植性、bundle 隔离；不因版本同步自动增加未采用模型 | `npm run sdk-runtime:typecheck && npm run sdk-runtime:build`；`npm run test:ui`；Rust 定向/全量测试；`npm run ui:build` | SDK 迁移提交 `5eb4c8b`，0.2.8 基础验证 `df3107e`，Rust→QuickJS 可选字段省略修复 `9e70d32`；QuickJS multipart 内存修复 `3f00ea9` 属宿主传输实现问题，改为原生二进制句柄且保持 64 MiB 沙箱上限，10 MiB 音频边界回归、重定向/资源清理测试、SDK Runtime 类型检查与构建通过 | 2026-09-01 |
-
-## SDK 仓内消费验证面
-
-这些目录是可独立安装、构建的真实示例，但与 SDK 同属 `Henji-AI` 仓库，不重复算外部仓库。
-它们的 manifest 均精确声明公共 npm `0.6.0`，仓内不维护锁文件；本次在仓外临时副本重新安装并验证，未使用 workspace 或本地源码替代正式包。
-
-| 路径 | 用途 / 入口 | 当前版本 | 宿主责任 | 验证命令 | 同步证据 | 最后核对 |
-|---|---|---|---|---|---|---|
-| `D:/VibeCode/Henji-AI/packages/ai-sdk/examples/minimal-node` | `generation` + `runtime` 按需入口；完整 generation catalog、KIE dry-run/live 闸门，不带 LLM/BigModel | `0.6.0`（精确 manifest，仓内无 lock） | Node transport、环境凭据、文件媒体读取、日志 | 在目录内 `npm install && npm run dry-run` | 公共 npm 匿名安装、类型构建与 dry-run 通过，模型网络调用为 0 | 2026-09-24 |
-| `D:/VibeCode/Henji-AI/packages/ai-sdk/examples/llm-chat` | `llm/streaming` 按需入口；OpenAI-compatible SSE 对话，不带 generation、BigModel preset/models/pricing、Groq 或 LLM modules（保留通用身份解析所需 profiles） | `0.6.0`（精确 manifest，仓内无 lock） | Node transport、环境凭据、流事件与取消 | 在目录内 `npm install && npm run dry-run && npm run check:bundle` | 公共 npm 匿名安装、类型构建、dry-run 和 bundle 边界检查通过 | 2026-09-24 |
-| `D:/VibeCode/Henji-AI/packages/ai-sdk/examples/form-renderer` | `generation` + `catalog` + `runtime` 按需入口；完整 generation catalog/参数契约与最小 renderer，不带 LLM/BigModel | `0.6.0`（精确 manifest，仓内无 lock） | 零网络 RuntimeContext；仅目录与 renderer | 在目录内 `npm install && npm run build && npm start` | 公共 npm 匿名安装、类型构建与五类代表模型表单输出通过 | 2026-09-24 |
-
-## 非消费者证据
-
-- `Henji-AI`、`henji-ai-ps`、`say-it` 的 README、任务文件和交接文档含历史版本或迁移描述；它们用于追溯，不形成额外消费者。
-- `/Users/henji/Documents/VibeCode` 下的 `ai-roundtable`、`fast-install`、`henji`、`henji-dev`、`henjicc.github.io`、`mySkills`、`test` 未发现 `@henjicc/ai-sdk` 的 manifest、lockfile、源码 import 或构建脚本引用。
-- SDK 自身的测试、fixture、导出检查和发布脚本属于生产者验证，不作为独立消费项目。
-
-## 发布后维护规则
-
-1. SDK 必须先在 `Henji-AI` 完成精确测试、全量/可移植性/包验证与远端回装，再发布。
-2. 发布后按变更影响逐个同步本清单中的实际消费者；外部消费者必须精确锁版本并核对 lock integrity，再回写 commit、验证状态、边界和日期。
-3. 只升级消费项目实际使用的按需入口。新增 provider/model 不等于所有宿主都要增加对应 bundle 或业务入口。
-4. 涉及 provider 身份、endpoint profile、credentialId、transport、media 或协议事件时，逐项检查表中宿主责任边界，禁止在消费方复制 SDK 执行内核。
-5. 消费项目升级完成后，将验证结果写入对应任务交接；本清单只维护稳定事实，不复制每次执行日志。
+# SDK 消费项目清单
+
+本清单是 `@henjicc/ai-sdk` 消费方的唯一维护入口，用于 SDK 发布后的跨仓升级协调。
+绝对路径仅描述当前开发机上的仓库位置，不进入 SDK 运行时代码、发布包或用户配置。
+
+最后核对日期：2026-09-24
+
+`0.6.2` 候选验证中，尚未发布：聊天/翻译流终态、百炼/火山实时 ASR、共享会话终止与脱敏诊断已完成修复及撤销修复后的失败验证。SDK 83 文件 / 1023 项测试、可移植性、构建、49 个公开入口、严格类型和受限宿主门禁通过，Henji-AI 8 项相关宿主测试与主进程类型检查通过。下一步验证固定候选包并等待对应发布提交的必需 CI；未执行本轮真实付费请求。Henji-AI workspace 和 llm-chat 示例准备使用 `0.6.2`，minimal-node/form-renderer 保持 `0.6.0`。说吧当前仍为 `0.6.1`，本次不修改外部仓库；Photoshop 未在本机验证，不能声称已升级。
+
+`0.6.1` 已发布：修复百炼 Fun Duplex 实时识别将无句首标记的空中间帧误判为 `invalid_response`；缺失 text、空 final 和无最终结果仍明确失败。发布源码提交 `6dd90b22` 的必需 CI [35917044506](https://github.com/henjicc/Henji-AI/actions/runs/35917044506) 全部成功；SDK 79 文件 / 933 项测试、可移植性、类型构建、49 个公开入口和受限宿主验证通过。两项事件序列回归撤销修复后失败、恢复后通过；合成语音最小真实请求成功。固定候选包发布后，隔离配置、缓存和令牌的仓外匿名回装及 Vite / 受限宿主验证通过。
+
+- `0.6.1` tarball：[公共 npm 包](https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.6.1.tgz)
+- `0.6.1` shasum：`48a48e4692dd30695393b0c7f7432b994ede5ef1`
+- `0.6.1` integrity：`sha512-0gY7crODwieU82r5XOgrmKVQIzLdJqFf8gAjsz8xv0wIpJe4aL8SeBM59qVVVSGpjckaVqzFe9NryhA/hjQw8Q==`
+
+外部 `say-it` 已在 `D:/VibeCode/说吧` 完成公共 npm `0.6.1` 精确升级，提交 `18bad6d`；manifest、lock、bundle 版本与完整性校验一致。QuickJS/WS 空中间帧回归、SDK 宿主 35 项本地测试、runtime 类型检查通过；另有听写 48 项、历史 12 项、历史 UI 6 项及前端类型检查/构建通过。开发桌面应用已重启，实际麦克风交互由用户验证。当前宿主已含流式/原生文件上传桥，不再受下方旧版迁移待办限制。三个仓内示例仅消费 generation/LLM，保持已验证的 `0.6.0`；Photoshop 未消费此次 ASR 修复，不机械升级。
+
+以下 `0.6.0` 及更早记录用于追溯历史发布。
+
+`0.6.0` 已发布：新增 MiMo 2.6、GLM-5.3-FlashX、KIE HappyHorse 1.1、火山 Seedream 5.0 Flash 和百炼 Qwen Audio 3.1 ASR；补齐 MiMo Responses 思考事件与 ASR JSON/说话人解析。SDK 79 个测试文件 / 933 项测试、类型构建、可移植性、49 个公开入口和受限宿主验证通过；痕迹 AI 目录、参数组合、模型发现与旧配置兼容验证通过。MiMo 思考事件、ASR JSON 回退、HappyHorse 图生字段的修复撤销验证均检测到失败，恢复后通过。未执行付费请求。发布提交 `d08ea8fa` 的必需 CI [35904531000](https://github.com/henjicc/Henji-AI/actions/runs/35904531000) 全部通过，npm 网页认证后发布固定候选包；公共索引可读后，隔离配置、缓存与令牌的仓外匿名安装、包校验、新模型请求探针、Vite 49 入口和受限宿主验证全部通过。
+
+本轮消费影响：Henji-AI 自动组合新增 generation pack，无需新增助手工具；三个仓内示例精确依赖同步到 `0.6.0`，均在仓外从公共 npm 匿名安装，minimal-node dry-run、llm-chat dry-run / bundle 边界和 form-renderer 构建 / 五类模型表单输出通过。外部 `say-it` 仍需先完成 `0.5.0` 文件上传桥迁移；当前未引入这批模型，不机械升级。`henji-ai-ps` 本机未定位，不声称已完成外部宿主升级。
+
+- `0.6.0` tarball：[公共 npm 包](https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.6.0.tgz)
+- `0.6.0` shasum：`2d02f956d6addc9fb92580cda323bc9d0904607e`
+- `0.6.0` integrity：`sha512-GzhWnVkdv2NNZjf0diI9dRBRkc/cH0O5nCjbiQrast54f+ik4Q4LbKjytrMhyMawxaSkCoHVeNQuEUwnCDkcnA==`
+
+Henji-AI 安装包的 GPT Image 2.5 高分辨率报错归属：宿主智能比例预处理曾忽略联动过滤，将 `smart` 转成 KIE 仅限 1K 的 `27:16`，SDK 在请求前正确拒绝。修复位于应用公共预处理，按当前分辨率/渠道的合法选项匹配；Flare/Sunburst 的 1K/2K/4K 及 APIMart、Grsai 同类筛选已有定向覆盖。无需放宽 SDK 契约或发布 SDK；安装包需随应用更新才包含修复，现有版本可手动选合法比例规避。
+
+当前仓内 SDK：`0.6.2` 候选；公共 npm 仍为 `0.6.1`（已发布并完成公共匿名回装）。以下为历史发布证据。
+
+`0.5.2` 完善轻量 `@henjicc/ai-sdk/llm/streaming`：正式类型支持文本、JSON Object 与 JSON Schema，Chat Completions 的最终请求体写入 `response_format`，OpenAI 输出上限写入 `max_completion_tokens`；结构化输出、思考模式和模型能力的非法组合会在请求前返回结构化错误。流式正文与思考继续分离，保留外部 `AbortSignal`，不设置默认总时限；未显式配置输出上限时不再注入 4096，服务端以 `length` 等原因结束时返回 `truncated: true`。发布前 77 个测试文件 / 909 项测试、可移植性、构建、49 个 Vite 公开入口和受限宿主门禁通过；故意撤销结构化参数、输出上限、OpenAI 字段映射和截断标记后，8 项定向断言失败，恢复后通过。公共索引可读后，已使用隔离 npm 配置和缓存匿名安装精确版本，并从已发布的轻量入口验证最终请求体包含 JSON Schema、思考强度和 24,000 token 上限，SSE 正文/思考事件分离且未截断。
+
+- `0.5.2` tarball：https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.5.2.tgz
+- `0.5.2` shasum：`f1c06ae12c9240b203f3ad310c4eec35b755db13`
+- `0.5.2` integrity：`sha512-ljb50njJ0bXWxwNmlgZ1+YDBoBgPiLhoNEDjsbhPbe4pc7aVZGcfvpDLh+zGdx9KsB7g7Xp3mqVM4MLpVQm15g==`
+
+`0.5.1` 将 Grsai GPT Image 2.5 未指定变体时的默认值从官方公告仍在维护的 Flare 改为 Standard，并同步默认价格；显式选择 Flare / Sunburst 的调用保持兼容。公共 DTO、请求协议、宿主边界和其余模型未变。发布前 77 个测试文件 / 899 项测试、可移植性、构建、49 个 Vite 公开入口和受限宿主门禁通过；公共索引可读后，已在隔离用户 npm 配置的仓外目录匿名安装并完成 ESM 导入。
+
+- `0.5.1` tarball：https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.5.1.tgz
+- `0.5.1` shasum：`40087e680f1b7de63a601d12758acb7280de305f`
+- `0.5.1` integrity：`sha512-+L/mAmFU6zgJ0gdsIwy0T1Z9TDOABaxO3HgLsEvMUNbRQhs9K55golF1472EgSJsIDysScnUulFJfBVg0xsNBg==`
+
+`0.5.0` 发布运行时代码提交 `1333422e`，补充边界回归提交 `da37e4bc`；后者必需 CI `35535140722` 全部成功。12组修复撤销验证均检测到失败，恢复后定向测试通过。固定候选包经仓外回装后发布，公共 registry 匿名安装的 shasum/integrity 与候选包一致；Vite公开入口和无TextEncoder/TextDecoder的受限宿主消费通过。npm网页登录与发布二次验证已完成；发布后等待公共索引可读才执行匿名验证，没有重复发布。
+
+- tarball：https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.5.0.tgz
+- shasum：`1b66a7c54f4f86a01b73fdca68b1c63e53dcbe10`
+- integrity：`sha512-MaPS87wDnvGdeAkGZOQHV+q/XPsQv9WZSPKYTYhqYrDhLbGUKS+m6h1sQ2oPM0GVXuZXKsos9BTJH61NSHjzag==`
+
+本轮按用户SDK范围交付可安装包及宿主调整依据；未升级或修改外部say-it/Photoshop仓库。say-it必须实现新流式/原生文件上传桥并完成Tauri集成验收后再升级；不能只改10 MiB常量。
+
+`0.5.0` 文件 ASR：四族九模型已核对。SDK 新增 describe/readChunk + fetchStream 的有界请求体消费，百炼异步 media-ref 必须通过 uploadFile 原生直传 OSS；旧宿主 read 兼容路径不得提升原内存阈值。structured media_too_large 保留实际字节、上限与可得时长。官方 Qwen 编码后10 MB对应原始7,500,000字节，Fun Flash 2,000,000,000字节/5分钟，Groq附件25,000,000，硅基流动50,000,000，百炼临时上传取min(1,000,000,000,凭证MB×1,000,000)。
+
+本次完成SDK精确回归、12组修复撤销反向验证、全量发布门禁与真实QuickJS 64 MiB堆探针（50 MB multipart、7.5/12 MB JSON）；未执行付费请求。say-it 当前 Host API 虽有分块，适配器仍拼回完整Uint8Array，请求体也仍缓冲，必须接入新契约后才可调整分块总文件上限；原生OSS单独受凭证限制。当前任务交付SDK及宿主调整依据，未改写该外部仓库或声称完成Tauri验收。Henji-AI/Photoshop现有生成媒体读取未迁移到新ASR接口，不机械增加未使用能力。
+
+2026-09-14 候选增量：安全网络失败在端点尝试耗尽后按 1/3/8 秒退避，每次失败重新判断重放安全性，取消立即结束退避。SDK 873 项测试、主进程定向测试与类型检查、可移植性及仓外 Vite／受限宿主消费通过；故意移除重试安全复核后，未知提交状态测试失败，恢复后通过。真实 Electron 主进程对本地服务及 KIE 无凭据只读查询，Node 与 Chromium 两栈均得到 HTTP 200；只证明当时连通，不代表付费生成成功，也未复现之前断连的外部原因。宿主增加关联原请求的脱敏 DNS／代理诊断，不更换网络栈。本机 npm 身份仍返回 401，本次候选变更尚未公共发布或同步外部消费者；下方旧候选包校验值仅对应此前版本内容。
+
+`0.4.2`：共享 transport 将 Node 明确的 TLS 建立前 ECONNRESET 识别为未发送，允许备用端点切换；GET/HEAD 的瞬态断连也允许切换，提交状态不明的写请求仍禁止重放。错误附带脱敏端点、阶段、耗时和提交状态，Henji-AI 生成与继续查询日志保留这些字段。SDK 870 项测试、宿主 7 项定向测试、可移植性、类型构建、仓外 Node ESM / 严格 TypeScript / Vite 49 入口与受限宿主回装通过；故意放行普通 ECONNRESET 重放会被 3 项写请求测试检测，恢复后全量通过。未执行真实付费请求。外部宿主使用不同 transport，需按其错误契约核对影响，不能将 Node 连接前分类视为所有宿主均已实测。
+
+修复提交 `5bf36dce` 已推送，CI `34758299265` 已启动。本机 npm 身份检查返回 `401 Unauthorized`，认证恢复且必需 CI 通过前不得发布；未声称完成公共回装或外部消费者升级。候选包 shasum 为 `dafaae4787798c3f22e5615fe8f5d60f4545c0a2`。宿主 Electron 类型检查与重启通过。上一提交 `45bb50b5` 的 CI 已存在两项画布能力引用相等断言失败，与本次网络修复无关，未夹带修改。
+
+`0.4.1`：修复 KIE GPT Image 2 / 2.5 的视频参考误标签，图片生成、编辑、多图输入及请求契约保持不变。109 个生成模型的跨模态视频标签检查、67 项定向测试、SDK 862 项全量测试、可移植性、类型构建及仓外公开入口/受限宿主回装通过。外部消费者登记版本为 `0.2.8`：say-it 不使用图片模型，不受影响；henji-ai-ps 的 KIE GPT Image 2 标签消费情况需在该项目可访问时核实，尚未升级。
+
+修复提交 `ef2be83f` 的必需 CI `34575686946` 已全部通过。正式包与固定候选包 shasum 一致：`32b8dd00f3e320822999b626b8e95a50b6a8ff2f`。发布后在仓外隔离 npm 配置并移除令牌环境变量，已从公共 npm 匿名安装精确版本；Node ESM、严格 TypeScript、49 个 Vite 入口及无 TextEncoder/TextDecoder 的受限宿主验证通过。仓内 workspace 与三个示例 manifest 已锁定 `0.4.1`；未执行真实付费生成或外部消费项目升级。
+
+- `0.4.1` tarball：`https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.4.1.tgz`
+- `0.4.1` integrity：`sha512-HtOoOlJWGR6m15wIvqI2VMJFk+ijHntXl2oZAqEA6Ri12gWqaa3JhPthisTj+epO7GwGcuGX4gW3a8qIDd4vAw==`
+
+`0.4.0`：新增硅基流动聊天预设与分类模型发现，提交 `a678dab6` 已推送，必需 CI `34565921443` 全部通过。SDK 861 项测试、宿主配置 15 项测试、类型构建、49 个公开入口及受限宿主候选包回装通过；未执行真实付费推理。移除服务端分类参数的断牙验证使 4 项测试失败，恢复后全量通过。
+
+账号网页二次验证已完成，正式包与候选包校验值一致。已在仓外隔离 npm 配置并移除令牌环境变量，从公共 npm 匿名安装精确版本：Node ESM、严格 TypeScript、Vite 49 个入口及无 TextEncoder/TextDecoder 的受限宿主验证通过，包含硅基流动动态模型发现。仓内 workspace 与三个示例 manifest 已锁定 `0.4.0`；现有外部消费者未新增硅基流动聊天使用，暂不升级。
+
+- tarball：`https://registry.npmjs.org/@henjicc/ai-sdk/-/ai-sdk-0.4.0.tgz`
+- shasum：`29a267d8a9f8375ac08b5af94569939473ab6a17`
+- integrity：`sha512-4D2gHakuo7Fhhh3a987qrObqJd78k8mIhXPL9dgE3A5uywBi4ebHj7U4XVLUcbjv/HO34wH/+8kFlE5JMOGD0g==`
+
+`0.3.0` 已发布：新增四家 GPT Image 2.5 pack、五家文本 embedding / 四家 rerank，DeepSeek 官方默认模型更新为 `deepseek-flash`。发布提交 `a2dc5bc4` 的必需 CI 门禁全部通过（运行 `34532267703`），SDK 全量 839 项测试和候选包回装通过。正式包已在隔离 npm 配置、无用户令牌的仓外环境从公共 npm 安装，标准 Vite 48 个入口与受限宿主验证通过；正式包校验值与候选包一致。未运行真实付费模型请求。
+
+Henji-AI workspace 与三个仓内示例 manifest 均锁定 `0.4.0`；下表原有示例运行记录仅代表 `0.2.8` 历史证据，本次未完成三个示例的独立全套回装复验。`say-it` 已在 `D:/VibeCode/说吧` 定位，仍锁定公共 npm `0.2.8`，实际按需使用 ASR、translation 与 LLM modules，未使用本次新增硅基流动聊天能力，无需机械升级；未运行其真实宿主验收。`henji-ai-ps` 的下表路径为另一台开发机记录，本机未定位该路径，不声称本次完成外部升级。
+
+## 判定口径
+
+- **消费者**：package manifest / lockfile 声明 SDK，或源码、构建入口实际导入 SDK。
+- **内部消费验证面**：位于 SDK 主仓库内，但有独立 manifest 和可运行构建的示例；它们不是外部仓库，仍需跟随发布版本验证。
+- **非消费者证据**：README、任务交接、迁移记录中的文字引用，以及没有进入实际构建的声明，不单独算消费者。
+- 扫描范围为 `/Users/henji/Documents/VibeCode` 下一级项目，排除了 `.git`、`node_modules`、`dist`、`target`、`build`、`coverage` 和缓存目录。
+
+## 独立宿主
+
+| 仓库 / 开发路径 | 宿主类型 | 当前精确版本 | SDK 入口与构建方式 | 凭据 / transport 责任 | 需同步的变更类型 | 验证命令 | 同步证据与边界 | 最后核对 |
+|---|---|---|---|---|---|---|---|---|
+| `Henji-AI`<br>`D:/VibeCode/Henji-AI` | Electron 42 主进程 + React/Vite；SDK 主开发、首发验证宿主 | workspace 源码 `0.6.2` 候选；公共 npm `0.6.1` | 包根、`provider-packs/*`、`tool-packs/*`；根构建先执行 `build:sdk`，再构建 Electron | Electron 主进程注入 HTTP transport、凭据、媒体读取、日志、trace、取消与落盘；渲染层不直接持有密钥 | 公共类型/目录、provider preset、凭据坐标、transport、媒体、包导出、LLM/生成执行协议 | SDK 发布门禁、相关宿主 Vitest、渲染层/主进程类型检查与模型 i18n | `6dd90b22`；必需 CI `35917044506` 成功，SDK 933 项测试、公开入口及受限宿主验证通过；公共包匿名回装通过，合成语音最小真实请求成功 | 2026-09-24 |
+| `henji-ai-ps`<br>`/Users/henji/Documents/VibeCode/henji-ai-ps` | Photoshop UXP 插件 + React/Vite IIFE（pnpm） | manifest/lock 均精确锁定公共 npm `0.2.8`；lock integrity 与上方正式产物一致 | `generation/core`、单模型/供应商 pack、LLM streaming；Vite 构建与 UXP smoke bundle | UXP 宿主注入受限 `fetch`、provider 凭据、媒体编码读取和脱敏日志；SDK 不读取 Node/文件系统 | 生成 pack/exports、受限环境可移植性、RuntimeContext、凭据 scope、媒体与流式 LLM；不因版本同步自动引入 GLM | `pnpm typecheck:uxp-smoke && pnpm check:uxp-sdk && pnpm smoke:uxp:build && pnpm check:uxp-smoke`；完整 `pnpm check` | `e509716`；无用户 npm 凭据的 frozen lock 安装通过；Node 22 下四项门禁通过，正式产品仍仅 39 个 generation/erase packs，网络调用与受限环境风险均为 0 | 2026-08-31 |
+| `say-it`<br>`D:/VibeCode/说吧` | Tauri 2 + Rust 管理 QuickJS；WebView 不运行 SDK | manifest/lock 精确锁定公共 npm `0.6.1`；bundle 版本、resolved、shasum、integrity 一致 | 按需打包 capability、Bailian/火山实时 ASR、SiliconFlow/Groq 文件 ASR、translation、LLM modules 为相互隔离 IIFE；Rust 加载 bundle | Rust Host API 注入 HTTP 字节流、WS、media-ref、CredentialStore、日志/trace、Abort/timeout/cancel；QuickJS/插件/WebView 不直取密钥 | capability/LLM 协议、按需 exports、descriptor source/坐标、QuickJS 可移植性、bundle 隔离；不因版本同步自动增加未采用模型 | `npm run sdk-runtime:typecheck && npm run sdk-runtime:build`；`npm run test:ui`；Rust 定向/全量测试；`npm run ui:build` | `18bad6d`；QuickJS/WS 空中间帧回归及 35 项 SDK 宿主本地测试通过，runtime 类型检查通过；听写/历史/UI 定向回归与前端类型构建通过，桌面开发应用已重启，实际麦克风交互待用户验证 | 2026-09-24 |
+
+## SDK 仓内消费验证面
+
+这些目录是可独立安装、构建的真实示例，但与 SDK 同属 `Henji-AI` 仓库，不重复算外部仓库。
+示例 manifest 使用精确版本，仓内不维护锁文件。llm-chat 准备升级到 `0.6.2`，其余两个示例保持 `0.6.0`；下表正式消费证据仍对应已发布版本，候选验证不冒充公共 npm 安装。
+
+| 路径 | 用途 / 入口 | 当前版本 | 宿主责任 | 验证命令 | 同步证据 | 最后核对 |
+|---|---|---|---|---|---|---|
+| `D:/VibeCode/Henji-AI/packages/ai-sdk/examples/minimal-node` | `generation` + `runtime` 按需入口；完整 generation catalog、KIE dry-run/live 闸门，不带 LLM/BigModel | `0.6.0`（精确 manifest，仓内无 lock） | Node transport、环境凭据、文件媒体读取、日志 | 在目录内 `npm install && npm run dry-run` | 公共 npm 匿名安装、类型构建与 dry-run 通过，模型网络调用为 0 | 2026-09-24 |
+| `D:/VibeCode/Henji-AI/packages/ai-sdk/examples/llm-chat` | `llm/streaming` 按需入口；OpenAI-compatible SSE 对话，不带 generation、BigModel preset/models/pricing、Groq 或 LLM modules（保留通用身份解析所需 profiles） | `0.6.2` 候选（上次公共验证为 `0.6.0`） | Node transport、环境凭据、流事件与取消 | 在目录内 `npm install && npm run dry-run && npm run check:bundle` | 公共 npm 匿名安装、类型构建、dry-run 和 bundle 边界检查通过 | 2026-09-24 |
+| `D:/VibeCode/Henji-AI/packages/ai-sdk/examples/form-renderer` | `generation` + `catalog` + `runtime` 按需入口；完整 generation catalog/参数契约与最小 renderer，不带 LLM/BigModel | `0.6.0`（精确 manifest，仓内无 lock） | 零网络 RuntimeContext；仅目录与 renderer | 在目录内 `npm install && npm run build && npm start` | 公共 npm 匿名安装、类型构建与五类代表模型表单输出通过 | 2026-09-24 |
+
+## 非消费者证据
+
+- `Henji-AI`、`henji-ai-ps`、`say-it` 的 README、任务文件和交接文档含历史版本或迁移描述；它们用于追溯，不形成额外消费者。
+- `/Users/henji/Documents/VibeCode` 下的 `ai-roundtable`、`fast-install`、`henji`、`henji-dev`、`henjicc.github.io`、`mySkills`、`test` 未发现 `@henjicc/ai-sdk` 的 manifest、lockfile、源码 import 或构建脚本引用。
+- SDK 自身的测试、fixture、导出检查和发布脚本属于生产者验证，不作为独立消费项目。
+
+## 发布后维护规则
+
+1. SDK 必须先在 `Henji-AI` 完成精确测试、全量/可移植性/包验证与远端回装，再发布。
+2. 发布后按变更影响逐个同步本清单中的实际消费者；外部消费者必须精确锁版本并核对 lock integrity，再回写 commit、验证状态、边界和日期。
+3. 只升级消费项目实际使用的按需入口。新增 provider/model 不等于所有宿主都要增加对应 bundle 或业务入口。
+4. 涉及 provider 身份、endpoint profile、credentialId、transport、media 或协议事件时，逐项检查表中宿主责任边界，禁止在消费方复制 SDK 执行内核。
+5. 消费项目升级完成后，将验证结果写入对应任务交接；本清单只维护稳定事实，不复制每次执行日志。