@linkdesk/plugin-sdk 0.1.31 → 0.1.33

package/dist/pack.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.test.d.ts","sourceRoot":"","sources":["../src/pack.test.ts"],"names":[],"mappings":""}

package/dist/pack.test.js

@@ -0,0 +1,58 @@
+/**
+ * `pack` 通道的**排除表**单测（2026-09-15 补）。
+ *
+ * 为什么值得一条测试：这张表的错法是**静默**的——多排一个真内容 = 装上少文件（用户那边才现形）；
+ * 少排一个仓面文件 = 出厂件与仓内重建不一致（内容指纹漂移，而两道门禁都看不见）。
+ * 两种错都不会让任何东西变红，所以只能靠这里的**正反两向**钉住。
+ */
+import { describe, expect, it } from "vitest";
+import { isPackableRelPath } from "./pack.js";
+describe("isPackableRelPath —— 进包的（正例）", () => {
+    it("插件本体：清单 / 数据文件 / 资源 / 源码 / 词典", () => {
+        for (const rel of [
+            "plugin.json",
+            "themes/my-glass.json",
+            "icons/pastel.json",
+            "resources/cover.svg",
+            "src/index.tsx",
+            "i18n/en.json",
+            "en.json",
+            "CHANGELOG.md",
+            "scripts/author-tool.mjs",
+        ]) {
+            expect(isPackableRelPath(rel), rel).toBe(true);
+        }
+    });
+    it("🔴 LICENSE 必须随包（MIT 要求副本里带声明；zip 才是用户拿到的那份）", () => {
+        for (const rel of ["LICENSE", "LICENSE.md", "LICENSE.txt"]) {
+            expect(isPackableRelPath(rel), rel).toBe(true);
+        }
+    });
+    it("同名但不同路径的工具文件不误伤（只精确排 scripts/ci-verify.mjs 这一条）", () => {
+        expect(isPackableRelPath("vendor/ci-verify.mjs")).toBe(true);
+    });
+});
+describe("isPackableRelPath —— 不进包的（负控）", () => {
+    it("构建产物 / npm 元数据 / 隐藏项", () => {
+        for (const rel of [
+            "node_modules/foo/index.js",
+            "dist/plugin.json",
+            "demo.linkdesk-plugin",
+            "pkg.tgz",
+            "package.json",
+            "package-lock.json",
+            ".gitignore",
+            ".github/workflows/ci.yml",
+            ".vscode/settings.json",
+            "sub/.npmrc",
+        ]) {
+            expect(isPackableRelPath(rel), rel).toBe(false);
+        }
+    });
+    it("🔴 仓库面工具文件：AGENTS.md / marketplace.json / scripts/ci-verify.mjs", () => {
+        for (const rel of ["AGENTS.md", "marketplace.json", "scripts/ci-verify.mjs"]) {
+            expect(isPackableRelPath(rel), rel).toBe(false);
+        }
+    });
+});
+//# sourceMappingURL=pack.test.js.map

package/dist/pack.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.test.js","sourceRoot":"","sources":["../src/pack.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,KAAK,MAAM,GAAG,IAAI;YAChB,aAAa;YACb,sBAAsB;YACtB,mBAAmB;YACnB,qBAAqB;YACrB,eAAe;YACf,cAAc;YACd,SAAS;YACT,cAAc;YACd,yBAAyB;SAC1B,EAAE,CAAC;YACF,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,KAAK,MAAM,GAAG,IAAI;YAChB,2BAA2B;YAC3B,kBAAkB;YAClB,sBAAsB;YACtB,SAAS;YACT,cAAc;YACd,mBAAmB;YACnB,YAAY;YACZ,0BAA0B;YAC1B,uBAAuB;YACvB,YAAY;SACb,EAAE,CAAC;YACF,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,kBAAkB,EAAE,uBAAuB,CAAC,EAAE,CAAC;YAC7E,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/publish.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=publish.test.d.ts.map

package/dist/publish.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.test.d.ts","sourceRoot":"","sources":["../src/publish.test.ts"],"names":[],"mappings":""}

package/dist/publish.test.js

