Kongming Agent

kongming-agent

简体中文 · English

async-first 的通用 agent 内核——单一 run loop 之上叠加 LLM 自选的多 agent workflow 编排，自带主动观察者（司天）、自我进化证据链和三层安全链。

• 不只是 coding agent——内核与场景无关，工具层可接 file / shell / memory / skill / MCP server；通过 sidecar 接入桌面/移动宿主，computer use 开发中
• LLM 自己选编排策略——对话中调用 run_agent_workflow，在 parallel / map_reduce / deep_research / roundtable_review / task_flow 里挑一个，把目标拆给独立 session 的子 agent 协作
• 司天：agent 会主动观察——不等你提问，后台扫描工作区，物化 work_item 和下一步建议
• 自我进化——每轮对话结束后台复盘证据窗口，把 review 与进化养料（memory / workflow / error 三类）写回长期记忆
• 三层安全链 + thread 本子——DangerGuard → 审批模式 → 按 thread 独立 allow/deny，cron task 还能声明自己的审批模式
• 模型无关，本地零成本起步——OpenAI-compat / Anthropic 都接，本地 preset 自动跳过远端 key 校验
• 工程纪律可执行——import-linter 强制架构边界、协议单一真源、@override 强制、commit+push 双层 hook

---

目录

• Quick Start
• 独特能力
• 架构一览
• 功能概览
• 开发命令
• 设计原则
• 范围与现状
• Roadmap
• 许可证

---

Quick Start

1. 安装依赖

cd /path/to/kongming-agent
uv sync --all-extras

或用统一入口脚本：

./start.sh install        # macOS / Linux

Windows 暂无等价入口脚本，请用 `uv sync --all-extras`。

2. 配模型 key

模型通过 **preset catalog**（`config/model-providers.yaml`）选择，不再用裸 base_url + 模型名拼装。**默认 preset 是 `local-gemma-4-e4b-it`（本地）**——开箱即用需要先起一个监听 `127.0.0.1:62000` 的 OpenAI 兼容服务（LM Studio / Ollama / vLLM 均可），本地 preset 自动跳过远端 key 校验。想用远端模型时切到 `minimax-m3` / `deepseek` / `bigmodel-glm5-1m` 等 preset 并配上对应的 provider key。

cp .env.exa