autocrew 0.1.0

package/src/modules/workflow/templates.ts

@@ -0,0 +1,124 @@
+/**
+ * Predefined workflow templates for AutoCrew.
+ *
+ * Each template defines a multi-step content pipeline that can be
+ * instantiated via the workflow engine.
+ */
+
+import type { WorkflowDefinition } from "../../runtime/workflow-engine.js";
+
+const TEMPLATES: WorkflowDefinition[] = [
+  {
+    id: "xiaohongshu_full",
+    name: "小红书一键发布",
+    description: "从选题调研到发布的完整小红书内容流水线。包含 AI 写作、去 AI 痕迹、敏感词审查、封面设计等全流程。",
+    steps: [
+      {
+        id: "research",
+        name: "选题调研",
+        tool: "autocrew_research",
+        params: { action: "discover", platform: "xhs" },
+      },
+      {
+        id: "topic",
+        name: "创建选题",
+        tool: "autocrew_topic",
+        params: { action: "create", source: "${research.bestResult}" },
+      },
+      {
+        id: "content",
+        name: "AI 写稿",
+        tool: "autocrew_content",
+        params: { action: "save", topic_id: "${topic.id}" },
+        requiresApproval: true,
+      },
+      {
+        id: "humanize",
+        name: "去 AI 痕迹",
+        tool: "autocrew_humanize",
+        params: { action: "rewrite", content_id: "${content.id}" },
+      },
+      {
+        id: "review",
+        name: "内容审查",
+        tool: "autocrew_review",
+        params: { action: "check", content_id: "${content.id}" },
+      },
+      {
+        id: "cover",
+        name: "封面设计",
+        tool: "autocrew_cover_review",
+        params: { action: "generate", content_id: "${content.id}" },
+        requiresApproval: true,
+      },
+      {
+        id: "pre_publish",
+        name: "发布前检查",
+        tool: "autocrew_pre_publish",
+        params: { action: "checklist", content_id: "${content.id}" },
+      },
+      {
+        id: "publish",
+        name: "发布",
+        tool: "autocrew_publish",
+        params: { action: "publish", content_id: "${content.id}", platform: "xhs" },
+        requiresApproval: true,
+      },
+    ],
+  },
+  {
+    id: "quick_publish",
+    name: "快速发布",
+    description: "已有内容的快速发布流程。去 AI 痕迹 → 审查 → 平台适配 → 封面 → 发布。",
+    steps: [
+      {
+        id: "humanize",
+        name: "去 AI 痕迹",
+        tool: "autocrew_humanize",
+        params: { action: "rewrite", content_id: "${content_id}" },
+      },
+      {
+        id: "review",
+        name: "内容审查",
+        tool: "autocrew_review",
+        params: { action: "check", content_id: "${content_id}" },
+      },
+      {
+        id: "rewrite",
+        name: "平台适配",
+        tool: "autocrew_rewrite",
+        params: { action: "adapt", content_id: "${content_id}" },
+      },
+      {
+        id: "cover",
+        name: "封面设计",
+        tool: "autocrew_cover_review",
+        params: { action: "generate", content_id: "${content_id}" },
+        requiresApproval: true,
+      },
+      {
+        id: "pre_publish",
+        name: "发布前检查",
+        tool: "autocrew_pre_publish",
+        params: { action: "checklist", content_id: "${content_id}" },
+      },
+      {
+        id: "publish",
+        name: "发布",
+        tool: "autocrew_publish",
+        params: { action: "publish", content_id: "${content_id}" },
+        requiresApproval: true,
+      },
+    ],
+  },
+];
+
+const templateMap = new Map(TEMPLATES.map((t) => [t.id, t]));
+
+export function getTemplates(): WorkflowDefinition[] {
+  return TEMPLATES;
+}
+
+export function getTemplate(id: string): WorkflowDefinition | undefined {
+  return templateMap.get(id);
+}

package/src/modules/writing/platform-rewrite.ts