@@ -0,0 +1,340 @@
+/**
+ * publish 纯函数测试（E6#91e，L3.7 第 3.7.2 轮）——**CHANGELOG 切段的 B1–B10 十条边界**。
+ *
+ * 为什么值得单列一个文件：这段切段逻辑是「未装插件『更改日志』页签」的**唯一写入方**，切错了
+ * 是**发错信息**（把上一版的说明挂到新版本上）——比不显示更坏。故每条边界都钉一个用例。
+ *
+ * **对照基线**：文件下半 `describe("旧行为对照")` 里的 `naiveSlice` 是**朴素第一版写法**（测试专用，
+ * 非生产代码）。它存在的唯一理由是满足 memory `snapshot-shadows-truth-bug-class` 的硬要求——
+ * **回归测试必须证明「在旧行为上会红」**。光断言「新实现对」证明不了边界有被守住；断言「朴素写法在这条
+ * 用例上给出错误结果」才是。哪些用例两种写法一致、哪些分道扬镳，逐条写明。
+ */
+import { describe, it, expect } from "vitest";
+import { buildCatalogEntry, createEmptyCatalog, judgePublishReadiness, parsePorcelainStatus, readmeRawUrl, sliceChangelogSection, upsertCatalogEntry, withCatalogIdentity, } from "./publish.js";
+/* ── 样本 ─────────────────────────────────────────────────────────────── */
+const SAMPLE = [
+    "# 更新日志",
+    "",
+    "## v1.2.0（2026-09-11）",
+    "- 修了某某问题",
+    "- 加了某个能力",
+    "",
+    "## v1.1.0（2026-08-01）",
+    "- 旧的一条",
+    "",
+    "## v1.0.0（2026-07-01）",
+    "- 最早的一条",
+    "",
+].join("\n");
+const view = (version) => ({ id: "demo-plugin", name: "Demo", version });
+/* ── B1–B10 十条边界 ─────────────────────────────────────────────────── */
+describe("sliceChangelogSection——B1–B10 边界", () => {
+    it("正常路径：切出目标版本正文，到下一个段标题为止", () => {
+        expect(sliceChangelogSection(SAMPLE, "1.2.0")).toBe("- 修了某某问题\n- 加了某个能力");
+        expect(sliceChangelogSection(SAMPLE, "1.0.0")).toBe("- 最早的一条");
+    });
+    it("B1 字段缺省：无 changelog 时不写该键（不是填空串）", () => {
+        // 「文件不存在」是 IO 层的事（collectPreview），纯函数层可断言的是**缺省即不写键**这条契约：
+        // 渲染层对「字段缺省」与「空串」走同一兜底，但缺省更诚实。
+        const entry = buildCatalogEntry(view("1.2.0"), "https://example.invalid/a.zip", 1, "owner", "2026-09-11T00:00:00Z", {});
+        expect("changelog" in entry.versions[0]).toBe(false);
+        expect("readmeUrl" in entry).toBe(false);
+        // 有值时两个键都在，且 changelog 落在 versions[0] 上（历史由 upsertCatalogEntry 拼）
+        const filled = buildCatalogEntry(view("1.2.0"), "https://example.invalid/a.zip", 1, "owner", "2026-09-11T00:00:00Z", {
+            readmeUrl: "https://example.invalid/README.md",
+            changelog: "- 一条",
+        });
+        expect(filled.readmeUrl).toBe("https://example.invalid/README.md");
+        expect(filled.versions[0].changelog).toBe("- 一条");
+    });
+    it("🔴 E6#109p-b（1.28）minAppVersion 随条目走——市场「拒装」腿的输入（此前生产端从不写它）", () => {
+        // 1.27 体检抓到：市场侧读 catalog entry 的 minAppVersion 并据此拒装，而 buildCatalogEntry **不写**该键
+        // ⇒ 官方 18 仓条目 0/18 有它 ⇒ 那条腿永远不触发（空转）。本条钉住「manifest → 条目」这一段。
+        const withMin = { id: "demo-plugin", name: "Demo", version: "1.0.0", minAppVersion: "0.2.0" };
+        const entry = buildCatalogEntry(withMin, "https://example.invalid/a.zip", 1, "owner", "2026-09-11T00:00:00Z", {});
+        expect(entry.minAppVersion).toBe("0.2.0");
+        // 缺省 ⇒ 不写该键（沿用「缺省即不写键」纪律；市场侧对 undefined 放行，两处同语义）
+        expect("minAppVersion" in buildCatalogEntry(view("1.2.0"), "https://example.invalid/a.zip", 1, "owner", "x", {})).toBe(false);
+    });
+    it("B2 版本切不到 → undefined（绝不回落到「取第一段」）", () => {
+        // 回落 = 把上一版的说明挂到新版本上，是发错信息——同 marketCatalog/select.ts「不发错包」的纪律
+        expect(sliceChangelogSection(SAMPLE, "9.9.9")).toBeUndefined();
+    });
+    it("B2b 版本号严格相等：1.0 不吃 1.0.0（不做 semver 松弛匹配）", () => {
+        expect(sliceChangelogSection(SAMPLE, "1.0")).toBeUndefined();
+        expect(sliceChangelogSection(SAMPLE, "1.2")).toBeUndefined();
+    });
+    it("B3 段标题下直接跟下一个标题（空正文）→ undefined", () => {
+        const text = "## v1.0.0\n\n## v0.9.0\n- 旧\n";
+        expect(sliceChangelogSection(text, "1.0.0")).toBeUndefined();
+    });
+    it("B4 围栏代码块内的假标题必须跳过（贴示例日志是常态）", () => {
+        const text = [
+            "# 更新日志",
+            "",
+            "## v1.2.0（2026-09-11）",
+            "示例（别当真）：",
+            "",
+            "```markdown",
+            "## v1.1.0",
+            "- 这是代码块里的假段标题",
+            "```",
+            "",
+            "真·收尾一行",
+            "",
+            "## v1.1.0（2026-08-01）",
+            "- 真的旧版说明",
+            "",
+        ].join("\n");
+        // 真段标题之后的正文 = 示例块 + 收尾行，**一直到下一个真段标题**——假标题不得截断它
+        const got = sliceChangelogSection(text, "1.2.0");
+        expect(got).toContain("真·收尾一行");
+        expect(got).toContain("- 这是代码块里的假段标题");
+        expect(got).not.toContain("- 真的旧版说明");
+        // 而 v1.1.0 仍能正确切出真段
+        expect(sliceChangelogSection(text, "1.1.0")).toBe("- 真的旧版说明");
+    });
+    it("B5 CRLF 正文不带 \\r（正文内部也不带，不只是两端）", () => {
+        const text = "# 更新日志\r\n\r\n## v1.0.0\r\n- 第一行\r\n- 第二行\r\n\r\n## v0.9.0\r\n- 旧\r\n";
+        const got = sliceChangelogSection(text, "1.0.0");
+        expect(got).toBe("- 第一行\n- 第二行");
+        expect(got).not.toContain("\r");
+    });
+    it("B6 BOM 剥离——首行就是段标题时也能切到", () => {
+        const text = "## v1.0.0\n- 有 BOM 的一段\n";
+        expect(sliceChangelogSection(text, "1.0.0")).toBe("- 有 BOM 的一段");
+    });
+    it("B7 prerelease 后缀整段捕获——不与同文件里的正式版段撞号", () => {
+        const text = ["## v1.0.0", "- 正式版", "", "## v1.0.0-beta.1", "- 预发布版", ""].join("\n");
+        expect(sliceChangelogSection(text, "1.0.0-beta.1")).toBe("- 预发布版");
+        expect(sliceChangelogSection(text, "1.0.0")).toBe("- 正式版");
+    });
+    it("B8 一级标题 `# 更新日志` 不当段标题（那是文档标题，不是版本号）", () => {
+        const text = "# v1.0.0\n- 这不是版本段\n";
+        expect(sliceChangelogSection(text, "1.0.0")).toBeUndefined();
+    });
+    it("B9 标题后无括号日期也正常通过（日期本就可选）", () => {
+        expect(sliceChangelogSection("## v1.0.0 后续补记\n- 一条\n", "1.0.0")).toBe("- 一条");
+    });
+    it("B10 Keep a Changelog 风格 `## [1.0.0] - 日期` 也认（解析器适配作者，不是反过来）", () => {
+        const text = ["# Changelog", "", "## [1.2.0] - 2026-09-11", "- 新版", "", "## [1.1.0] - 2026-08-01", "- 旧版", ""].join("\n");
+        expect(sliceChangelogSection(text, "1.2.0")).toBe("- 新版");
+        expect(sliceChangelogSection(text, "1.1.0")).toBe("- 旧版");
+    });
+    it("B10b 两种主流写法混排互不干扰", () => {
+        const text = ["## [1.2.0] - 2026-09-11", "- 方括号风", "", "## v1.1.0（2026-08-01）", "- 全角括号风", "", "## 1.0.0", "- 裸版本号", ""].join("\n");
+        expect(sliceChangelogSection(text, "1.2.0")).toBe("- 方括号风");
+        expect(sliceChangelogSection(text, "1.1.0")).toBe("- 全角括号风");
+        expect(sliceChangelogSection(text, "1.0.0")).toBe("- 裸版本号");
+    });
+    it("B11 同版本出现多次 → 取第一个（「最新在最上」是格式约定）", () => {
+        const text = ["## v1.0.0", "- 第一次出现（最新）", "", "## v1.0.0", "- 第二次出现（旧）", ""].join("\n");
+        expect(sliceChangelogSection(text, "1.0.0")).toBe("- 第一次出现（最新）");
+    });
+    it("两侧前导 v 等价：段标题带 v、传参不带（或反之）都认", () => {
+        expect(sliceChangelogSection("## v1.0.0\n- 一条\n", "v1.0.0")).toBe("- 一条");
+        expect(sliceChangelogSection("## 1.0.0\n- 一条\n", "1.0.0")).toBe("- 一条");
+    });
+    it("`###` / `####` 容忍，`#####` 不算段标题", () => {
+        expect(sliceChangelogSection("### v1.0.0\n- 三级\n", "1.0.0")).toBe("- 三级");
+        expect(sliceChangelogSection("#### v1.0.0\n- 四级\n", "1.0.0")).toBe("- 四级");
+        expect(sliceChangelogSection("##### v1.0.0\n- 五级不该认\n", "1.0.0")).toBeUndefined();
+    });
+});
+/* ── readmeUrl 形态 ──────────────────────────────────────────────────── */
+describe("readmeRawUrl", () => {
+    it("固定形态 = raw.githubusercontent.com/{owner}/{repo}/{tag}/README.md", () => {
+        expect(readmeRawUrl({ owner: "demo-owner", repo: "demo-repo" }, "v1.2.0")).toBe("https://raw.githubusercontent.com/demo-owner/demo-repo/v1.2.0/README.md");
+    });
+    it("用 tag 不用 default_branch——未装看到的与装上后看到的同源", () => {
+        expect(readmeRawUrl({ owner: "o", repo: "r" }, "v1.0.0")).not.toContain("/main/");
+    });
+});
+/* ── 旧行为对照（证明上面这些边界在朴素写法上会红）──────────────────── */
+/**
+ * 朴素第一版写法——**测试专用，非生产代码**。特征：按 `##` 行找段标题、正则**只捕三段版本号**、
+ * 不剥 BOM、不跳围栏、`split("\n")` 不兼容 CRLF。这是真正会有人写出来的第一版，不是稻草人。
+ */
+function naiveSlice(text, version) {
+    const lines = text.split("\n");
+    // 🔴 关键缺陷就在这条正则：只捕 `\d+.\d+.\d+` 三段——预发布号与方括号风格都漏
+    const heading = /^##\s+v?(\d+\.\d+\.\d+)/;
+    const target = version.replace(/^v/, "");
+    let start = -1;
+    let end = lines.length;
+    for (let i = 0; i < lines.length; i++) {
+        const m = heading.exec(lines[i] ?? "");
+        if (!m)
+            continue;
+        if (start < 0) {
+            if (m[1] === target)
+                start = i + 1;
+        }
+        else {
+            end = i;
+            break;
+        }
+    }
+    if (start < 0)
+        return undefined;
+    return lines.slice(start, end).join("\n").trim() || undefined;
+}
+describe("旧行为对照——朴素写法在这几条上会红", () => {
+    it("B4 围栏：朴素写法把代码块里的假标题当真段标题，正文被提前截断", () => {
+        const text = ["## v1.2.0", "正文甲", "```", "## v1.1.0", "```", "正文乙", "", "## v1.1.0", "- 真旧版", ""].join("\n");
+        expect(sliceChangelogSection(text, "1.2.0")).toBe("正文甲\n```\n## v1.1.0\n```\n正文乙");
+        // 朴素：在块内的假标题处就 break → 正文腰斩（实测值 = 正文甲 + 围栏起止行；「正文乙」整段丢失）
+        expect(naiveSlice(text, "1.2.0")).toBe("正文甲\n```");
+    });
+    it("B5 CRLF：朴素写法在正文内部留下 \\r", () => {
+        const text = "## v1.0.0\r\n- 第一行\r\n- 第二行\r\n";
+        expect(sliceChangelogSection(text, "1.0.0")).toBe("- 第一行\n- 第二行");
+        expect(naiveSlice(text, "1.0.0")).toContain("\r");
+    });
+    it("B6 BOM：朴素写法匹配不到首行段标题 → 整段丢失", () => {
+        const text = "## v1.0.0\n- 有 BOM 的一段\n";
+        expect(sliceChangelogSection(text, "1.0.0")).toBe("- 有 BOM 的一段");
+        expect(naiveSlice(text, "1.0.0")).toBeUndefined();
+    });
+    it("B7 预发布：朴素写法只捕三段 → 预发布版整段切不到（两条段撞成同一个版本号）", () => {
+        const text = ["## v1.0.0", "- 正式版", "", "## v1.0.0-beta.1", "- 预发布版", ""].join("\n");
+        expect(sliceChangelogSection(text, "1.0.0-beta.1")).toBe("- 预发布版");
+        // 朴素：两段都被捕成 "1.0.0"，预发布版这一版**永远切不到**（真机症状 = 该版显示「此版本未提供变更说明」）
+        expect(naiveSlice(text, "1.0.0-beta.1")).toBeUndefined();
+    });
+    it("B10 Keep a Changelog：朴素写法认不得方括号 → 整段丢失", () => {
+        const text = "## [1.0.0] - 2026-09-11\n- 方括号风\n";
+        expect(sliceChangelogSection(text, "1.0.0")).toBe("- 方括号风");
+        expect(naiveSlice(text, "1.0.0")).toBeUndefined();
+    });
+    it("诚实记账：这几条朴素写法与生产写法**一致**（不假装它们也是边界）", () => {
+        // B1/B3/B8/B9 以及「切不到→undefined」在朴素写法上本来就对——写出来免得读者以为十条都靠新写法救
+        expect(naiveSlice(SAMPLE, "9.9.9")).toBeUndefined(); // B2：两边都 undefined
+        expect(naiveSlice(SAMPLE, "1.0.0")).toBe("- 最早的一条"); // 常规路径：两边都对
+        expect(naiveSlice("## v1.0.0\n\n## v0.9.0\n- 旧\n", "1.0.0")).toBeUndefined(); // B3：两边都 undefined
+    });
+});
+/* ── E6#106（身份图上架链路）：目录条目的图标字段必须是「未装态可解析」形态 ──────────────
+ * 这一组的另一半在插件仓 marketplace 侧（CatalogRow 已装优先 + img onError 兜底）——
+ * 但**「选哪张图」这件事只有 plugin.json 知道**，所以本组是根因那一侧的钉子。 */
+describe("E6#106 withCatalogIdentity——图标字段转未装态可解析形态", () => {
+    const remote = { owner: "Encaron", repo: "linkdesk-plugin-demo" };
+    const tag = "v1.0.0";
+    it("包内相对路径 → 远端 raw 直链 + iconSource:\"url\"（两条字段都转）", () => {
+        const out = withCatalogIdentity({ id: "demo", name: "Demo", version: "1.0.0", icon: "resources/icon-bar.svg", marketIcon: "resources/icon.svg" }, remote, tag);
+        expect(out.icon).toBe("https://raw.githubusercontent.com/Encaron/linkdesk-plugin-demo/v1.0.0/resources/icon-bar.svg");
+        expect(out.marketIcon).toBe("https://raw.githubusercontent.com/Encaron/linkdesk-plugin-demo/v1.0.0/resources/icon.svg");
+        // 🔴 source 必须显式 "url"：消费端 resolvePluginIcon 对「无 source 的绝对 URL」会当包内路径拼 linkdesk://
+        expect(out.iconSource).toBe("url");
+        expect(out.marketIconSource).toBe("url");
+    });
+    it("本仓真正要修的那一格：图标栏插件（icon = Type-1 剪影 + marketIcon = Type-2 身份图）两条都进条目", () => {
+        const entry = buildCatalogEntry(withCatalogIdentity({ id: "serial", name: "串口", version: "1.0.9", icon: "resources/icon-bar.svg", marketIcon: "resources/icon.svg" }, remote, tag), "https://example.invalid/a.zip", 1, remote.owner, "2026-09-14T00:00:00Z", {});
+        expect(entry.marketIcon).toContain("/v1.0.0/resources/icon.svg");
+        expect(entry.marketIconSource).toBe("url");
+    });
+    it("作者自填 http(s) 绝对 URL → 原样留 + 补 iconSource:\"url\"", () => {
+        const out = withCatalogIdentity({ id: "demo", name: "Demo", version: "1.0.0", icon: "https://cdn.example.invalid/i.svg" }, remote, tag);
+        expect(out.icon).toBe("https://cdn.example.invalid/i.svg");
+        expect(out.iconSource).toBe("url");
+    });
+    it("lucide / codicon 图标名 → 原样留（不当路径拼 URL）；来源照声明，声明缺省照缺省", () => {
+        const withSource = withCatalogIdentity({ id: "demo", name: "Demo", version: "1.0.0", icon: "Smile", iconSource: "lucide" }, remote, tag);
+        expect(withSource.icon).toBe("Smile");
+        expect(withSource.iconSource).toBe("lucide");
+        const noSource = withCatalogIdentity({ id: "demo", name: "Demo", version: "1.0.0", icon: "terminal" }, remote, tag);
+        expect(noSource.icon).toBe("terminal"); // 消费端按值推断 codicon——两处判据同源，SDK 不替它决定
+        expect(noSource.iconSource).toBeUndefined();
+    });
+    it("无声明 → 不写键（零图可发：市场落统一默认彩色块，不塞空串）", () => {
+        const out = withCatalogIdentity({ id: "demo", name: "Demo", version: "1.0.0" }, remote, tag);
+        expect("icon" in out).toBe(false);
+        expect("marketIcon" in out).toBe(false);
+        const entry = buildCatalogEntry(out, "https://example.invalid/a.zip", 1, remote.owner, "2026-09-14T00:00:00Z", {});
+        expect("marketIcon" in entry).toBe(false);
+        expect("icon" in entry).toBe(false);
+    });
+    it("合并保历史：新版没声明 marketIcon 时，不让已收录条目塌成默认块", () => {
+        const first = buildCatalogEntry(withCatalogIdentity({ id: "demo", name: "Demo", version: "1.0.0", marketIcon: "resources/icon.svg" }, remote, tag), "https://example.invalid/v1.zip", 1, remote.owner, "2026-09-14T00:00:00Z", {});
+        const second = buildCatalogEntry(withCatalogIdentity({ id: "demo", name: "Demo", version: "1.1.0" }, remote, "v1.1.0"), "https://example.invalid/v11.zip", 1, remote.owner, "2026-09-15T00:00:00Z", {});
+        const merged = upsertCatalogEntry(upsertCatalogEntry(createEmptyCatalog(), first), second);
+        expect(merged.plugins[0].marketIcon).toBe(first.marketIcon);
+    });
+});
+/* ────────────────────────────────────────────────────────────────────────
+   发布前置断言（E6#68c，2026-09-15 用户拍板「做成机械门禁」）。
+   实测来源：本机代理进程死掉那段时间，`git push` 失败而 `publish` **照样成功** ⇒
+   Release 与 asset 都对（asset 取自本地工作区），但 tag 打在**没推上去的旧 HEAD** 上
+   ⇒ 目录条目里的 icon / readmeUrl 直链（raw/…/v<版本>/…）全 404。
+   下面每条用例对应一个真实会发生的形态，不是凑覆盖率。
+   ──────────────────────────────────────────────────────────────────────── */
+describe("judgePublishReadiness——发布前置断言", () => {
+    it("本地 HEAD == 远端 HEAD 且工作区干净 → 放行", () => {
+        expect(judgePublishReadiness({ localHead: "a".repeat(40), remoteHead: "a".repeat(40), dirtyFiles: [] })).toEqual({ ok: true });
+    });
+    it("本地 HEAD ≠ 远端 HEAD（那笔提交没推上去）→ 拦，且必须给出修法", () => {
+        const v = judgePublishReadiness({ localHead: "a".repeat(40), remoteHead: "b".repeat(40), dirtyFiles: [] });
+        expect(v.ok).toBe(false);
+        if (!v.ok) {
+            expect(v.kind).toBe("unpushed");
+            expect(v.message).toContain("本地 HEAD 还没推上去");
+            expect(v.message).toContain("git push");
+            expect(v.message).toContain("404"); // 讲清后果，不只是「不许」
+        }
+    });
+    it("工作区脏（已跟踪文件有未提交改动）→ 拦，且把文件名念出来", () => {
+        const v = judgePublishReadiness({ localHead: "a".repeat(40), remoteHead: "a".repeat(40), dirtyFiles: [" M plugin.json", "M  README.md"] });
+        expect(v.ok).toBe(false);
+        if (!v.ok) {
+            expect(v.kind).toBe("dirty");
+            expect(v.message).toContain(" M plugin.json");
+            expect(v.message).toContain("M  README.md");
+        }
+    });
+    it("两个都犯 → 先报脏（更上游：脏工作区打出来的包根本不在任何提交里）", () => {
+        const v = judgePublishReadiness({ localHead: "a".repeat(40), remoteHead: "b".repeat(40), dirtyFiles: [" M x"] });
+        expect(v.ok).toBe(false);
+        if (!v.ok)
+            expect(v.kind).toBe("dirty");
+    });
+    it("读不到远端 HEAD（空仓 / 权限 / API 抖）→ **放行 + 说明**，不判红（假红让真红失效）", () => {
+        const v = judgePublishReadiness({ localHead: "a".repeat(40), remoteHead: null, dirtyFiles: [] });
+        expect(v.ok).toBe(true);
+        if (v.ok)
+            expect(v.skipped).toContain("远端 HEAD");
+    });
+    it("读不到本地 HEAD（非 git / git 不在 PATH）→ 同样放行 + 说明", () => {
+        const v = judgePublishReadiness({ localHead: null, remoteHead: "b".repeat(40), dirtyFiles: [] });
+        expect(v.ok).toBe(true);
+        if (v.ok)
+            expect(v.skipped).toContain("本地 HEAD");
+    });
+    it("分叉（两笔互不在对方历史里）也是 local≠remote ⇒ 拦——tag 同样指向缺文件的那个提交", () => {
+        const v = judgePublishReadiness({ localHead: "abc1234".padEnd(40, "0"), remoteHead: "def5678".padEnd(40, "0"), dirtyFiles: [] });
+        expect(v.ok).toBe(false);
+    });
+    it("报错里只印 7 位短 sha（40 位原样倒出来扫一眼读不出）", () => {
+        const v = judgePublishReadiness({ localHead: "1234567" + "0".repeat(33), remoteHead: "7654321" + "0".repeat(33), dirtyFiles: [] });
+        expect(v.ok).toBe(false);
+        if (!v.ok) {
+            expect(v.message).toContain("1234567");
+            expect(v.message).toContain("7654321");
+            expect(v.message).not.toContain("0".repeat(20)); // 没把 40 位原样倒出来
+        }
+    });
+});
+describe("parsePorcelainStatus——git status 解析", () => {
+    it("空输出 / 只有换行 → 空数组（不是「脏了一条空路径」）", () => {
+        expect(parsePorcelainStatus("")).toEqual([]);
+        expect(parsePorcelainStatus("\n")).toEqual([]);
+        expect(parsePorcelainStatus("\r\n\r\n")).toEqual([]);
+    });
+    it("CRLF 与 LF 两种 git 输出都解析得出", () => {
+        expect(parsePorcelainStatus(" M a.ts\nM  b.json\n")).toHaveLength(2);
+        expect(parsePorcelainStatus(" M a.ts\r\nM  b.json\r\n")).toHaveLength(2);
+    });
+    it("原样保留 XY 状态码（作者靠它看懂是「改了没暂存」还是「已暂存」）", () => {
+        expect(parsePorcelainStatus("MM plugin.json")).toEqual(["MM plugin.json"]);
+    });
+});
+//# sourceMappingURL=publish.test.js.map

