@cloudglab/confluence-cli 0.0.3 → 0.0.5

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.0.5 - 2026-06-17
+
+### 修复
+
+- `install` / `update` 链路：把仓库内 `skills/confluence-cli` 从指向 `.agents/skills/confluence-cli` 的符号链接替换为真实目录副本，避免 npm tarball 中 `skills/confluence-cli` 路径在用户机器上不可用导致“未找到已安装包内的 Confluence skill”错误。
+- `install` / `update` 链路：`installMmdCli` 不再因 `curl -fsSL ... | sh` 网络失败而中断整个安装，改为捕获异常并输出 `已跳过 mmd-cli 安装：<原因>` 与后续 `--mermaid none` 退路提示。
+- `install` / `update` 链路：`installSkillFromInstalledPackage` 在 `access` 失败时不再直接抛错，自动回退到 `installSkillFromNpmPackage`（`npm pack` + `tar -xzf` + `npx -y skills add`），覆盖包内 skill 缺失场景。
+
+### 测试
+
+- `tests/install.test.ts` 新增回归用例 `本地 skill 缺失时自动回退到 npm 包解压安装，mmd-cli 失败不阻断安装`：mock `curl` 退出码 35、stderr 含 `curl: (35) LibreSSL SSL_connect...`，断言安装链路按 `npm install -g` → 跳过 `mmd-cli` → `npm pack` → `tar` → `npx -y skills add` 顺序完成，并校验 stdout 中包含“已跳过 mmd-cli 安装”与“正在自动回退到 npm 包解压安装”两行提示。
+
+### 说明
+
+- 本次热修不改变 `mmd-cli` 运行时仍需系统 Chrome/Chromium 的前提；网络环境下无法自动安装 `mmd-cli` 时，建议用户改用 `--mermaid none` 保留代码块。
+- 验证结果：`pnpm test -- tests/install.test.ts tests/skill.test.ts tests/tools/transfer.test.ts` 全部通过（3 个文件、10 个测试）。
+
+## 0.0.4 - 2026-06-17
+
+### 修复
+
+- Mermaid 渲染器从 `@mermaid-js/mermaid-cli` 全量替换为 `coolamit/mermaid-cli` 的原生二进制 `mmd-cli`，不再保留 `mmdc` / Puppeteer 兼容路径。
+- `install` / `update` 链路会自动执行上游 `mmd-cli` 安装脚本，避免 npm 安装阶段拉取 Chrome 失败。
+- `uninstall` 链路会一并清理 `~/.local/bin/mmd-cli` 和 `/usr/local/bin/mmd-cli`。
+- `uploadMarkdown` 的 Mermaid 附件匹配逻辑改为优先按预期文件名命中，减少多附件场景下图片宏指向错误的问题。
+
+### 测试
+
+- `tests/install.test.ts` 新增 `mmd-cli` 安装步骤断言，覆盖 install / update 流程。
+- `tests/tools/transfer.test.ts` 新增 Mermaid 渲染调用测试，校验 `mmd-cli` 的输入、输出、背景和缩放参数。
+
+### 说明
+
+- `mmd-cli` 运行时仍要求系统已有 Chrome/Chromium；如果目标机器没有浏览器，可在上传时传 `--mermaid none`，保留 Mermaid 代码块。
+
 ## 0.0.3 - 2026-06-16
 
 ### Fixed

package/README.md

@@ -21,6 +21,15 @@ pnpm test
 pnpm release:smoke-query --dry-run
 ```
 
+从 `0.0.4` 起，Mermaid 渲染不再依赖 `@mermaid-js/mermaid-cli`。CLI 安装/更新时会自动安装 `coolamit/mermaid-cli` 提供的原生二进制 `mmd-cli`，避开 Puppeteer/Chrome 下载链路，并在卸载时清理常见安装位置下的 `mmd-cli` 二进制。
+
+`mmd-cli` 运行时仍需要系统已有 Chrome/Chromium；如果机器完全没有浏览器，可在上传时传 `--mermaid none`，保留 Mermaid 代码块。
+
+从 `0.0.5` 起，`install` / `update` 在以下两种情况会**继续完成安装**而不是中断：
+
+- `mmd-cli` 官方安装脚本因网络问题失败时，会打印 `已跳过 mmd-cli 安装：<原因>` 与 `后续如需 Mermaid 图片渲染，可稍后重试安装，或在上传时传 --mermaid none 保留代码块。`。
+- 全局包内 `skills/confluence-cli` 缺失时，会打印 `未找到已安装包内的 Confluence skill：<path>，正在自动回退到 npm 包解压安装...` 并自动用 `npm pack` + `tar` + `npx -y skills add` 完成 skill 安装，无需手动切换 `--skill-source npm`。
+
 安装/更新入口：
 
 ```bash
