growork 1.0.1 → 1.1.2

package/src/commands/sync.ts

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import chalk from 'chalk';
-import { loadConfig } from '../utils/config.js';
+import { loadConfigV2, normalizeConfig, sanitizeFileName, SyncOptions, NormalizedDoc } from '../utils/config.js';
 import { FeishuService } from '../services/feishu.js';
 import { NotionService } from '../services/notion.js';
 
@@ -14,44 +14,74 @@ function clearLine(): void {
   }
 }
 
-export async function syncCommand(docName?: string): Promise<void> {
-  const config = loadConfig();
+function extractTitleFromMarkdown(content: string): string {
+  const match = content.match(/^#\s+(.+)$/m);
+  return match ? match[1].trim() : '未命名文档';
+}
+
+export async function syncCommand(options: SyncOptions = {}): Promise<void> {
+  const config = loadConfigV2();
+  const docs = normalizeConfig(config, options);
+
+  if (docs.length === 0) {
+    console.log(chalk.yellow('⚠️  没有找到匹配的文档'));
+    return;
+  }
+
+  // 分组：普通文档 vs Figma 文档
+  const normalDocs = docs.filter(d => d.type !== 'figma');
+  const figmaDocs = docs.filter(d => d.type === 'figma');
+
   const feishuService = config.feishu ? new FeishuService(config.feishu) : null;
   const notionService = config.notion ? new NotionService(config.notion) : null;
 
-  let docsToSync = config.docs;
+  // 检查凭证（只针对普通文档）
+  const hasFeishuDocs = normalDocs.some(d => d.type === 'feishu');
+  const hasNotionDocs = normalDocs.some(d => d.type === 'notion');
 
-  if (docName) {
-    const doc = config.docs.find(d => d.name === docName);
-    if (!doc) {
-      console.log(chalk.red(`❌ 未找到名为 "${docName}" 的文档配置`));
-      console.log(chalk.gray(`可用的文档: ${config.docs.map(d => d.name).join(', ')}`));
-      process.exit(1);
-    }
-    docsToSync = [doc];
+  if (hasFeishuDocs && !feishuService) {
+    throw new Error('配置文件缺少飞书凭证 (feishu.appId, feishu.appSecret)');
+  }
+  if (hasNotionDocs && !notionService) {
+    throw new Error('配置文件缺少 Notion 凭证 (notion.token)');
   }
 
   console.log(chalk.blue('📄 开始同步文档...\n'));
 
   let successCount = 0;
 
-  for (const doc of docsToSync) {
-    process.stdout.write(chalk.gray(`  ⏳ ${doc.name.padEnd(15)} → ${doc.output}`));
+  // Figma 文档按目录分组
+  const figmaGroups = new Map<string, { feature: string; urls: string[] }>();
+  for (const doc of figmaDocs) {
+    const dir = path.dirname(doc.outputPath);
+    const feature = path.basename(path.dirname(dir));
+    if (!figmaGroups.has(dir)) {
+      figmaGroups.set(dir, { feature, urls: [] });
+    }
+    figmaGroups.get(dir)!.urls.push(doc.url);
+  }
+
+  // 处理普通文档（feishu/notion）
+  for (const doc of normalDocs) {
+    const displayName = doc.name || doc.url.slice(-20);
+    process.stdout.write(chalk.gray(`  ⏳ ${displayName}`));
 
     try {
       let content: string;
       if (doc.type === 'feishu') {
-        if (!feishuService) throw new Error('飞书服务未配置');
-        content = await feishuService.getDocumentAsMarkdown(doc.url);
-      } else if (doc.type === 'notion') {
-        if (!notionService) throw new Error('Notion 服务未配置');
-        content = await notionService.getPageAsMarkdown(doc.url);
+        content = await feishuService!.getDocumentAsMarkdown(doc.url);
       } else {
-        throw new Error(`不支持的文档类型: ${doc.type}`);
+        content = await notionService!.getPageAsMarkdown(doc.url);
       }
 
-      const outputPath = path.join(process.cwd(), doc.output);
+      // 从 markdown 提取标题
+      const title = doc.name || extractTitleFromMarkdown(content);
+      const safeTitle = sanitizeFileName(title);
+
+      // 替换占位符生成最终路径
+      const outputPath = path.join(process.cwd(), doc.outputPath.replace('{title}', safeTitle));
       const outputDir = path.dirname(outputPath);
+
       if (!fs.existsSync(outputDir)) {
         fs.mkdirSync(outputDir, { recursive: true });
       }
@@ -59,19 +89,32 @@ export async function syncCommand(docName?: string): Promise<void> {
       fs.writeFileSync(outputPath, content, 'utf-8');
 
       clearLine();
-      console.log(chalk.green(`  ✓ ${doc.name.padEnd(15)} → ${doc.output}`));
+      console.log(chalk.green(`  ✓ ${safeTitle.padEnd(25)} → ${path.relative(process.cwd(), outputPath)}`));
       successCount++;
     } catch (error) {
       clearLine();
       const errorMessage = error instanceof Error ? error.message : String(error);
-      console.log(chalk.red(`  ✗ ${doc.name.padEnd(15)} → ${errorMessage}`));
+      console.log(chalk.red(`  ✗ ${displayName.padEnd(25)} → ${errorMessage}`));
     }
   }
 
+  // 处理 Figma 文档：生成 design.md
+  for (const [dir, { feature, urls }] of figmaGroups) {
+    const content = `# ${feature} 设计稿\n\n${urls.map(u => `- ${u}`).join('\n')}\n`;
+    const outputPath = path.join(process.cwd(), dir, 'design.md');
+
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, content, 'utf-8');
+
+    console.log(chalk.green(`  ✓ design.md → ${path.relative(process.cwd(), outputPath)}`));
+    successCount++;
+  }
+
   console.log('');
-  if (successCount === docsToSync.length) {
-    console.log(chalk.green(`✅ 同步完成，共 ${docsToSync.length} 个文档`));
+  const totalCount = normalDocs.length + figmaGroups.size;
+  if (successCount === totalCount) {
+    console.log(chalk.green(`✅ 同步完成，共 ${totalCount} 个文档`));
   } else {
-    console.log(chalk.yellow(`⚠️  同步完成: ${successCount}/${docsToSync.length} 个文档成功`));
+    console.log(chalk.yellow(`⚠️  同步完成: ${successCount}/${totalCount} 个文档成功`));
   }
 }

package/src/index.ts

@@ -10,7 +10,7 @@ const program = new Command();
 program
   .name('growork')
   .description('将飞书文档同步到本地，为 AI Agent 提供完整上下文')
-  .version('1.0.0');
+  .version('2.0.0');
 
 program
   .command('init')
@@ -18,9 +18,18 @@ program
   .action(initCommand);
 
 program
-  .command('sync [name]')
-  .description('同步文档，可选指定文档名称')
-  .action(syncCommand);
+  .command('sync')
+  .description('同步文档')
+  .option('--ver <version>', '只同步指定版本')
+  .option('-f, --feature <feature>', '只同步指定 feature')
+  .option('-c, --custom', '只同步全局文档')
+  .action((options) => {
+    // 将 ver 映射到 version
+    if (options.ver) {
+      options.version = options.ver;
+    }
+    syncCommand(options);
+  });
 
 program
   .command('list')

package/src/utils/config.ts

@@ -2,13 +2,6 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as yaml from 'yaml';
 
-export interface DocConfig {
-  name: string;
-  type: 'feishu' | 'notion';
-  url: string;
-  output: string;
-}
-
 export interface NotionConfig {
   token: string;
 }
@@ -16,13 +9,40 @@ export interface NotionConfig {
 export interface FeishuConfig {
   appId: string;
   appSecret: string;
-  domain?: 'feishu' | 'lark';  // 默认 feishu，国际版用 lark
+  domain?: 'feishu' | 'lark';
 }
+export type DocInput = string | { url: string; name?: string };
+
+export type FeatureValue = DocInput[] | {
+  prd?: DocInput[];
+  design?: DocInput[];
+  api?: DocInput[];
+  test?: DocInput[];
+};
 
-export interface GroworkConfig {
+export interface GroworkConfigV2 {
   feishu?: FeishuConfig;
   notion?: NotionConfig;
-  docs: DocConfig[];
+  outputDir?: string;  // 输出根目录，默认 "docs"
+  custom?: DocInput[];
+  versions?: {
+    [version: string]: {
+      [feature: string]: FeatureValue;
+    };
+  };
+}
+
+export interface NormalizedDoc {
+  url: string;
+  name?: string;
+  type: 'feishu' | 'notion' | 'figma';
+  outputPath: string;  // 含 {title} 占位符
+}
+
+export interface SyncOptions {
+  version?: string;
+  feature?: string;
+  custom?: boolean;
 }
 
 const CONFIG_FILE_NAME = 'growork.config.yaml';
@@ -35,38 +55,125 @@ export function configExists(): boolean {
   return fs.existsSync(getConfigPath());
 }
 
-export function loadConfig(): GroworkConfig {
-  const configPath = getConfigPath();
+export function inferDocType(url: string): 'feishu' | 'notion' | 'figma' {
+  if (url.includes('feishu.cn') || url.includes('larksuite.com')) {
+    return 'feishu';
+  }
+  if (url.includes('notion.so') || url.includes('notion.site')) {
+    return 'notion';
+  }
+  if (url.includes('figma.com')) {
+    return 'figma';
+  }
+  throw new Error(`无法从 URL 推断文档类型: ${url}`);
+}
 
-  if (!fs.existsSync(configPath)) {
-    throw new Error(`配置文件不存在: ${configPath}\n请先运行 growork init 初始化配置`);
+export function sanitizeFileName(title: string): string {
+  return title
+    .replace(/[\/\\:*?"<>|]/g, '')  // 移除文件系统保留字符
+    .replace(/\s+/g, '-')           // 空格替换为 -
+    .replace(/-+/g, '-')            // 连续 - 合并
+    .replace(/^-|-$/g, '');         // 首尾 - 去除
+}
+
+export function parseDocInput(input: DocInput): { url: string; name?: string } {
+  if (typeof input === 'string') {
+    return { url: input };
   }
+  return input;
+}
 
-  const content = fs.readFileSync(configPath, 'utf-8');
-  const config = yaml.parse(content) as GroworkConfig;
+function isTypedFeature(value: FeatureValue): value is { prd?: DocInput[]; design?: DocInput[]; api?: DocInput[]; test?: DocInput[] } {
+  return !Array.isArray(value);
+}
+
+export function normalizeConfig(config: GroworkConfigV2, options: SyncOptions = {}): NormalizedDoc[] {
+  const docs: NormalizedDoc[] = [];
+  const outputDir = config.outputDir || 'docs';
+
+  // 处理 custom 文档
+  if (config.custom && (options.custom || (!options.version && !options.feature))) {
+    for (const input of config.custom) {
+      const { url, name } = parseDocInput(input);
+      docs.push({
+        url,
+        name,
+        type: inferDocType(url),
+        outputPath: `${outputDir}/custom/{title}.md`,
+      });
+    }
+  }
+
+  // 如果只请求 custom，直接返回
+  if (options.custom) {
+    return docs;
+  }
 
-  // 验证配置
-  if (!config.docs || config.docs.length === 0) {
-    throw new Error('配置文件中没有配置任何文档');
+  // 处理 versions
+  if (config.versions) {
+    for (const [version, features] of Object.entries(config.versions)) {
+      // 版本过滤
+      if (options.version && options.version !== version) continue;
+
+      for (const [feature, value] of Object.entries(features)) {
+        // feature 过滤
+        if (options.feature && options.feature !== feature) continue;
+
+        if (isTypedFeature(value)) {
+          // 分类型的 feature
+          for (const docType of ['prd', 'design', 'api', 'test'] as const) {
+            const docInputs = value[docType];
+            if (!docInputs) continue;
+
+            for (const input of docInputs) {
+              const { url, name } = parseDocInput(input);
+              docs.push({
+                url,
+                name,
+                type: inferDocType(url),
+                outputPath: `${outputDir}/${version}/${feature}/${docType}/{title}.md`,
+              });
+            }
+          }
+        } else {
+          // 简单 feature（数组形式）
+          for (const input of value) {
+            const { url, name } = parseDocInput(input);
+            docs.push({
+              url,
+              name,
+              type: inferDocType(url),
+              outputPath: `${outputDir}/${version}/${feature}/{title}.md`,
+            });
+          }
+        }
+      }
+    }
   }
 
-  // 检查文档类型所需的凭证
-  const hasFeishuDocs = config.docs.some(d => d.type === 'feishu');
-  const hasNotionDocs = config.docs.some(d => d.type === 'notion');
+  return docs;
+}
+
+export function loadConfigV2(): GroworkConfigV2 {
+  const configPath = getConfigPath();
 
-  if (hasFeishuDocs && (!config.feishu?.appId || !config.feishu?.appSecret)) {
-    throw new Error('配置文件缺少飞书凭证 (feishu.appId, feishu.appSecret)');
+  if (!fs.existsSync(configPath)) {
+    throw new Error(`配置文件不存在: ${configPath}\n请先运行 growork init 初始化配置`);
   }
 
-  if (hasNotionDocs && !config.notion?.token) {
-    throw new Error('配置文件缺少 Notion 凭证 (notion.token)');
+  const content = fs.readFileSync(configPath, 'utf-8');
+  const config = yaml.parse(content) as GroworkConfigV2;
+
+  // v2.0 至少需要 custom 或 versions
+  if (!config.custom && !config.versions) {
+    throw new Error('配置文件中没有配置任何文档（custom 或 versions）');
   }
 
   return config;
 }
 
 export function getDefaultConfig(): string {
-  return `# Growork 配置文件
+  return `# Growork v2.0 配置文件
 
 # 飞书应用凭证 (使用飞书文档时需要)
 feishu:
@@ -78,18 +185,30 @@ feishu:
 notion:
   token: "ntn_xxxx"  # Notion Integration Token
 
-# 文档同步配置
-docs:
-  # 飞书文档示例
-  - name: prd
-    type: feishu
-    url: "https://xxx.feishu.cn/docx/xxxxx"
-    output: "docs/product/prd.md"
-
-  # Notion 文档示例
-  - name: notion-prd
-    type: notion
-    url: "https://www.notion.so/xxxxx"
-    output: "docs/product/notion-prd.md"
+# 输出根目录（默认 "docs"）
+outputDir: "docs"
+
+# 全局文档（不跟版本）
+custom:
+  - "https://xxx.feishu.cn/docx/xxxxx"        # 最简写法
+  # - url: "https://www.notion.so/xxxxx"
+  #   name: "技术架构"                          # 可选：自定义名称
+
+# 版本化文档
+versions:
+  v1.0:
+    用户登录:
+      prd:
+        - "https://xxx.feishu.cn/docx/xxxxx"
+      # design:
+      #   - "https://xxx.feishu.cn/docx/yyyyy"
+      # api:
+      #   - "https://xxx.feishu.cn/docx/zzzzz"
+      # test:
+      #   - "https://xxx.feishu.cn/docx/aaaaa"
+
+    # 简单 feature 可不分类
+    # 小优化:
+    #   - "https://xxx.feishu.cn/docx/bbbbb"
 `;
 }