package/dist/publish.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.test.js","sourceRoot":"","sources":["../src/publish.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,cAAc,CAAC;AAEtB,2EAA2E;AAE3E,MAAM,MAAM,GAAG;IACb,QAAQ;IACR,EAAE;IACF,uBAAuB;IACvB,UAAU;IACV,UAAU;IACV,EAAE;IACF,uBAAuB;IACvB,QAAQ;IACR,EAAE;IACF,uBAAuB;IACvB,SAAS;IACT,EAAE;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,IAAI,GAAG,CAAC,OAAe,EAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAE/F,wEAAwE;AAExE,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAChD,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC1E,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,2DAA2D;QAC3D,+BAA+B;QAC/B,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACxH,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,kEAAkE;QAClE,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE;YACnH,SAAS,EAAE,mCAAmC;YAC9C,SAAS,EAAE,MAAM;SAClB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,kFAAkF;QAClF,6DAA6D;QAC7D,MAAM,OAAO,GAAiB,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;QAC5G,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,+BAA+B,EAAE,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QAClH,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,kDAAkD;QAClD,MAAM,CAAC,eAAe,IAAI,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChI,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,+DAA+D;QAC/D,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7D,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,+BAA+B,CAAC;QAC7C,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,IAAI,GAAG;YACX,QAAQ;YACR,EAAE;YACF,uBAAuB;YACvB,UAAU;YACV,EAAE;YACF,aAAa;YACb,WAAW;YACX,eAAe;YACf,KAAK;YACL,EAAE;YACF,QAAQ;YACR,EAAE;YACF,uBAAuB;YACvB,UAAU;YACV,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,iDAAiD;QACjD,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtC,oBAAoB;QACpB,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,uEAAuE,CAAC;QACrF,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,2BAA2B,CAAC;QACzC,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,kBAAkB,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,IAAI,GAAG,sBAAsB,CAAC;QACpC,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,qBAAqB,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,IAAI,GAAG,CAAC,aAAa,EAAE,EAAE,EAAE,yBAAyB,EAAE,MAAM,EAAE,EAAE,EAAE,yBAAyB,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1H,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,IAAI,GAAG,CAAC,yBAAyB,EAAE,QAAQ,EAAE,EAAE,EAAE,uBAAuB,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpI,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxF,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,qBAAqB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1E,MAAM,CAAC,qBAAqB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1E,MAAM,CAAC,qBAAqB,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3E,MAAM,CAAC,qBAAqB,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,0EAA0E;AAE1E,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAC7E,yEAAyE,CAC1E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,oDAAoD;AAEpD;;;GAGG;AACH,SAAS,UAAU,CAAC,IAAY,EAAE,OAAe;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,kDAAkD;IAClD,MAAM,OAAO,GAAG,yBAAyB,CAAC;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM;gBAAE,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,CAAC,CAAC;YACR,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AAChE,CAAC;AAED,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7G,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QACnF,yDAAyD;QACzD,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,iCAAiC,CAAC;QAC/C,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAClE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,IAAI,GAAG,2BAA2B,CAAC;QACzC,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,kBAAkB,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,8DAA8D;QAC9D,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,IAAI,GAAG,mCAAmC,CAAC;QACjD,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,6DAA6D;QAC7D,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,mBAAmB;QACxE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;QACjE,MAAM,CAAC,UAAU,CAAC,+BAA+B,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,mBAAmB;IACnG,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH;;oDAEoD;AAEpD,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;IAClE,MAAM,GAAG,GAAG,QAAQ,CAAC;IAErB,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,GAAG,GAAG,mBAAmB,CAC7B,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,UAAU,EAAE,oBAAoB,EAAE,EAChH,MAAM,EACN,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,8FAA8F,CAAC,CAAC;QACtH,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,0FAA0F,CAAC,CAAC;QACxH,oFAAoF;QACpF,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,MAAM,KAAK,GAAG,iBAAiB,CAC7B,mBAAmB,CACjB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,UAAU,EAAE,oBAAoB,EAAE,EAChH,MAAM,EACN,GAAG,CACJ,EACD,+BAA+B,EAC/B,CAAC,EACD,MAAM,CAAC,KAAK,EACZ,sBAAsB,EACtB,EAAE,CACH,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAG,mBAAmB,CAC7B,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,mCAAmC,EAAE,EACzF,MAAM,EACN,GAAG,CACJ,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,UAAU,GAAG,mBAAmB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACzI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,mBAAmB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACpH,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,oCAAoC;QAC5E,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,mBAAmB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,EAAE,+BAA+B,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QACnH,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,KAAK,GAAG,iBAAiB,CAC7B,mBAAmB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAClH,gCAAgC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAC9E,CAAC;QACF,MAAM,MAAM,GAAG,iBAAiB,CAC9B,mBAAmB,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EACrF,iCAAiC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAC/E,CAAC;QACF,MAAM,MAAM,GAAG,kBAAkB,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH;;;;;;8EAM8E;AAC9E,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,qBAAqB,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACjI,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3G,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAChC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;YAC7C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACxC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,gBAAgB,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;QAC3I,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC9C,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjH,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QACjG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE;YAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QACjI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QACnI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC7C,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/validate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validate.test.d.ts.map