@@ -0,0 +1,190 @@
+export type SupportedPlatform =
+  | "xiaohongshu"
+  | "douyin"
+  | "wechat_mp"
+  | "wechat_video"
+  | "bilibili";
+
+export interface AdaptPlatformOptions {
+  title: string;
+  body: string;
+  targetPlatform: SupportedPlatform;
+  tags?: string[];
+}
+
+export interface AdaptPlatformResult {
+  ok: boolean;
+  platform: SupportedPlatform;
+  title: string;
+  body: string;
+  notes: string[];
+}
+
+function cleanTitle(title: string): string {
+  return title.replace(/\s+/g, " ").trim();
+}
+
+function splitParagraphs(body: string): string[] {
+  return body
+    .split(/\n{2,}/)
+    .map((item) => item.trim())
+    .filter(Boolean);
+}
+
+function ensureSentenceEnding(text: string): string {
+  if (!text) return text;
+  if (/[。！？.!?]$/.test(text)) return text;
+  return `${text}。`;
+}
+
+function trimTitle(title: string, maxLength: number): string {
+  if (title.length <= maxLength) return title;
+  return `${title.slice(0, maxLength - 1)}…`;
+}
+
+function hashtags(tags: string[] = []): string {
+  if (tags.length === 0) return "";
+  return tags.map((tag) => (tag.startsWith("#") ? tag : `#${tag}`)).join(" ");
+}
+
+function adaptForXiaohongshu(title: string, body: string, tags: string[]): AdaptPlatformResult {
+  const paragraphs = splitParagraphs(body).map((paragraph) => {
+    const parts = paragraph
+      .replace(/([。！？])/g, "$1\n")
+      .split("\n")
+      .map((line) => line.trim())
+      .filter(Boolean);
+    return parts.slice(0, 2).join("\n");
+  });
+
+  const bodyWithTags = [...paragraphs];
+  const tagLine = hashtags(tags);
+  if (tagLine) bodyWithTags.push(tagLine);
+
+  return {
+    ok: true,
+    platform: "xiaohongshu",
+    title: trimTitle(cleanTitle(title), 20),
+    body: bodyWithTags.join("\n\n"),
+    notes: [
+      "按小红书习惯压成短段落和短句。",
+      "保留标签行，适合直接做图文文案基底。",
+    ],
+  };
+}
+
+function adaptForDouyin(title: string, body: string, tags: string[]): AdaptPlatformResult {
+  const paragraphs = splitParagraphs(body);
+  const hook = ensureSentenceEnding(paragraphs[0] || title);
+  const voiceover = paragraphs.slice(1).join("\n\n") || paragraphs[0] || body;
+  const tagLine = hashtags(tags.slice(0, 5));
+
+  return {
+    ok: true,
+    platform: "douyin",
+    title: trimTitle(cleanTitle(title), 30),
+    body: [
+      "[3秒开头]",
+      hook,
+      "",
+      "[口播]",
+      voiceover,
+      "",
+      "[字幕重点]",
+      trimTitle(cleanTitle(title), 18),
+      "",
+      "[互动引导]",
+      "你最卡的是哪一步？评论区告诉我。",
+      tagLine ? `\n${tagLine}` : "",
+    ]
+      .join("\n")
+      .trim(),
+    notes: [
+      "改成短视频脚本结构，先给 3 秒钩子。",
+      "默认附带一条互动引导，方便评论区承接。",
+    ],
+  };
+}
+
+function adaptForWechatMp(title: string, body: string): AdaptPlatformResult {
+  const paragraphs = splitParagraphs(body);
+  const intro = paragraphs[0] || body;
+  const middle = paragraphs.slice(1);
+
+  const sections = ["先说结论", "为什么这件事会卡住", "真正值得做的动作"];
+  const blocks: string[] = [trimTitle(cleanTitle(title), 64), "", ensureSentenceEnding(intro), ""];
+
+  middle.forEach((paragraph, index) => {
+    const section = sections[index % sections.length];
+    blocks.push(section, "", ensureSentenceEnding(paragraph), "");
+  });
+
+  return {
+    ok: true,
+    platform: "wechat_mp",
+    title: trimTitle(cleanTitle(title), 64),
+    body: blocks.join("\n").trim(),
+    notes: [
+      "改成更适合公众号长文继续扩写的结构。",
+      "自动补了分节标题，方便后续加案例和配图。",
+    ],
+  };
+}
+
+function adaptForWechatVideo(title: string, body: string, tags: string[]): AdaptPlatformResult {
+  const paragraphs = splitParagraphs(body);
+  const description = [trimTitle(cleanTitle(title), 40), ...paragraphs.slice(0, 2)].join("\n");
+  const tagLine = hashtags(tags.slice(0, 5));
+  return {
+    ok: true,
+    platform: "wechat_video",
+    title: trimTitle(cleanTitle(title), 40),
+    body: `${description}${tagLine ? `\n\n${tagLine}` : ""}`.trim(),
+    notes: [
+      "压成视频号创作描述格式。",
+      "保留简洁摘要，避免正文过长。",
+    ],
+  };
+}
+
+function adaptForBilibili(title: string, body: string, tags: string[]): AdaptPlatformResult {
+  const paragraphs = splitParagraphs(body);
+  const description = paragraphs.join("\n\n");
+  const tagLine = hashtags(tags.slice(0, 10));
+  return {
+    ok: true,
+    platform: "bilibili",
+    title: trimTitle(cleanTitle(title), 80),
+    body: `${description}${tagLine ? `\n\n${tagLine}` : ""}`.trim(),
+    notes: [
+      "保留信息密度，适合 B 站视频简介或动态文案。",
+    ],
+  };
+}
+
+export function adaptPlatformDraft(options: AdaptPlatformOptions): AdaptPlatformResult {
+  const title = options.title || "未命名内容";
+  const body = options.body || "";
+  const tags = options.tags || [];
+
+  switch (options.targetPlatform) {
+    case "xiaohongshu":
+      return adaptForXiaohongshu(title, body, tags);
+    case "douyin":
+      return adaptForDouyin(title, body, tags);
+    case "wechat_mp":
+      return adaptForWechatMp(title, body);
+    case "wechat_video":
+      return adaptForWechatVideo(title, body, tags);
+    case "bilibili":
+      return adaptForBilibili(title, body, tags);
+    default:
+      return {
+        ok: false,
+        platform: options.targetPlatform,
+        title,
+        body,
+        notes: ["Unsupported platform"],
+      };
+  }
+}

