| """ |
| Claude Agent 项目目录结构设计 |
| |
| 新的项目结构将更加清晰和专业化： |
| |
| claude-agent/ |
| ├── src/ # 源代码目录 |
| │ └── claude_agent/ # 主要包 |
| │ ├── __init__.py |
| │ ├── core/ # 核心功能 |
| │ │ ├── __init__.py |
| │ │ └── agent.py |
| │ ├── cli/ # 命令行界面 |
| │ │ ├── __init__.py |
| │ │ ├── interface.py # 原版CLI |
| │ │ └── enhanced_interface.py # 增强版CLI |
| │ ├── sshout/ # SSHOUT集成 |
| │ │ ├── __init__.py |
| │ │ └── integration.py |
| │ ├── mcp/ # MCP工具集成 |
| │ │ ├── __init__.py |
| │ │ ├── integration.py |
| │ │ └── tool_manager.py |
| │ └── utils/ # 工具函数 |
| │ ├── __init__.py |
| │ └── helpers.py |
| ├── tests/ # 测试目录 |
| │ ├── __init__.py |
| │ ├── unit/ # 单元测试 |
| │ │ ├── __init__.py |
| │ │ ├── test_core/ |
| │ │ │ ├── __init__.py |
| │ │ │ └── test_agent.py |
| │ │ ├── test_cli/ |
| │ │ │ ├── __init__.py |
| │ │ │ └── test_enhanced_interface.py |
| │ │ ├── test_sshout/ |
| │ │ │ ├── __init__.py |
| │ │ │ └── test_integration.py |
| │ │ └── test_mcp/ |
| │ │ ├── __init__.py |
| │ │ └── test_integration.py |
| │ ├── integration/ # 集成测试 |
| │ │ ├── __init__.py |
| │ │ └── test_full_workflow.py |
| │ ├── blackbox/ # 黑盒测试 |
| │ │ ├── __init__.py |
| │ │ └── test_end_to_end.py |
| │ ├── fixtures/ # 测试夹具和数据 |
| │ │ ├── __init__.py |
| │ │ └── test_data.py |
| │ └── conftest.py # pytest配置 |
| ├── docs/ # 文档目录 |
| │ ├── README.md |
| │ ├── ENHANCED_FEATURES.md |
| │ ├── API_REFERENCE.md |
| │ ├── DEVELOPMENT.md |
| │ └── TESTING.md |
| ├── scripts/ # 脚本目录 |
| │ ├── main.py # 主入口 |
| │ ├── main_enhanced.py # 增强版入口 |
| │ └── setup.py # 安装脚本 |
| ├── configs/ # 配置文件 |
| │ ├── default.yaml |
| │ └── production.yaml |
| ├── assets/ # 资源文件 |
| │ └── ssh-keys/ |
| ├── .gitignore |
| ├── pyproject.toml |
| ├── requirements.txt |
| └── README.md # 项目主README |
| |
| 重构原则： |
| 1. 源代码和测试完全分离 |
| 2. 按功能模块组织代码 |
| 3. 测试结构镜像源代码结构 |
| 4. 文档集中管理 |
| 5. 配置和脚本分离 |
| """ |