完全使用 PHP 加 Neuron AI 框架构建的 AI 编码助手
Neuron 编码助手
完全使用 PHP Neuron AI 框架 构建的 AI 驱动编码助手。
Coding Agent 是一个命令行工具，帮助开发者完成各种软件工程任务。它在你的本地机器上运行，利用多家 AI 提供商提供智能辅助，包括编码、调试、代码审查等。
系统要求
PHP >= 8.1Composer安装方式
全局安装（推荐在任意目录使用）
代码语言：javascript复制composer global require neuron-core/coding-agent
确保 Composer 的全局 bin 目录已加入 PATH：
代码语言：javascript复制# 添加到你的 shell 配置文件（~/.bashrc、~/.zshrc 等）export PATH="$HOME/.config/composer/vendor/bin:$PATH"# 或者运行此命令查看全局 bin 路径composer global config bin-dir --absolute
项目本地安装（推荐用于特定项目）
作为开发依赖安装，避免全局污染：
代码语言：javascript复制composer require --dev neuron-core/coding-agent
然后在 composer.json 中添加自定义脚本，方便调用：
{"scripts": {"neuron": "vendor/bin/neuron"}}
之后在项目目录中即可运行：
代码语言：javascript复制composer neuroncomposer neuron "你的问题或指令"
配置
使用前需要配置 AI 提供商和 API Key。
创建配置文件 .neuron/settings.json
在项目根目录创建目录和文件：
代码语言：javascript复制mkdir -p .neuron && printf "{}" > .neuron/settings.json
Anthropic 示例
代码语言：javascript复制{"provider": {"type": "anthropic","api_key": "sk-ant-your-api-key-here","model": "claude-sonnet-4-20250514","max_tokens": 8192}}
OpenAI 示例
代码语言：javascript复制{"provider": {"type": "openai","api_key": "sk-your-openai-key-here","model": "gpt-4","max_tokens": 8192}}
Google Gemini 示例
代码语言：javascript复制{"provider": {"type": "gemini","api_key": "your-gemini-api-key","model": "gemini-pro","max_tokens": 8192}}
本地 Ollama 示例
代码语言：javascript复制{"provider": {"type": "ollama","base_url": "http://localhost:11434","model": "llama2"}}
其他支持的提供商（配置方式类似）
Cohere："type": "cohere" cohere.api_keyMistral："type": "mistral" mistral.api_key**Grok (xAI)**："type": "xai" xai.api_key（或 grok.api_key）Deepseek："type": "deepseek" deepseek.api_keyMCP 服务器配置（可选，扩展能力）
代码语言：javascript复制{"mcp_servers": {"filesystem": {"command": "npx","args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/workspace"]},"brave-search": {"command": "uvx","args": ["mcp-brave-search"]},"github": {"command": "npx","args": ["-y", "@modelcontextprotocol/server-github"],"env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-token"}}}}
注意：.neuron/settings.json 必须位于运行 neuron 命令时的当前工作目录。
使用方法
进入交互式聊天
代码语言：javascript复制neuron
单次提问
代码语言：javascript复制neuron "这个 PHP 错误怎么修复？"
在项目中使用（推荐）
代码语言：javascript复制cd /path/to/your/projectneuron
进入项目目录后，助手会自动读取当前目录文件，提供上下文相关的帮助。
典型对话示例：
代码语言：javascript复制> 这个项目是做什么的？> 请帮我 review UserController.php 文件，看看有没有安全问题> Auth.php 报 "Class not found" 错误，怎么办？> 能不能把 UserService 类改成依赖注入的形式？
支持的命令
代码语言：javascript复制neuron# 进入交互模式neuron "你的指令或问题"# 单次提问
功能亮点
多模型提供商支持：兼容 Anthropic Claude、OpenAI、Gemini、Cohere、Mistral、Ollama、Grok、Deepseek文件系统集成：可读取、搜索、分析任意项目目录中的代码MCP 支持：可接入 Model Context Protocol 服务器，扩展更多能力原生命令行体验：基于 Minicli 构建，终端使用流畅上下文感知：在给出建议前会理解项目整体结构安全优先：你的代码不会离开本地机器（除了发给 AI API 的必要部分）专注编程任务：系统 Prompt 针对软件工程场景深度优化工作原理
Coding Agent 由以下核心部分组成：
Neuron AI Framework：提供 Agent 架构和工具集成Settings 模块：从.neuron/settings.json 加载多提供商配置Provider Factory：根据配置动态创建对应 AI 提供商实例Minicli：负责命令行界面和路由助手可使用的文件系统工具包括：
列出目录内容读取文件在文件中搜索模式通过 glob 查找文件解析文档（PDF、HTML 等）
