AI Punk 自主软件开发助手

AI Punk是一款利用LangChain ReAct模式和先进AI模型构建的自主软件开发助手，能完全透明地展示代理的思维过程，让用户实时洞察其每一步决策，具备强大的自主执行能力，可独立规划并完成复杂的编程任务，为保障操作安全，AI Punk限定在安全的隔离工作空间内运行，并提供丰富的文件操作、代码搜索和终端命令等工具集。

思考全程可见：实时查看助手推理的每一个步骤 自主执行任务：能够独立规划并完成复杂任务 工作空间安全：仅在选定目录内工作，保障安全 工具集丰富：包含文件操作、终端命令、代码搜索及编辑等功能 界面美观：拥有丰富的终端界面，可可视化整个流程 国际化支持：自动检测用户使用的语言（英语/俄语） 性能高效：与LangChain快速集成，工具经过优化 国际化支持：自动检测用户使用的语言（英语/俄语）

AI Punk快速上手

1、安装依赖：

pip install -r requirements.txt

2、配置AI提供商：

python main.py
# 选择选项1 - 设置AI提供商

3、选择工作目录：

# 选择选项2 - 选择工作目录

4、初始化助手：

# 选择选项3 - 初始化助手

5、开始使用：

# 选择选项4 - 与助手开始聊天

过程透明度

AI Punk会展示助手完整的思考过程：

╭─ 🧠 助手思考（步骤1） ─────────────────────────────────────────────────────╮
│ 我需要先分析项目结构，了解我们要处理的内容，我先列出当前目录的内容吧，       │
╰──────────────────────────────────────────────────────────────────────────────────╯

╭─ ⚡ 助手行动 ─────────────────────────────────────────────────────────────────╮
│  🔧 工具：  list_directory                                                        │
│  📝 输入： "."                                                                   │
╰──────────────────────────────────────────────────────────────────────────────────╯

╭─ ✅ 执行结果（0.15秒） ────────────────────────────────────────────────╮
│ [助手的最终答案]                                                           │
╰──────────────────────────────────────────────────────────────────────────────────╯

项目结构

ai-punk/
├── main.py             # 应用入口点
├── src/
│   ├── agent/          # 具有透明度的LangChain ReAct助手
│   ├── tools/          # 文件操作和系统工具
│   ├── ui/             # 丰富的终端界面
│   ├── config.py       # 配置管理
│   ├── workspace.py    # 安全的工作空间管理
│   └── localization.py # 国际化支持
├── requirements.txt    # Python依赖
└── README.md           # 此文件

可用工具

文件操作：list_directory（列出目录）、read_file（读取文件）、edit_file（编辑文件） 搜索：grep_search（用于查找代码模式） 终端：run_terminal（用于执行命令） 安全：所有操作均限制在选定的工作空间内

依赖项

• Python 3.8+：核心运行时 • LangChain：ReAct助手和AI模型集成 • Rich：美观的终端界面 • OpenAI/Google/Anthropic：AI模型提供商

语言支持

AI Punk会自动检测用户的语言并做出相应回应： • 英语：文档和系统消息的默认语言 • 俄语：完全支持，可自动检测 • 混合语言：优先考虑用户输入中的主要语言

安全特性

• 工作空间隔离：助手无法访问选定目录之外的文件 • 路径验证：所有文件操作仅使用相对路径 • 安全执行：终端命令在受控环境中运行

AI Punk使用示例

基本文件分析：

用户：“分析项目结构，告诉我这个代码库的作用”
助手：[分析文件，提供详细解释]

代码修改：

用户：“给main.py文件添加错误处理”
助手：[读取文件，添加适当的错误处理，解释所做更改]

多语言交互：

用户：“создай новый файл config.json с базовыми настройками”（创建一个带有基本设置的新文件config.json）
助手：[用俄语回应，按要求创建文件]