快速开始

安装

# 克隆并进入项目
git clone https://github.com/QUSEIT/simacode.git
cd simacode

# 安装依赖（开发环境可加 --with dev）
poetry install

终端工作流代理（CLI）

# 显示帮助
poetry run simacode --help

# 初始化工作流项目目录（生成 .simacode/ 配置）
poetry run simacode init

# 交互工作流任务及对话（ReAct 智能编排模式）
poetry run simacode chat --react --interactive

# 单次工作流对话
poetry run simacode chat "创建一个完整的Python项目，包含斐波那契函数、测试和文档"

工作流API服务（FastAPI + Uvicorn）

# 启动开发服务
poetry run simacode serve --host 0.0.0.0 --port 8000 --reload --debug

# 健康检查
curl http://localhost:8000/health

质量与校验

# 运行测试
poetry run pytest -v

# 覆盖率
poetry run pytest --cov=simacode --cov-report=html

# 代码风格与类型
poetry run black . && poetry run isort .
poetry run flake8 src/simacode
poetry run mypy src/simacode