@@ -132,7 +141,7 @@ CONFLUENCE_SKIP_UPDATE_CHECK=true
 - Confluence 7.13.7 全量 REST API 端点注册与通用调用
 - MCP 页面/子页/评论/标签能力的语义化 CLI 命令
 - Markdown 转 Confluence Wiki Markup
-- Markdown/HTML 上传时默认用 `mermaid-cli` 将 Mermaid 渲染为 PNG 附件并以内置图片宏展示，必要时可用 `--mermaid none` 保留原代码块
+- Markdown/HTML 上传时默认用 `mmd-cli` 将 Mermaid 渲染为 PNG 附件并以内置图片宏展示，必要时可用 `--mermaid none` 保留原代码块
 - mark 风格 metadata 生成
 - Markdown 上传预览、确认写入和附件上传
 - 页面下载为带 frontmatter 的 Markdown，并可下载附件和一层子页
@@ -143,7 +152,7 @@ CONFLUENCE_SKIP_UPDATE_CHECK=true
 
 `.opencode/opencode.json` 提供了两个项目级 OpenCode 命令：
 
-- `release`：复刻 zentao-cli 的 `/release` 流程，按 12 步固定顺序准备发布；默认手动发包，**未经再次授权不会执行 `npm publish`、`git push`、打 tag 或创建 GitHub Release**。
+- `release`：复刻 zentao-cli 的 `/release` 流程，按 14 步固定顺序准备发布；默认手动发包，**未经再次授权不会执行 `npm publish`、`git push`、打 tag 或创建 GitHub Release**。
 - `smoke`：检查当前 CLI 的烟测与验证入口（`pnpm release:smoke-query --dry-run`、`pnpm typecheck`、`pnpm build` 等）。
 
 修改 `.opencode/opencode.json` 后，需要退出并重启 OpenCode 才能生效。

package/dist/install.js

@@ -7,6 +7,7 @@ import { loadConfluenceConfig, normalizeConfig, saveConfig } from "./core/config
 import { writeUpdateCacheAfterInstall } from "./update-probe.js";
 const PACKAGE_NAME = "@cloudglab/confluence-cli";
 const GIT_SKILL_SOURCE = "cloudglab/confluence-cli";
