# 📚 OpenClaw 自动优化系统 v5.2
— 架构 openclaw-tutorial-auto/ ├── auto_optimizer.py openclaw skills 教程 # 统一入口（自动检测 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 阶段) discover → scan → analyze → collect_refs → check_links → check_consistency → check_readability → fix_issues → refine → format → track → update_readme → git → report | # | 阶段 | 模块 | 说明 | |—|——|——|——| | 1 | discover | pipeline 内置 | 递归扫描教程目录，区分根目录/子目录文件，生成完整文件清单 | | 2 | scan | `tutorial_scanner` | 扫描全部章节，提取元数据、结构、缺陷列表、六维度质量评分（代码块感知） | | 3 | analyze | `quality_analyzer` | 深度分析每章质量，生成优先级排序的优化计划 | | 4 | collect_refs | `reference_collector` | 按章节主题匹配权威参考来源（默认启用 Web 搜索） | | 5 | check_links | `link_checker` | 内部/外部链接健康检查，生成断链报告 | | 6 | check_consistency | `consistency_checker` | 术语、格式、URL 一致性检查 | | 7 | check_readability | `readability_analyzer` | 段落密度、句长、可读性分析 | | 8 | fix_issues | `link_checker` + `consistency_checker` | 自动修复断链（3 策略）+ 术语/URL 规范化（保护代码块） | | 9 | refine | `tutorial_refiner` | 增量修复（导航、目录、标题、代码标签、FAQ、摘要等），处理所有文档 | | 10 | format | `formatter` | 统一 Markdown 格式（优化评分权重） | | 11 | track | `optimization_tracker` | 记录优化历史 | | 12 | update_readme | `readme_generator` | 所有文档优化后自动生成/更新 README | | 13 | git | `utils/git_ops` | 安全提交 + 推送 | | 14 | report | pipeline 内置 | 生成结构化优化报告 (pipeline-report.md) | 代码模式 (5 阶段) scan → analyze → enrich → refine → report | # | 阶段 | 模块 | 说明 | |—|——|——|——| | 1 | scan | `code_scanner` | 8 语言深度分析 (Python/JS/TS/Go/Shell/Rust/C/C++/Java)，五维度评分 | | 2 | analyze | `code_analyzer` | 生成优先级优化建议（31 种模板），覆盖 8 语言族 | | 3 | enrich | `suggestion_enricher` | 为建议附加最佳实践参考链接（静态引用 + Web 搜索） | | 4 | refine | `code_refiner` | 自动修复 (docstring/doxygen/javadoc/imports/header_guard 等) | | 5 | report | code_pipeline 内置 | 生成 Markdown + HTML 双格式报告，含引用和分数表 | v5.2 数据流 discover-report.json ──→ scan-report.json ──→ analysis-report.json │ ┌─────────────────────────────────────────────────┘ ↓ references.json ──→ link-check-report.json ──→ consistency-report.json │ ┌─────────────────────────────────────────────────┘ ↓ readability-report.json ──→ fix-issues-report.json ──→ refine-result.json (断链修复 + 术语规范化) ┌───────────────────────────────────────�
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/286799.html原文链接：https://javaforall.net
