AI 原生 Coding Agent,实现完整的四自系统(自感知、自适应、自组织、自编译),严格遵循铁三角原则。
- 健康自检:系统级健康检查,监控所有模块状态
- 资源监控:CPU、内存、磁盘、网络实时监控
- 依赖检查:外部 API、文件、服务依赖验证
- 健康报告:结构化健康报告生成
- 动态调参:根据负载自动调整系统参数
- 性能优化:基于指标自动生成优化建议
- 限流控制:令牌桶限流 + 熔断器模式
- 配置热更新:运行时配置更新,无需重启
- 工作流定义:声明式工作流定义,支持链式调用
- 任务编排:串行、并行、条件任务执行
- 依赖解析:拓扑排序,自动解析任务依赖
- 动态合成:根据条件动态合成工作流
- 代码模板:支持变量插值、条件渲染、循环
- 代码生成:运行时代码生成和编译
- 自我修复:自动检测并修复代码问题
- 热加载:模块热加载,无需重启
- ✅ 透明可审计:所有操作记录审计日志
- ✅ 不擅自修改用户文件:修改前必须创建备份
- ✅ 操作可回溯:支持操作历史查询和回滚
- ✅ 日志不可篡改:使用哈希链保证日志完整性
- 💰 能力持久化:系统状态自动保存和恢复
- 💰 下次启动继承:持久化数据跨会话保留
- 💰 增量更新:支持增量保存,提高效率
- 💰 版本迁移:数据版本自动迁移
- ⚙️ 配置驱动:所有行为通过配置控制
- ⚙️ 拒绝硬编码:零硬编码,完全可配置
- ⚙️ 配置分层:默认/用户/运行时三层配置
- ⚙️ 热加载配置:运行时更新配置无需重启
让四自系统真正"活"起来:
| 行为 | 频率 | 说明 |
|---|---|---|
| 自感知 | 每 60 秒 | 资源检查 + 异常告警 |
| 自适应 | 每 5 分钟 | 参数调优建议 |
| 自编译 | 每 1 小时 | 代码问题扫描 |
/evolver # 查看状态
/evolver start # 启动进化器
/evolver stop # 停止进化器
/evolver debug # 切换调试模式
| 参数 | 默认值 | 说明 |
|---|---|---|
self_check_interval |
60s | 自检间隔 |
adapt_interval |
300s | 自适应间隔 |
repair_check_interval |
3600s | 修复检查间隔 |
auto_repair_enabled |
False | 自动修复(安全优先) |
debug |
False | 调试输出 |
基于 Claude Code 的上下文工程最佳实践:
| 层级 | 内容 | Token 预算 |
|---|---|---|
| L1: 系统层 | 核心指令、工具定义、安全规则 | 20% |
| L2: 项目层 | Skills、CLAUDE.md、MCP tools | 30% |
| L3: 会话层 | 对话历史、运行状态、中间结果 | 28% |
- Token 预算管理:22% 预留给自动压缩
- 按需加载 Skills:减少上下文占用
- 上下文压缩:自动清理工具结果
from temper.context import ContextManager
manager = ContextManager()
# 添加系统层内容
manager.add_system_content("core", "You are Temper Agent...", 100)
# 按需加载 Skill
manager.load_project_skill("heartbeat_evolver")
# 添加会话层内容
manager.add_session_content("query", "Check health", 20)
# 构建上下文
context = manager.build_context()
# 压缩会话层
manager.compact_session_layer(keep_last_n=10)| 样式 | 用途 |
|---|---|
| Default | 标准软件工程模式,高效完成任务 |
| Explanatory | 教育模式,提供 Insights 解释实现选择 |
| Learning | 学习模式,交互式编程,添加 TODO(human) |
强制 JSON Schema 输出:
from temper.output import OutputStyleManager, OutputStyle
manager = OutputStyleManager()
# 设置结构化输出
manager.set_structured_output({
"type": "object",
"properties": {
"status": {"type": "string"},
"issues": {"type": "array"}
}
})
# 格式化输出
result = manager.format_output({"status": "healthy", "issues": []})
# => {"ok": True, "value": {"status": "healthy", "issues": []}}manager.create_custom_style(
"temper_heartbeat",
"Focus on heartbeat evolution tasks",
"Heartbeat evolution mode"
)temper/
├── temper.py # 主入口
├── README.md # 说明文档
├── .temper/
│ └── config.json # 默认配置
└── temper/
├── core/ # 核心模块
│ ├── errors.py # Codong 错误处理
│ ├── result.py # 结果类型
│ └── events.py # 事件系统
├── config/ # 配置系统(杠杆原则)
│ ├── manager.py
│ └── schema.py
├── audit/ # 审计系统(信任原则)
│ ├── logger.py
│ └── tracer.py
├── persistence/ # 持久化系统(复利原则)
│ └── snapshot.py
├── self_awareness/ # 自感知模块
│ ├── metrics.py
│ ├── resources.py
│ └ diagnostics.py
├── self_adaptive/ # 自适应模块
│ ├── tuner.py
│ └ strategies.py
├── self_organizing/ # 自组织模块
│ ├── workflow.py
│ └ scheduler.py
│ └ graph.py
├── self_compiling/ # 自编译模块
│ ├── repair.py
│ └ generator.py
├── heartbeat/ # 💓 心跳进化器(新增)
│ ├── __init__.py
│ └ evolver.py # 核心进化器(445行)
└── __main__.py # 主入口
python3 temper.py/status - 查看系统状态
/metrics - 查看系统指标
/health - 查看健康状态
/config - 查看/修改配置
/snapshot - 创建/恢复快照
/audit - 查看审计日志
/repair - 代码修复
/generate - 代码生成
/evolver - 心跳进化器控制(新增)
/evolver start - 启动进化器
/evolver stop - 停止进化器
/evolver debug - 切换调试模式
/clear - 清空对话历史
exit - 退出
from temper.core import (
get_four_self_system,
create_workflow, parallel_tasks,
quick_health_check
)
# 初始化系统
system = get_four_self_system()
system.initialize()
# 健康检查
result = system.health_check()
if result['ok']:
report = result['value']
print(f"状态: {report.status}")
# 创建工作流
workflow = create_workflow("我的工作流")
workflow.add_task("task1", lambda: ok("结果1"))
workflow.add_task("task2", lambda: ok("结果2"), dependencies=["task1"])
# 运行工作流
result = system.run_workflow(workflow)
# 并行任务
result = parallel_tasks([task1, task2, task3])所有函数遵循 Codong 错误处理风格:
# 成功返回
return {"ok": True, "value": 返回值}
# 错误返回
return {"ok": False, "error": "ERROR_CODE", "message": "详细错误信息"}
# 检查错误
if is_error(result): ...
# 提取值
value = unwrap(result, default=None)- Python 3.8+
- 仅使用 Python 标准库
- 无外部依赖
MIT License
新增:心跳进化器
- ✅ 新增
temper/heartbeat/模块 - ✅
TemperEvolver类实现定时触发四自行为 - ✅ 新增
/evolver命令(start/stop/debug) - ✅ 测试脚本
test_simple.py验证通过 - ✅ 更新 journal/day-006.md 记录开发过程
解决的问题:
用户反馈"四自系统代码存在但感受不到运行",通过添加心跳循环让系统真正"活"起来。