+const MMD_CLI_INSTALL_URL = "https://raw.githubusercontent.com/coolamit/mermaid-cli/master/install.sh";
 export async function runInstallCommand(args = []) {
     const options = parseInstallOptions(args);
     await installPackageAndSkill("安装", options);
@@ -56,6 +57,7 @@ function printSuccessGuide(action, status) {
   confluence update                       更新 CLI 和 Skill
   confluence install --skip-config-check  仅安装，跳过配置校验
   confluence install --skill-global       把 skill 装到 user-level 全局目录
+  mmd-cli --version                       检查 Mermaid 渲染器
   CONFLUENCE_DISABLE_WRITE=true           禁用真实写操作
 
 写操作提示：真实写入仍需显式传 confirm=true。
@@ -158,7 +160,7 @@ function parseUninstallOptions(args) {
 function printUninstallPreview(options) {
     const steps = [
         ...(!options.cliOnly ? ["卸载 confluence skill（项目级和全局级）"] : []),
-        ...(!options.skillOnly ? ["卸载全局 CLI 包并清理 npm 残留目录"] : []),
+        ...(!options.skillOnly ? ["卸载全局 CLI 包、清理 npm 残留目录，并删除 mmd-cli 二进制"] : []),
         ...(shouldRemoveConfig(options) ? ["删除 ~/.confluence/config.json"] : ["保留 ~/.confluence/config.json"]),
     ];
     process.stdout.write(`卸载预览：\n${steps.map((step) => `  - ${step}`).join("\n")}\n\n真实执行请运行：\n  confluence uninstall --confirm true\n  npx -y ${PACKAGE_NAME}@latest uninstall --confirm true\n\n可选参数：\n  --keep-config true   保留 Confluence 配置\n  --cli-only true      只卸载 CLI\n  --skill-only true    只卸载 skill\n`);
@@ -222,6 +224,7 @@ async function installPackageAndSkill(action, options) {
     if (!options.skillOnly) {
         await cleanupGlobalPackageResidues();
         await installGlobalCli(action);
+        await installMmdCli(action);
     }
     if (!options.cliOnly) {
         await installSkill(action, options);
@@ -242,6 +245,16 @@ async function installGlobalCli(action) {
         await runStep(`${action} Confluence CLI`, "npm", args);
     }
 }
+async function installMmdCli(action) {
+    try {
+        await runStep(`${action} Mermaid 原生渲染器 mmd-cli`, "sh", ["-c", `curl -fsSL ${MMD_CLI_INSTALL_URL} | sh`]);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stdout.write(`已跳过 mmd-cli 安装：${message}\n`);
+        process.stdout.write("后续如需 Mermaid 图片渲染，可稍后重试安装，或在上传时传 --mermaid none 保留代码块。\n");
+    }
+}
 function isNpmDirectoryNotEmptyError(error) {
     const message = error instanceof Error ? error.message : String(error);
     return message.includes("ENOTEMPTY") || message.toLowerCase().includes("directory not empty");
@@ -280,7 +293,9 @@ async function installSkillFromInstalledPackage(action, skillGlobal) {
         await access(skillPath);
     }
     catch {
-        throw new Error(`未找到已安装包内的 Confluence skill：${skillPath}。可重试 --skill-source npm 或 --skill-source git。`);
+        process.stdout.write(`未找到已安装包内的 Confluence skill：${skillPath}，正在自动回退到 npm 包解压安装...\n`);
+        await installSkillFromNpmPackage(action, skillGlobal);
+        return;
     }
     await runNpxStepWithRetry(`${action} Confluence skill`, createSkillAddArgs(skillPath, skillGlobal));
 }
@@ -311,6 +326,11 @@ async function uninstallSkill() {
 async function uninstallPackage() {
     await runStep("卸载 Confluence CLI", "npm", ["uninstall", "-g", PACKAGE_NAME]);
     await cleanupGlobalPackageResidues();
+    await removeMmdCliBinary();
+}
+async function removeMmdCliBinary() {
+    await rm(path.join(os.homedir(), ".local", "bin", "mmd-cli"), { force: true });
+    await rm("/usr/local/bin/mmd-cli", { force: true });
 }
 async function cleanupGlobalPackageResidues() {
     const globalNodeModules = (await runCommandOutput("npm", ["root", "-g"])).trim();
@@ -370,7 +390,7 @@ async function runStep(title, command, args) {
 }
 function runCommand(command, args) {
     return new Promise((resolve, reject) => {
-        const child = spawn(command, args, { shell: process.platform === "win32" });
+        const child = spawn(command, args, { shell: process.platform === "win32", env: createInstallEnv() });
         let stderr = "";
         child.stdout?.pipe(process.stdout);
         child.stderr?.on("data", (chunk) => {
@@ -389,7 +409,7 @@ function runCommand(command, args) {
 }
 function runCommandOutput(command, args) {
     return new Promise((resolve, reject) => {
-        const child = spawn(command, args, { shell: process.platform === "win32" });
+        const child = spawn(command, args, { shell: process.platform === "win32", env: createInstallEnv() });
         let stdout = "";
         let stderr = "";
         child.stdout?.on("data", (chunk) => { stdout += chunk.toString("utf8"); });
@@ -404,6 +424,12 @@ function runCommandOutput(command, args) {
         });
     });
 }
+function createInstallEnv() {
+    return {
+        ...process.env,
+        CI: process.env.CI ?? "true",
+    };
+}
 function renderBanner() {
     return [
         "   ___       ___       ___       ___       ___       ___       ___       ___       ___       ___   ",

package/dist/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.3",
+  "version": "0.0.5",
   "commands": [
     "addComment",
     "addLabels",

package/dist/tools/transfer.js

@@ -171,10 +171,9 @@ function applyMermaidImageMacros(body, generatedFiles, uploadedAttachments) {
     for (let index = 0; index < generatedFiles.length; index += 1) {
         const generated = generatedFiles[index];
         const uploaded = uploadedAttachments[index];
-        const attachment = readUploadedAttachment(uploaded?.result);
-        if (!attachment)
-            continue;
-        const macro = buildImageMacro(attachment.title ?? generated.attachmentName);
+        const attachment = readUploadedAttachment(uploaded?.result, generated.attachmentName);
+        const filename = attachment?.title ?? generated.attachmentName;
+        const macro = buildImageMacro(filename);
         output = output.replaceAll(`<p>${generated.marker}</p>`, macro).replaceAll(generated.marker, macro);
     }
     return output;
@@ -182,11 +181,17 @@ function applyMermaidImageMacros(body, generatedFiles, uploadedAttachments) {
 function buildImageMacro(filename) {
     return `<ac:image><ri:attachment ri:filename="${escapeXml(filename)}" /></ac:image>`;
 }
-function readUploadedAttachment(value) {
+function readUploadedAttachment(value, expectedTitle) {
     if (typeof value !== "object" || value === null)
         return undefined;
     if ("results" in value && Array.isArray(value.results)) {
-        return value.results?.[0];
+        const list = value.results ?? [];
+        if (expectedTitle) {
+            const matched = list.find((entry) => entry?.title === expectedTitle);
+            if (matched)
+                return matched;
+        }
+        return list[0];
     }
     if ("id" in value)
         return value;
@@ -377,29 +382,29 @@ function createMermaidFile(mermaidSource, pageTitle, sourceFile, idx, renderKind
 function renderMermaidFile(mermaidSource, outputFile, renderKind) {
     const inputFile = join(dirname(outputFile), `${basename(outputFile, extname(outputFile))}.mmd`);
     writeFileSync(inputFile, mermaidSource, "utf8");
-    const mmdc = resolveMmdcBin();
+    const mmdCli = resolveMmdCliBin();
     const args = ["-i", inputFile, "-o", outputFile, "-b", "transparent"];
     if (renderKind === "png") {
-        args.push("--scale", "3");
+        args.push("-s", "3");
     }
     try {
-        execFileSync(mmdc, args, { stdio: "pipe" });
+        execFileSync(mmdCli, args, { stdio: "pipe" });
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Failed to render Mermaid as ${renderKind} with mermaid-cli: ${message}`);
+        throw new Error(`Failed to render Mermaid as ${renderKind} with mmd-cli: ${message}`);
     }
 }
-function resolveMmdcBin() {
-    const extension = process.platform === "win32" ? ".cmd" : "";
+function resolveMmdCliBin() {
+    const extension = process.platform === "win32" ? ".exe" : "";
     const candidates = [
-        join(process.cwd(), "node_modules", ".bin", `mmdc${extension}`),
-        join(dirname(process.argv[1] ?? process.cwd()), "..", "node_modules", ".bin", `mmdc${extension}`),
+        join(process.env.HOME ?? "", ".local", "bin", `mmd-cli${extension}`),
+        "/usr/local/bin/mmd-cli",
     ];
     const found = candidates.find((candidate) => existsSync(candidate));
     if (found)
         return found;
-    return `mmdc${extension}`;
+    return `mmd-cli${extension}`;
 }
 function safeFileName(value) {
     return value.replace(/[\\/:*?"<>|]/g, "_");

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.0.3";
+export declare const VERSION = "0.0.5";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.0.3";
+export const VERSION = "0.0.5";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudglab/confluence-cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Confluence REST CLI for agents and local automation",
   "repository": {
     "type": "git",
@@ -38,7 +38,6 @@
     "prepare": "node scripts/prepare.mjs"
   },
   "dependencies": {
-    "@mermaid-js/mermaid-cli": "^11.15.0",
     "@whitebite/diagram-converter": "^0.2.0",
     "axios": "^1.7.9",
     "marked": "^18.0.5",