@zzclub/pipeline 0.10.0 → 0.10.2

package/README.md

@@ -38,12 +38,13 @@ bun install --global .
 
 这是一个状态机模型，输入是任务意图、正文、图片、路由和发布要求，输出是可恢复的工作流状态、渲染产物和发布结果。
 
-当前只有两条主工作流路由：
+当前有三条主工作流路由：
 
 - `wechat-article` — 公众号文章草稿（HTML）
 - `wechat-newspic` — 公众号图片消息（PNG 卡片/图集）
+- `blog` — 将 Markdown 同步到配置的博客项目并执行发布命令
 
-`blog` 只做事后同步（`sync-blog`），不参与主工作流分支，但同步结果会写回 `workflow-state.json` 的 `publish.results`。
+`blog` 参与统一的 `prepare → publish` 工作流；作为唯一目标时跳过 render。`sync-blog` 继续保留为事后同步命令，两种路径都会把结果写回 `workflow-state.json` 的 `publish.results`。
 
 状态文件分两类：
 
@@ -374,7 +375,7 @@ src/
   wechat-preview/         # 微信文章 HTML 预览，Milkdown + 主题
     index.ts
     themes.ts
-    wechat-formatter.ts
+    wechat-renderer.ts     # 元素 renderer 注册表、CSS 内联和微信安全清理
     frontmatter-handler.ts
     browser/
       editor-export.ts
@@ -409,13 +410,15 @@ src/
 | `review` | Update content review status |
 | `abandon` | Mark one or more tasks as abandoned |
 
-`ops` 组，11 个命令：
+`ops` 组，12 个命令：
 
 | 命令 | 说明 |
 | --- | --- |
 | `sync-blog` | Copy post.md to blog repo, publish, and record result in state JSON |
+| `republish` | Publish a completed task to an additional account or platform |
 | `imgx` | Run bundled imgx renderer subcommands |
 | `wechat-export` | Render markdown to WeChat HTML with bundled preview styles |
+| `wechat-preview` | Local singleton server to preview exported WeChat HTML |
 | `cos-upload` | Upload a local image to configured COS CDN |
 | `config` | Read or update pipeline config |
 | `doctor` | Inspect resolved paths and provider health |
@@ -618,9 +621,98 @@ bun run src/cli.ts hermes-metrics --workspace /abs/workspace
 ### 微信 HTML 预览导出
 
 ```bash
-bun run src/cli.ts wechat-export --body /abs/path/body.md --account default
+bun run src/cli.ts wechat-export \
+  --markdown /abs/path/body.md \
+  --out /abs/path/article.html \
+  --account default \
+  --preview-shell-out /abs/path/article-preview.html
 ```
 
