完全使用 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 中添加自定义脚本，方便调用：

代码语言：javascript

复制

{"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_key

MCP 服务器配置（可选，扩展能力）

代码语言：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 等）

安全性

代码仅在本地处理，只把必要片段发送给所选 AI API不会把代码存储到外部服务器（API 提供商的请求日志除外）文件系统工具只读不写、不执行API Key 只保存在你本地的 settings 文件中本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。原始发表：2026-03-04，如有侵权请联系[email protected] 删除