聊聊那个基于 PHP 构建的 AI 编码助手——Neuron。坦白说，这类工具这几年出了不少，但真正让人眼前一亮的并不多。它本质上是一个命令行工具，跑在你的本地机器上，通过对接多家 AI 提供商来帮你完成编码、调试、代码审查这些软件工程任务。简单理解，就是给你的终端请了个全能副驾。
Neuron 编码助手
Coding Agent 是一个命令行工具，帮助开发者完成各种软件工程任务。它在你的本地机器上运行，利用多家 AI 提供商提供智能辅助，包括编码、调试、代码审查等。
系统要求
想跑起来，环境得先达标：PHP >= 8.1，以及 Composer。别小看版本要求，PHP 8.1 带来的枚举、只读属性这些特性，是整个框架高效运转的基础。
安装方式
怎么装机？两个主流方案，看你具体场景。
全局安装（推荐在任意目录使用）
如果你希望在任何项目目录下都能直接调用，全局安装是最省心的。一行命令搞定：
composer global require neuron-core/coding-agent
之后记得确保 Composer 的全局 bin 目录已加入 PATH，不然系统找不到命令。把下面这行加到你的 shell 配置文件里（~/.bashrc、~/.zshrc 都行）：
export PATH="$HOME/.config/composer/vendor/bin:$PATH"
如果你不确定全局 bin 目录在哪，用 composer global config bin-dir --absolute 查一下就行。
项目本地安装（推荐用于特定项目）
如果你只想在某个项目里用它，避免全局污染，本地开发依赖是更好的选择：
composer require --dev neuron-core/coding-agent
然后在 composer.json 里加个自定义脚本，调用更方便：
{"scripts": {"neuron": "vendor/bin/neuron"}}
之后在项目目录里，直接 composer neuron 或者 composer neuron "你的问题或指令" 就能跑起来了。
配置
用之前必须先配好 AI 提供商和 API Key。这一步绕不开，但好处是灵活性极高——想换哪家换哪家。
创建配置文件 .neuron/settings.json
在项目根目录下创建目录和空文件：
mkdir -p .neuron && printf "{}" > .neuron/settings.json
下面给出几种主流提供商的配置示例，照着填就行。
Anthropic 示例
{"provider": {"type": "anthropic","api_key": "sk-ant-your-api-key-here","model": "claude-sonnet-4-20250514","max_tokens": 8192}}
OpenAI 示例
{"provider": {"type": "openai","api_key": "sk-your-openai-key-here","model": "gpt-4","max_tokens": 8192}}
Google Gemini 示例
{"provider": {"type": "gemini","api_key": "your-gemini-api-key","model": "gemini-pro","max_tokens": 8192}}
本地 Ollama 示例
如果你追求完全的本地化、零网络依赖，Ollama 是绝佳选择：
{"provider": {"type": "ollama","base_url": "https://localhost:11434","model": "llama2"}}
其他支持的提供商（配置方式类似）
Cohere、Mistral、Grok (xAI)、Deepseek 也都原生支持，配置参数基本一样，把 type 和 api_key 换成对应的就行。
MCP 服务器配置（可选，扩展能力）
如果你想给助手开点外设，比如让它能操作文件系统、联网搜索、直接调 GitHub API，那就配 MCP 服务器。举个例子：
{"mcp_servers": {"filesystem": {"command": "npx","args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/workspace"]},"bra ve-search": {"command": "uvx","args": ["mcp-bra ve-search"]},"github": {"command": "npx","args": ["-y", "@modelcontextprotocol/server-github"],"env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-token"}}}}
一个关键提醒：.neuron/settings.json 必须放在你运行 neuron 命令时的当前工作目录下，否则它找不到配置。
使用方法
玩法很灵活，两种主流模式：
进入交互式聊天
直接输入 neuron，进入会话模式，可以连续提问，上下文连贯。
单次提问
像这样 neuron "这个 PHP 错误怎么修复？"，问完即止，适合快速解决问题。
在项目中使用（推荐）
先 cd 到项目目录，再运行 neuron。助手会自动读取当前目录的文件结构，给出上下文相关的建议。典型对话场景比如：
> 这个项目是做什么的？
> 请帮我 review UserController.php 文件，看看有没有安全问题
> Auth.php 报 "Class not found" 错误，怎么办？
> 能不能把 UserService 类改成依赖注入的形式？
功能亮点
一圈用下来，几个最戳人的点：
- 多模型提供商支持：Anthropic、OpenAI、Gemini、Cohere、Mistral、Ollama、Grok、Deepseek……几乎覆盖了主流玩家，想用哪个全看心情。
- 文件系统集成：能直接读取、搜索、分析项目目录里的代码，不用手动复制粘贴。
- MCP 支持：接入 Model Context Protocol 服务器，扩展能力边界，比如联网搜索、操作文件系统、调用 GitHub API。
- 原生命令行体验：基于 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 文件里，不过网不传。
