@lightcone-ai/daemon 0.15.53 → 0.15.55

package/mcp-servers/official/hook-pattern-library/index.js

@@ -1,417 +1,24 @@
 #!/usr/bin/env node
+// Thin-proxy. Real implementation runs on lightcone server.
+// Source of truth: src/mcp-services/hook-pattern-library.js
 import { z } from 'zod';
-import { startFixtureServer } from '../../official-common/server.js';
+import { startThinProxy } from '../../_thin-proxy/forward.js';
 
-const FIXTURE_META = Object.freeze({
-  mode: 'fixture',
-  as_of: '2026-04-29',
-  capability: 'hook-pattern-library',
-  disclaimer: 'Pattern seeds are curated from local fixture examples, not live platform telemetry.',
-});
-
-const HOOK_PATTERNS = Object.freeze([
-  {
-    id: 'hook-q-gap-001',
-    name: 'Question Gap',
-    hook_family: 'question',
-    template: '你以为 {common_belief}，其实最关键的是 {unexpected_factor}？',
-    example: '你以为涨粉靠日更，其实最关键的是开头 3 秒？',
-    best_for_platforms: ['all'],
-    best_for_formats: ['graphic', 'short_video', 'long_video'],
-    intent_tags: ['engagement', 'authority'],
-    risk_notes: '问题必须可在正文给出明确回答，避免空钩子。',
-  },
-  {
-    id: 'hook-number-002',
-    name: 'Concrete Number',
-    hook_family: 'number',
-    template: '我用 {duration} 把 {metric} 从 {before_value} 提到 {after_value}。',
-    example: '我用 14 天把完播率从 19% 提到 37%。',
-    best_for_platforms: ['xhs', 'douyin', 'wechat-mp'],
-    best_for_formats: ['graphic', 'short_video'],
-    intent_tags: ['engagement', 'conversion'],
-    risk_notes: '数字必须可追溯，无法证明时需标注来源不详。',
-  },
-  {
-    id: 'hook-contrast-003',
-    name: 'Before/After Contrast',
-    hook_family: 'contrast',
-    template: '同样是 {topic}，改了 {one_change} 前后结果差了 {delta}。',
-    example: '同样是探店脚本，改了第一句前后播放差了 3 倍。',
-    best_for_platforms: ['all'],
-    best_for_formats: ['graphic', 'short_video'],
-    intent_tags: ['engagement', 'retention'],
-    risk_notes: '对比样本要可比，避免制造伪因果。',
-  },
-  {
-    id: 'hook-mistake-004',
-    name: 'Common Mistake',
-    hook_family: 'mistake',
-    template: '90% 的人做 {topic} 都会踩这 3 个坑。',
-    example: '90% 的账号做矩阵分发都会踩这 3 个坑。',
-    best_for_platforms: ['xhs', 'douyin', 'wechat-mp'],
-    best_for_formats: ['graphic', 'short_video', 'long_video'],
-    intent_tags: ['engagement', 'authority'],
-    risk_notes: '避免绝对化夸张，结尾要给可执行修正。',
-  },
-  {
-    id: 'hook-myth-005',
-    name: 'Myth Busting',
-    hook_family: 'myth',
-    template: '别再信“{myth_statement}”了，真实情况刚好相反。',
-    example: '别再信“账号越多越好”了，真实情况刚好相反。',
-    best_for_platforms: ['all'],
-    best_for_formats: ['graphic', 'short_video'],
-    intent_tags: ['engagement', 'authority'],
-    risk_notes: '反驳观点需给证据，不可只靠情绪。',
-  },
-  {
-    id: 'hook-urgency-006',
-    name: 'Window Urgency',
-    hook_family: 'urgency',
-    template: '{time_window} 内不做 {action}，你会错过 {opportunity}。',
-    example: '这周内不做评论区复盘，你会错过一次自然流量窗口。',
-    best_for_platforms: ['douyin', 'xhs'],
-    best_for_formats: ['short_video', 'graphic'],
-    intent_tags: ['conversion', 'engagement'],
-    risk_notes: '避免虚假稀缺，不可制造恐慌式误导。',
-  },
-  {
-    id: 'hook-checklist-007',
-    name: 'Checklist Tease',
-    hook_family: 'checklist',
-    template: '发稿前先过这 {count} 项清单，不然很容易被限流。',
-    example: '发稿前先过这 7 项清单，不然很容易被限流。',
-    best_for_platforms: ['xhs', 'douyin', 'wechat-mp'],
-    best_for_formats: ['graphic', 'long_video'],
-    intent_tags: ['authority', 'retention'],
-    risk_notes: '清单要具体且可执行，避免泛化口号。',
-  },
-  {
-    id: 'hook-story-008',
-    name: 'Micro Story',
-    hook_family: 'story',
-    template: '昨天一个 {persona} 找我：{problem_scene}，我们只改了 {one_change}。',
-    example: '昨天一个本地餐饮老板找我：发了 20 条没起量，我们只改了开头镜头。',
-    best_for_platforms: ['all'],
-    best_for_formats: ['short_video', 'long_video', 'graphic'],
-    intent_tags: ['engagement', 'conversion'],
-    risk_notes: '案例需脱敏，避免可识别个人信息。',
-  },
-  {
-    id: 'hook-taboo-009',
-    name: 'Taboo Truth',
-    hook_family: 'taboo',
-    template: '行业里很少人明说：{taboo_truth}。',
-    example: '行业里很少人明说：很多爆款不是靠选题，而是靠重写开头。',
-    best_for_platforms: ['xhs', 'wechat-mp', 'douyin'],
-    best_for_formats: ['graphic', 'long_video'],
-    intent_tags: ['authority', 'engagement'],
-    risk_notes: '避免涉及违法违规内幕叙述。',
-  },
-  {
-    id: 'hook-cost-010',
-    name: 'Cost Reveal',
-    hook_family: 'cost',
-    template: '这件事看起来省时间，其实每周要多花 {cost_delta}。',
-    example: '全平台同文直发看起来省时间，其实每周要多花 6 小时返工。',
-    best_for_platforms: ['wechat-mp', 'xhs'],
-    best_for_formats: ['graphic', 'long_video'],
-    intent_tags: ['authority', 'conversion'],
-    risk_notes: '成本估算需说明口径，避免伪精确。',
-  },
-  {
-    id: 'hook-benchmark-011',
-    name: 'Benchmark Frame',
-    hook_family: 'benchmark',
-    template: '如果你的 {metric} 还在 {value}，先别急着投流。',
-    example: '如果你的 3 秒停留率还在 22%，先别急着投流。',
-    best_for_platforms: ['douyin', 'xhs'],
-    best_for_formats: ['short_video', 'graphic'],
-    intent_tags: ['conversion', 'authority'],
-    risk_notes: '阈值需标注来源或样本范围。',
-  },
-  {
-    id: 'hook-challenge-012',
-    name: 'Challenge Format',
-    hook_family: 'challenge',
-    template: '给你一个挑战：按这套模板连做 {duration} 天，看数据会不会变。',
-    example: '给你一个挑战：按这套模板连做 7 天，看完播率会不会变。',
-    best_for_platforms: ['douyin', 'xhs'],
-    best_for_formats: ['short_video', 'graphic'],
-    intent_tags: ['engagement', 'retention'],
-    risk_notes: '避免过度承诺“必涨”“必爆”。',
-  },
-  {
-    id: 'hook-comparison-013',
-    name: 'A/B Comparison',
-    hook_family: 'comparison',
-    template: 'A 方案和 B 方案我都试过，真正拉开差距的是 {key_difference}。',
-    example: 'A 方案和 B 方案我都试过，真正拉开差距的是第一屏字幕密度。',
-    best_for_platforms: ['all'],
-    best_for_formats: ['graphic', 'short_video', 'long_video'],
-    intent_tags: ['authority', 'engagement'],
-    risk_notes: '明确样本量，避免单次实验过拟合。',
-  },
-  {
-    id: 'hook-antiintuitive-014',
-    name: 'Counter-intuitive',
-    hook_family: 'anti_intuitive',
-    template: '越想 {goal}，越不能先做 {common_action}。',
-    example: '越想提升转化，越不能先改 CTA。',
-    best_for_platforms: ['all'],
-    best_for_formats: ['graphic', 'long_video', 'short_video'],
-    intent_tags: ['engagement', 'authority'],
-    risk_notes: '后文需解释机制，否则容易变标题党。',
-  },
-  {
-    id: 'hook-hot-topic-015',
-    name: 'Trend Piggyback',
-    hook_family: 'trend',
-    template: '趁 {trend_topic} 还在窗口期，这个切角更容易被推荐。',
-    example: '趁“同城探店”还在窗口期，这个反差切角更容易被推荐。',
-    best_for_platforms: ['xhs', 'douyin'],
-    best_for_formats: ['short_video', 'graphic'],
-    intent_tags: ['engagement', 'conversion'],
-    risk_notes: '热点需确认时效，过期热点会触发 stale 风险。',
-  },
-  {
-    id: 'hook-proof-016',
-    name: 'Proof First',
-    hook_family: 'proof',
-    template: '先给你看证据：{proof_line}，再说方法。',
-    example: '先给你看证据：同样预算下互动率提升了 42%，再说方法。',
-    best_for_platforms: ['wechat-mp', 'xhs', 'douyin'],
-    best_for_formats: ['graphic', 'long_video', 'short_video'],
-    intent_tags: ['authority', 'conversion'],
-    risk_notes: '证据必须可溯源，避免“截图式”伪证据。',
-  },
-  {
-    id: 'hook-community-017',
-    name: 'Community Voice',
-    hook_family: 'community',
-    template: '过去 30 天我们收到最多的问题是：{question}。',
-    example: '过去 30 天我们收到最多的问题是：矩阵号会不会互相限流？',
-    best_for_platforms: ['xhs', 'wechat-mp'],
-    best_for_formats: ['graphic', 'long_video'],
-    intent_tags: ['engagement', 'retention'],
-    risk_notes: '用户问题需脱敏，避免暴露私信信息。',
-  },
-  {
-    id: 'hook-framework-018',
-    name: 'Framework Reveal',
-    hook_family: 'framework',
-    template: '我把 {topic} 拆成一个 {steps} 步框架，今天直接给你。',
-    example: '我把账号复盘拆成一个 4 步框架，今天直接给你。',
-    best_for_platforms: ['all'],
-    best_for_formats: ['graphic', 'long_video'],
-    intent_tags: ['authority', 'retention', 'conversion'],
-    risk_notes: '框架类内容要避免过于抽象，最好配案例。',
-  },
-  {
-    id: 'hook-roleplay-019',
-    name: 'Role-play Scenario',
-    hook_family: 'scenario',
-    template: '如果你是 {persona}，今天只能做一件事，就做 {single_action}。',
-    example: '如果你是新账号运营，今天只能做一件事，就做首屏重写。',
-    best_for_platforms: ['douyin', 'xhs', 'wechat-mp'],
-    best_for_formats: ['short_video', 'graphic', 'long_video'],
-    intent_tags: ['conversion', 'engagement'],
-    risk_notes: '角色设定要明确，不同人群给不同动作。',
-  },
-  {
-    id: 'hook-failure-020',
-    name: 'Failure Debrief',
-    hook_family: 'failure',
-    template: '这条内容失败了，我只复盘 1 个真正致命的问题。',
-    example: '这条内容失败了，我只复盘 1 个真正致命的问题：开头误导。',
-    best_for_platforms: ['all'],
-    best_for_formats: ['short_video', 'graphic', 'long_video'],
-    intent_tags: ['authority', 'engagement'],
-    risk_notes: '失败复盘要客观，避免甩锅平台。',
-  },
-  {
-    id: 'hook-objection-021',
-    name: 'Objection Handling',
-    hook_family: 'objection',
-    template: '你可能会说“{objection}”，这正是很多人卡住的原因。',
-    example: '你可能会说“我没时间拍”，这正是很多人卡住的原因。',
-    best_for_platforms: ['xhs', 'douyin', 'wechat-mp'],
-    best_for_formats: ['short_video', 'graphic'],
-    intent_tags: ['conversion', 'retention'],
-    risk_notes: '反对意见要真实常见，避免自造稻草人。',
-  },
-  {
-    id: 'hook-time-022',
-    name: 'Time Box',
-    hook_family: 'time_box',
-    template: '给我 {minutes} 分钟，我帮你把 {goal} 做成可执行版本。',
-    example: '给我 10 分钟，我帮你把选题会做成可执行版本。',
-    best_for_platforms: ['douyin', 'xhs'],
-    best_for_formats: ['short_video', 'graphic'],
-    intent_tags: ['conversion', 'engagement'],
-    risk_notes: '时间承诺要匹配内容复杂度。',
-  },
-  {
-    id: 'hook-reverse-023',
-    name: 'Reverse Sequence',
-    hook_family: 'reverse',
-    template: '先说结论：{conclusion}。为什么？因为 {reason_tease}。',
-    example: '先说结论：发得更少反而更稳。为什么？因为推荐系统看质量稳定性。',
-    best_for_platforms: ['all'],
-    best_for_formats: ['graphic', 'short_video', 'long_video'],
-    intent_tags: ['authority', 'engagement'],
-    risk_notes: '结论必须在后文证明，避免断言式误导。',
-  },
-  {
-    id: 'hook-angle-024',
-    name: 'Angle Shift',
-    hook_family: 'angle_shift',
-    template: '同一个话题，换成 {angle} 视角，点击会完全不同。',
-    example: '同一个话题，换成“老板视角”，点击会完全不同。',
-    best_for_platforms: ['xhs', 'wechat-mp', 'douyin'],
-    best_for_formats: ['graphic', 'short_video', 'long_video'],
-    intent_tags: ['engagement', 'retention'],
-    risk_notes: '视角变化不能偏离品牌定位。',
-  },
-]);
-
-function normalizePlatform(value) {
-  const raw = String(value ?? '').trim().toLowerCase();
-  if (!raw) return '';
-  if (raw === 'xiaohongshu' || raw === 'redbook') return 'xhs';
-  if (raw === 'wechat' || raw === 'wechat_mp' || raw === 'wechatmp' || raw === 'gzh' || raw === '公众号') {
-    return 'wechat-mp';
-  }
-  if (raw === 'tiktok_cn') return 'douyin';
-  return raw;
-}
-
-function normalizeFormat(value) {
-  return String(value ?? '').trim().toLowerCase();
-}
-
-function includesKeyword(pattern, keyword) {
-  if (!keyword) return true;
-  const haystack = [
-    pattern.name,
-    pattern.hook_family,
-    pattern.template,
-    pattern.example,
-    ...pattern.intent_tags,
-  ].join(' ').toLowerCase();
-  return haystack.includes(keyword);
-}
-
-function fitScore(pattern, { platform, contentFormat, intent, keyword }) {
-  let score = 0;
-
-  if (!platform) {
-    score += 1;
-  } else if (pattern.best_for_platforms.includes('all') || pattern.best_for_platforms.includes(platform)) {
-    score += 3;
-  } else {
-    return -1;
-  }
-
-  if (!contentFormat) {
-    score += 1;
-  } else if (pattern.best_for_formats.includes(contentFormat)) {
-    score += 3;
-  } else {
-    return -1;
-  }
-
-  if (!intent) {
-    score += 1;
-  } else if (pattern.intent_tags.includes(intent)) {
-    score += 2;
-  }
-
-  if (keyword) {
-    if (includesKeyword(pattern, keyword)) {
-      score += 4;
-    } else {
-      return -1;
-    }
-  }
-
-  return score;
-}
-
-await startFixtureServer({
+await startThinProxy({
   serverId: 'hook-pattern-library',
   serverName: 'official-hook-pattern-library',
-  toolName: 'hook_pattern_library',
-  toolDescription: 'Return curated hook-pattern seeds and recommended templates by platform/format.',
-  inputSchema: {
-    platform: z.enum(['xhs', 'douyin', 'wechat-mp']).optional()
-      .describe('Target platform: xhs, douyin, or wechat-mp.'),
-    content_format: z.enum(['graphic', 'short_video', 'long_video']).optional()
-      .describe('Content format to match hook structure.'),
-    intent: z.enum(['engagement', 'conversion', 'authority', 'retention']).optional()
-      .describe('Primary objective for the draft hook.'),
-    keyword: z.string().optional()
-      .describe('Optional keyword filter against pattern name/template/example.'),
-    limit: z.number().int().min(1).max(20).optional()
-      .describe('Max number of returned patterns (default 8).'),
-    include_examples: z.boolean().optional()
-      .describe('Whether to include example lines in returned payload (default true).'),
-  },
-  handler: ({
-    platform,
-    content_format,
-    intent,
-    keyword,
-    limit = 8,
-    include_examples = true,
-  }) => {
-    const normalizedPlatform = normalizePlatform(platform);
-    const normalizedFormat = normalizeFormat(content_format);
-    const normalizedIntent = String(intent ?? '').trim().toLowerCase();
-    const normalizedKeyword = String(keyword ?? '').trim().toLowerCase();
-
-    const ranked = HOOK_PATTERNS
-      .map((pattern) => ({
-        pattern,
-        score: fitScore(pattern, {
-          platform: normalizedPlatform,
-          contentFormat: normalizedFormat,
-          intent: normalizedIntent,
-          keyword: normalizedKeyword,
-        }),
-      }))
-      .filter((entry) => entry.score >= 0)
-      .sort((a, b) => {
-        if (b.score !== a.score) return b.score - a.score;
-        return a.pattern.id.localeCompare(b.pattern.id);
-      })
-      .slice(0, limit)
-      .map((entry) => ({
-        id: entry.pattern.id,
-        name: entry.pattern.name,
-        hook_family: entry.pattern.hook_family,
-        template: entry.pattern.template,
-        example: include_examples ? entry.pattern.example : undefined,
-        best_for_platforms: entry.pattern.best_for_platforms,
-        best_for_formats: entry.pattern.best_for_formats,
-        intent_tags: entry.pattern.intent_tags,
-        risk_notes: entry.pattern.risk_notes,
-        fit_score: entry.score,
-      }));
-
-    return {
-      ...FIXTURE_META,
-      query: {
-        platform: normalizedPlatform || null,
-        content_format: normalizedFormat || null,
-        intent: normalizedIntent || null,
-        keyword: normalizedKeyword || null,
-        limit,
+  tools: [
+    {
+      name: 'hook_pattern_library',
+      description: 'Return curated hook-pattern seeds and recommended templates by platform/format.',
+      inputSchema: {
+        platform: z.enum(['xhs', 'douyin', 'wechat-mp']).optional(),
+        content_format: z.enum(['graphic', 'short_video', 'long_video']).optional(),
+        intent: z.enum(['engagement', 'conversion', 'authority', 'retention']).optional(),
+        keyword: z.string().optional(),
+        limit: z.number().int().min(1).max(20).optional(),
+        include_examples: z.boolean().optional(),
       },
-      seed_count: HOOK_PATTERNS.length,
-      count: ranked.length,
-      patterns: ranked,
-    };
-  },
+    },
+  ],
 });