| commit | 96a372daf1bf682d785ce524b1d2d272664de5e5 | [log] [download] |
|---|---|---|
| author | Claude Agent Developer <claude-agent@example.com> | Fri Sep 26 21:22:15 2025 +0800 |
| committer | Claude Agent Developer <claude-agent@example.com> | Fri Sep 26 21:22:15 2025 +0800 |
| tree | d228a117cbae975f2f55bf0bf3711263d2fda588 | |
| parent | 5d32f3971678a624bb98250896d7e7379de2e00d [diff] |
fix(sshout): resolve connection stability issues and improve protocol handling Fix critical SSHOUT API connection stability issues where connections would drop immediately after establishment. This resolves the issue where users would see logout messages right after connection. Key Improvements: - Enhanced SSH object reference management to prevent garbage collection - Improved _get_online_users() to handle USER_STATE_CHANGE packets correctly - Added robust connection state detection in _read_exact() with timeout handling - Implemented keep-alive mechanism with SSH heartbeat packets every 30 seconds - Enhanced message listener with connection closed detection and error recovery Protocol Enhancements: - Handle multiple packet types during online user retrieval - Process USER_STATE_CHANGE packets before ONLINE_USERS_INFO - Improved error handling for connection timeouts and disconnections - Added connection health monitoring in background tasks Testing: - Added comprehensive unit tests for connection stability features - Enhanced test coverage for SSH object management and error scenarios - Added tests for packet handling edge cases and timeout conditions - All 109 unit tests pass with 48% code coverage (excluding test files) Configuration: - Added .coveragerc to exclude test files from coverage reporting - Updated CLAUDE.md requirements for 80% coverage target Breaking Change: Enhanced connection robustness may affect timing of connection establishment, but provides significantly better stability. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
基于ClaudeCodeSDK的功能丰富智能命令行Agent，支持增强CLI交互、SSHOUT聊天室集成和YOLO自主思考模式。
claude-agent/ ├── src/claude_agent/ # 源代码 │ ├── core/ # 核心功能 │ │ └── agent.py # Agent核心逻辑 │ ├── cli/ # 命令行界面 │ │ ├── interface.py # 基础CLI │ │ └── enhanced_interface.py # 增强CLI │ ├── sshout/ # SSHOUT集成 │ │ └── integration.py # 聊天室集成 │ ├── mcp/ # MCP工具支持 │ │ ├── integration.py # MCP集成 │ │ └── tool_manager.py # 工具管理 │ └── utils/ # 工具函数 │ └── helpers.py # 辅助工具 ├── tests/ # 测试套件 (55个单元测试 + 12个黑盒测试) │ ├── unit/test_*/ # 单元测试 (按模块组织) │ ├── integration/ # 集成测试 │ ├── blackbox/ # 端到端测试 │ └── fixtures/ # 测试数据 ├── docs/ # 项目文档 │ ├── ENHANCED_FEATURES_REPORT.md │ ├── COMPREHENSIVE_TEST_REPORT.md │ └── MCP_SUPPORT.md ├── scripts/ # 启动脚本 │ ├── main.py # 基础版本 │ └── main_enhanced.py # 增强版本 ├── configs/ # 配置文件 ├── assets/ssh-keys/ # SSH密钥文件 └── pyproject.toml # 项目配置
# Python 3.9+ 环境 source venv/bin/activate pip install -r requirements.txt
# 设置环境变量 export ANTHROPIC_API_KEY="your_api_key_here"
# 增强版CLI (推荐) python scripts/main_enhanced.py # YOLO自主模式 + 可视化思考过程 python scripts/main_enhanced.py --mode yolo # 自动连接SSHOUT聊天室 python scripts/main_enhanced.py --sshout # 组合使用 python scripts/main_enhanced.py --mode yolo --sshout
# 完整测试套件 python tests/run_tests.py # 单元测试 (100%通过率) pytest tests/unit/ -v # 黑盒测试 pytest tests/blackbox/ -v
# CLI中的SSHOUT命令 > sshout connect # 连接聊天室 > sshout status # 查看连接状态 > sshout send 消息 # 发送消息 > sshout disconnect # 断开连接
# 在CLI中使用 > help # 显示帮助 > status # 显示系统状态 > history # 查看历史记录 > mode # 切换思考模式 > tools # 显示可用工具
sshout_config = { 'hostname': 'tianjin1.rivoreo.one', 'port': 22333, 'username': 'sshout', 'key_path': 'assets/ssh-keys/id_ecdsa_sshout_test' }
@Claude、@claude、@CLAUDEClaude:、claude:# 格式化代码 black src/ tests/ isort src/ tests/ # 类型检查 mypy src/
# 添加新的单元测试 # tests/unit/test_[module]/test_[feature].py # 运行特定测试 pytest tests/unit/test_sshout/ -v
MIT License - 详见 LICENSE 文件
当前版本: v2.0.0 (增强版) 测试状态: ✅ 55/55 单元测试通过 功能状态: 🚀 生产就绪