package/src/modules/writing/title-hashtag.ts

@@ -0,0 +1,385 @@
+/**
+ * Multi-Platform Title & Hashtag Generator
+ *
+ * Generates platform-native title variants and hashtag suggestions
+ * based on each platform's conventions and character limits.
+ *
+ * PRD §14.2: "各版本的标题和 hashtag 按平台独立生成"
+ */
+
+// --- Types ---
+
+export interface PlatformRules {
+  name: string;
+  /** Display name in Chinese */
+  displayName: string;
+  /** Max title length (chars) */
+  maxTitleLength: number;
+  /** Recommended title length range */
+  titleLengthRange: [number, number];
+  /** Max hashtags */
+  maxHashtags: number;
+  /** Hashtag format */
+  hashtagPrefix: string;
+  /** Platform-specific title tips */
+  titleTips: string[];
+  /** Common high-performing hashtag patterns */
+  hotHashtagPatterns: string[];
+}
+
+export interface TitleVariant {
+  title: string;
+  style: "hook" | "list" | "question" | "story" | "direct";
+  /** Why this variant works for the platform */
+  note: string;
+}
+
+export interface HashtagSuggestion {
+  tag: string;
+  /** "topic" = content-related, "trending" = platform trend, "niche" = audience-specific */
+  type: "topic" | "trending" | "niche";
+}
+
+export interface PlatformTitleResult {
+  platform: string;
+  titles: TitleVariant[];
+  hashtags: HashtagSuggestion[];
+  tips: string[];
+}
+
+// --- Platform Rules ---
+
+const PLATFORM_RULES: Record<string, PlatformRules> = {
+  xhs: {
+    name: "xhs",
+    displayName: "小红书",
+    maxTitleLength: 20,
+    titleLengthRange: [10, 18],
+    maxHashtags: 10,
+    hashtagPrefix: "#",
+    titleTips: [
+      "用 emoji 开头增加视觉吸引力",
+      "数字 + 结果型标题表现最好",
+      "避免标题党，小红书会限流",
+      "口语化、第一人称更亲切",
+    ],
+    hotHashtagPatterns: [
+      "干货分享", "经验分享", "避坑指南", "真实体验",
+      "好物推荐", "自我提升", "效率工具", "学习打卡",
+    ],
+  },
+  douyin: {
+    name: "douyin",
+    displayName: "抖音",
+    maxTitleLength: 300, // Full caption field; visible ~55 chars before fold
+    titleLengthRange: [15, 55],
+    maxHashtags: 5,
+    hashtagPrefix: "#",
+    titleTips: [
+      "标题和描述是同一字段，前 55 字可见，后面需展开",
+      "前 3 秒决定完播率，标题要制造悬念",
+      "用「没想到」「居然」等反转词",
+      "数字型标题点击率高",
+      "可以用 | 分隔主副标题",
+    ],
+    hotHashtagPatterns: [
+      "涨知识", "干货", "必看", "真相",
+      "生活小妙招", "职场", "创业", "副业",
+    ],
+  },
+  wechat_mp: {
+    name: "wechat_mp",
+    displayName: "微信公众号",
+    maxTitleLength: 64,
+    titleLengthRange: [20, 30],
+    maxHashtags: 3,
+    hashtagPrefix: "#",
+    titleTips: [
+      "公众号标题可以更长，信息量更大",
+      "用「：」分隔前后半句制造节奏",
+      "数据型标题增加可信度",
+      "避免全大写或过多感叹号",
+    ],
+    hotHashtagPatterns: [
+      "深度", "观点", "行业分析", "趋势",
+    ],
+  },
+  wechat_video: {
+    name: "wechat_video",
+    displayName: "视频号",
+    maxTitleLength: 30,
+    titleLengthRange: [10, 25],
+    maxHashtags: 5,
+    hashtagPrefix: "#",
+    titleTips: [
+      "视频号用户偏成熟，标题要稳重",
+      "避免过度网感，保持专业感",
+      "可以用提问式引发评论",
+    ],
+    hotHashtagPatterns: [
+      "知识分享", "行业洞察", "职场经验", "创业心得",
+    ],
+  },
+  bilibili: {
+    name: "bilibili",
+    displayName: "B站",
+    maxTitleLength: 80,
+    titleLengthRange: [12, 24],
+    maxHashtags: 5,
+    hashtagPrefix: "#",
+    titleTips: [
+      "系统限制 80 字，但移动端只显示 20-24 中文字",
+      "用【】标注视频类型（如【干货】【避坑】）",
+      "年轻化表达，可以用梗",
+      "副标题补充信息量",
+    ],
+    hotHashtagPatterns: [
+      "干货", "教程", "测评", "避坑",
+      "知识区", "科技", "生活", "学习",
+    ],
+  },
+  toutiao: {
+    name: "toutiao",
+    displayName: "今日头条",
+    maxTitleLength: 30,
+    titleLengthRange: [15, 30],
+    maxHashtags: 5,
+    hashtagPrefix: "#",
+    titleTips: [
+      "标题最少 5 字，最多 30 字",
+      "两段式标题（主题+价值点）表现最好",
+      "视频标题建议 26-30 字",
+      "直接点明价值，不要含糊",
+    ],
+    hotHashtagPatterns: [
+      "干货", "涨知识", "实用", "经验",
+      "职场", "创业", "生活", "科技",
+    ],
+  },
+  youtube: {
+    name: "youtube",
+    displayName: "YouTube",
+    maxTitleLength: 100,
+    titleLengthRange: [30, 70],
+    maxHashtags: 15,
+    hashtagPrefix: "#",
+    titleTips: [
+      "搜索结果只显示约 60 字，YouTube 界面约 70 字",
+      "前置关键词有利于 SEO",
+      "中英双语受众可混合使用",
+      "避免全大写",
+    ],
+    hotHashtagPatterns: [
+      "tutorial", "howto", "review", "tips",
+    ],
+  },
+  twitter: {
+    name: "twitter",
+    displayName: "Twitter/X",
+    maxTitleLength: 280, // Whole tweet, no separate title
+    titleLengthRange: [60, 140],
+    maxHashtags: 3,
+    hashtagPrefix: "#",
+    titleTips: [
+      "没有独立标题，第一行就是标题",
+      "简短有力，留空间给讨论",
+      "Emoji 算 2 个字符",
+      "URL 固定算 23 字符",
+    ],
+    hotHashtagPatterns: [],
+  },
+  instagram: {
+    name: "instagram",
+    displayName: "Instagram",
+    maxTitleLength: 2200, // Whole caption
+    titleLengthRange: [60, 125],
+    maxHashtags: 30,
+    hashtagPrefix: "#",
+    titleTips: [
+      "第一行就是标题，125 字后被折叠",
+      "Reels 只显示前 55-60 字",
+      "Emoji 文化浓厚",
+      "Hashtag 放评论区也可以",
+    ],
+    hotHashtagPatterns: [],
+  },
+};
+
+// Alias
+PLATFORM_RULES["xiaohongshu"] = PLATFORM_RULES["xhs"];
+
+/**
+ * Get platform rules. Returns null if platform is unknown.
+ */
+export function getPlatformRules(platform: string): PlatformRules | null {
+  return PLATFORM_RULES[platform] || null;
+}
+
+/**
+ * Generate title variants for a specific platform.
+ *
+ * Takes a base title/topic and produces 3-5 platform-optimized variants.
+ * This is a rule-based generator — the AI agent can use these as starting
+ * points and refine further.
+ */
+export function generateTitleVariants(
+  baseTopic: string,
+  platform: string,
+  opts?: { keyword?: string },
+): TitleVariant[] {
+  const rules = PLATFORM_RULES[platform];
+  if (!rules) return [{ title: baseTopic, style: "direct", note: "未知平台，返回原标题" }];
+
+  const keyword = opts?.keyword || "";
+  const variants: TitleVariant[] = [];
+  const [minLen, maxLen] = rules.titleLengthRange;
+
+  // 1. Hook style — emotional trigger
+  const hookTitle = buildHookTitle(baseTopic, maxLen);
+  if (hookTitle) {
+    variants.push({ title: hookTitle, style: "hook", note: "情绪触发型，适合引发好奇" });
+  }
+
+  // 2. List style — number + result
+  const listTitle = buildListTitle(baseTopic, keyword, maxLen);
+  variants.push({ title: listTitle, style: "list", note: "数字型，点击率通常最高" });
+
+  // 3. Question style
+  const questionTitle = buildQuestionTitle(baseTopic, maxLen);
+  variants.push({ title: questionTitle, style: "question", note: "提问型，引发思考和评论" });
+
+  // 4. Story style (first person)
+  const storyTitle = buildStoryTitle(baseTopic, maxLen);
+  variants.push({ title: storyTitle, style: "story", note: "故事型，第一人称更有代入感" });
+
+  // 5. Direct style — clean and informative
+  let directTitle = baseTopic;
+  if (directTitle.length > maxLen) directTitle = directTitle.slice(0, maxLen);
+  variants.push({ title: directTitle, style: "direct", note: "直述型，清晰传达主题" });
+
+  // Enforce length limits
+  return variants
+    .map((v) => ({
+      ...v,
+      title: v.title.length > rules.maxTitleLength ? v.title.slice(0, rules.maxTitleLength) : v.title,
+    }))
+    .filter((v) => v.title.length >= Math.min(minLen, 5));
+}
+
+/**
+ * Generate hashtag suggestions for a platform.
+ */
+export function generateHashtags(
+  topic: string,
+  platform: string,
+  tags: string[] = [],
+): HashtagSuggestion[] {
+  const rules = PLATFORM_RULES[platform];
+  if (!rules) return tags.map((t) => ({ tag: `#${t}`, type: "topic" as const }));
+
+  const suggestions: HashtagSuggestion[] = [];
+  const prefix = rules.hashtagPrefix;
+
+  // 1. Topic-based hashtags from provided tags
+  for (const tag of tags.slice(0, 3)) {
+    suggestions.push({ tag: `${prefix}${tag}`, type: "topic" });
+  }
+
+  // 2. Topic-derived hashtag
+  if (topic.length <= 10) {
+    suggestions.push({ tag: `${prefix}${topic}`, type: "topic" });
+  }
+
+  // 3. Platform trending patterns
+  const patterns = rules.hotHashtagPatterns;
+  // Pick 2-3 relevant patterns
+  const relevant = patterns.filter((p) =>
+    topic.includes(p.slice(0, 2)) || tags.some((t) => t.includes(p.slice(0, 2))),
+  );
+  const selected = relevant.length > 0 ? relevant.slice(0, 2) : patterns.slice(0, 2);
+  for (const p of selected) {
+    suggestions.push({ tag: `${prefix}${p}`, type: "trending" });
+  }
+
+  // 4. Niche hashtag (combine keyword + platform pattern)
+  if (tags[0] && patterns[0]) {
+    suggestions.push({ tag: `${prefix}${tags[0]}${patterns[0]}`, type: "niche" });
+  }
+
+  // Deduplicate and limit
+  const seen = new Set<string>();
+  return suggestions
+    .filter((s) => {
+      if (seen.has(s.tag)) return false;
+      seen.add(s.tag);
+      return true;
+    })
+    .slice(0, rules.maxHashtags);
+}
+
+/**
+ * Generate titles + hashtags for a specific platform in one call.
+ */
+export function generateForPlatform(
+  baseTopic: string,
+  platform: string,
+  opts?: { keyword?: string; tags?: string[] },
+): PlatformTitleResult {
+  const rules = PLATFORM_RULES[platform];
+  const titles = generateTitleVariants(baseTopic, platform, opts);
+  const hashtags = generateHashtags(baseTopic, platform, opts?.tags);
+  const tips = rules?.titleTips || [];
+
+  return { platform, titles, hashtags, tips };
+}
+
+/**
+ * Generate titles + hashtags for multiple platforms at once.
+ */
+export function generateForAllPlatforms(
+  baseTopic: string,
+  platforms: string[],
+  opts?: { keyword?: string; tags?: string[] },
+): PlatformTitleResult[] {
+  return platforms.map((p) => generateForPlatform(baseTopic, p, opts));
+}
+
+// --- Title Builders ---
+
+function buildHookTitle(topic: string, maxLen: number): string | null {
+  const hooks = [
+    `别再${topic.slice(0, 4)}了，试试这个`,
+    `${topic.slice(0, 6)}的真相，没人告诉你`,
+    `后悔没早知道的${topic.slice(0, 6)}`,
+  ];
+  const valid = hooks.filter((h) => h.length <= maxLen);
+  return valid[0] || null;
+}
+
+function buildListTitle(topic: string, keyword: string, maxLen: number): string {
+  const core = keyword || topic.slice(0, 6);
+  const candidates = [
+    `${core}必知的5个要点`,
+    `3个${core}技巧，亲测有效`,
+    `${core}避坑指南：7条经验`,
+  ];
+  return candidates.find((c) => c.length <= maxLen) || candidates[0].slice(0, maxLen);
+}
+
+function buildQuestionTitle(topic: string, maxLen: number): string {
+  const candidates = [
+    `${topic.slice(0, 8)}，你真的会吗？`,
+    `为什么${topic.slice(0, 6)}总是做不好？`,
+    `${topic.slice(0, 8)}到底怎么选？`,
+  ];
+  return candidates.find((c) => c.length <= maxLen) || candidates[0].slice(0, maxLen);
+}
+
+function buildStoryTitle(topic: string, maxLen: number): string {
+  const candidates = [
+    `我用${topic.slice(0, 6)}的真实经历`,
+    `做了3个月${topic.slice(0, 4)}，说说感受`,
+    `从零开始${topic.slice(0, 6)}，踩过的坑`,
+  ];
+  return candidates.find((c) => c.length <= maxLen) || candidates[0].slice(0, maxLen);
+}