中文 | English
基于 Python + LangGraph 的 SOP 驱动型受控 Agent 框架。将 LLM 的角色从"自主决策者"转变为"标准化作业程序（SOP）的数字执行员"，专为消费级硬件（RTX 3060 6GB）环境下的 qwen3:4b 模型设计。
核心价值：低成本（消费级硬件 + 4B 模型可跑）+ 数据完全本地（不上云，数据主权在你自己手里）。
v2 采用 REPL 外层 + LangGraph 执行内层 双层架构。REPL 提供交互式命令循环（/help /sops /history /clear /exit，Tab 补全），UserCoordinator 做意图分类与渐进确认，确认后加载 SOP 进入 LangGraph 执行图。所有 LLM 调用支持 token 级流式输出。
8 大设计要点详见 关键设计概述，各要点独立论述"做了什么、为什么这么做、不这么做会怎样"：
| # | 设计要点 | 核心思路 | 文档 |
|---|---|---|---|
| 1 | Thinker + Formatter 双阶段 | Thinker(temp 0.4)自由推理 + Formatter(temp 0.0)结构化提取 + Validator 重试兜底 | ThinkerFormatter设计.md |
| 2 | UserCoordinator 人机协作网关 | 五字段输出 + 三级渐进确认 + IS_EXECUTE 代码闸门 | UserCoordinator设计.md |
| 3 | Compactor 评价与历史压缩 | 三字段输出 + 代码管理历史生命周期 + 8K 上下文防溢出 | Compactor设计.md |
| 4 | SOP 存储与校验 | Markdown 7 section + 加载时 13 项校验 + CSV 轻量索引 | SOP体系设计.md |
| 5 | 工具合约与变量传递 | 四字段统一契约 + 字典路由 + VAR_ 变量传递 | 工具合约设计.md |
| 6 | 进度更新与重试 | 纯代码机械拼接 + 4 种追加模式 + 剥离-重建重试策略 | 进度更新与重试设计.md |
| 7 | 日志系统 | 按 round+node 分目录 + JSON 快照 + 文本日志互补 | 日志系统设计.md |
| 8 | 图结构与路由 | 3 节点硬编码路由 + task_status 字符串比对 + ProgressUpdater 无条件回 Scheduler | 图结构与路由设计.md |
更多文档：
- 架构总览 — 架构概述 | 架构论述
- 解决的痛点 — 痛点.md
- 任务与领域分类 — 任务和领域分类.md
- 进度更新机制 — 进度更新器设计手册.md
- REPL 模块设计 — repl设计文档.md
- SOP 编写规范 — sop编写规范.md
| 组件 | 要求 |
|---|---|
| 操作系统 | Ubuntu 24.04 LTS (x86_64) |
| GPU | NVIDIA RTX 3060 6GB（或同等显存） |
| Docker | Docker Engine + Docker Compose v2 |
| NVIDIA 组件 | NVIDIA 驱动 + NVIDIA Container Toolkit |
| Python | 3.10+ |
完整从零配置教程见 环境配置说明.md。
git clone https://github.com/GTLordLL/CutinAgent.git
cd CutinAgent
bash setup.sh
source .venv/bin/activate
python main.pysetup.sh 自动完成：环境自检 → 启动 Ollama 容器 → 拉取模型 → 创建定制模型 → 配置 Python 虚拟环境。全程幂等，失败自动清理。
启动后进入 REPL 交互界面，直接输入自然语言指令即可：
检查一下docker服务的运行状态我怀疑/var/log目录磁盘占用太大对当前系统做一次全面的健康检查
支持 /help /sops /history /clear /exit 等 REPL 命令，Tab 补全。所有 LLM 推理 token 级流式输出到终端。
cutin_agent/
├── main.py # 入口：资源初始化 → REPL 循环编排
├── repl/ # REPL 基础设施（命令处理、状态管理、会话管理）
├── config/ # 模型配置 (model_config.json)
├── graph/ # LangGraph StateGraph 构建与路由
├── llm_nodes/ # LLM 节点 (Thinker+Formatter 双阶段模式)
├── data_nodes/ # 非 LLM 数据节点 (ToolExecutor, ProgressUpdater)
├── prompts/ # 提示词模板
├── tools/ # 工具箱：ToolDispatcher + 11 个工具
├── sop/ # SOP 技能库 (Markdown 文件 + CSV 索引)
├── validator/ # 输出校验 (防幻觉)
├── utils/ # 资源加载、日志、流式输出
└── history/ # 运行时日志（git ignored）
新增 SOP 不改框架代码，但需满足前置条件：
- 理解工具集：熟悉
tools/tools.csv中每个工具的功能和参数约束 - 如果工具不够：按四字段契约格式封装新工具，注册到
tools/tools.csv - 编写 SOP 文件：创建
sop/NEW_SKILL.md，包含 7 个标准 section - 注册索引：在
sop/sops.csv中添加一行索引
SOP 编写规范详见 sop编写规范.md。
MIT License