# 📚 OpenClaw 自动优化系统 v5.2

架构

openclaw-tutorial-auto/
├── auto_optimizer.py        # 统一入口（自动检测 tutorial/code/both）
├── pipeline.py              # 教程流水线编排器（14 阶段）
├── code_pipeline.py         # 代码流水线编排器（5 阶段）
├── base_pipeline.py         # 流水线基类（共享 run/banner/报告/插件）
├── cli.py                   # 交互式 CLI（15 命令, Tab 补全）
├── plugin_loader.py         # 插件热加载系统（discover/load/unload/reload）
├── scoring_engine.py        # YAML 评分规则引擎（20+ 内建检查）
├── task_queue.py            # 优先级任务队列（多线程 + 持久化）
├── config.yaml              # 全局配置
├── workflow-pipeline.yaml   # OpenClaw 工作流 v5.2
├── openclaw.sh              # 统一命令行入口脚本
├── run-optimize.sh          # Cron 定时调度脚本
│
├── modules/                 # 功能模块
│   ├── compat.py                # 兼容层: 统一 utils 导入 (消除 13 处重复)
│   ├── types.py                 # 类型定义: 17 个 TypedDict (全模块类型标注)
│   ├── diff_scanner.py          # 增量扫描: git diff 变更检测
│   ├── notifier.py              # 通知: 飞书/企微/钉钉/Slack/Webhook 多渠道
│   ├── ai_refiner.py            # AI 精炼: OpenClaw agent 驱动的智能优化
│   ├── tutorial_scanner.py      # 教程扫描: 章节元数据、结构、缺陷 (代码块感知)
│   ├── quality_analyzer.py      # 教程分析: 深度质量分析、优化计划
│   ├── tutorial_refiner.py      # 教程精炼: 增量修复（12 种操作）
│   ├── reference_collector.py   # 教程采集: 权威参考来源 (默认启用 Web 搜索)
│   ├── formatter.py             # 教程格式化: 统一 Markdown 风格 (优化评分权重)
│   ├── link_checker.py          # 链接检查 + 自动修复: 3 策略断链修复
│   ├── consistency_checker.py   # 一致性检查 + 自动修复: 术语/URL 规范化
│   ├── readability_analyzer.py  # 教程可读性: 段落密度/句长分析
│   ├── optimization_tracker.py  # 教程追踪: 优化历史记录
│   ├── readme_generator.py      # README 自动生成器
│   ├── code_scanner.py          # 代码扫描: 8 语言深度分析、五维度评分
│   ├── code_analyzer.py         # 代码分析: 31 种模板、优先级建议
│   ├── code_refiner.py          # 代码修复: docstring/imports/whitespace
│   └── suggestion_enricher.py   # 引用增强: 静态引用 + Web 搜索
│
├── plugins/                 # 插件目录
│   └── score_highlighter.py     # 示例: 低分告警标记 (after_scan hook)
│
├── scoring-rules/           # 评分规则 (YAML)
│   └── default.yaml             # 默认 6 维度评分规则
│
├── dashboard/               # 可视化 Dashboard
│   ├── server.py                # HTTP API 服务器 (端口 8686)
│   └── index.html               # ECharts 前端 (质量分布/趋势/缺陷)
│
├── prompts/                 # AI 提示词（模块化）
│   ├── scan_prompt.md           # 扫描阶段提示
│   ├── analyze_prompt.md        # 分析阶段提示
│   ├── refine_prompt.md         # 精炼阶段提示
│   ├── format_prompt.md         # 格式化提示
│   ├── reference_prompt.md      # 参考搜集提示
│   ├── chapter_template.md      # 章节模板
│   ├── discover_prompt.md       # 目录发现提示
│   └── readme_prompt.md         # README 生成提示
│
├── templates/               # 输出模板
├── utils/                   # 共享工具 (config/git_ops/markdown)
├── scripts/                 # 活跃脚本 (utils/daemon/feishu/health_check 等)
├── _archive/                # 归档遗留文件 (旧 workflow/scripts)
└── .task-logs/              # 运行日志

流水线阶段

教程模式 (14 阶段)

GPT plus 代充 只需 145discover → scan → analyze → collect_refs → check_links → check_consistency → check_readability → fix_issues → refine → format → track → update_readme → git → report 

代码模式 (5 阶段)

scan → analyze → enrich → refine → report 

v5.2 数据流

”` discover-report.json ──→ scan-report.json ──→ analysis-report.json

GPT plus 代充 只需 145 │ ┌─────────────────────────────────────────────────┘ ↓ 

references.json ──→ link-check-report.json ──→ consistency-report.json

 │ ┌─────────────────────────────────────────────────┘ ↓ 

readability-report.json ──→ fix-issues-report.json ──→ refine-result.json

GPT plus 代充 只需 145 (断链修复 + 术语规范化) ┌───────────────────────────────────────