@mbws/plugin-sdk 0.3.0 → 0.3.1

package/dist/config.d.ts

@@ -94,6 +94,7 @@ declare const UserConfigSchema: z.ZodObject<{
         name: z.ZodString;
         entry: z.ZodOptional<z.ZodString>;
         devPath: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
     }, z.core.$strip>>>;
     devKey: z.ZodOptional<z.ZodString>;
     apiBaseUrl: z.ZodOptional<z.ZodString>;

package/dist/manifest.d.ts

@@ -48,14 +48,16 @@ export declare const AttachmentDeclSchema: z.ZodObject<{
 export type AttachmentDecl = z.output<typeof AttachmentDeclSchema>;
 /**
  * 开发者侧的附件引用（mbws.config.ts 可填形态）——platforms 由构建解析填充。
- * devPath 是 dev-only 的本机路径覆盖（线上还没有的新版本附件指到本机开发；
- * 未填/路径不存在时 dev 自动按 name+version 从官方附件库下载缓存），不进产物。
+ * devPath 是 dev-only 的本机路径覆盖（线上还没有的新版本附件指到本机开发），不进产物。
+ * url 是 dev 下载直链（暂由开发者提供官方地址；自建附件中心上线后改走 name+version
+ * 解析）：string = 全平台同地址，record = 按平台键（darwin-arm64 等），不进产物。
  */
 export declare const AttachmentRefSchema: z.ZodObject<{
     version: z.ZodString;
     name: z.ZodString;
     entry: z.ZodOptional<z.ZodString>;
     devPath: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
 }, z.core.$strip>;
 export type AttachmentRef = z.output<typeof AttachmentRefSchema>;
 export declare const ManifestSchema: z.ZodObject<{

package/dist/manifest.js

@@ -72,11 +72,13 @@ export const AttachmentDeclSchema = z.object({
 });
 /**
  * 开发者侧的附件引用（mbws.config.ts 可填形态）——platforms 由构建解析填充。
- * devPath 是 dev-only 的本机路径覆盖（线上还没有的新版本附件指到本机开发；
- * 未填/路径不存在时 dev 自动按 name+version 从官方附件库下载缓存），不进产物。
+ * devPath 是 dev-only 的本机路径覆盖（线上还没有的新版本附件指到本机开发），不进产物。
+ * url 是 dev 下载直链（暂由开发者提供官方地址；自建附件中心上线后改走 name+version
+ * 解析）：string = 全平台同地址，record = 按平台键（darwin-arm64 等），不进产物。
  */
 export const AttachmentRefSchema = AttachmentDeclSchema.omit({ platforms: true }).extend({
     devPath: z.string().optional(),
+    url: z.union([z.string(), z.record(z.string(), z.string())]).optional(),
 });
 /**
  * 权限声明，两种语法（CSP connect-src 与权限预览文案的推导输入，设计稿 §6.5）：

package/dist/version.d.ts

@@ -12,4 +12,4 @@ export declare const PROTOCOL_VERSION: 1;
  * SDK 自身版本（与 package.json version 保持一致）。
  * init-ack 上报给宿主做审计，与 manifest.sdk（build 写入）交叉核对。
  */
-export declare const SDK_VERSION = "0.3.0";
+export declare const SDK_VERSION = "0.3.1";

package/dist/version.js

@@ -12,4 +12,4 @@ export const PROTOCOL_VERSION = 1;
  * SDK 自身版本（与 package.json version 保持一致）。
  * init-ack 上报给宿主做审计，与 manifest.sdk（build 写入）交叉核对。
  */
-export const SDK_VERSION = "0.3.0";
+export const SDK_VERSION = "0.3.1";

package/dist/vite.js

@@ -18,6 +18,8 @@ import { spawn, spawnSync } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
+import { pipeline } from "node:stream/promises";
+import zlib from "node:zlib";
 import { buildManifest, resolveAttachmentRefs } from "./config.js";
 import { generateContractTypes } from "./schema-types.js";
 // 契约类型生成经本子路径暴露（Node 端工具链用；依赖 prettier，不进根入口）
@@ -245,10 +247,41 @@ const inflightDevAttachments = new Map();
  */
 const devAttachmentResolves = new Map();
 /**
- * 确保官方附件库附件在本地就绪：按 config.attachments 声明查 resolve 端点，
- * 内容寻址缓存 `.mbws/attachments/<name>@<version>/<sha256>/<entry>`——命中零下载；
- * 未命中流式下载（sha256 校验）+ `tar -xf` 解包（bsdtar 通吃 tar.gz/zip）+ chmod 755。
- * 附件未声明 / 库未登记返回 null（调用方回 501）；下载/校验/解包失败抛错。
+ * 流式下载到文件：边下边算 sha256（不整包进内存），每 5MB 报一次进度行。
+ * sizeHint 已知（库 resolve 下发）报「x / y MB」，直链未知报「x MB」。返回 sha256。
+ */
+async function downloadToFile(url, dest, log, sizeHint) {
+    const response = await fetch(url);
+    if (!response.ok || !response.body)
+        throw new Error(`下载 HTTP ${response.status}`);
+    const hash = crypto.createHash("sha256");
+    const out = fs.createWriteStream(dest);
+    let received = 0;
+    let lastReported = 0;
+    // Node fetch 的 body 是 async iterable
+    for await (const chunk of response.body) {
+        const bytes = Buffer.from(chunk);
+        hash.update(bytes);
+        out.write(bytes);
+        received += bytes.byteLength;
+        if (received - lastReported >= 5 * 1e6) {
+            lastReported = received;
+            log(sizeHint != null
+                ? `[mbws:dev] 下载中 ${Math.round(received / 1e6)} / ${Math.round(sizeHint / 1e6)} MB`
+                : `[mbws:dev] 下载中 ${Math.round(received / 1e6)} MB`);
+        }
+    }
+    await new Promise((resolve, reject) => out.end((error) => (error ? reject(error) : resolve())));
+    return hash.digest("hex");
+}
+/**
+ * 确保附件在本地就绪（两条来源，优先级：url 直链 > 官方附件库 resolve）：
+ * - url 直链（暂由开发者提供官方地址）：无 sha256，缓存目录不带 hash 层
+ *   （`.mbws/attachments/<name>@<version>/`，同 version 重传视为修正）；
+ *   按后缀分派 tar.gz/zip 解包、.gz 单文件解压、其余当裸二进制。
+ * - 官方附件库：resolve 端点拿 url/sha256/size，内容寻址缓存
+ *   `.mbws/attachments/<name>@<version>/<sha256>/`，下载后 sha256 校验 + tar -xf。
+ * 附件未声明 / 无 url 且库未登记返回 null（调用方回 501）；下载/校验/解包失败抛错。
  * log 收下载进度行（调用方转 NDJSON 事件流）。
  */
 async function ensureLibraryAttachment(config, root, name, log) {
@@ -261,6 +294,44 @@ async function ensureLibraryAttachment(config, root, name, log) {
         if (!ref)
             return null;
         const platform = currentAttachmentPlatform();
+        // win 平台包内入口带 .exe 后缀（publish 脚本布局），显式 entry 原样用
+        const entry = ref.entry ?? `${name}${platform.startsWith("win") ? ".exe" : ""}`;
+        // —— url 直链分支（开发者提供的官方地址）——
+        const directUrl = typeof ref.url === "string" ? ref.url : ref.url?.[platform];
+        if (directUrl) {
+            const dir = path.join(root, DEV_ATTACHMENT_CACHE, `${name}@${ref.version}`);
+            const entryPath = path.join(dir, entry);
+            if (fs.existsSync(entryPath))
+                return entryPath;
+            log(`[mbws:dev] 下载附件 ${name}@${ref.version}（${platform} 直链，无 hash 校验）`);
+            fs.mkdirSync(dir, { recursive: true });
+            const tmpPath = path.join(dir, "download.tmp");
+            try {
+                await downloadToFile(directUrl, tmpPath, log);
+                const lower = directUrl.toLowerCase();
+                if (/\.(tar\.gz|tgz|zip)$/.test(lower)) {
+                    const extracted = spawnSync("tar", ["-xf", tmpPath, "-C", dir]);
+                    if (extracted.status !== 0) {
+                        throw new Error(`解包失败：${extracted.stderr?.toString().trim() || `tar exit ${extracted.status}`}`);
+                    }
+                }
+                else if (/\.gz$/.test(lower)) {
+                    await pipeline(fs.createReadStream(tmpPath), zlib.createGunzip(), fs.createWriteStream(entryPath));
+                }
+                else {
+                    fs.copyFileSync(tmpPath, entryPath);
+                }
+                if (!fs.existsSync(entryPath))
+                    throw new Error(`解包后未见入口 ${entry}`);
+                fs.chmodSync(entryPath, 0o755);
+                log(`[mbws:dev] 附件 ${name}@${ref.version} 就绪（已缓存，后续零下载）`);
+                return entryPath;
+            }
+            finally {
+                fs.rmSync(tmpPath, { force: true });
+            }
+        }
+        // —— 官方附件库分支 ——
         const resolveKey = `${name}@${ref.version}`;
         let resolved = devAttachmentResolves.get(resolveKey);
         if (!resolved) {
@@ -278,8 +349,6 @@ async function ensureLibraryAttachment(config, root, name, log) {
                 return null;
             }
         }
-        // win 平台包内入口带 .exe 后缀（publish 脚本布局），显式 entry 原样用
-        const entry = ref.entry ?? `${name}${platform.startsWith("win") ? ".exe" : ""}`;
         const dir = path.join(root, DEV_ATTACHMENT_CACHE, `${name}@${ref.version}`, resolved.sha256);
         const entryPath = path.join(dir, entry);
         if (fs.existsSync(entryPath))
@@ -288,26 +357,7 @@ async function ensureLibraryAttachment(config, root, name, log) {
         fs.mkdirSync(dir, { recursive: true });
         const tmpPath = path.join(dir, `download.${resolved.archive}`);
         try {
-            const response = await fetch(resolved.url);
-            if (!response.ok || !response.body)
-                throw new Error(`下载 HTTP ${response.status}`);
-            const hash = crypto.createHash("sha256");
-            const out = fs.createWriteStream(tmpPath);
-            let received = 0;
-            let lastReported = 0;
-            // Node fetch 的 body 是 async iterable：流式落盘 + 边下边算 hash（不整包进内存）
-            for await (const chunk of response.body) {
-                const bytes = Buffer.from(chunk);
-                hash.update(bytes);
-                out.write(bytes);
-                received += bytes.byteLength;
-                if (received - lastReported >= 5 * 1e6) {
-                    lastReported = received;
-                    log(`[mbws:dev] 下载中 ${Math.round(received / 1e6)} / ${Math.round(resolved.size / 1e6)} MB`);
-                }
-            }
-            await new Promise((resolve, reject) => out.end((error) => (error ? reject(error) : resolve())));
-            const sha256 = hash.digest("hex");
+            const sha256 = await downloadToFile(resolved.url, tmpPath, log, resolved.size);
             if (sha256 !== resolved.sha256) {
                 throw new Error(`sha256 不符（期望 ${resolved.sha256}，实得 ${sha256}）`);
             }
@@ -375,7 +425,7 @@ async function handleDevExec(config, root, req, res) {
             res.statusCode = 501;
             res.end(JSON.stringify({
                 message: declared
-                    ? `附件 ${attachment} 未在官方附件库登记当前平台产物（发布见 scripts/publish-attachment.mjs），或后端不可达；本机覆盖可配 attachments 的 devPath / env MBWS_DEV_ATTACHMENT_${attachment.replace(/-/g, "_").toUpperCase()}`
+                    ? `附件 ${attachment} 无 url 直链且未在官方附件库登记当前平台产物（或后端不可达）；可配 attachments 的 url 直链 / devPath / env MBWS_DEV_ATTACHMENT_${attachment.replace(/-/g, "_").toUpperCase()}`
                     : `mbws.config.ts 的 attachments 未声明附件 ${attachment}（dev 自动下载依赖声明）；本机覆盖可配该项 devPath / env MBWS_DEV_ATTACHMENT_${attachment.replace(/-/g, "_").toUpperCase()}`,
             }));
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mbws/plugin-sdk",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Moye 插件开发 SDK——panel/viewer 与宿主的类型定义与运行时端口适配",
   "license": "MIT",
   "type": "module",