@zzclub/pipeline 0.10.2 → 0.11.0

package/README.md

@@ -410,7 +410,7 @@ src/
 | `review` | Update content review status |
 | `abandon` | Mark one or more tasks as abandoned |
 
-`ops` 组，12 个命令：
+`ops` 组，11 个命令：
 
 | 命令 | 说明 |
 | --- | --- |
@@ -425,8 +425,6 @@ src/
 | `hermes-metrics` | Show Hermes execution metrics per task |
 | `wx-drafts` | List or get drafts from WeChat draft box |
 | `wx-draft-delete` | Delete a draft from WeChat draft box |
-| `topic` | 选题管理（添加、列表、更新、排期、复盘、放弃） |
-| `analytics` | 发布数据录入和分析 |
 
 ## 常用命令
 
@@ -521,75 +519,6 @@ bun run src/cli.ts reset --state {state_path} --mode full         # 完全放弃
 
 每种模式均会设置 `redo_hint`，确保 Agent 恢复时知道从哪个子步骤开始。
 
-### 选题管理
-
-使用 `topic` 命令管理内容选题的完整生命周期：
-
-```bash
-# 添加选题
-bun run src/cli.ts topic add \
-  --workspace {workspace} \
-  --title "AI 工具推荐" \
-  --priority high \
-  --tags "AI,工具"
-
-# 列出选题
-bun run src/cli.ts topic list --workspace {workspace}
-bun run src/cli.ts topic list --workspace {workspace} --status backlog --priority high
-
-# 更新选题（AI 评估）
-bun run src/cli.ts topic update \
-  --workspace {workspace} \
-  --topic {topic_id} \
-  --ai-score 85 \
-  --ai-reason "基于热点趋势和受众匹配度"
-
-# 排期
-bun run src/cli.ts topic schedule \
-  --workspace {workspace} \
-  --topic {topic_id} \
-  --scheduled-date 2026-06-15 \
-  --target-account default
-
-# 复盘（发布后）
-bun run src/cli.ts topic retro \
-  --workspace {workspace} \
-  --topic {topic_id} \
-  --performance good \
-  --lessons "标题悬念效果好" \
-  --metrics-snapshot '{"reads": 1500, "likes": 45}'
-
-# 放弃选题
-bun run src/cli.ts topic abandon \
-  --workspace {workspace} \
-  --topic {topic_id} \
-  --reason "话题过时"
-```
-
-选题状态流转：`backlog` → `evaluating` → `scheduled` → `in_progress` → `published`（或 `abandoned`）
-
-### 数据分析
-
-使用 `analytics` 命令录入和分析发布后的数据：
-
-```bash
-# 录入发布数据
-bun run src/cli.ts analytics record \
-  --state {workspace}/posts/{date-slug}/workflow-state.json \
-  --reads 1500 \
-  --likes 45 \
-  --favorites 23 \
-  --shares 12 \
-  --comments 8 \
-  --notes "标题效果好，转化率高"
-
-# 列出历史数据
-bun run src/cli.ts analytics list --workspace {workspace}
-bun run src/cli.ts analytics list --workspace {workspace} --days 30 --sort reads
-```
-
-数据存储在 `{workspace}/zzhub.db`（SQLite 数据库），支持复杂查询和统计分析。
-
 ### Blog 同步
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zzclub/pipeline",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "type": "module",
   "bin": {
     "zzp": "./src/cli.ts",

package/src/commands/config.ts

@@ -5,13 +5,17 @@ import {
   configSummary,
   getConfigValue,
   loadConfig,
-  PipelineConfigSchema,
+  normalizeConfig,
   redactConfig,
   redactConfigValue,
   saveConfig,
   setConfigValue,
 } from "../config";
 
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 export async function configCommand(args: string[]): Promise<void> {
   const parsed = parseArgs(args);
 
@@ -26,6 +30,11 @@ Options:
   --export     Print full config as JSON (secrets redacted; use --raw to show all)
   --import     Path to a JSON file to merge into current config
   --raw        Show secrets unredacted (use with --export)
+
+Examples:
+  zzhub-pipeline config --key wx.defaultAccount
+  zzhub-pipeline config --key wx.accounts.default.name --value "大号（早早集市）"
+  zzhub-pipeline config --export
 `.trim());
     return;
   }
@@ -50,27 +59,45 @@ Options:
       throw new Error(`Failed to read import file: ${err instanceof Error ? err.message : String(err)}`);
     }
 
-    // Merge: existing values win, imported fills gaps
-    const importedObj = (typeof imported === "object" && imported !== null ? imported : {}) as Record<string, unknown>;
-    const mergedWx = {
-      ...config.wx,
-      ...(importedObj.wx as Record<string, unknown> ?? {}),
-      accounts: {
-        ...config.wx.accounts,
-        ...((importedObj.wx as Record<string, unknown>)?.accounts as Record<string, unknown> ?? {}),
-      },
-    };
+    // Merge: top-level shallow; wx.accounts deep-merge per key so partial imports
+    // keep existing fields (e.g. display `name`) unless overridden.
+    const importedObj = isPlainObject(imported) ? imported : {};
+    const importedWx = isPlainObject(importedObj.wx) ? importedObj.wx : {};
+    const importedAccounts = isPlainObject(importedWx.accounts) ? importedWx.accounts : {};
+    const mergedAccounts: Record<string, unknown> = { ...config.wx.accounts };
+    for (const [key, value] of Object.entries(importedAccounts)) {
+      const accountKey = key.trim();
+      if (!accountKey) continue;
+      const existing = isPlainObject(mergedAccounts[accountKey])
+        ? mergedAccounts[accountKey]
+        : {};
+      const incoming = isPlainObject(value) ? value : {};
+      mergedAccounts[accountKey] = { ...existing, ...incoming };
+    }
     const raw = {
-      paths: { ...config.paths, ...(importedObj.paths ?? {}) },
-      services: { ...config.services, ...(importedObj.services ?? {}) },
-      commands: { ...config.commands, ...(importedObj.commands ?? {}) },
-      wx: mergedWx,
-      cos: { ...config.cos, ...(importedObj.cos ?? {}) },
-      plugins: { ...config.plugins, ...(importedObj.plugins ?? {}) },
-      imgx: { ...config.imgx, ...(importedObj.imgx ?? {}) },
+      paths: { ...config.paths, ...(isPlainObject(importedObj.paths) ? importedObj.paths : {}) },
+      services: {
+        ...config.services,
+        ...(isPlainObject(importedObj.services) ? importedObj.services : {}),
+      },
+      commands: {
+        ...config.commands,
+        ...(isPlainObject(importedObj.commands) ? importedObj.commands : {}),
+      },
+      wx: {
+        ...config.wx,
+        ...importedWx,
+        accounts: mergedAccounts,
+      },
+      cos: { ...config.cos, ...(isPlainObject(importedObj.cos) ? importedObj.cos : {}) },
+      plugins: {
+        ...config.plugins,
+        ...(isPlainObject(importedObj.plugins) ? importedObj.plugins : {}),
+      },
+      imgx: { ...config.imgx, ...(isPlainObject(importedObj.imgx) ? importedObj.imgx : {}) },
     };
-    // Validate through Zod schema — strips unknown fields, applies defaults
-    const merged = PipelineConfigSchema.parse(raw);
+    // Soft-fill known account display names + Zod defaults / strip unknowns
+    const merged = normalizeConfig(raw);
 
     saveConfig(merged);
     printResult(configSummary(merged), renderConfig);

package/src/config.ts

@@ -43,6 +43,15 @@ export interface ResolvedWorkspacePaths {
 
 const DEFAULT_WX_ACCOUNT_NAME = "default";
 
+/**
+ * Soft display names for known account keys when `name` is missing/empty.
+ * Never overrides a user-set name.
+ */
+export const SUGGESTED_ACCOUNT_NAMES: Record<string, string> = {
+  default: "大号（早早集市）",
+  ancientone: "小号（古一）",
+};
+
 export const DEFAULT_CONFIG: PipelineConfig = PipelineConfigSchema.parse({});
 
 const PIPELINE_CONFIG_DIR = "zzhub-pipeline";
@@ -104,8 +113,9 @@ export function getLegacyZCliConfigPath(): string {
 /**
  * Merge source config with legacy config, then normalize through Zod schema.
  * Legacy values fill gaps where source has nothing.
+ * Soft-fills known account display `name` only when missing/empty.
  */
-function normalizeConfig(value: unknown, legacyValue?: unknown): PipelineConfig {
+export function normalizeConfig(value: unknown, legacyValue?: unknown): PipelineConfig {
   const source = isPlainObject(value) ? value : {};
   const legacy = isPlainObject(legacyValue) ? legacyValue : {};
 
@@ -122,7 +132,16 @@ function normalizeConfig(value: unknown, legacyValue?: unknown): PipelineConfig
     if (!accountName) continue;
     const legacyAccount = isPlainObject(legacyAccounts[accountName]) ? legacyAccounts[accountName] : {};
     const sourceAccount = isPlainObject(sourceAccounts[accountName]) ? sourceAccounts[accountName] : {};
-    mergedAccounts[accountName] = { ...legacyAccount, ...sourceAccount };
+    const merged = { ...legacyAccount, ...sourceAccount };
+    // Trim + soft-fill display name for known keys only when missing/empty (never override user-set name).
+    if (typeof merged.name === "string") {
+      merged.name = merged.name.trim();
+    }
+    const existingName = typeof merged.name === "string" ? merged.name : "";
+    if (!existingName && SUGGESTED_ACCOUNT_NAMES[accountName]) {
+      merged.name = SUGGESTED_ACCOUNT_NAMES[accountName];
+    }
+    mergedAccounts[accountName] = merged;
   }
 
   // Merge wx config: source wins, legacy fills gaps

package/src/plugins.ts

@@ -1,5 +1,4 @@
 import { abandon } from "./commands/abandon";
-import { analytics } from "./commands/analytics";
 import { attachBody } from "./commands/attach-body";
 import { attachBodyImages } from "./commands/attach-body-images";
 import { attachNewspicSpec } from "./commands/attach-newspic-spec";
@@ -23,7 +22,6 @@ import { review } from "./commands/review";
 import { status } from "./commands/status";
 import { syncBlog } from "./commands/sync-blog";
 import { tasks } from "./commands/tasks";
-import { topic } from "./commands/topic";
 import { wechatExport } from "./commands/wechat-export";
 import { wechatPreview } from "./commands/wechat-preview";
 import { wxDrafts } from "./commands/wx-drafts";
@@ -79,8 +77,6 @@ export function getCommandPlugins(): CommandPlugin[] {
         { name: "hermes-metrics", summary: "Show Hermes execution metrics per task", plugin: "ops", handler: hermesMetrics },
         { name: "wx-drafts", summary: "List or get drafts from WeChat draft box", plugin: "ops", handler: wxDrafts },
         { name: "wx-draft-delete", summary: "Delete a draft from WeChat draft box", plugin: "ops", handler: wxDraftDelete },
-        { name: "topic", summary: "Manage topics (add, list, update, schedule, retro, abandon)", plugin: "ops", handler: topic },
-        { name: "analytics", summary: "Record and analyze post-publish metrics", plugin: "ops", handler: analytics },
       ],
     },
   ];

package/src/providers/wechat.ts

@@ -161,8 +161,10 @@ export function normalizeAccountName(value: string): string {
   return account;
 }
 
-function fillWxAccountConfig(source?: WxAccountConfig): WxAccountConfig {
+/** Fill missing wx account fields with defaults. Preserves optional display `name`. */
+export function fillWxAccountConfig(source?: WxAccountConfig): WxAccountConfig {
   return {
+    name: source?.name ?? "",
     pat: source?.pat ?? "",
     appId: source?.appId ?? "",
     appSecret: source?.appSecret ?? "",

package/src/schema/config.account-name.test.ts

@@ -0,0 +1,79 @@
+import { describe, expect, test } from "bun:test";
+
+import { normalizeConfig, SUGGESTED_ACCOUNT_NAMES } from "../config";
+import { fillWxAccountConfig } from "../providers/wechat";
+import { PipelineConfigSchema } from "./config";
+
+describe("wx account display name", () => {
+  test("schema keeps name when provided", () => {
+    const parsed = PipelineConfigSchema.parse({
+      wx: {
+        accounts: {
+          default: {
+            name: "早早集市",
+            appId: "wx123",
+          },
+        },
+      },
+    });
+    expect(parsed.wx.accounts.default?.name).toBe("早早集市");
+    expect(parsed.wx.accounts.default?.appId).toBe("wx123");
+  });
+
+  test("schema defaults name to empty string when missing", () => {
+    const parsed = PipelineConfigSchema.parse({
+      wx: {
+        accounts: {
+          custom: {
+            appId: "wx999",
+          },
+        },
+      },
+    });
+    // custom key has no soft-suggest unless normalizeConfig is used
+    expect(parsed.wx.accounts.custom?.name).toBe("");
+  });
+
+  test("normalizeConfig soft-fills known keys only when name empty", () => {
+    const normalized = normalizeConfig({
+      wx: {
+        accounts: {
+          default: { appId: "wx1" },
+          ancientone: { name: "我自定义的小号", appId: "wx2" },
+          other: { appId: "wx3" },
+        },
+      },
+    });
+    expect(normalized.wx.accounts.default?.name).toBe(SUGGESTED_ACCOUNT_NAMES.default);
+    expect(normalized.wx.accounts.ancientone?.name).toBe("我自定义的小号");
+    expect(normalized.wx.accounts.other?.name).toBe("");
+  });
+
+  test("normalizeConfig does not override explicit empty-then-set name after trim", () => {
+    const normalized = normalizeConfig({
+      wx: {
+        accounts: {
+          default: { name: "  大号定制  ", appId: "wx1" },
+        },
+      },
+    });
+    expect(normalized.wx.accounts.default?.name).toBe("大号定制");
+  });
+
+  test("fillWxAccountConfig preserves name", () => {
+    const filled = fillWxAccountConfig({
+      name: "大号",
+      pat: "p",
+      appId: "id",
+      appSecret: "s",
+      customCss: null,
+      theme: { editorVars: {}, exportTheme: {} },
+    });
+    expect(filled.name).toBe("大号");
+  });
+
+  test("fillWxAccountConfig defaults name to empty", () => {
+    const filled = fillWxAccountConfig(undefined);
+    expect(filled.name).toBe("");
+  });
+});

package/src/schema/config.ts

@@ -56,6 +56,12 @@ const WechatThemeOverridesSchema = withObjectDefault(
 );
 
 const WxAccountConfigSchema = z.object({
+  /**
+   * Optional Chinese display name for UIs (e.g. 大号（早早集市）).
+   * Config map key remains the stable account id (default / ancientone).
+   * Whitespace is trimmed in normalizeConfig when soft-filling / merging.
+   */
+  name: z.string().default(""),
   pat: z.string().default(""),
   appId: z.string().default(""),
   appSecret: z.string().default(""),
@@ -74,9 +80,9 @@ const WxConfigSchema = withObjectDefault(
       z.number().default(30000),
     ),
     defaultAccount: trimmedNonEmptyString("default"),
-    accounts: z
-      .record(z.string(), WxAccountConfigSchema)
-      .default({ default: { pat: "", appId: "", appSecret: "", customCss: null, theme: { editorVars: {}, exportTheme: {} } } }),
+    accounts: z.record(z.string(), WxAccountConfigSchema).default(() => ({
+      default: WxAccountConfigSchema.parse({}),
+    })),
   }),
 );
 

package/src/workflow.test.ts

@@ -1437,6 +1437,7 @@ describe("config", () => {
           defaultAccount: "default",
           accounts: {
             default: {
+              name: "",
               pat: "",
               appId: "",
               appSecret: "",

package/src/commands/analytics.test.ts

@@ -1,156 +0,0 @@
-import { describe, test, expect, beforeEach, afterEach } from "bun:test";
-import { mkdtemp, rm, writeFile } from "fs/promises";
-import { join } from "path";
-import { tmpdir } from "os";
-import { recordAnalytics, listAnalytics } from "./analytics";
-
-describe("analytics commands", () => {
-  let workspace: string;
-
-  beforeEach(async () => {
-    workspace = await mkdtemp(join(tmpdir(), "zzhub-test-"));
-  });
-
-  afterEach(async () => {
-    await rm(workspace, { recursive: true, force: true });
-  });
-
-  describe("recordAnalytics", () => {
-    test("records analytics from state file", async () => {
-      const statePath = join(workspace, "state.json");
-      await writeFile(statePath, JSON.stringify({
-        run_id: "run_001",
-        metadata: {
-          title: "Test Article",
-          date: "2026-06-11",
-        },
-        route: {
-          primary: "wechat-article",
-        },
-        publish: {
-          results: {
-            wechat: {
-              status: "success",
-              published_at: "2026-06-11T10:00:00Z",
-            },
-          },
-        },
-      }));
-
-      const result = await recordAnalytics({
-        statePath,
-        reads: 1500,
-        likes: 45,
-        favorites: 23,
-        shares: 12,
-        comments: 8,
-        notes: "Good performance",
-      });
-
-      expect(result.run_id).toBe("run_001");
-      expect(result.reads).toBe(1500);
-      expect(result.likes).toBe(45);
-      expect(result.favorites).toBe(23);
-      expect(result.shares).toBe(12);
-      expect(result.comments).toBe(8);
-      expect(result.notes).toBe("Good performance");
-      expect(result.title).toBe("Test Article");
-      expect(result.publish_date).toBe("2026-06-11");
-    });
-
-    test("defaults missing metrics to 0", async () => {
-      const statePath = join(workspace, "state.json");
-      await writeFile(statePath, JSON.stringify({
-        run_id: "run_002",
-        metadata: { title: "Minimal", date: "2026-06-11" },
-        route: { primary: "wechat-article" },
-        publish: { results: { wechat: { status: "success", published_at: "2026-06-11T10:00:00Z" } } },
-      }));
-
-      const result = await recordAnalytics({ statePath });
-
-      expect(result.run_id).toBe("run_002");
-      expect(result.reads).toBe(0);
-      expect(result.likes).toBe(0);
-      expect(result.favorites).toBe(0);
-      expect(result.shares).toBe(0);
-      expect(result.comments).toBe(0);
-    });
-
-    test("re-recording replaces previous entry", async () => {
-      const statePath = join(workspace, "state.json");
-      await writeFile(statePath, JSON.stringify({
-        run_id: "run_003",
-        metadata: { title: "Update Me", date: "2026-06-11" },
-        route: { primary: "wechat-article" },
-        publish: { results: { wechat: { status: "success", published_at: "2026-06-11T10:00:00Z" } } },
-      }));
-
-      await recordAnalytics({ statePath, reads: 100 });
-      const updated = await recordAnalytics({ statePath, reads: 200 });
-
-      expect(updated.reads).toBe(200);
-
-      const all = await listAnalytics(workspace, {});
-      expect(all.filter(a => a.run_id === "run_003").length).toBe(1);
-    });
-  });
-
-  describe("listAnalytics", () => {
-    test("lists all analytics", async () => {
-      const statePath1 = join(workspace, "state1.json");
-      await writeFile(statePath1, JSON.stringify({
-        run_id: "run_001",
-        metadata: { title: "Article 1", date: "2026-06-11" },
-        route: { primary: "wechat-article" },
-        publish: { results: { wechat: { status: "success", published_at: "2026-06-11T10:00:00Z" } } },
-      }));
-
-      const statePath2 = join(workspace, "state2.json");
-      await writeFile(statePath2, JSON.stringify({
-        run_id: "run_002",
-        metadata: { title: "Article 2", date: "2026-06-12" },
-        route: { primary: "wechat-article" },
-        publish: { results: { wechat: { status: "success", published_at: "2026-06-12T10:00:00Z" } } },
-      }));
-
-      await recordAnalytics({ statePath: statePath1, reads: 1000 });
-      await recordAnalytics({ statePath: statePath2, reads: 2000 });
-
-      const analytics = await listAnalytics(workspace, {});
-      expect(analytics.length).toBe(2);
-    });
-
-    test("filters by days", async () => {
-      const statePath = join(workspace, "state.json");
-      const today = new Date().toISOString().slice(0, 10);
-      await writeFile(statePath, JSON.stringify({
-        run_id: "run_001",
-        metadata: { title: "Article", date: today },
-        route: { primary: "wechat-article" },
-        publish: { results: { wechat: { status: "success", published_at: `${today}T10:00:00Z` } } },
-      }));
-
-      await recordAnalytics({ statePath, reads: 1000 });
-
-      const analytics = await listAnalytics(workspace, { days: 30 });
-      expect(analytics.length).toBe(1);
-    });
-
-    test("limits results", async () => {
-      for (let i = 0; i < 5; i++) {
-        const statePath = join(workspace, `state${i}.json`);
-        await writeFile(statePath, JSON.stringify({
-          run_id: `run_${String(i).padStart(3, "0")}`,
-          metadata: { title: `Article ${i}`, date: "2026-06-11" },
-          route: { primary: "wechat-article" },
-          publish: { results: { wechat: { status: "success", published_at: "2026-06-11T10:00:00Z" } } },
-        }));
-        await recordAnalytics({ statePath, reads: 100 * (i + 1) });
-      }
-
-      const analytics = await listAnalytics(workspace, { limit: 3 });
-      expect(analytics.length).toBe(3);
-    });
-  });
-});