Molt Pi Maker

您在 Molt Pi Maker 上的 AI 指导助手。

它的功能

• 为 GPIO、传感器和摄像头生成 Python 代码
• 逐个引脚讲解接线方法
• 在遇到问题时进行故障排查
• 在您构建项目的过程中提供教学

快速入门

from gpiozero import LED
led = LED(17)
led.blink()

包含内容

• GPIO 引脚参考
• 常用库指南
• 从初学者到进阶的项目
• 故障排查建议

项目状态

版本: v0.9.9 - 活跃开发中 核心功能: 已完成并经过测试 测试覆盖率: 308 个测试用例，通过率 100%

当前已实现的功能

• 带有智能退出检测的自主开发循环
• 双重条件退出机制: 要求同时满足完成指标和显式的 EXIT_SIGNAL
• 速率限制功能，支持按小时重置（100 次调用/小时，可配置）
• 带有高级错误检测的断路器（防止失控循环）
• 具备语义理解和两阶段错误过滤功能的响应分析器
• 支持 JSON 输出格式，并具备自动回退到文本解析的功能
• 支持 --continue 标志以保持会话连贯性
• 支持可配置的会话过期时间（默认为 24 小时）
• 现代化的 CLI 标志: --output-format, --allowed-tools, --no-continue
• 用于准确检测卡死循环的多行错误匹配
• 5 小时 API 限制处理及用户提示
• tmux 集成，用于实时监控
• PRD 导入功能
• 包含 GitHub Actions 的 CI/CD 流水线
• 用于彻底卸载的专属卸载脚本
• 11 个测试文件中共有 308 个测试用例通过

近期改进

v0.9.9 - EXIT_SIGNAL 门控与卸载脚本

• 修复了过早退出的 Bug：完成指标现在要求 Claude 显式发出 EXIT_SIGNAL: true
• 增加了双重条件检查，防止在 Claude 报告工作正在进行时退出
• 修复了 response_analyzer.sh，使其在处理显式 EXIT_SIGNAL 时优先于启发式算法
• 增加了用于清理 Ralph 的专属 uninstall.sh 脚本
• 支持可配置的会话过期时间（默认为 24 小时）
• 增加了 32 个针对 EXIT_SIGNAL 行为和会话过期的测试用例
• 测试总数: 308（从 276 增加）

v0.9.8 - 用于 PRD 导入的现代 CLI

• 现代化改造了 ralph_import.sh，以使用 Claude Code CLI 的 JSON 输出格式
• 通过 --output-format json 支持 JSON 输出格式，实现结构化响应
• 增强了错误处理，支持结构化 JSON 错误信息
• 改进了文件验证，支持基于 JSON 的状态信息
• 向后兼容旧版 CLI（支持自动文本回退）
• 增加了 11 个针对现代化 CLI 功能的测试用例

v0.9.7 - 会话生命周期管理

• 完善的会话生命周期管理，带有自动重置触发器
• 会话自动重置触发条件：断路器打开、手动中断、项目完成
• 增加了 --reset-session CLI 标志用于手动重置会话
• 用于调试的会话历史记录追踪（最近 50 次转换）
• 增加了 26 个针对会话连贯性功能的测试用例

v0.9.6 - JSON 输出与会话管理

• 扩展了 parse_json_response() 以支持 Claude Code CLI JSON 格式
• 增加了会话管理函数：store_session_id(), get_last_session_id(), should_resume_session()
• date_utils.sh 中实现了跨平台的 epoch 时间工具
• 增加了 16 个覆盖 Claude CLI 格式和会话管理的测试用例

v0.9.5 - PRD 导入测试

• 为 ralph_import.sh PRD 转换脚本增加了 22 个全面测试
• 测试范围包括：文件格式支持、输出文件创建、项目命名、错误处理

v0.9.4 - 项目设置测试

• 为 setup.sh 项目初始化脚本增加了 36 个全面测试
• 测试范围包括：目录创建、模板复制、git 初始化

v0.9.3 - 安装测试

• 为 install.sh 全局安装脚本增加了 14 个全面测试
• 测试范围包括：目录创建、命令安装、依赖项检测

v0.9.2 - 提示文件修复

• 修复了关键 Bug：用 -p 标志替换了不存在的 --prompt-file CLI 标志
• 现代 CLI 模式现在可通过 -p "$(cat file)" 正确传递提示内容
• 在 build_claude_command() 中增加了对丢失提示文件的错误处理

v0.9.1 - 现代化 CLI 命令 (阶段 1.1)

• 支持 JSON 输出格式，默认为 --output-format json
• 使用 --continue 标志实现跨循环的上下文连贯性
• 通过 --allowed-tools 标志管理工具权限
• 带有 kcov 覆盖率报告的 CI/CD 流水线

v0.9.0 - 断路器增强

• 修复了卡死循环检测中的多行错误匹配问题
• 消除了 JSON 字段的误报（例如 "is_error": false）
• 增加了两阶段错误过滤，以实现更准确的检测

开发中

• 扩大测试覆盖率
• 日志轮转功能
• 试运行 (Dry-run) 模式
• 配置文件支持 (.ralphrc)
• 指标和分析追踪
• 桌面通知
• Git 备份与回滚系统

v1.0 时间表: 约 4 周 | 完整路线图 | 欢迎贡献！

特性

• 自主开发循环 - 持续进行中