create-linkdesk-plugin 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Encaron
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,55 +1,55 @@
-# create-linkdesk-plugin
-
-LinkDesk 插件脚手架——一行命令生成你的第一个插件项目（对标 `yo code`）。
-
-```bash
-npm create linkdesk-plugin my-cool-plugin
-```
-
-不带名字则交互式询问：
-
-```bash
-npm create linkdesk-plugin
-```
-
-## 生成什么
-
-生成物的形状**与官方插件一致**——README / CHANGELOG / resources / i18n 一个不少：
-
-```
-my-cool-plugin/
-├── plugin.json           # 插件清单（JSONC：可注释/尾逗号，字段分节示范，VS Code $schema 校验）
-├── package.json          # scripts: dev / dev:real / build / publish / validate / lint
-├── tsconfig.json         # jsx: react-jsx + window.linkdesk.* 类型（@linkdesk/plugin-sdk）
-├── .gitignore            # node_modules / dist / *.linkdesk-plugin
-├── README.md             # 说明——市场「详情」页签的数据源 + 目录契约表
-├── CHANGELOG.md          # 更新日志——市场「更改日志」页签的数据源
-├── .vscode/settings.json # plugin.json 按 jsonc 识别（注释不标红）
-├── resources/
-│   └── icon.svg          # 图标占位图——换成你自己的
-├── src/
-│   ├── index.tsx         # 视图组件 default 导出——壳以 { isActive, tabId?, sourceId? } 渲染
-│   └── index.css         # 样式示例——颜色 / 字号走 var(--xxx)，间距走 4px 节奏
-└── i18n/
-    └── en.json           # 英文译文（key = 中文原文；不建 zh.json）
-```
-
-> **不预建空文件夹**（git 本来也不记录空目录）——「东西该放哪」写在生成的 `README.md` 的目录契约表里，
-> 用文字说清比用空夹暗示更清楚。
-
-## 命令
-
-```bash
-cd my-cool-plugin
-npm install
-
-npm run dev        # 浏览器热重载预览（改代码即时生效）
-npm run dev:real   # 真机环——直写 {userData}/plugins/<id> + CDP reload（真 IPC / 串口 / LSP 类插件用）
-npm run validate   # 校验 plugin.json
-npm run build      # 产出 <pluginId>.linkdesk-plugin——可装进 LinkDesk / 发布
-npm run lint       # 门禁自检（硬编码颜色 / 字号 / 间距网格 / eslint 规则）
-npm run publish    # 一键发布（建 GitHub Release + 上传 + 更新 catalog）
-```
-
-> 说明：插件作者工作流（dev 热预览 / build / 发布全链路）的完整文档见
-> [00-第三方作者旅程](../../docs/02-Electron架构/E6_插件生态与发布/05-文档与发布/00-第三方作者旅程.md)。
+# create-linkdesk-plugin
+
+LinkDesk 插件脚手架——一行命令生成你的第一个插件项目（对标 `yo code`）。
+
+```bash
+npm create linkdesk-plugin my-cool-plugin
+```
+
+不带名字则交互式询问：
+
+```bash
+npm create linkdesk-plugin
+```
+
+## 生成什么
+
+生成物的形状**与官方插件一致**——README / CHANGELOG / resources / i18n 一个不少：
+
+```
+my-cool-plugin/
+├── plugin.json           # 插件清单（JSONC：可注释/尾逗号，字段分节示范，VS Code $schema 校验）
+├── package.json          # scripts: dev / dev:real / build / publish / validate / lint
+├── tsconfig.json         # jsx: react-jsx + window.linkdesk.* 类型（@linkdesk/plugin-sdk）
+├── .gitignore            # node_modules / dist / *.linkdesk-plugin
+├── README.md             # 说明——市场「详情」页签的数据源 + 目录契约表
+├── CHANGELOG.md          # 更新日志——市场「更改日志」页签的数据源
+├── .vscode/settings.json # plugin.json 按 jsonc 识别（注释不标红）
+├── resources/
+│   └── icon.svg          # 图标占位图——换成你自己的
+├── src/
+│   ├── index.tsx         # 视图组件 default 导出——壳以 { isActive, tabId?, sourceId? } 渲染
+│   └── index.css         # 样式示例——颜色 / 字号走 var(--xxx)，间距走 4px 节奏
+└── i18n/
+    └── en.json           # 英文译文（key = 中文原文；不建 zh.json）
+```
+
+> **不预建空文件夹**（git 本来也不记录空目录）——「东西该放哪」写在生成的 `README.md` 的目录契约表里，
+> 用文字说清比用空夹暗示更清楚。
+
+## 命令
+
+```bash
+cd my-cool-plugin
+npm install
+
+npm run dev        # 浏览器热重载预览（改代码即时生效）
+npm run dev:real   # 真机环——直写 {userData}/plugins/<id> + CDP reload（真 IPC / 串口 / LSP 类插件用）
+npm run validate   # 校验 plugin.json
+npm run build      # 产出 <pluginId>.linkdesk-plugin——可装进 LinkDesk / 发布
+npm run lint       # 门禁自检（硬编码颜色 / 字号 / 间距网格 / eslint 规则）
+npm run publish    # 一键发布（建 GitHub Release + 上传 + 更新 catalog）
+```
+
+> 说明：插件作者工作流（dev 热预览 / build / 发布全链路）的完整文档见
+> [00-第三方作者旅程](../../docs/02-Electron架构/E6_插件生态与发布/05-文档与发布/00-第三方作者旅程.md)。