package/dist/validate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.test.d.ts","sourceRoot":"","sources":["../src/validate.test.ts"],"names":[],"mappings":""}

package/dist/validate.test.js

@@ -0,0 +1,107 @@
+/**
+ * validate 墓碑提示测试（E6#91d，L3.7 第 3.7.2 轮）+ pluginId 显式声明提醒（E6#98g，L7 第 7.1 轮）。
+ *
+ * 钉死两件事：
+ *   ① 旧写法（`plugin.json` 里还有 `changelog` / `readme`）→ **有警告、仍 `valid`**（警告不是错误——
+ *      判错会让存量第三方插件的 `npm run build` 突然炸，为一个从无读取方的字段破坏构建不值）。
+ *   ② 新写法（干净 manifest）→ **无警告**（墓碑不能变成噪音——那会让人习惯性忽略它）。
+ *   `pluginId` 提醒同款哲学（E6#98g）：不声明 → 一条警告、`valid` 不变（兜底路径不删）。
+ *
+ * fixture 一律用明显虚构值（硬约束 21：测试桩不指向真实插件）。
+ */
+import { afterEach, describe, expect, it } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { validatePluginJson } from "./validate.js";
+const dirs = [];
+/**
+ * 造一个临时插件工程（写到盘上——validatePluginJson 是路径入口，含真实文件 IO）。
+ * `pluginId` 默认写入：E6#98g 之后「干净 manifest」的定义包含显式身份——想测缺声明请
+ * 显式传 `{ pluginId: undefined }`（见下方 pluginId 提醒那组）。
+ */
+function fixture(manifest) {
+    const dir = mkdtempSync(join(tmpdir(), "linkdesk-fixture-"));
+    dirs.push(dir);
+    writeFileSync(join(dir, "plugin.json"), JSON.stringify({ name: "Demo Fixture", version: "1.0.0", pluginId: "demo-fixture", ...manifest }, null, 2), "utf8");
+    return join(dir, "plugin.json");
+}
+afterEach(() => {
+    while (dirs.length > 0)
+        rmSync(dirs.pop(), { recursive: true, force: true });
+});
+describe("validatePluginJson——墓碑提示（E6#91d）", () => {
+    it("干净 manifest → 无 warnings 键（墓碑不是噪音）", () => {
+        const res = validatePluginJson(fixture({}));
+        expect(res.valid).toBe(true);
+        expect(res.errors).toEqual([]);
+        expect(res.warnings).toBeUndefined();
+    });
+    it("旧写法 changelog → 警告、valid 仍为 true（构建不炸）", () => {
+        const res = validatePluginJson(fixture({ changelog: [{ version: "1.0.0", date: "2026-09-11", changes: ["一条"] }] }));
+        expect(res.valid).toBe(true);
+        expect(res.errors).toEqual([]);
+        expect(res.warnings).toHaveLength(1);
+        expect(res.warnings?.[0]).toContain("changelog");
+        expect(res.warnings?.[0]).toContain("CHANGELOG.md"); // 警告必须给出**去哪**
+    });
+    it("旧写法 readme → 警告、valid 仍为 true", () => {
+        const res = validatePluginJson(fixture({ readme: "./README.md" }));
+        expect(res.valid).toBe(true);
+        expect(res.warnings).toHaveLength(1);
+        expect(res.warnings?.[0]).toContain("readme");
+        expect(res.warnings?.[0]).toContain("README.md");
+    });
+    it("两个都写 → 两条警告（各自指路，不合并成一条）", () => {
+        const res = validatePluginJson(fixture({ readme: "./README.md", changelog: [{ version: "1.0.0", date: "2026-09-11" }] }));
+        expect(res.valid).toBe(true);
+        expect(res.warnings).toHaveLength(2);
+    });
+    it("嵌套同名字段不算命中——只扫顶层（`cardDocMap` 里的键名 changelog 与墓碑无关）", () => {
+        // `cardDocMap` 是合法的「任意键」顶层对象——用它的**键名**叫 changelog 来证明扫描只看顶层 key，
+        // 不递归进子对象（递归 = 把用户数据当字段名，会误报）
+        const res = validatePluginJson(fixture({ cardDocMap: { changelog: "resources/demo.md", readme: "resources/demo.md" } }));
+        expect(res.valid).toBe(true);
+        expect(res.warnings).toBeUndefined();
+    });
+    it("schema 已经拦下的 manifest → 提前返回，不产 warnings（先修错，别看噪音）", () => {
+        // 缺 version（schema required）→ 走 valid:false 分支
+        const dir = mkdtempSync(join(tmpdir(), "linkdesk-fixture-"));
+        dirs.push(dir);
+        const p = join(dir, "plugin.json");
+        writeFileSync(p, JSON.stringify({ name: "Demo Fixture", changelog: [] }), "utf8");
+        const res = validatePluginJson(p);
+        expect(res.valid).toBe(false);
+        expect(res.warnings).toBeUndefined();
+    });
+});
+describe("validatePluginJson——pluginId 显式声明提醒（E6#98g）", () => {
+    it("不声明 pluginId → 一条警告、valid 仍为 true（兜底路径不删，只是必须被告知）", () => {
+        const res = validatePluginJson(fixture({ pluginId: undefined }));
+        expect(res.valid).toBe(true);
+        expect(res.errors).toEqual([]);
+        expect(res.warnings).toHaveLength(1);
+        expect(res.warnings?.[0]).toContain("pluginId");
+        // 警告必须说清**后果**（五条全不报错）与**怎么做**
+        expect(res.warnings?.[0]).toContain("目录名");
+    });
+    it("显式声明 pluginId → 该提醒不出现（干净 manifest 不产噪音）", () => {
+        const res = validatePluginJson(fixture({}));
+        expect(res.valid).toBe(true);
+        expect(res.warnings).toBeUndefined();
+    });
+    it("pluginId 为空白串 → schema 判错（不是「声明过了」，也不是静默警告）", () => {
+        // 空白串不合 SAFE_PLUGIN_ID 形状 ⇒ schema 的 pattern 直接拦下（比「警告」更早、更硬）
+        const res = validatePluginJson(fixture({ pluginId: "   " }));
+        expect(res.valid).toBe(false);
+        expect(res.errors.some((e) => e.includes("pluginId"))).toBe(true);
+        expect(res.warnings).toBeUndefined();
+    });
+    it("pluginId 形状非法 → schema 判错、无警告（错误优先，先修错）", () => {
+        const res = validatePluginJson(fixture({ pluginId: "../escape" }));
+        expect(res.valid).toBe(false);
+        expect(res.errors.some((e) => e.includes("pluginId"))).toBe(true);
+        expect(res.warnings).toBeUndefined();
+    });
+});
+//# sourceMappingURL=validate.test.js.map

package/dist/validate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.test.js","sourceRoot":"","sources":["../src/validate.test.ts"],"names":[],"mappings":"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"}