{"id":"ea3cc352-5cb0-448a-9a5b-3fe969664890","slug":"dawu-agent","kind":"skill","name":"dawu-agent","summary":"一款面向数据分析与报告生成场景的企业级 AI Agent 平台。它采用 Harness Engineering 模式构建，内置多模型协作、向量记忆、安全沙箱、搜索引擎集成与可扩展工具生态，能够自主完成从数据读取、清洗、分析到可视化报告输出的完整工作流。","owner":"sofild","repoUrl":"https://github.com/sofild/dawu-agent","license":"Apache-2.0","licenseTier":"permissive","trust":"community","stars":3,"match":null,"fewStars":true,"format":"skill","createdAt":"2026-05-22T12:40:21.000Z","addedAt":"2026-10-21T21:13:10.592Z","logoUrl":"https://avatars.githubusercontent.com/u/4433471?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["writing"],"tags":[],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-25T19:36:16.907Z","sample":false,"url":"https://conduits.dev/tools/dawu-agent","language":"Python","transports":["stdio"],"install":{"pypi":"dawu-agent"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# 大悟智能体 (Dawu Agent)\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/badge/Python-3.10%2B-blue?logo=python\" alt=\"Python 3.10+\">\n  <img src=\"https://img.shields.io/badge/License-Apache%202.0-green.svg\" alt=\"License: Apache 2.0\">\n  <img src=\"https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey\" alt=\"Platform\">\n</p>\n\n**大悟智能体**是一款面向数据分析与报告生成场景的企业级 AI Agent 平台。它采用 Harness Engineering 模式构建，内置多模型协作、向量记忆、安全沙箱、搜索引擎集成与可扩展工具生态，能够自主完成从数据读取、清洗、分析到可视化报告输出的完整工作流。\n\n> 本项目在开发过程中使用了 [agent-harness-engineer](https://github.com/sofild/agent-harness-engineer) Skill 进行架构设计与代码生成指导。\n\n---\n\n## 核心能力\n\n| 能力 | 说明 |\n|------|------|\n| **多模型统一调度** | 兼容 OpenAI、Anthropic Claude、通义千问、DeepSeek 等主流模型，支持按场景自动路由 |\n| **数据分析工具链** | 内置 pandas/SQL 查询、数据可视化、报告生成（Markdown/HTML/Excel） |\n| **智能搜索增强** | 集成 Bing、百度千帆、Tavily 三大搜索引擎，支持时间感知自动过滤 |\n| **向量长期记忆** | 基于 ChromaDB 的语义记忆，自动关联历史会话上下文 |\n| **多 Agent 协作** | 数据工程师、分析师、报告撰写员等角色自动分工协作 |\n| **企业级安全** | 6 层安全防御（权限管理、Hook 校验、沙箱隔离、审计日志） |\n| **MCP 协议扩展** | 支持 Model Context Protocol，可快速接入外部工具与数据源 |\n\n---\n\n## 快速开始\n\n### 环境要求\n\n- Python 3.10+\n- Windows / macOS / Linux\n- 无需 Docker（沙箱自动降级为路径隔离）\n\n### 安装\n\n```bash\n# 克隆仓库\ngit clone <repo-url>\ncd dawu-agent\n\n# 创建虚拟环境\npython -m venv .venv\nsource .venv/bin/activate  # Windows: .venv\\Scripts\\activate\n\n# 安装依赖（国内用户推荐清华镜像）\npip install -e \".[dev]\" -i https://pypi.tuna.tsinghua.edu.cn/simple\n```\n\n> **注意**：Windows 用户若遇到 `onnxruntime` 错误，请执行：\n> ```bash\n> pip install chromadb==0.4.24 \"numpy<2.0\" -i https://pypi.tuna.tsinghua.edu.cn/simple\n> ```\n\n### 配置\n\n```bash\n# 复制环境模板\ncp .env.example .env  # Windows: copy .env.example .env\n```\n\n编辑 `.env`，填写模型 API 密钥：\n\n```bash\nMODEL_API_KEY=your-api-key\nMODEL_BASE_URL=https://api.openai.com/v1\nMODEL_NAME=gpt-4o\nMODEL_API_TYPE=openai\n\n# 搜索引擎 API Key（可选）\nBAIDU_API_KEY=your-baidu-key\nTAVILY_API_KEY=your-tavily-key\n```\n\n### 运行\n\n```bash\n# 交互式 CLI（推荐）\npython -m dawu_agent.cli.main run\n\n# 启动 API 服务\npython -m dawu_agent.cli.main server\n```\n\n---\n\n## 系统架构\n\n```\n用户输入\n    │\n    ▼\n┌─────────────────────────────────────────────┐\n│  Agent 核心（状态机 + 7 个恢复点）            │\n│  • 流式事件输出                              │\n│  • 自动上下文压缩                            │\n│  • 记忆注入与检索                            │\n└──────────┬────────────────┬─────────────────┘\n           │                │\n    ┌──────┴──────┐  ┌──────┴──────┐\n    ▼             ▼  ▼             ▼\n┌──────┐   ┌──────────┐   ┌──────────┐\n│  LLM │   │ 工具注册表 │   │ 向量记忆  │\n│ 路由 │   │ + MCP    │   │ ChromaDB │\n└──────┘   └──────────┘   └──────────┘\n                │\n    ┌───────────┼───────────┐\n    ▼           ▼           ▼\n┌──────┐  ┌────────┐  ┌──────────┐\n│文件操作│  │数据分析│  │搜索引擎  │\n│沙箱执行│  │可视化  │  │Bing/Baidu│\n└──────┘  └────────┘  └──────────┘\n```\n\n---\n\n## 配置体系（7 级优先级）\n\n| 优先级 | 来源 | 说明 |\n|:------:|------|------|\n| 1 | 命令行参数 | `--env production` |\n| 2 | 特性开关 | `ENABLE_MULTI_AGENT=true` |\n| 3 | 策略规则 | 管理员配置 |\n| 4 | 远程配置 | etcd / Consul |\n| 5 | 本地覆盖 | `config/local.yaml` |\n| 6 | 环境配置 | `config/development.yaml` |\n| 7 | 用户全局 | `~/.dawu/settings.yaml` |\n\n---\n\n## 项目结构\n\n```\ndawu-agent/\n├── src/dawu_agent/          # 核心源码\n│   ├── core/                # Agent 主循环、状态机、事件流\n│   ├── llm/                 # 多厂商 LLM 适配与路由\n│   ├── tools/               # 内置工具 + MCP 适配\n│   ├── context/             # 记忆管理、上下文压缩\n│   ├── security/            # 权限、Hook、沙箱、审计\n│   ├── multi/               # 多 Agent 协调器\n│   ├── config/              # 7 级配置加载器\n│   └── observability/       # 日志、指标、链路追踪\n├── config/                  # 环境配置文件\n├── sessions/                # 会话 WAL 持久化\n├── memory/                  # 向量数据库文件\n├── workspace/               # 沙箱工作目录\n├── skills/                  # 可扩展 Skill 目录\n└── tests/                   # 测试用例\n```\n\n---\n\n## 开发\n\n```bash\n# 运行测试\npytest\n\n# 代码检查\nruff check src\n\n# 类型检查\nmypy src\n\n# 格式化\nruff format src\n```\n\n---\n\n## 常见问题\n\n**Q: Windows 上提示 `onnxruntime` 未安装？**\nA: ChromaDB 的已知兼容性问题。已降级到 `chromadb==0.4.24`，如仍有问题请确保使用 Python 3.10 和 `numpy<2.0`。\n\n**Q: 如何添加自定义工具？**\nA: 在 `skills/` 目录下创建新模块，实现 `@skill` 装饰器标记的函数，Agent 会自动发现注册。\n\n**Q: 沙箱隔离级别如何切换？**\nA: 编辑 `config/development.yaml`：\n```yaml\nsandbox:\n  isolation_level: path   # 无 Docker 时使用 path\n```\n\n---\n\n## 开发背景\n\n本项目在开发过程中使用了 [agent-harness-engineer](https://github.com/sofild/agent-harness-engineer) Skill 进行架构设计与代码生成指导。该 Skill 提供了生产级 Agent 系统的构建范式，帮助团队快速搭建起包含状态机、Hook 系统、多模型路由、安全沙箱等核心模块的完整框架。\n\n---\n\n## 许可证\n\n[Apache 2.0](LICENSE)\n"}