@vima_tech/flywheel 1.0.0

package/install.sh

@@ -0,0 +1,194 @@
+#!/bin/bash
+# Flywheel — 自成长 AI Agent 飞轮框架
+#
+# 一键安装（GitHub 下载方式）：
+#   curl -sSL https://raw.githubusercontent.com/renmengkai/flywheel/main/install.sh | bash
+#
+# 一键安装（npm 方式）：
+#   npm install -g @vima_tech/flywheel
+#
+# 安装并指定 skill（仅限 GitHub 方式）：
+#   curl -sSL https://raw.githubusercontent.com/renmengkai/flywheel/main/install.sh | bash -s req-mining
+
+set -e
+
+REPO="renmengkai/flywheel"
+BRANCH="main"
+BASE_URL="https://raw.githubusercontent.com/$REPO/$BRANCH"
+INSTALL_DIR="${FLYWHEEL_DIR:-.}"
+SKILLS=()
+
+# ── 解析参数 ───────────────────────────────────────────────────
+for arg in "$@"; do
+  case "$arg" in
+    --list)
+      echo "可用 skill 包（通过 PR 添加更多）："
+      echo "  req-mining   需求挖掘与落地（内置）"
+      exit 0
+      ;;
+    --help|-h)
+      echo "用法：curl -sSL .../install.sh | bash -s [skill-name...]"
+      echo "      bash install.sh [--list] [skill-name...]"
+      exit 0
+      ;;
+    *) SKILLS+=("$arg") ;;
+  esac
+done
+
+[ ${#SKILLS[@]} -eq 0 ] && SKILLS=("req-mining")
+
+# ── 环境检查 ───────────────────────────────────────────────────
+check_deps() {
+  local missing=()
+  command -v curl    &>/dev/null || missing+=("curl")
+  command -v git     &>/dev/null || missing+=("git")
+  command -v python3 &>/dev/null || missing+=("python3")
+  if [ ${#missing[@]} -gt 0 ]; then
+    echo "❌ 缺少依赖：${missing[*]}"
+    echo "   请先安装后重试"
+    exit 1
+  fi
+}
+
+# ── 文件下载工具 ───────────────────────────────────────────────
+download() {
+  local src="$1"   # 相对于仓库根的路径
+  local dst="$2"   # 目标路径（相对于 INSTALL_DIR）
+  local full_dst="$INSTALL_DIR/$dst"
+  mkdir -p "$(dirname "$full_dst")"
+  curl -fsSL "$BASE_URL/$src" -o "$full_dst"
+}
+
+# ── 下载内核文件 ───────────────────────────────────────────────
+install_kernel() {
+  echo "📦 安装 Flywheel 内核..."
+
+  local kernel_files=(
+    "CLAUDE.md"
+    ".gitignore"
+    ".claude/commands/flywheel.md"
+    ".claude/commands/skill.md"
+    "scripts/auto-distill.sh"
+    "scripts/feedback-hook.sh"
+    "scripts/bridge-to-coder.sh"
+    "scripts/flywheel-install.sh"
+    "templates/state.json"
+    "skills/_kernel/distillation.md"
+    "skills/_template/skill.yaml"
+    "skills/_template/domain.md"
+    "skills/_template/feedback-questions.sh"
+  )
+
+  for f in "${kernel_files[@]}"; do
+    download "$f" "$f"
+    echo "  ✓ $f"
+  done
+
+  # 初始化运行时目录（gitignore 内容）
+  mkdir -p "$INSTALL_DIR"/{.distill-needed,episodic-logs,projects,memory}
+  touch "$INSTALL_DIR/.distill-needed/.gitkeep"
+  touch "$INSTALL_DIR/episodic-logs/.gitkeep"
+  touch "$INSTALL_DIR/projects/.gitkeep"
+  touch "$INSTALL_DIR/memory/.gitkeep"
+
+  chmod +x "$INSTALL_DIR"/scripts/*.sh
+  echo "  ✓ 内核安装完成"
+}
+
+# ── 下载 skill 包 ──────────────────────────────────────────────
+install_skill() {
+  local skill="$1"
+  echo ""
+  echo "🎯 安装 skill：$skill"
+
+  # 读取 skill.yaml 获取文件列表
+  local yaml_url="$BASE_URL/skills/$skill/skill.yaml"
+  if ! curl -fsSL "$yaml_url" -o /dev/null 2>/dev/null; then
+    echo "  ❌ skill '$skill' 不存在，可用列表：bash install.sh --list"
+    return 1
+  fi
+
+  # 下载核心文件
+  local skill_files=(
+    "skills/$skill/skill.yaml"
+    "skills/$skill/domain.md"
+    "skills/$skill/feedback-questions.sh"
+  )
+
+  # 可选文件（不存在则跳过）
+  local optional_files=(
+    "skills/$skill/artifacts.md"
+    "skills/$skill/bridge.sh"
+    "skills/$skill/memory/failure-patterns.md"
+    "skills/$skill/industry/erp.md"
+  )
+
+  for f in "${skill_files[@]}"; do
+    download "$f" "$f" && echo "  ✓ $f" || echo "  ⚠ 跳过 $f"
+  done
+
+  for f in "${optional_files[@]}"; do
+    curl -fsSL "$BASE_URL/$f" -o "$INSTALL_DIR/$f" 2>/dev/null \
+      && echo "  ✓ $f" \
+      || true  # 可选文件不报错
+  done
+
+  echo "  ✓ skill '$skill' 安装完成"
+}
+
+# ── 更新 .gitignore ────────────────────────────────────────────
+setup_gitignore() {
+  local marker="# flywheel-managed"
+  local gitignore="$INSTALL_DIR/.gitignore"
+
+  # 如果已经有 flywheel 标记则跳过
+  grep -q "$marker" "$gitignore" 2>/dev/null && return
+
+  cat >> "$gitignore" << 'EOF'
+
+# flywheel-managed
+projects/*/
+episodic-logs/
+.distill-needed/*
+!.distill-needed/.gitkeep
+memory/.gitkeep
+*.log
+EOF
+  echo "  ✓ .gitignore 已更新"
+}
+
+# ── 主流程 ─────────────────────────────────────────────────────
+main() {
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "   Flywheel 安装器 v1.0"
+  echo "   自成长 AI Agent 飞轮框架"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "安装目录：$(realpath "$INSTALL_DIR")"
+  echo "Skills：${SKILLS[*]}"
+  echo ""
+
+  check_deps
+  install_kernel
+  setup_gitignore
+
+  for skill in "${SKILLS[@]}"; do
+    install_skill "$skill"
+  done
+
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "  ✅ 安装完成！"
+  echo ""
+  echo "  启动方式："
+  echo "    cd $(realpath "$INSTALL_DIR") && claude"
+  echo "    输入 /flywheel 或 sfw 激活飞轮"
+  echo ""
+  echo "  npm 安装用户可运行：flywheel list"
+  echo "  查看可用 skill：bash install.sh --list"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+}
+
+main

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@vima_tech/flywheel",
+  "version": "1.0.0",
+  "description": "自成长 AI Agent 飞轮框架 — 让任何需要积累迭代的 AI 工作流都能自我进化",
+  "main": "bin/flywheel.js",
+  "bin": {
+    "flywheel": "./bin/flywheel.js"
+  },
+  "scripts": {
+    "postinstall": "chmod +x bin/flywheel.js"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "claude",
+    "flywheel",
+    "self-evolution",
+    "skill"
+  ],
+  "author": "renmengkai",
+  "license": "MIT",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.60.0"
+  }
+}

package/scripts/auto-distill.sh

@@ -0,0 +1,154 @@
+#!/bin/bash
+# scripts/auto-distill.sh
+# 自动检查 episodic-logs 和 .distill-needed/ 标记，触发蒸馏
+#
+# 用法：
+#   ./scripts/auto-distill.sh              # 检查所有项目
+#   ./scripts/auto-distill.sh <project_id> # 检查指定项目
+#   ./scripts/auto-distill.sh --cron       # Cron 模式（静默，仅在需要时输出）
+#
+# 设置为 Cron 自动运行（每天早上 9 点检查）：
+#   0 9 * * * /path/to/req-miner/scripts/auto-distill.sh --cron
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+LOGS_DIR="$REPO_DIR/episodic-logs"
+DISTILL_NEEDED_DIR="$REPO_DIR/.distill-needed"
+THRESHOLD=${DISTILL_THRESHOLD:-3}
+CRON_MODE=false
+TARGET_PROJECT=""
+
+for arg in "$@"; do
+  case "$arg" in
+    --cron) CRON_MODE=true ;;
+    *) TARGET_PROJECT="$arg" ;;
+  esac
+done
+
+check_project() {
+  local project_id="$1"
+
+  # 优先检查标记文件（由 feedback-hook.sh --auto 写入）
+  if [ -f "$DISTILL_NEEDED_DIR/$project_id" ]; then
+    return 0
+  fi
+
+  # 回退：扫描日志文件
+  local log_file="$LOGS_DIR/${project_id}.jsonl"
+  [ -f "$log_file" ] || return 1
+
+  local pending
+  pending=$(python3 - << PYEOF
+import json
+try:
+    with open("$log_file") as f:
+        events = [json.loads(l) for l in f if l.strip()]
+    pending = sum(1 for e in events
+                  if e.get("distillation_candidate") and not e.get("distilled")
+                  and e.get("quality_score", 0) >= 0.6)
+    print(pending)
+except:
+    print(0)
+PYEOF
+)
+  [ "$pending" -ge "$THRESHOLD" ]
+}
+
+report_status() {
+  local project_id="$1"
+  local log_file="$LOGS_DIR/${project_id}.jsonl"
+  local has_marker=""
+  [ -f "$DISTILL_NEEDED_DIR/$project_id" ] && has_marker=" [标记文件]"
+
+  python3 - << PYEOF
+import json
+try:
+    with open("$log_file") as f:
+        events = [json.loads(l) for l in f if l.strip()]
+    total = len(events)
+    pending = sum(1 for e in events
+                  if e.get("distillation_candidate") and not e.get("distilled")
+                  and e.get("quality_score", 0) >= 0.6)
+    distilled = sum(1 for e in events if e.get("distilled"))
+    print(f"  项目 $project_id$has_marker: 总事件={total}, 待蒸馏={pending}, 已蒸馏={distilled}")
+except:
+    print("  项目 $project_id$has_marker: 无日志文件（由标记文件触发）")
+PYEOF
+}
+
+# ── 收集待检查项目 ─────────────────────────────────────────────
+declare -A seen_projects
+
+if [ -n "$TARGET_PROJECT" ]; then
+  seen_projects["$TARGET_PROJECT"]=1
+else
+  # 从标记文件收集
+  if [ -d "$DISTILL_NEEDED_DIR" ]; then
+    for marker in "$DISTILL_NEEDED_DIR"/*; do
+      [ -f "$marker" ] || continue
+      project_id=$(basename "$marker")
+      [ "$project_id" = ".gitkeep" ] && continue
+      seen_projects["$project_id"]=1
+    done
+  fi
+  # 从日志文件收集
+  for log_file in "$LOGS_DIR"/*.jsonl; do
+    [ -f "$log_file" ] || continue
+    project_id=$(basename "$log_file" .jsonl)
+    [ "$project_id" = ".gitkeep" ] && continue
+    seen_projects["$project_id"]=1
+  done
+fi
+
+projects=("${!seen_projects[@]}")
+
+if [ ${#projects[@]} -eq 0 ]; then
+  $CRON_MODE || echo "📭 没有找到任何项目。"
+  exit 0
+fi
+
+$CRON_MODE || echo "━━━ 蒸馏检查器 ━━━"
+$CRON_MODE || echo "检查阈值：$THRESHOLD 条待蒸馏事件"
+$CRON_MODE || echo ""
+
+needs_distill=()
+for project_id in "${projects[@]}"; do
+  if check_project "$project_id"; then
+    needs_distill+=("$project_id")
+    $CRON_MODE || report_status "$project_id"
+    $CRON_MODE || echo "  ⚡ 需要蒸馏"
+  else
+    $CRON_MODE || report_status "$project_id"
+  fi
+done
+
+if [ ${#needs_distill[@]} -eq 0 ]; then
+  $CRON_MODE || echo "✅ 所有项目暂无需要蒸馏（待蒸馏事件均 < $THRESHOLD 条）"
+  exit 0
+fi
+
+# ── 有需要蒸馏的项目 ──────────────────────────────────────────
+echo ""
+echo "━━━ 蒸馏建议 ━━━"
+echo "以下项目已积累足够反馈，建议进行蒸馏："
+for p in "${needs_distill[@]}"; do
+  echo "  • $p"
+done
+echo ""
+echo "操作方式："
+echo "  1. 打开 req-miner 会话（cd $REPO_DIR && claude）"
+echo "  2. 系统将自动检测待蒸馏标记并启动蒸馏"
+echo ""
+
+# Cron 模式下发送桌面通知
+if $CRON_MODE; then
+  if command -v notify-send &>/dev/null; then
+    notify-send "req-miner 蒸馏提醒" "项目 ${needs_distill[*]} 已积累足够反馈，建议蒸馏"
+  elif command -v osascript &>/dev/null; then
+    osascript -e "display notification \"项目 ${needs_distill[*]} 已积累足够反馈\" with title \"req-miner 蒸馏提醒\""
+  fi
+fi
+
+exit 0

package/scripts/bridge-to-coder.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+# scripts/bridge-to-coder.sh
+# 将 req-miner 产物桥接到 agent 编程工具，工具退出后自动收集反馈
+#
+# 用法：./scripts/bridge-to-coder.sh <project_id> [tool] [impl_dir]
+#   project_id : req-miner 项目 ID（如 proj_20260515_01）
+#   tool       : claude（默认）| opencode | trae | codex
+#   impl_dir   : 实现目录（默认 ../{project_id}-impl）
+#
+# 前置条件：projects/{project_id}/artifacts/ai-execution-doc.md 已生成
+
+set -e
+
+PROJECT_ID="${1:?用法: $0 <project_id> [tool] [impl_dir]}"
+TOOL="${2:-claude}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+ARTIFACTS_DIR="$REPO_DIR/projects/$PROJECT_ID/artifacts"
+AI_DOC="$ARTIFACTS_DIR/ai-execution-doc.md"
+STATE_FILE="$REPO_DIR/projects/$PROJECT_ID/state.json"
+IMPL_DIR="${3:-$(dirname "$REPO_DIR")/${PROJECT_ID}-impl}"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+LOG_FILE="$REPO_DIR/episodic-logs/${PROJECT_ID}.jsonl"
+DISTILL_NEEDED_DIR="$REPO_DIR/.distill-needed"
+
+# ── 检查前置条件 ───────────────────────────────────────────────
+if [ ! -f "$AI_DOC" ]; then
+  echo "❌ 错误：AI 执行文档不存在：$AI_DOC"
+  echo "   请先完成 req-miner 分析并生成产物。"
+  exit 1
+fi
+
+# ── 创建实现工作区 ─────────────────────────────────────────────
+echo "📁 创建实现目录：$IMPL_DIR"
+mkdir -p "$IMPL_DIR"
+
+# ── 注入 AI 执行文档为编程工具上下文 ──────────────────────────
+PROJECT_NAME=$(python3 -c "import json,sys; d=json.load(open('$STATE_FILE')); print(d.get('project_name','未命名项目'))" 2>/dev/null || echo "未命名项目")
+
+cat > "$IMPL_DIR/CLAUDE.md" << HEREDOC
+# $PROJECT_NAME — AI 执行规格
+
+> 本文档由 req-miner 自动生成，是唯一权威需求来源。
+> **遇到本文档未说明的情况，必须停止并记录，不得自行决定。**
+
+---
+
+$(cat "$AI_DOC")
+
+---
+
+## 反馈协议（实现完成后必须执行）
+
+实现过程中如遇到以下情况，请记录到 \`.flywheel-feedback.json\`：
+- 需求描述不清晰或有歧义
+- 遇到文档未覆盖的技术决策
+- 发现需求假设与现实不符
+- 验收标准无法被测试
+
+记录格式：
+\`\`\`json
+{
+  "unclear_specs": ["具体描述哪条规格不清晰"],
+  "uncovered_decisions": ["遇到的未覆盖决策"],
+  "wrong_assumptions": ["发现的错误假设"],
+  "untestable_criteria": ["无法测试的验收标准"],
+  "general_feedback": "总体反馈和质量评分（1-10）"
+}
+\`\`\`
+
+**重要：** 实现完成后请写入上述文件。退出编程工具后，飞轮系统会自动读取该文件收集反馈，无需手动运行任何命令。
+HEREDOC
+
+echo "✅ CLAUDE.md 已生成"
+
+# ── 写入桥接事件日志 ──────────────────────────────────────────
+mkdir -p "$(dirname "$LOG_FILE")"
+EVENT_ID="evt_bridge_$(date +%s)"
+echo "{\"event_id\":\"$EVENT_ID\",\"type\":\"bridge_to_coder\",\"project_id\":\"$PROJECT_ID\",\"tool\":\"$TOOL\",\"impl_dir\":\"$IMPL_DIR\",\"timestamp\":\"$TIMESTAMP\"}" >> "$LOG_FILE"
+
+# ── 启动编程工具 ───────────────────────────────────────────────
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  项目：$PROJECT_NAME ($PROJECT_ID)"
+echo "  工具：$TOOL"
+echo "  目录：$IMPL_DIR"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+cd "$IMPL_DIR"
+
+case "$TOOL" in
+  claude)
+    echo "🚀 启动 Claude Code..."
+    claude
+    ;;
+  opencode)
+    echo "🚀 启动 opencode..."
+    opencode
+    ;;
+  trae)
+    echo "🚀 启动 trae..."
+    trae .
+    ;;
+  codex)
+    echo "🚀 启动 codex..."
+    codex
+    ;;
+  cursor)
+    echo "🚀 启动 Cursor..."
+    cursor .
+    ;;
+  *)
+    echo "⚠️  未知工具：$TOOL，已准备好实现目录。"
+    echo "   手动进入：cd $IMPL_DIR"
+    ;;
+esac
+
+# ── 工具退出后：自动收集反馈 ──────────────────────────────────
+echo ""
+echo "━━━ 编程工具已退出，自动收集反馈... ━━━"
+cd "$REPO_DIR"
+"$SCRIPT_DIR/feedback-hook.sh" "$PROJECT_ID" "$IMPL_DIR" --auto
+
+# ── 检查是否需要蒸馏，自动打开蒸馏会话 ───────────────────────
+DISTILL_MARKER="$DISTILL_NEEDED_DIR/$PROJECT_ID"
+if [ -f "$DISTILL_MARKER" ]; then
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "  ⚡ 蒸馏条件已满足，自动启动蒸馏会话"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "即将打开 req-miner 蒸馏会话..."
+  echo "AI 将展示所有变更预览，你只需确认一次 (y/n)"
+  echo ""
+  sleep 1
+  cd "$REPO_DIR"
+  exec claude
+fi

package/scripts/feedback-hook.sh

@@ -0,0 +1,157 @@
+#!/bin/bash
+# scripts/feedback-hook.sh
+# 从编程工具实现会话收集反馈，写入 episodic-logs 以驱动蒸馏飞轮
+#
+# 用法：./scripts/feedback-hook.sh <project_id> [impl_dir] [--auto]
+#   project_id : 飞轮项目 ID
+#   impl_dir   : 实现目录（用于读取 .flywheel-feedback.json）
+#   --auto     : 非交互模式，仅读取反馈文件，跳过问答
+#
+# 反馈问题可由 skill 定制：
+#   在 skills/{skill-name}/feedback-questions.sh 中定义
+#   QUESTION_1 ~ QUESTION_5 变量
+
+set -e
+
+PROJECT_ID="${1:?用法: $0 <project_id> [impl_dir] [--auto]}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+IMPL_DIR="${2:-$(dirname "$REPO_DIR")/${PROJECT_ID}-impl}"
+LOG_FILE="$REPO_DIR/episodic-logs/${PROJECT_ID}.jsonl"
+FEEDBACK_FILE="$IMPL_DIR/.flywheel-feedback.json"
+DISTILL_NEEDED_DIR="$REPO_DIR/.distill-needed"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+EVENT_ID="evt_feedback_$(date +%s)"
+AUTO_MODE=false
+THRESHOLD=${DISTILL_THRESHOLD:-3}
+
+# 解析参数（支持 --auto 在任意位置）
+for arg in "$@"; do
+  [ "$arg" = "--auto" ] && AUTO_MODE=true
+done
+
+$AUTO_MODE || echo "━━━ 需求反馈收集器 ━━━"
+$AUTO_MODE || echo "项目：$PROJECT_ID"
+$AUTO_MODE || echo ""
+
+# ── 读取编程工具自动生成的反馈文件 ───────────────────────────
+FEEDBACK_JSON="{}"
+if [ -f "$FEEDBACK_FILE" ]; then
+  echo "✅ 读取反馈文件：$FEEDBACK_FILE"
+  FEEDBACK_JSON=$(cat "$FEEDBACK_FILE")
+else
+  if $AUTO_MODE; then
+    echo "ℹ️  未发现 .flywheel-feedback.json，写入空反馈事件"
+  else
+    echo "ℹ️  未发现自动反馈文件，进入交互收集模式..."
+  fi
+fi
+
+# ── 加载 skill 专属反馈问题（如存在则覆盖默认问题）────────────
+QUESTION_1="执行过程中哪些输入信息不清晰？"
+QUESTION_2="遇到了哪些文档未覆盖的决策点？"
+QUESTION_3="发现哪些假设与实际情况不符？"
+QUESTION_4="哪些产出无法验证质量？"
+QUESTION_5="总体反馈（执行难度、输入质量评分 1-10）："
+
+# 从 state.json 读取当前 skill，尝试加载其 feedback-questions.sh
+STATE_FILE="$REPO_DIR/projects/$PROJECT_ID/state.json"
+if [ -f "$STATE_FILE" ]; then
+  ACTIVE_SKILL=$(python3 -c "import json; d=json.load(open('$STATE_FILE')); print(d.get('skill',''))" 2>/dev/null || echo "")
+  if [ -n "$ACTIVE_SKILL" ] && [ -f "$REPO_DIR/skills/$ACTIVE_SKILL/feedback-questions.sh" ]; then
+    source "$REPO_DIR/skills/$ACTIVE_SKILL/feedback-questions.sh"
+  fi
+fi
+
+# ── 交互补充（仅非 auto 模式）────────────────────────────────
+UNCLEAR=""
+UNCOVERED=""
+WRONG_ASSUMPTIONS=""
+UNTESTABLE=""
+GENERAL=""
+
+if ! $AUTO_MODE; then
+  echo "请回答以下问题（直接按 Enter 跳过）："
+  echo ""
+  read -p "1. $QUESTION_1 " UNCLEAR
+  read -p "2. $QUESTION_2 " UNCOVERED
+  read -p "3. $QUESTION_3 " WRONG_ASSUMPTIONS
+  read -p "4. $QUESTION_4 " UNTESTABLE
+  read -p "5. $QUESTION_5 " GENERAL
+fi
+
+# ── 合并反馈并生成事件 ────────────────────────────────────────
+PENDING=$(python3 - << PYEOF
+import json, os
+
+try:
+    existing = json.loads('''$FEEDBACK_JSON''')
+except:
+    existing = {}
+
+feedback = {
+    "event_id": "$EVENT_ID",
+    "type": "implementation_feedback",
+    "project_id": "$PROJECT_ID",
+    "timestamp": "$TIMESTAMP",
+    "distillation_candidate": True,
+    "unclear_specs": existing.get("unclear_specs", []) + (["$UNCLEAR"] if "$UNCLEAR" else []),
+    "uncovered_decisions": existing.get("uncovered_decisions", []) + (["$UNCOVERED"] if "$UNCOVERED" else []),
+    "wrong_assumptions": existing.get("wrong_assumptions", []) + (["$WRONG_ASSUMPTIONS"] if "$WRONG_ASSUMPTIONS" else []),
+    "untestable_criteria": existing.get("untestable_criteria", []) + (["$UNTESTABLE"] if "$UNTESTABLE" else []),
+    "general_feedback": existing.get("general_feedback", "") or "$GENERAL",
+    "impl_dir": "$IMPL_DIR"
+}
+
+# 过滤空字符串
+for key in ["unclear_specs", "uncovered_decisions", "wrong_assumptions", "untestable_criteria"]:
+    feedback[key] = [x for x in feedback[key] if x.strip()]
+
+# 计算质量分数
+score = 0.0
+if feedback["unclear_specs"]: score += 0.3
+if feedback["uncovered_decisions"]: score += 0.4
+if feedback["wrong_assumptions"]: score += 0.3
+if feedback["general_feedback"]: score += 0.2
+feedback["quality_score"] = min(score, 0.9)
+
+log_file = "$LOG_FILE"
+os.makedirs(os.path.dirname(log_file), exist_ok=True)
+with open(log_file, "a") as f:
+    f.write(json.dumps(feedback, ensure_ascii=False) + "\n")
+
+print(f"✅ 反馈已写入：{log_file}")
+print(f"   质量分数：{feedback['quality_score']:.2f}（≥0.6 将被蒸馏提炼）")
+
+# 统计待蒸馏事件数
+try:
+    with open(log_file) as f:
+        events = [json.loads(l) for l in f if l.strip()]
+    pending = sum(1 for e in events
+                  if e.get("distillation_candidate") and not e.get("distilled")
+                  and e.get("quality_score", 0) >= 0.6)
+    print(f"   待蒸馏事件：{pending} 条（阈值：$THRESHOLD）")
+    print(str(pending))  # 最后一行供 bash 读取
+except:
+    print("0")
+PYEOF
+)
+
+# 读取 python 输出的最后一行（待蒸馏事件数）
+PENDING_COUNT=$(echo "$PENDING" | tail -1)
+echo "$PENDING" | head -n -1  # 打印非数字行
+
+# ── 自动触发蒸馏标记 ──────────────────────────────────────────
+if [ "$PENDING_COUNT" -ge "$THRESHOLD" ] 2>/dev/null; then
+  mkdir -p "$DISTILL_NEEDED_DIR"
+  echo "$PENDING_COUNT" > "$DISTILL_NEEDED_DIR/$PROJECT_ID"
+  echo ""
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "  ⚡ 蒸馏条件已满足（$PENDING_COUNT 条待蒸馏反馈）"
+  echo "  已写入标记：$DISTILL_NEEDED_DIR/$PROJECT_ID"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+else
+  $AUTO_MODE || echo ""
+  $AUTO_MODE || echo "━━━ 飞轮状态更新完成 ━━━"
+  $AUTO_MODE || echo "下一步：积累 ≥$THRESHOLD 条反馈后将自动触发蒸馏"
+fi