+`--preview-shell-out` 生成最终发布 HTML 的精确预览：预览页直接嵌入 `--out`
+中的内联样式片段，不再加载 Milkdown 编辑器或复制浏览器 bundle。
+
+默认会将导出结果登记到本地 **单例预览服务**（`http://127.0.0.1:18765`），可在浏览器
+侧栏切换多篇产物，无需发到微信草稿箱。服务未启动时会自动拉起；失败导出也会登记并展示
+`error_kind` / timeout / Chrome stderr 等调试信息。
+
+```bash
+# 显式启动预览服务（全局只允许一个实例；重复启动会复用）
+bun run src/cli.ts wechat-preview serve --open
+
+# 导出并打开该条目
+bun run src/cli.ts wechat-export \
+  --markdown /abs/path/body.md \
+  --out /tmp/article.html \
+  --account default \
+  --open
+
+# 调试中间产物
+bun run src/cli.ts wechat-export \
+  --markdown /abs/path/body.md \
+  --out /tmp/article.html \
+  --debug-dir /tmp/wx-debug \
+  --timeout-ms 20000
+
+# 关闭预览登记
+bun run src/cli.ts wechat-export ... --no-preview
+```
+
+| 子命令 | 说明 |
+| --- | --- |
+| `wechat-preview serve` | 启动/复用单例服务 |
+| `wechat-preview status` | 是否在运行 |
+| `wechat-preview open` | 打开 dashboard |
+| `wechat-preview list` | 列出条目 |
+| `wechat-preview clear` | 清空条目 |
+
+环境变量：`ZZHUB_WECHAT_PREVIEW_PORT`（默认 18765）、`ZZHUB_WECHAT_PREVIEW_HOST`、
+`ZZHUB_WECHAT_PREVIEW_DIR`（锁与条目落盘目录）。发布草稿时默认也会登记一条
+`[publish] ...` 预览；设 `ZZHUB_WECHAT_PREVIEW_ON_PUBLISH=0` 可关闭。
+
+源码（CSS/browser 入口）新于 dist 时会自动尝试 rebuild；失败则回退已有 bundle 并标记
+`bundle_stale`。手动重建：`bun run build:wechat-preview`。
+
+#### 自定义 CSS
+
+可以通过账号配置或 CLI 覆盖内置样式：
+
+```json
+{
+  "wx": {
+    "accounts": {
+      "default": {
+        "customCss": "./themes/default-wechat.css"
+      }
+    }
+  }
+}
+```
+
+```bash
+bun run src/cli.ts wechat-export \
+  --markdown /abs/path/body.md \
+  --out /abs/path/article.html \
+  --custom-css ./local-wechat.css
+```
+
+样式优先级固定为：内置排版 CSS → 账号主题令牌 → 账号 `customCss`。传入
+`--custom-css` 时，它会替代账号 `customCss`。CLI 相对路径按当前工作目录解析，
+配置中的相对路径按 `config.json` 所在目录解析。
+
+推荐使用语义标签或稳定节点钩子：
+
+```css
+.milkdown .editor p { line-height: 1.9; }
+.milkdown .editor h2 { color: #a94473; }
+.milkdown .editor [data-wechat-node="inline-code"] { background: #f7eef2; }
+.milkdown .editor [data-wechat-node="image-caption"] { font-size: 13px; }
+```
+
+`.milkdown .editor` 只是 CSS 内联阶段的兼容包装；最终 HTML 会移除 `class` 和
+`data-wechat-node`。外部 CSS 支持变量、层叠和常规选择器，随后由 Juice 解析为
+内联样式。最终片段只保留微信稳定标签、图片/链接/表格必要属性和保守 CSS；
+脚本、事件属性、外部 `<style>`、未解析变量、`flex`/`grid`、定位和伪元素都会被移除。
+
 ### COS 图片上传
 
 ```bash
@@ -796,10 +888,23 @@ bun run src/cli.ts init ... --note-id NOTE_ID
 
 ## wechat-preview 子系统
 
-- 基于 Milkdown 的 markdown 到微信 HTML 转换
-- 支持多主题
+- 基于 Milkdown core + CommonMark/GFM 生成语义 HTML，不读取 Crepe/CodeMirror 可视 DOM
+- 固定管线：Markdown → Milkdown HTML → 元素 renderer prepare → Juice 内联 → renderer finalize → 微信白名单清理
+- 元素 renderer 覆盖段落/标题、强调、行内代码、代码块、引用、图片标题、链接脚注、列表、表格、分隔线和页脚
+- 内置默认采用“静默编辑”：深色标题、低装饰引用和中性行内代码，品牌色只用于链接等识别点
+- `default` 与 `ancientone` 共用排版骨架，只通过主题令牌切换品牌色、字体栈和页脚
 - 构建命令：`bun run build:wechat-preview`
-- `wechat-export` 会直接使用这套预览样式
+- `wechat-export` 和微信草稿发布使用同一份最终内联 HTML
+
+`@zzclub/milkdown-article-style`（`article.css`）会通过 Vite 以 raw CSS 打入浏览器
+bundle。修改该 CSS 或浏览器 renderer 后必须执行：
+
+```bash
+bun run build:wechat-preview
+bun install --global .
+```
+
+全局 `zzp` 使用编译产物；只修改源码而不重新全局安装不会更新全局命令。
 
 ## 插件系统
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zzclub/pipeline",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "type": "module",
   "bin": {
     "zzp": "./src/cli.ts",
@@ -25,6 +25,7 @@
   },
   "dependencies": {
     "@chenglou/pretext": "^0.0.5",
+    "@zzclub/milkdown-article-style": "0.1.1",
     "image-size": "^2.0.2",
     "pngjs": "^7.0.0",
     "zod": "^4.4.2"
@@ -34,12 +35,11 @@
     "cos-nodejs-sdk-v5": "^2.15.4"
   },
   "devDependencies": {
-    "@milkdown/crepe": "^7.18.0",
-    "@milkdown/plugin-listener": "^7.18.0",
-    "@milkdown/utils": "^7.18.0",
+    "@milkdown/kit": "^7.18.0",
     "@types/bun": "latest",
     "@types/pngjs": "^6.0.5",
     "changelogen": "^0.6.2",
+    "juice": "11.1.1",
     "typescript": "^5.7.0",
     "vite": "^7.1.10"
   }

package/src/adapter-types.ts

@@ -143,6 +143,12 @@ export interface MarkdownRenderInput {
     editorVars?: Record<string, string>;
     exportTheme?: Record<string, string>;
   };
+
+  /** Chrome virtual-time-budget in ms */
+  timeoutMs?: number;
+
+  /** Write intermediate artifacts for debugging */
+  debugDir?: string;
 }
 
 /**
@@ -164,6 +170,21 @@ export interface MarkdownRenderOutput {
 
   /** Path to preview shell HTML (if generated) */
   previewShellPath?: string;
+
+  /** Wall-clock render duration */
+  durationMs?: number;
+
+  /** Whether the browser bundle was rebuilt during this render */
+  bundleRebuilt?: boolean;
+
+  /** Whether the browser bundle was stale before render */
+  bundleStale?: boolean;
+
+  /** Debug directory if requested */
+  debugDir?: string;
+
+  /** Semantic HTML from Milkdown before WeChat finalize (when available) */
+  semanticHtml?: string;
 }
 
 export interface MarkdownRenderPlugin {

package/src/adapters/builtin-markdown-renderer.ts

@@ -51,6 +51,8 @@ export const builtinMarkdownRenderer: MarkdownRenderPlugin = {
       previewShellOutPath: input.previewShellOutPath,
       customCss: input.customCss,
       themeOverrides: input.themeOverrides,
+      timeoutMs: input.timeoutMs,
+      debugDir: input.debugDir ?? undefined,
     });
 
     return {
@@ -59,6 +61,11 @@ export const builtinMarkdownRenderer: MarkdownRenderPlugin = {
       account: result.account,
       previewStyle: result.previewStyle,
       previewShellPath: result.previewShellPath,
+      durationMs: result.durationMs,
+      bundleRebuilt: result.bundleRebuilt,
+      bundleStale: result.bundleStale,
+      debugDir: result.debugDir,
+      semanticHtml: result.semanticHtml,
     };
   },
 };

package/src/cli.ts

@@ -3,6 +3,7 @@
 import { readFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
+import { getDailyLogPath, runWithCommandLog } from "./logger";
 import { formatUsage, getCommandRegistry } from "./plugins";
 
 const COMMANDS = getCommandRegistry();
@@ -36,10 +37,13 @@ async function main() {
   }
 
   try {
-    await command.handler(args.slice(1));
+    await runWithCommandLog(cmd, args.slice(1), async () => {
+      await command.handler(args.slice(1));
+    });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     console.error(`[zzhub-pipeline ${cmd}] Error: ${msg}`);
+    console.error(`[zzhub-pipeline ${cmd}] Full log: ${getDailyLogPath()}`);
     process.exit(1);
   }
 }

package/src/commands/ingest-handoff.ts

@@ -6,16 +6,12 @@ import { loadConfig, resolveWorkspacePaths, resolveWorkspaceRoot } from "../conf
 import { printResult } from "../output";
 import { resolveFullRoute } from "../routes";
 import {
-  defaultArtifacts,
   defaultContentReview,
-  defaultImages,
-  defaultMetadata,
-  defaultPhase,
-  defaultPublish,
   defaultState,
   generateRunId,
   getRunStatePath,
   readResolvedState,
+  resetDerivedState,
   writeState,
   type ContentForm,
   type HandoffAuthoringPolicy,
@@ -302,22 +298,6 @@ function routesEqual(a: WorkflowState["route"], b: WorkflowState["route"]): bool
   );
 }
 
-function resetDerivedState(state: WorkflowState): void {
-  state.mode = "active";
-  state.phase = defaultPhase();
-  state.asset_path = "";
-  state.formatted_body_path = null;
-  state.metadata = {
-    ...defaultMetadata(),
-    title: state.metadata.title,
-  };
-  state.artifacts = defaultArtifacts();
-  state.images = defaultImages();
-  state.publish = defaultPublish();
-  state.content_review = defaultContentReview();
-  state.redo_hint = null;
-}
-
 async function resolveExistingStatePath(
   workspaceRoot: string,
   handoff: ResolvedWorkflowHandoff,

package/src/commands/prepare-finalize.ts

@@ -31,6 +31,7 @@ import {
   writeState,
   getCanonicalStatePath,
 } from "../state";
+import { loadTaskState } from "../task-manager";
 import {
   extractHighlightWords,
   buildFrontmatter,
@@ -195,7 +196,7 @@ Options:
   const initialResolved = await readResolvedState(requestedStatePath);
   const releaseOperationLock = await acquireStateOperationLock(initialResolved.path);
   try {
-  const resolved = await readResolvedState(initialResolved.path);
+  const resolved = await loadTaskState(initialResolved.path);
   const statePath = resolved.path;
   const state = resolved.state;
   if (state.content_review.status !== "passed") {

package/src/commands/prepare.ts

@@ -31,10 +31,10 @@ import { printResult, renderPrepare } from "../output";
 import { resolveWorkspacePaths } from "../config";
 import {
   defaultBodyInputs,
-  readResolvedState,
   reenterPrepare,
   writeState,
 } from "../state";
+import { loadTaskState } from "../task-manager";
 import { resolveFullRoute } from "../routes";
 import { resolveAuthoring, hasStyleRequest } from "../profiles";
 import { parseAccountName, parseRoutePrimary } from "../publish-targets";
@@ -69,15 +69,16 @@ function getManagedFormattedBodyPath(workspaceRoot: string, runId: string): stri
 }
 
 function shouldPreserveExistingRoute(params: {
-  intentText: string;
+  hasExplicitPublishTargets: boolean;
+  hasIntentOverride: boolean;
   routeOverride?: RoutePrimary;
   extrasRaw?: string;
   accountOverride?: string;
   assetPath: string;
 }): boolean {
   return (
-    Boolean(params.assetPath) &&
-    !params.intentText.trim() &&
+    (params.hasExplicitPublishTargets || Boolean(params.assetPath)) &&
+    !params.hasIntentOverride &&
     !params.routeOverride &&
     !params.extrasRaw &&
     !params.accountOverride
@@ -130,10 +131,11 @@ Options:
     : undefined;
 
   // Read state and body
-  const resolved = await readResolvedState(requestedStatePath);
+  const resolved = await loadTaskState(requestedStatePath);
   const statePath = resolved.path;
   const state = resolved.state;
-  const intentText = optionalArg(parsed, "intent-text") ?? state.intent.intent_text ?? "";
+  const intentTextOverride = optionalArg(parsed, "intent-text");
+  const intentText = intentTextOverride ?? state.intent.intent_text ?? "";
   const resolvedBodyPath = bodyPath
     ? await stageManagedBodyFile(state.workspace_root, state.run_id, bodyPath)
     : state.source_body_path;
@@ -142,9 +144,18 @@ Options:
   }
   const bodyRaw = await readFile(resolvedBodyPath, "utf-8");
   const cleanBody = stripFrontmatter(bodyRaw);
+  const incomingBody = Boolean(bodyPath);
+  // A newly supplied body satisfies a pending writer/style revision. Clearing
+  // these hints prevents status from looping back to revise-content after the
+  // body has already been handed in via prepare --body. (format/asset-meta/
+  // channel-route hints are cleared below after prepare runs their steps.)
+  const effectiveRedoHint = incomingBody &&
+      (state.redo_hint === "writer" || state.redo_hint === "style")
+    ? null
+    : state.redo_hint;
   reenterPrepare(state, {
-    redoHint: state.redo_hint,
-    resetReview: Boolean(bodyPath),
+    redoHint: effectiveRedoHint,
+    resetReview: incomingBody,
   });
   if (bodyPath && state.handoff.review_policy === "trust_user") {
     state.content_review = { status: "passed", feedback: null };
@@ -154,7 +165,8 @@ Options:
 
   // ── Step 1: Channel route (1st pass) ──
   const route = shouldPreserveExistingRoute({
-    intentText,
+    hasExplicitPublishTargets: state.publish_targets.length > 0,
+    hasIntentOverride: intentTextOverride !== undefined,
     routeOverride,
     extrasRaw,
     accountOverride,
@@ -177,16 +189,15 @@ Options:
     state.route.highlight_words = highlightWordsOverride;
   }
 
-  // Re-derive requires.render and requires.publish based on resolved route.
-  // requires.research is intentional (set at init from user request), not touched here.
-  // Same for render/publish: if the orchestrator set them at init, keep that value.
-  // wechat-article always needs render regardless.
-  state.intent.requires.render =
-    state.intent.requires.render ||
-    route.primary === "wechat-article";
-  state.intent.requires.publish =
-    state.intent.requires.publish ||
-    state.intent.task_kind === "publish";
+  // Re-derive requires.render and requires.publish deterministically from the
+  // resolved route/task kind rather than OR-accumulating: a flag set true for a
+  // previous route must not linger after the route changes (e.g. switching a
+  // task to blog-only would otherwise keep requires.render=true forever).
+  // requires.research is intentional (set at init from the user request) and is
+  // intentionally not recomputed here.
+  const allRoutes = [route.primary, ...route.extras];
+  state.intent.requires.render = allRoutes.some((r) => r !== "blog");
+  state.intent.requires.publish = state.intent.task_kind === "publish";
 
   // ── Step 2: Author select ──
   const styleRequest =

package/src/commands/publish.ts

@@ -33,7 +33,7 @@ import {
   executePublishTargets,
   upsertPublishResult,
 } from "../providers/publish-core";
-import { reconcileStateArtifacts } from "../workflow-materials";
+import { loadTaskState } from "../task-manager";
 
 export async function publish(args: string[]): Promise<void> {
   const parsed = parseArgs(args);
@@ -60,10 +60,9 @@ Options:
   const initialResolved = await readResolvedState(requestedStatePath);
   const releaseOperationLock = await acquireStateOperationLock(initialResolved.path);
   try {
-  const resolved = await readResolvedState(initialResolved.path);
+  const resolved = await loadTaskState(initialResolved.path);
   const statePath = resolved.path;
   const state = resolved.state;
-  await reconcileStateArtifacts(state);
   const config = loadConfig();
   const workspacePaths = resolveWorkspacePaths(state.workspace_root, config);
 

package/src/commands/reconcile.ts

@@ -1,8 +1,7 @@
 import { parseArgs, requireArg } from "../args";
 import { printResult, renderTaskShape } from "../output";
-import { readResolvedState, writeState } from "../state";
-import { getTaskByStatePath } from "../task-manager";
-import { reconcileStateArtifacts } from "../workflow-materials";
+import { writeState } from "../state";
+import { getTaskByStatePath, loadTaskState } from "../task-manager";
 
 export async function reconcile(args: string[]): Promise<void> {
   const parsed = parseArgs(args);
@@ -18,10 +17,9 @@ Options:
   }
 
   const requestedStatePath = requireArg(parsed, "state", "state JSON path");
-  const resolved = await readResolvedState(requestedStatePath);
+  const resolved = await loadTaskState(requestedStatePath);
   const statePath = resolved.path;
   const state = resolved.state;
-  await reconcileStateArtifacts(state);
   await writeState(statePath, state);
 
   const task = await getTaskByStatePath(statePath);

package/src/commands/render.ts

@@ -31,6 +31,7 @@ import {
   type NewspicRenderSpec,
   type WorkflowState,
 } from "../state";
+import { loadTaskState } from "../task-manager";
 import {
   stripFrontmatter,
   generateCoverTitle,
@@ -66,7 +67,7 @@ Options:
   const initialResolved = await readResolvedState(requestedStatePath);
   const releaseOperationLock = await acquireStateOperationLock(initialResolved.path);
   try {
-  const resolved = await readResolvedState(initialResolved.path);
+  const resolved = await loadTaskState(initialResolved.path);
   const statePath = resolved.path;
   const state = resolved.state;
 

package/src/commands/republish.ts

@@ -35,7 +35,7 @@ import {
   executePublishTargets,
   upsertPublishResult,
 } from "../providers/publish-core";
-import { reconcileStateArtifacts } from "../workflow-materials";
+import { loadTaskState } from "../task-manager";
 
 export async function republish(args: string[]): Promise<void> {
   const parsed = parseArgs(args);
@@ -75,10 +75,9 @@ Examples:
   const initialResolved = await readResolvedState(requestedStatePath);
   const releaseOperationLock = await acquireStateOperationLock(initialResolved.path);
   try {
-  const resolved = await readResolvedState(initialResolved.path);
+  const resolved = await loadTaskState(initialResolved.path);
   const statePath = resolved.path;
   const state = resolved.state;
-  await reconcileStateArtifacts(state);
   const config = loadConfig();
   const workspacePaths = resolveWorkspacePaths(state.workspace_root, config);
 

package/src/commands/reset.ts

@@ -22,6 +22,7 @@
 import { parseArgs, requireArg } from "../args";
 import { printResult, renderReset } from "../output";
 import {
+  acquireStateOperationLock,
   defaultContentReview,
   readResolvedState,
   reenterPrepare,
@@ -29,6 +30,7 @@ import {
   reenterRender,
   writeState,
 } from "../state";
+import { loadTaskState } from "../task-manager";
 
 type ResetMode =
   | "content"
@@ -84,7 +86,10 @@ Modes:
     );
   }
 
-  const resolved = await readResolvedState(requestedStatePath);
+  const initialResolved = await readResolvedState(requestedStatePath);
+  const releaseOperationLock = await acquireStateOperationLock(initialResolved.path);
+  try {
+  const resolved = await loadTaskState(initialResolved.path);
   const statePath = resolved.path;
   const state = resolved.state;
 
@@ -149,4 +154,7 @@ Modes:
   };
 
   printResult(output, renderReset);
+  } finally {
+    await releaseOperationLock();
+  }
 }

package/src/commands/review.ts

@@ -17,7 +17,8 @@
 
 import { parseArgs, requireArg, optionalArg } from "../args";
 import { printResult, renderReview } from "../output";
-import { readResolvedState, writeState, type ContentReviewStatus } from "../state";
+import { writeState, type ContentReviewStatus } from "../state";
+import { loadTaskState } from "../task-manager";
 
 const VALID_STATUSES: ContentReviewStatus[] = [
   "passed",
@@ -59,7 +60,7 @@ Statuses:
     );
   }
 
-  const resolved = await readResolvedState(requestedStatePath);
+  const resolved = await loadTaskState(requestedStatePath);
   const statePath = resolved.path;
   const state = resolved.state;
 

package/src/commands/sync-blog.ts

@@ -6,6 +6,7 @@ import {
   readResolvedState,
   updateState,
 } from "../state";
+import { loadTaskState } from "../task-manager";
 import { publishBlogRoute } from "../providers/blog";
 
 export async function syncBlog(args: string[]): Promise<void> {
@@ -31,7 +32,7 @@ Options:
   const initialResolved = await readResolvedState(requestedStatePath);
   const releaseOperationLock = await acquireStateOperationLock(initialResolved.path);
   try {
-  const resolved = await readResolvedState(initialResolved.path);
+  const resolved = await loadTaskState(initialResolved.path);
   const statePath = resolved.path;
   const state = resolved.state;
 

package/src/commands/wechat-export.test.ts

@@ -0,0 +1,41 @@
+import { describe, expect, test } from "bun:test";
+import { resolveConfigRelativePath } from "../config";
+import { resolveWechatExportCustomCss } from "./wechat-export";
+
+describe("wechat-export custom CSS path precedence", () => {
+  const configPath = "/workspace/config/config.json";
+
+  test("resolves configured CSS relative to the config file", () => {
+    expect(resolveConfigRelativePath("themes/account.css", configPath)).toBe(
+      "/workspace/config/themes/account.css",
+    );
+  });
+
+  test("keeps an absolute configured CSS path", () => {
+    expect(resolveConfigRelativePath("/opt/zzhub/account.css", configPath)).toBe(
+      "/opt/zzhub/account.css",
+    );
+  });
+
+  test("uses account CSS when the CLI override is absent", () => {
+    expect(resolveWechatExportCustomCss(
+      undefined,
+      "themes/account.css",
+      "/workspace/post",
+      configPath,
+    )).toBe("/workspace/config/themes/account.css");
+  });
+
+  test("CLI CSS replaces account CSS and resolves from the current directory", () => {
+    expect(resolveWechatExportCustomCss(
+      "./local.css",
+      "themes/account.css",
+      "/workspace/post",
+      configPath,
+    )).toBe("/workspace/post/local.css");
+  });
+
+  test("returns null when neither source configures CSS", () => {
+    expect(resolveWechatExportCustomCss(undefined, null, "/workspace/post", configPath)).toBeNull();
+  });
+});