package/index.js

@@ -1,136 +1,266 @@
-#!/usr/bin/env node
-/**
- * create-linkdesk-plugin——LinkDesk 插件脚手架 CLI（纯 Node，零依赖，对标 yo code）。
- *
- * 用法：
- *   npm create linkdesk-plugin my-cool-plugin   # 直接给名字（kebab-case，非交互）
- *   npm create linkdesk-plugin                  # 不带参数 → 交互式询问插件名
- *
- * 行为：把同目录 template/ 复制到 <cwd>/<name>，把占位符替换成真实值，打印下一步提示。
- * 占位符：{{pluginName}} {{displayName}} {{author}} {{date}}（递归替换所有模板文件）。
- *   {{date}} 注入 CHANGELOG.md 的初始段标题——格式必须是 `## v<版本>（YYYY-MM-DD）`，
- *   那是市场「更改日志」页签切段的解析依据（见 docs/02-Electron架构/.../插件规范化层/02）。
- *
- * 生成产物契约：见 docs/02-Electron架构/E6_插件生态与发布/02-插件开发工具链/01-create-linkdesk-plugin脚手架.md。
- */
-import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { spawnSync } from "node:child_process";
-import { createInterface } from "node:readline";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const TEMPLATE_DIR = join(dirname(fileURLToPath(import.meta.url)), "template");
-
-/** kebab-case——同时满足插件 id / viewsContainers key / npm 包名惯例（SAFE_PLUGIN_ID 的形状子集） */
-const NAME_RE = /^[a-z][a-z0-9-]*$/;
-
-/** 本地日期 YYYY-MM-DD（不用 toISOString——那是 UTC，跨时区会差一天） */
-function todayLocal() {
-  const d = new Date();
-  const p = (n) => String(n).padStart(2, "0");
-  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
-}
-
-/** my-cool-plugin → My Cool Plugin */
-function toDisplayName(name) {
-  return name
-    .split("-")
-    .map((s) => (s ? s[0].toUpperCase() + s.slice(1) : s))
-    .join(" ");
-}
-
-/** 作者默认值 = git config user.name；读不到（无 git/无配置）→ "you"（作者生成后自改） */
-function gitUserName() {
-  try {
-    const r = spawnSync("git", ["config", "user.name"], { encoding: "utf8", timeout: 3000 });
-    const v = (r.stdout || "").trim();
-    return v || "you";
-  } catch {
-    return "you";
-  }
-}
-
-/** 交互式单问——返回去除首尾空白的答案 */
-function ask(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-function replacePlaceholders(file, values) {
-  let text = readFileSync(file, "utf8");
-  for (const [key, value] of Object.entries(values)) {
-    text = text.split(`{{${key}}}`).join(value);
-  }
-  writeFileSync(file, text);
-}
-
-/** 递归替换目录内全部文件（模板全是文本文件，无需跳过二进制） */
-function walkReplace(dir, values) {
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    const full = join(dir, entry.name);
-    if (entry.isDirectory()) walkReplace(full, values);
-    else replacePlaceholders(full, values);
-  }
-}
-
-async function main() {
-  let name = (process.argv[2] || "").trim();
-  if (!name) {
-    name = await ask("插件名（kebab-case，如 my-cool-plugin）: ");
-  }
-  name = name.trim();
-  if (!NAME_RE.test(name)) {
-    console.error(`✖ 插件名须为 kebab-case（小写字母/数字/连字符），收到：${JSON.stringify(name)}`);
-    process.exit(1);
-  }
-
-  const target = join(process.cwd(), name);
-  if (existsSync(target) && readdirSync(target).length > 0) {
-    console.error(`✖ ${name}/ 已存在且非空——换个名字，或清空后重跑`);
-    process.exit(1);
-  }
-
-  mkdirSync(target, { recursive: true });
-  cpSync(TEMPLATE_DIR, target, { recursive: true });
-
-  // 🔥 模板里存的是 `gitignore`（无点），生成时才改名为 `.gitignore`。
-  // 原因：**npm 打包恒定丢弃名为 `.gitignore` 的文件**（npm-packlist 排除表；实测
-  // `template/.gitignoreprobe` 与 `template/probe.txt` 都能进 tarball，唯独 `.gitignore` 不能）。
-  // 若模板里直接放 `.gitignore`，仓内生成（读模板目录）一切正常，**但发布后的
-  // `npm create linkdesk-plugin` 生成的工程会没有 .gitignore**——作者第一次 `git add .`
-  // 就把 node_modules/ 和 dist/ 全提交了。生成物契约见 check-scaffold.mjs 断言 8。
-  const tplGitignore = join(target, "gitignore");
-  if (existsSync(tplGitignore)) renameSync(tplGitignore, join(target, ".gitignore"));
-
-  const values = {
-    pluginName: name,
-    displayName: toDisplayName(name),
-    author: gitUserName(),
-    date: todayLocal(),
-  };
-  walkReplace(target, values);
-
-  console.log("");
-  console.log(`✔ ${name}/ 已创建`);
-  console.log("");
-  console.log("  接下来：");
-  console.log(`    cd ${name}`);
-  console.log("    npm install");
-  console.log("    npm run dev        # 浏览器热重载预览（改代码即时生效）");
-  console.log("    npm run validate   # 校验 plugin.json（$schema / 字段 / i18n 文件）");
-  console.log("    npm run build      # 打包出 <pluginId>.linkdesk-plugin，可装进 LinkDesk / 发布");
-  console.log("");
-  console.log("  然后：先读 README.md —— 目录该放哪、三条纪律、怎么发布都在里面。");
-  console.log("  plugin.json 的 name / description / author 是你的身份信息，src/index.tsx 是插件本体。");
-  console.log("  完整插件能力（侧栏视图 / 命令 / 设置 / 协议……）见 docs/03-插件制造/。");
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});
+#!/usr/bin/env node
+/**
+ * create-linkdesk-plugin——LinkDesk 插件脚手架 CLI（纯 Node，零依赖，对标 yo code）。
+ *
+ * 用法：
+ *   npm create linkdesk-plugin my-cool-plugin            # 直接给名字（kebab-case，非交互）
+ *   npm create linkdesk-plugin                           # 不带参数 → 交互式询问插件名
+ *   npm create linkdesk-plugin my-cool-plugin --no-git   # 跳过建仓
+ *
+ * 行为：把同目录 template/ 复制到 <cwd>/<name>，占位符替换成真实值，**按 `cargo new` 的语义决定
+ *      建不建 git 仓**，再打印下一步提示。
+ * 占位符：{{pluginName}} {{displayName}} {{author}} {{date}}（递归替换所有模板文件）。
+ *   {{date}} 注入 CHANGELOG.md 的初始段标题——格式必须是 `## v<版本>（YYYY-MM-DD）`，
+ *   那是市场「更改日志」页签切段的解析依据（见 docs/02-Electron架构/.../插件规范化层/02）。
+ *
+ * 🔴 建仓三语义（E6#103 · L7 第 7.6 轮）——照抄 `cargo new`，**不是「一律 git init」**：
+ *   ① 目标目录**已在某个 git 仓内** ⇒ 不 init（防嵌套仓——在容器目录里生成插件正是这种情形）
+ *   ② 不在任何 git 仓内 ⇒ `git init -b main`
+ *   ③ `--no-git` ⇒ 不建仓（逃生口，对标 `cargo new --vcs none`）
+ *   比 cargo 多一步：建完仓**顺手做一次初始提交**——模板自带 `.gitignore`，作者第一步看到的
+ *   就不是满屏 untracked，`git log` 也立刻有一笔可回退的基线。不想要仓的人用 `--no-git`。
+ *
+ * 生成产物契约：见 docs/02-Electron架构/E6_插件生态与发布/02-插件开发工具链/01-create-linkdesk-plugin脚手架.md。
+ */
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const TEMPLATE_DIR = join(dirname(fileURLToPath(import.meta.url)), "template");
+
+/** kebab-case——同时满足插件 id / viewsContainers key / npm 包名惯例（SAFE_PLUGIN_ID 的形状子集） */
+const NAME_RE = /^[a-z][a-z0-9-]*$/;
+
+/** 认识的旗标——**显式白名单**：`--nogit` 这种拼错不能静默略过（作者会以为仓建好了） */
+const KNOWN_FLAGS = ["--no-git", "--help", "-h"];
+
+const USAGE = [
+  "用法：",
+  "  npm create linkdesk-plugin <name>          生成 <name>/ 插件工程（kebab-case）",
+  "  npm create linkdesk-plugin                 交互式询问插件名",
+  "选项：",
+  "  --no-git      不建 git 仓（对标 cargo new --vcs none）",
+  "  --help, -h    显示本说明",
+].join("\n");
+
+/** 本地日期 YYYY-MM-DD（不用 toISOString——那是 UTC，跨时区会差一天） */
+function todayLocal() {
+  const d = new Date();
+  const p = (n) => String(n).padStart(2, "0");
+  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}`;
+}
+
+/** my-cool-plugin → My Cool Plugin */
+function toDisplayName(name) {
+  return name
+    .split("-")
+    .map((s) => (s ? s[0].toUpperCase() + s.slice(1) : s))
+    .join(" ");
+}
+
+/** 作者默认值 = git config user.name；读不到（无 git/无配置）→ "you"（作者生成后自改） */
+function gitUserName() {
+  try {
+    const r = spawnSync("git", ["config", "user.name"], { encoding: "utf8", timeout: 3000 });
+    const v = (r.stdout || "").trim();
+    return v || "you";
+  } catch {
+    return "you";
+  }
+}
+
+// ─────────────────────────── git（§〇 建仓三语义） ───────────────────────────
+
+/** 跑一条 git 命令——不抛，失败由调用方看 status（没装 git 时 status=null 且 error 有值） */
+function git(args, cwd) {
+  try {
+    return spawnSync("git", args, { cwd, encoding: "utf8", timeout: 15000 });
+  } catch (err) {
+    return { status: null, stdout: "", stderr: String(err?.message ?? err) };
+  }
+}
+
+/** git 在不在 PATH 上——不在就不建仓（骨架照常给，不拿「没装 git」卡住作者） */
+function gitAvailable() {
+  return git(["--version"]).status === 0;
+}
+
+/**
+ * 目标目录是否**已在某个 git 仓内**——`cargo new` 的「不造嵌套仓」判据。
+ *
+ * 在**目标目录里**问（不是 cwd）：目录此时已建出来，向上找仓根正是 `cargo new` 的做法。
+ * `rev-parse --show-toplevel` 在仓外会 exit 128 ⇒ 那就是「不在仓内」。
+ */
+function insideGitRepo(dir) {
+  const r = git(["rev-parse", "--show-toplevel"], dir);
+  return r.status === 0 ? (r.stdout || "").trim() : "";
+}
+
+/** stderr 摘要（给作者看的失败原因，最多三行） */
+function why(r) {
+  return ((r.stderr || r.stdout || "").trim().split("\n").filter(Boolean).slice(0, 3).join(" / ")) || "（无输出）";
+}
+
+/**
+ * 建仓——返回结果对象给 CLI 输出（**作者必须知道到底建没建、为什么**，不许自己猜）。
+ *
+ * 🔴 任何一步失败都**不终止脚手架**：骨架已经生成好了，建仓是加分项，不是前置条件。
+ */
+function setupGit(target, { noGit }) {
+  if (noGit) return { kind: "skipped-flag" };
+  if (!gitAvailable()) return { kind: "no-git-binary" };
+
+  const top = insideGitRepo(target);
+  if (top) return { kind: "skipped-inside-repo", top };
+
+  const init = git(["init", "-b", "main"], target);
+  if (init.status !== 0) {
+    // `-b` 是 git 2.28+ 才有的旗标；更老的 git 退回 init + 显式把 HEAD 指到 main
+    // （不这么做，作者第一次 push 会撞上默认分支叫 master 的提示，与 GitHub 默认也不一致）
+    if (git(["init"], target).status !== 0) return { kind: "failed", step: "git init", detail: why(init) };
+    git(["symbolic-ref", "HEAD", "refs/heads/main"], target);
+  }
+
+  if (git(["add", "-A"], target).status !== 0) return { kind: "init-only", step: "git add" };
+
+  // `--no-verify`：这是**一个新仓的初始提交**，不该被使用者全局 core.hooksPath 上的
+  // commit-msg / pre-commit 钩子审（那些钩子是给别的仓立的规矩）
+  const commit = git(["commit", "--no-verify", "-m", "chore: 初始骨架（create-linkdesk-plugin 生成）"], target);
+  if (commit.status !== 0) return { kind: "init-only", step: "git commit", detail: why(commit) };
+
+  return { kind: "created" };
+}
+
+/** 建仓结果 → CLI 那一行（`git` 那步发生了什么，说全） */
+function gitLine(res) {
+  switch (res.kind) {
+    case "created":
+      return "  ✔ 已建 git 仓（main 分支 + 一次初始提交）";
+    case "skipped-flag":
+      return "  · --no-git：未建 git 仓（发布前需要自己 git init）";
+    case "skipped-inside-repo":
+      return `  · 已在 git 仓内（${res.top}）——按 cargo new 语义不建嵌套仓`;
+    case "no-git-binary":
+      return "  ⚠️ 找不到 git（不在 PATH）——未建仓；装上 git 后进目录自己 git init -b main";
+    case "init-only":
+      return `  ⚠️ 仓已建，但初始提交没成（${res.step}）：${res.detail}\n     多半是没配 git 身份 → git config --global user.name "你" && git config --global user.email "you@example.com"，再进目录 git commit -m "初始骨架"`;
+    default:
+      return `  ⚠️ 建仓失败（${res.step}）：${res.detail}——进目录自己 git init -b main`;
+  }
+}
+
+/** 交互式单问——返回去除首尾空白的答案 */
+function ask(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+function replacePlaceholders(file, values) {
+  let text = readFileSync(file, "utf8");
+  for (const [key, value] of Object.entries(values)) {
+    text = text.split(`{{${key}}}`).join(value);
+  }
+  writeFileSync(file, text);
+}
+
+/** 递归替换目录内全部文件（模板全是文本文件，无需跳过二进制） */
+function walkReplace(dir, values) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) walkReplace(full, values);
+    else replacePlaceholders(full, values);
+  }
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const flags = argv.filter((a) => a.startsWith("-"));
+  const positional = argv.filter((a) => !a.startsWith("-"));
+
+  if (flags.includes("--help") || flags.includes("-h")) {
+    console.log(USAGE);
+    return;
+  }
+  const unknown = flags.filter((f) => !KNOWN_FLAGS.includes(f));
+  if (unknown.length > 0) {
+    console.error(`✖ 不认识的选项：${unknown.join("、")}\n\n${USAGE}`);
+    process.exit(1);
+  }
+  if (positional.length > 1) {
+    console.error(`✖ 只接受一个插件名，收到 ${positional.length} 个：${positional.join("、")}\n\n${USAGE}`);
+    process.exit(1);
+  }
+  const noGit = flags.includes("--no-git");
+
+  let name = (positional[0] || "").trim();
+  if (!name) {
+    name = await ask("插件名（kebab-case，如 my-cool-plugin）: ");
+  }
+  name = name.trim();
+  if (!NAME_RE.test(name)) {
+    console.error(`✖ 插件名须为 kebab-case（小写字母/数字/连字符），收到：${JSON.stringify(name)}`);
+    process.exit(1);
+  }
+
+  const target = join(process.cwd(), name);
+  if (existsSync(target) && readdirSync(target).length > 0) {
+    console.error(`✖ ${name}/ 已存在且非空——换个名字，或清空后重跑`);
+    process.exit(1);
+  }
+
+  mkdirSync(target, { recursive: true });
+  cpSync(TEMPLATE_DIR, target, { recursive: true });
+
+  // 🔥 模板里存的是 `gitignore`（无点），生成时才改名为 `.gitignore`。
+  // 原因：**npm 打包恒定丢弃名为 `.gitignore` 的文件**（npm-packlist 排除表；实测
+  // `template/.gitignoreprobe` 与 `template/probe.txt` 都能进 tarball，唯独 `.gitignore` 不能）。
+  // 若模板里直接放 `.gitignore`，仓内生成（读模板目录）一切正常，**但发布后的
+  // `npm create linkdesk-plugin` 生成的工程会没有 .gitignore**——作者第一次 `git add .`
+  // 就把 node_modules/ 和 dist/ 全提交了。生成物契约见 check-scaffold.mjs 断言 8。
+  const tplGitignore = join(target, "gitignore");
+  if (existsSync(tplGitignore)) renameSync(tplGitignore, join(target, ".gitignore"));
+
+  const values = {
+    pluginName: name,
+    displayName: toDisplayName(name),
+    author: gitUserName(),
+    date: todayLocal(),
+  };
+  walkReplace(target, values);
+
+  // 建仓放在**最后**——此刻工作区已是终态，初始提交提交的就是作者拿到的那个骨架
+  const repo = setupGit(target, { noGit });
+
+  console.log("");
+  console.log(`✔ ${name}/ 已创建`);
+  console.log(gitLine(repo));
+  console.log("");
+  console.log("  接下来：");
+  console.log(`    cd ${name}`);
+  console.log("    npm install");
+  console.log("    npm run dev        # 浏览器热重载预览（改代码即时生效）");
+  console.log("    npm run validate   # 校验 plugin.json（$schema / 字段 / i18n 文件）");
+  console.log("    npm run build      # 打包出 <pluginId>.linkdesk-plugin，可装进 LinkDesk / 发布");
+  if (repo.kind === "created") {
+    console.log("");
+    console.log("  要发布（npm run publish）时还需要一个 GitHub 远端：");
+    console.log("    git remote add origin git@github.com:<你>/<仓库>.git");
+    console.log("    git push -u origin main");
+  }
+  console.log("");
+  console.log("  然后：先读 README.md —— 目录该放哪、三条纪律、怎么发布都在里面。");
+  console.log("  plugin.json 的 name / description / author 是你的身份信息，src/index.tsx 是插件本体。");
+  console.log("  完整插件能力（侧栏视图 / 命令 / 设置 / 协议……）见 docs/03-插件制造/。");
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "create-linkdesk-plugin",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "LinkDesk 插件脚手架——`npm create linkdesk-plugin my-cool-plugin` 一行生成你的第一个插件项目（对标 yo code）。",
   "type": "module",
   "bin": {
-    "create-linkdesk-plugin": "./index.js"
+    "create-linkdesk-plugin": "index.js"
   },
   "files": [
     "index.js",

package/template/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+# LinkDesk 插件仓 CI（E6#102）——「搬出去不等于脱管」。
+#
+# 为什么有这份文件：插件源码住在**自己的仓**里，壳仓的 `npm run check` 够不着它（那是壳的门禁）。
+# 类型 / lint / 测试 / i18n / 主题审计这些检查必须在**插件仓自己**跑一遍，否则「独立」是拿
+# 「质量真空」换的。本文件 + `npm run verify` 就是把那一份装回来。
+#
+# 四步各自对应一类「本该在提交前拦住」的错误：
+#   validate —— plugin.json 过 schema（身份/contributes 形状）+ 声明的 i18n 字典文件真的在
+#   verify   —— 严格门禁（内含 SDK lint 全腿；WARN 转拦）。见 scripts/ci-verify.mjs 头注
+#   build    —— 真的能产出 .linkdesk-plugin（构建期错误在这里现形，不是等用户装的时候）
+#   test     —— 工程自带测试（没写测试的工程自动跳过，不是失败）
+#
+# 🔴 这份文件**不用任何 `${{ … }}` 表达式**——它是被脚手架当模板复制出去的文本，而壳仓的
+#   `check-scaffold.mjs` 会把残留的 `{{…}}` 当「未替换占位符」判红。需要表达式时先去那道门禁
+#   登记（它已对 `.github/**` 开了口子，说明见该脚本）。
+#
+# node 版本对齐壳仓 engines（>=24）：插件与壳跑在同一个 Pool 里，别让语法/crypto 行为分叉。
+name: ci
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+
+      # 依赖全部来自公开货架（@linkdesk/plugin-sdk 等作者面包）——本步骤不读 GitHub API，
+      # 故无需 GITHUB_TOKEN；将来若加了读 GitHub 的步骤，记得喂 token（共享 runner 的匿名
+      # 配额 60 次/时，匿名跑会把门禁打成 403 假红）。
+      - run: npm ci
+
+      - run: npm run validate
+      - run: npm run verify
+      - run: npm run build
+
+      # 没写测试的工程直接跳过（--if-present），不是失败——但**必须显式跳过**，
+      # 不许把「没跑」伪装成「跑了且绿」。
+      - run: npm test --if-present

package/template/.vscode/settings.json

@@ -1,8 +1,8 @@
-{
-  // 让 VS Code 按 JSONC 解析 plugin.json —— 它允许 // 注释与尾逗号（对标 VS Code 自己的 package.json）。
-  // 没有这一行，VS Code 会按严格 JSON 解析，本模板 plugin.json 里的注释会被标成满屏红波浪线。
-  // 这只是编辑器提示，不影响运行：LinkDesk 与 SDK 本来就按 jsonc 解析。
-  "files.associations": {
-    "plugin.json": "jsonc"
-  }
-}
+{
+  // 让 VS Code 按 JSONC 解析 plugin.json —— 它允许 // 注释与尾逗号（对标 VS Code 自己的 package.json）。
+  // 没有这一行，VS Code 会按严格 JSON 解析，本模板 plugin.json 里的注释会被标成满屏红波浪线。
+  // 这只是编辑器提示，不影响运行：LinkDesk 与 SDK 本来就按 jsonc 解析。
+  "files.associations": {
+    "plugin.json": "jsonc"
+  }
+}

package/template/README.md

@@ -45,4 +45,14 @@ npm run publish     # 建 GitHub Release + 上传 .linkdesk-plugin + 更新 cata
 
 首次发布需要 GitHub token（跑一次会引导你填，存在本机）。只预览不动作：`npm run publish -- --dry-run`。
 
+发布还要求本工程**已经推到 GitHub**（`publish` 拿工程 origin 的仓库去建 Release）：
+
+```bash
+git remote add origin git@github.com:<你>/<仓库>.git
+git push -u origin main
+```
+
+> 脚手架生成时已替你建好本仓（`main` 分支 + 一次初始提交），所以这一步只是接远端。
+> 若生成时带了 `--no-git`，则先自己 `git init -b main` 再提交。
+
 > 完整作者文档见 LinkDesk 仓库的 `docs/03-插件制造/`（API 契约 / 生命周期 / contributes / 分发 / UI 写法规约）。