chore: 初始化 bot042 项目(uv + deepagents)

This commit is contained in:
openbot committed 2026-11-05 14:49:27 +08:00
commit 94421e5c2b
20 files changed
+2213

No files matched your search

+72
View File
@@ -0,0 +1,72 @@
# bot042
基于 [deepagents](https://github.com/langchain-ai/deepagents) 的自主行动机器人原型:理解任务、自主规划(todo)、调用机器人工具在模拟环境中行动。
## 特性
- 深度智能体:内置任务规划 / 子智能体 / 工具调用循环(deepagents)
- 机器人工具:感知 `perceive`、移动 `move`、播报 `speak`,附带简易虚拟世界状态
- uv 管理依赖与 Python,国内镜像加速(见 `uv.toml`)
- CLI 入口:单次任务 / 交互模式
## 快速开始
```bash
uv sync
$env:OPENAI_API_KEY = "sk-..." # PowerShell;bash 用 export
uv run bot042 "感知环境,然后向北移动 2 步并播报状态"
```
交互模式:
```bash
uv run bot042 -i
```
## 配置(环境变量)
| 变量 | 说明 | 默认值 |
| --- | --- | --- |
| `BOT042_MODEL` | langchain 模型标识(`provider:model`) | `openai:gpt-4o-mini` |
| `OPENAI_API_KEY` | OpenAI 兼容 API Key | — |
| `OPENAI_BASE_URL` | 兼容网关地址(DeepSeek / Kimi 等均可) | 官方地址 |
| `BOT042_MAX_STEPS` | 单次任务最大步数(recursion_limit) | `50` |
| `BOT042_LOG_LEVEL` | 日志级别 | `INFO` |
使用 DeepSeek 等 OpenAI 兼容服务示例:
```bash
$env:OPENAI_BASE_URL = "https://api.deepseek.com/v1"
$env:OPENAI_API_KEY = "sk-..."
$env:BOT042_MODEL = "openai:deepseek-chat"
```
## 目录结构
```
src/bot042/
__main__.py # CLI 入口(uv run bot042)
config.py # 环境变量配置
agent/ # 智能体:组装(agent.py)、提示词(prompts.py)、工具(tools.py)
channels/ # 通道:与外部世界交互,base.py 定义协议,cli.py 为 CLI 实现
flows/ # 编排:单任务流程(task.py)、交互会话流程(session.py)
tests/ # 冒烟测试
uv.toml # 国内镜像配置(TUNA PyPI + npmmirror Python)
```
分层关系:`channels`(收/发消息)→ `flows`(组织流程)→ `agent`(智能体与工具)。新增通道实现 `channels.base.Channel` 协议即可复用现有 flows。
## 开发
```bash
uv run pytest # 运行测试
uv run ruff check # 代码检查
uv run ruff format # 格式化
```
## 镜像源
`uv.toml` 已配置国内镜像,`uv sync` / `uv python install` 均自动生效:
- PyPI 包:清华大学 TUNA — `https://pypi.tuna.tsinghua.edu.cn/simple`
- Python(python-build-standalone):npmmirror — `https://registry.npmmirror.com/-/binary/python-build-standalone`