feat: 重构为 agent / channels / flows / db 分层架构

- agent: 新增 base.py 执行基类、execution.py 执行器、web.py 网络工具,
  middlewares/steering.py 中间件;移除旧的 agent.py
- channels: 新增 ChannelManager、registry、models 与 IM 渠道(企业微信),
  扩展 base.py
- flows: 新增 agent_task / bus / cron / scheduler / service / stream / rpc /
  processor / tasks / model_settings / builtin;移除旧的 task.py
- db: 新增 sqlite schema 与 repo 层
- docs: 新增架构说明、Channel × EventBus 设计、任务编写教程
- 依赖新增 aiosqlite / httpx / langgraph / primp / pydantic / ripgrep /
  wecom-aibot-sdk;新增 bot 命令入口
- 测试:232 passed
This commit is contained in:
openbot committed 2026-11-09 20:32:25 +08:00
1 parent 94421e5c2b
commit fbb01c4c83
65 files changed
+15322 -173

No files matched your search

+101
View File
@@ -0,0 +1,101 @@
"""基于 deepagents 组装自主行动智能体。"""
from __future__ import annotations
from collections.abc import Sequence
from pathlib import Path
from typing import Any
from deepagents import create_deep_agent
from deepagents.backends import LocalShellBackend
from langchain.agents.middleware.types import AgentMiddleware
from langgraph.graph.state import CompiledStateGraph
from bot042.agent.middlewares.steering import SteeringMiddleware
from bot042.agent.prompts import SYSTEM_PROMPT
from bot042.agent.tools import get_tools
from bot042.config import Settings
EXECUTE_TIMEOUT = 120
"""单条 shell 命令的默认超时秒数(可由模型在单次调用里放宽)。"""
def _build_backend(settings: Settings) -> LocalShellBackend:
"""本地执行后端:真实磁盘 + 宿主机 shell,没有沙箱隔离。
- ``root_dir`` 取 home 目录:文件工具的虚拟路径(如 ``/plan.md``)落在
``~/.bot042`` 内,不把宿主目录搅乱;
- shell 不受 ``root_dir`` 限制,``execute`` 能跑任意命令、直接调用 Python;
- ``inherit_env=True`` 让 PATH 等变量可见(否则连解释器都找不到),
代价是模型也能读到进程环境里的密钥——本地单机原型接受这个取舍。
"""
root = Path(settings.home)
root.mkdir(parents=True, exist_ok=True)
return LocalShellBackend(
root_dir=root,
virtual_mode=True,
timeout=EXECUTE_TIMEOUT,
inherit_env=True,
)
def _build_model(settings: Settings) -> Any:
"""按配置构建模型;没有显式凭据时回退到 ``"provider:model"`` 字符串。
- 无 ``api_key`` 且无 ``base_url``:返回字符串,由 langchain 从环境变量取凭据
(行为与改造前一致);
- 有凭据:直接构造 ``ChatOpenAI``,支持数据库里配置的 OpenAI 兼容网关;
- 非 ``openai`` 前缀(如 ``anthropic:``)暂不支持显式凭据,同样回退字符串。
"""
if not settings.api_key and not settings.base_url:
return settings.model
provider, sep, name = settings.model.partition(":")
if sep and provider != "openai":
return settings.model
from langchain_openai import ChatOpenAI
# 本地网关可能不校验密钥,但 AsyncOpenAI 不接受空值,用占位串兜底
kwargs: dict[str, Any] = {
"model": name if sep else settings.model,
"api_key": settings.api_key or "EMPTY",
}
if settings.base_url:
kwargs["base_url"] = settings.base_url
return ChatOpenAI(**kwargs)
def create_agent(
settings: Settings | None = None,
*,
interrupt_on: dict[str, Any] | None = None,
middleware: Sequence[AgentMiddleware[Any, Any, Any]] = (),
) -> CompiledStateGraph[Any, Any, Any, Any]:
"""构建 deepagents 智能体(返回图支持 `ainvoke` 异步调用)。
- FilesystemMiddleware:ls/read_file/write_file/edit_file/delete/glob/grep,
后端支持执行时额外挂载 ``execute``(shell 命令)
- SubAgentMiddleware:task(子智能体派发)
- SummarizationMiddleware:compact_conversation(上下文压缩)
``backend`` 显式固定为 :class:`LocalShellBackend`:文件真实落盘、命令直接
在宿主机执行(无沙箱)。这一条是有意为之——原型需要读写真实文件、跑
bash 与 Python;不要依赖 deepagents 的默认后端,默认值变化会让能力悄悄漂移。
人工确认(HumanInTheLoopMiddleware)通过 interrupt_on 启用,例如
{"move": True, "execute": True} 表示调用前中断、等待人工确认。
model 支持 langchain 的 "provider:model" 标识,如
"openai:gpt-4o-mini"、"openai:deepseek-chat"(配合 OPENAI_BASE_URL)等。
"""
settings = settings or Settings.from_env()
# SteeringMiddleware 放最前:每轮模型调用前都先消化插话
return create_deep_agent(
model=_build_model(settings),
tools=get_tools(),
system_prompt=SYSTEM_PROMPT,
backend=_build_backend(settings),
middleware=[SteeringMiddleware(), *middleware],
interrupt_on=interrupt_on,
)