harness9轻量级 Go Agent Harness 框架

功能完备、生产可用。极简抽象，代码直白。

harness9

▋

🎯

简洁

最小化抽象层，代码直白易读，极少的直接依赖。引入 harness9 不意味着引入一套复杂的概念体系。

✅

完备

覆盖 Agent 运行所需的全部核心模块——Engine、Provider、Schema、Tools、Env，开箱即用。

🚀

生产可用

错误恢复、上下文管理、超时控制、并发工具执行、Path Traversal 防护，不只是 demo。

💻

全屏 TUI

流式输出、Spinner 进度、Token 用量实时展示、Tab 补全。AltScreen 全屏渲染，非 TTY 自动退回 CLI。

⚡

Shell 执行

输入框 ! 前缀直接运行 Bash 命令，输出追加到对话流并自动注入 LLM 上下文，无需切换终端。

🧠

Context Engineering

LLM 摘要压缩、SQLite 会话持久化、80% 阈值自动触发，长对话不丢语义。

🗃️

Long-Term Memory

跨会话长期记忆，SQLite + FTS5 持久化，MEMORY.md 物化视图实时注入，显式工具 / 压缩前提取 / nudge 三路触发，零新增依赖。

📋

Planning 模块

Plan Mode 先规划后执行，TodoStore 状态机校验，工具层权限过滤，自动续跑 + 停滞检测。

🔀

并发工具执行

同 Turn 内多工具并发执行，每工具独立超时控制。执行失败时错误原样回传 LLM，触发自动重试。

💡

推理内容展示

Anthropic extended thinking 和 OpenRouter reasoning_content 均路由为 EventThinkingDelta，TUI 流式渲染深灰色思维块。

架构总览

harness9 整体架构图

快速开始

安装

bash

curl -fsSL https://raw.githubusercontent.com/ZhangShenao/harness9/master/scripts/install.sh | bash

配置 API Key

bash

# OpenAI / OpenRouter
export OPENAI_API_KEY="sk-..."

# 或 Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."

启动

bash

cd /your/project && harness9

在 TTY 环境中自动进入全屏 TUI；管道/CI 环境退回 CLI REPL 模式。
更多配置选项见快速启动指南。

harness9轻量级 Go Agent Harness 框架

简洁

完备

生产可用

全屏 TUI

Shell 执行

Context Engineering

Long-Term Memory

Planning 模块

并发工具执行

推理内容展示

架构总览 ​

快速开始 ​

安装 ​

配置 API Key ​

启动 ​

架构总览

快速开始

安装

配置 API Key

启动