autosnippet 3.2.9 → 3.2.11

package/lib/service/quality/FeedbackCollector.js

@@ -1,146 +0,0 @@
-/**
- * FeedbackCollector — 用户反馈收集器
- * 记录交互事件 (view/click/rate/dismiss)，可持久化，支持统计汇总
- * 持久化到 AutoSnippet/feedback.json（Git 友好）
- */
-
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import pathGuard from '../../shared/PathGuard.js';
-
-export class FeedbackCollector {
-  #feedbackPath;
-  #events; // [{ type, recipeId, data, timestamp }]
-  #maxEvents;
-
-  constructor(projectRoot, options = {}) {
-    const kbDir = options.knowledgeBaseDir || 'AutoSnippet';
-    this.#feedbackPath = join(projectRoot, kbDir, 'feedback.json');
-    pathGuard.assertProjectWriteSafe(this.#feedbackPath);
-    this.#maxEvents = options.maxEvents || 1000;
-    this.#migrateOldPath(projectRoot, options.internalDir || '.autosnippet');
-    this.#events = this.#load();
-  }
-
-  /**
-   * 记录一个交互事件
-   * @param {'view'|'click'|'rate'|'dismiss'|'copy'|'insert'|'feedback'} type
-   * @param {string} recipeId
-   * @param {object} data - 任意附加数据 (rating, comment, etc.)
-   */
-  record(type, recipeId, data = {}) {
-    this.#events.push({
-      type,
-      recipeId,
-      data,
-      timestamp: new Date().toISOString(),
-    });
-
-    if (this.#events.length > this.#maxEvents) {
-      this.#events = this.#events.slice(-this.#maxEvents);
-    }
-
-    this.#save();
-  }
-
-  /**
-   * 获取指定 Recipe 的事件统计
-   * @param {string} recipeId
-   * @returns {{ views: number, clicks: number, copies: number, avgRating: number, feedbackCount: number }}
-   */
-  getRecipeStats(recipeId) {
-    const events = this.#events.filter((e) => e.recipeId === recipeId);
-    const ratings = events
-      .filter((e) => e.type === 'rate' && e.data.rating)
-      .map((e) => e.data.rating);
-
-    return {
-      views: events.filter((e) => e.type === 'view').length,
-      clicks: events.filter((e) => e.type === 'click').length,
-      copies: events.filter((e) => e.type === 'copy' || e.type === 'insert').length,
-      avgRating: ratings.length > 0 ? ratings.reduce((a, b) => a + b, 0) / ratings.length : 0,
-      feedbackCount: events.filter((e) => e.type === 'feedback').length,
-      totalEvents: events.length,
-    };
-  }
-
-  /**
-   * 获取全局统计
-   */
-  getGlobalStats() {
-    const byType = {};
-    for (const e of this.#events) {
-      byType[e.type] = (byType[e.type] || 0) + 1;
-    }
-    return {
-      totalEvents: this.#events.length,
-      byType,
-      uniqueRecipes: new Set(this.#events.map((e) => e.recipeId)).size,
-    };
-  }
-
-  /**
-   * 获取热门 Recipes (by interaction count)
-   */
-  getTopRecipes(n = 10) {
-    const counts = {};
-    for (const e of this.#events) {
-      counts[e.recipeId] = (counts[e.recipeId] || 0) + 1;
-    }
-    return Object.entries(counts)
-      .sort(([, a], [, b]) => b - a)
-      .slice(0, n)
-      .map(([recipeId, count]) => ({ recipeId, count }));
-  }
-
-  /**
-   * 清空记录
-   */
-  clear() {
-    this.#events = [];
-    this.#save();
-  }
-
-  // ─── 私有 ─────────────────────────────────────────────
-
-  #load() {
-    try {
-      if (existsSync(this.#feedbackPath)) {
-        const data = JSON.parse(readFileSync(this.#feedbackPath, 'utf-8'));
-        return Array.isArray(data) ? data : data.events || [];
-      }
-    } catch {
-      /* silent */
-    }
-    return [];
-  }
-
-  #save() {
-    try {
-      const dir = dirname(this.#feedbackPath);
-      if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-      }
-      writeFileSync(this.#feedbackPath, JSON.stringify(this.#events, null, 2));
-    } catch {
-      /* silent */
-    }
-  }
-
-  #migrateOldPath(projectRoot, internalDir) {
-    try {
-      const oldPath = join(projectRoot, internalDir, 'feedback.json');
-      if (existsSync(oldPath) && !existsSync(this.#feedbackPath)) {
-        const content = readFileSync(oldPath, 'utf-8');
-        const dir = dirname(this.#feedbackPath);
-        if (!existsSync(dir)) {
-          mkdirSync(dir, { recursive: true });
-        }
-        writeFileSync(this.#feedbackPath, content);
-        unlinkSync(oldPath);
-      }
-    } catch {
-      /* 迁移失败不阻断启动 */
-    }
-  }
-}

package/lib/service/quality/QualityScorer.js

@@ -1,203 +0,0 @@
-/**
- * QualityScorer — Recipe 质量评分器
- * 5 个维度: completeness(0.35) + format(0.25) + codeQuality(0.25) + metadata(0.15) + engagement(0)
- * 每个维度评分 0-1，加权求和
- */
-
-import { CODE_LENGTH, QUALITY_GRADES, QUALITY_WEIGHTS } from '../../shared/constants.js';
-
-const DEFAULT_WEIGHTS = QUALITY_WEIGHTS;
-
-export class QualityScorer {
-  #weights;
-
-  constructor(options = {}) {
-    this.#weights = { ...DEFAULT_WEIGHTS, ...options.weights };
-  }
-
-  /**
-   * 计算综合质量分
-   * @param {object} recipe - Recipe 对象 (title, trigger, code, language, category, summary, usageGuide, headers, tags, views, clicks, rating)
-   * @returns {{ score: number, dimensions: object, grade: string }}
-   */
-  score(recipe) {
-    const dimensions = {
-      completeness: this.#scoreCompleteness(recipe),
-      format: this.#scoreFormat(recipe),
-      codeQuality: this.#scoreCodeQuality(recipe),
-      metadata: this.#scoreMetadata(recipe),
-      engagement: this.#scoreEngagement(recipe),
-    };
-
-    let totalScore = 0;
-    for (const [dim, weight] of Object.entries(this.#weights)) {
-      totalScore += (dimensions[dim] || 0) * weight;
-    }
-
-    totalScore = Math.min(1, Math.max(0, totalScore));
-
-    return {
-      score: parseFloat(totalScore.toFixed(3)),
-      dimensions,
-      grade: this.#toGrade(totalScore),
-    };
-  }
-
-  /**
-   * 批量评分
-   */
-  scoreBatch(recipes) {
-    return recipes.map((r) => ({ recipe: r, ...this.score(r) }));
-  }
-
-  /**
-   * 获取维度权重
-   */
-  getWeights() {
-    return { ...this.#weights };
-  }
-
-  // ─── 维度评分 ─────────────────────────────────────────
-
-  /**
-   * 完整性: title(0.25) + trigger(0.25) + code(0.3) + usageGuide(0.2)
-   */
-  #scoreCompleteness(r) {
-    let s = 0;
-    if (r.title?.trim()) {
-      s += 0.25;
-    }
-    if (r.trigger?.trim()) {
-      s += 0.25;
-    }
-    if (r.code && r.code.trim().length > 5) {
-      s += 0.3;
-    }
-    if (r.usageGuide?.trim()) {
-      s += 0.2;
-    }
-    return s;
-  }
-
-  /**
-   * 格式: trigger 格式(0.5) + language 合法性(0.5)
-   */
-  #scoreFormat(r) {
-    let s = 0;
-    if (r.trigger) {
-      if (
-        /^[a-zA-Z0-9_\-:.]+$/.test(r.trigger) &&
-        r.trigger.length >= 2 &&
-        r.trigger.length <= 64
-      ) {
-        s += 0.5;
-      } else if (r.trigger.length >= 2) {
-        s += 0.25;
-      }
-    }
-    if (r.language) {
-      const valid = new Set([
-        'swift',
-        'objective-c',
-        'objc',
-        'javascript',
-        'typescript',
-        'python',
-        'c',
-        'cpp',
-        'shell',
-        'markdown',
-      ]);
-      s += valid.has(r.language.toLowerCase()) ? 0.5 : 0.25;
-    }
-    return s;
-  }
-
-  /**
-   * 代码质量: 长度适中(0.3) + 无 TODO(0.2) + 有注释(0.3) + 有错误处理(0.2)
-   */
-  #scoreCodeQuality(r) {
-    if (!r.code) {
-      return 0;
-    }
-    let s = 0;
-    const code = r.code;
-
-    // 长度适中
-    if (code.length >= CODE_LENGTH.MIN && code.length <= CODE_LENGTH.MAX) {
-      s += 0.3;
-    } else if (code.length > CODE_LENGTH.MAX) {
-      s += 0.15;
-    }
-
-    // 无 TODO/FIXME/HACK
-    if (!/\b(TODO|FIXME|HACK|XXX)\b/.test(code)) {
-      s += 0.2;
-    }
-
-    // 有注释
-    if (/\/\/|\/\*|#\s/.test(code)) {
-      s += 0.3;
-    }
-
-    // 有错误处理
-    if (/try|catch|throw|guard|if\s+let|do\s*\{|\.catch/.test(code)) {
-      s += 0.2;
-    }
-
-    return s;
-  }
-
-  /**
-   * 元数据: category(0.35) + tags/headers(0.35) + summary(0.3)
-   */
-  #scoreMetadata(r) {
-    let s = 0;
-    if (r.category?.trim()) {
-      s += 0.35;
-    }
-    if ((r.tags && r.tags.length > 0) || (r.headers && r.headers.length > 0)) {
-      s += 0.35;
-    }
-    if (r.summary?.trim()) {
-      s += 0.3;
-    }
-    return s;
-  }
-
-  /**
-   * 互动: views(0.3) + clicks(0.3) + rating(0.4)
-   */
-  #scoreEngagement(r) {
-    let s = 0;
-    if (r.views && r.views > 0) {
-      s += Math.min(0.3, (r.views / 100) * 0.3);
-    }
-    if (r.clicks && r.clicks > 0) {
-      s += Math.min(0.3, (r.clicks / 50) * 0.3);
-    }
-    if (r.rating && r.rating > 0) {
-      s += (r.rating / 5) * 0.4;
-    }
-    return s;
-  }
-
-  /**
-   * 分数转等级
-   */
-  #toGrade(score) {
-    if (score >= QUALITY_GRADES.A) {
-      return 'A';
-    }
-    if (score >= QUALITY_GRADES.B) {
-      return 'B';
-    }
-    if (score >= QUALITY_GRADES.C) {
-      return 'C';
-    }
-    if (score >= QUALITY_GRADES.D) {
-      return 'D';
-    }
-    return 'F';
-  }
-}

package/lib/service/recipe/RecipeCandidateValidator.js

@@ -1,211 +0,0 @@
-/**
- * RecipeCandidateValidator — Recipe 候选校验器 (V3)
- *
- * 验证候选是否满足 V3 结构化字段要求。
- * 核心变更：用 content 对象替代旧版 code 字符串。
- */
-
-import { LanguageService } from '../../shared/LanguageService.js';
-import { getRequiredFieldNames } from '../../shared/FieldSpec.js';
-
-/* ── V3 必填字段（从 FieldSpec 获取顶层字段，排除嵌套和容器字段） ── */
-const REQUIRED_FIELDS = getRequiredFieldNames().filter(f =>
-  !['content', 'headers', 'reasoning', 'knowledgeType', 'usageGuide'].includes(f)
-);
-
-/* ── 需要 content 子对象有内容 ── */
-// NOTE: reserved for future content sub-field validation
-// const REQUIRED_CONTENT_FIELDS = ['pattern', 'markdown', 'rationale'];
-
-const VALID_CATEGORIES = new Set([
-  'view',
-  'service',
-  'tool',
-  'model',
-  'network',
-  'storage',
-  'ui',
-  'utility',
-]);
-
-const VALID_KINDS = new Set(['rule', 'pattern', 'fact']);
-
-export class RecipeCandidateValidator {
-  /**
-   * 验证单个候选（V3 结构）
-   * @param {object} candidate
-   * @returns {{ valid: boolean, errors: string[], warnings: string[] }}
-   */
-  validate(candidate) {
-    const errors = [];
-    const warnings = [];
-
-    if (!candidate || typeof candidate !== 'object') {
-      return { valid: false, errors: ['候选为空或类型错误'], warnings: [] };
-    }
-
-    // ── V3 必填字段 ──
-    for (const field of REQUIRED_FIELDS) {
-      const val = candidate[field];
-      if (!val || (typeof val === 'string' && !val.trim())) {
-        errors.push(`缺少必填字段: ${field}`);
-      }
-    }
-
-    // ── content 对象必须包含有效内容 ──
-    const content = candidate.content;
-    if (!content || typeof content !== 'object') {
-      errors.push('缺少必填字段: content（需为 { pattern, markdown, rationale } 对象）');
-    } else {
-      const hasPattern = !!(content.pattern && String(content.pattern).trim());
-      const hasMarkdown = !!(content.markdown && String(content.markdown).trim());
-      if (!hasPattern && !hasMarkdown) {
-        errors.push('content.pattern 或 content.markdown 至少需要一个非空');
-      }
-      if (!content.rationale || !String(content.rationale).trim()) {
-        errors.push('缺少必填字段: content.rationale（设计原理）');
-      }
-    }
-
-    // ── trigger 格式 ──
-    if (candidate.trigger && typeof candidate.trigger === 'string') {
-      if (candidate.trigger.length < 2) {
-        errors.push('trigger 过短');
-      }
-      if (candidate.trigger.length > 64) {
-        errors.push('trigger 过长 (>64)');
-      }
-      if (!candidate.trigger.startsWith('@')) {
-        warnings.push('trigger 应以 @ 开头');
-      }
-      if (!/^@?[a-zA-Z0-9_\-:.]+$/.test(candidate.trigger)) {
-        warnings.push('trigger 含特殊字符，建议仅使用字母/数字/下划线/连字符');
-      }
-    }
-
-    // ── kind 合法性 ──
-    if (candidate.kind && !VALID_KINDS.has(candidate.kind)) {
-      errors.push(`kind "${candidate.kind}" 无效 — 必须为 rule/pattern/fact`);
-    }
-
-    // ── category 合法性 ──
-    if (candidate.category && !VALID_CATEGORIES.has(candidate.category.toLowerCase())) {
-      warnings.push(
-        `category "${candidate.category}" 不在标准列表（View/Service/Tool/Model/Network/Storage/UI/Utility）`
-      );
-    }
-
-    // ── language 合法性 ──
-    if (candidate.language) {
-      const lang = candidate.language.toLowerCase();
-      if (!LanguageService.isKnownLang(lang) && lang !== 'objc' && lang !== 'markdown') {
-        warnings.push(`language "${candidate.language}" 不在已知语言列表`);
-      }
-    }
-
-    // ── headers 必填 ──
-    if (!Array.isArray(candidate.headers)) {
-      errors.push('缺少必填字段: headers（需为 import 语句数组，无 import 时传 []）');
-    }
-
-    // ── knowledgeType 必填 ──
-    if (!candidate.knowledgeType || !String(candidate.knowledgeType).trim()) {
-      errors.push('缺少必填字段: knowledgeType');
-    }
-
-    // ── usageGuide 必填 ──
-    if (!candidate.usageGuide || !String(candidate.usageGuide).trim()) {
-      errors.push('缺少必填字段: usageGuide（使用指南，### 章节格式）');
-    }
-
-    // ── 推理依据 (reasoning) 必填 ──
-    if (!candidate.reasoning) {
-      errors.push('缺少必填字段: reasoning（需包含 whyStandard + sources + confidence）');
-    } else {
-      if (!candidate.reasoning.whyStandard?.trim()) {
-        errors.push('reasoning.whyStandard 不能为空');
-      }
-      if (!Array.isArray(candidate.reasoning.sources) || candidate.reasoning.sources.length === 0) {
-        errors.push('reasoning.sources 至少包含一项来源');
-      }
-      if (
-        typeof candidate.reasoning.confidence !== 'number' ||
-        candidate.reasoning.confidence < 0 ||
-        candidate.reasoning.confidence > 1
-      ) {
-        warnings.push('reasoning.confidence 应为 0-1 的数字');
-      }
-    }
-
-    // ── 标签 ──
-    if (candidate.tags && !Array.isArray(candidate.tags)) {
-      warnings.push('tags 应为数组');
-    }
-
-    return {
-      valid: errors.length === 0,
-      errors,
-      warnings,
-    };
-  }
-
-  /**
-   * 批量验证
-   * @param {object[]} candidates
-   * @returns {{ valid: object[], invalid: object[], summary: { total: number, validCount: number, invalidCount: number } }}
-   */
-  validateBatch(candidates) {
-    const valid = [];
-    const invalid = [];
-
-    for (const candidate of candidates) {
-      const result = this.validate(candidate);
-      if (result.valid) {
-        valid.push({ candidate, ...result });
-      } else {
-        invalid.push({ candidate, ...result });
-      }
-    }
-
-    return {
-      valid,
-      invalid,
-      summary: {
-        total: candidates.length,
-        validCount: valid.length,
-        invalidCount: invalid.length,
-      },
-    };
-  }
-
-  /**
-   * 获取有效类别列表
-   */
-  getValidCategories() {
-    return [...VALID_CATEGORIES];
-  }
-
-  /**
-   * 获取有效 kind 列表
-   */
-  getValidKinds() {
-    return [...VALID_KINDS];
-  }
-
-  /**
-   * 获取所有必填字段名列表
-   */
-  getRequiredFields() {
-    return [
-      ...REQUIRED_FIELDS,
-      'content',
-      'content.rationale',
-      'headers',
-      'knowledgeType',
-      'usageGuide',
-      'reasoning',
-      'reasoning.whyStandard',
-      'reasoning.sources',
-    ];
-  }
-}