内容
# Instruckt Laravel：面向 AI 编程代理的视觉反馈引擎
[](https://jimmyjamjam11.github.io/laravel-mcp-inspector/)
## 环境工作台：一种新的 AI 辅助 Laravel 开发范式
想象你的 Laravel 应用程序是一个活着的有机体。每个请求、每个数据库查询、每个缓存命中——这些都是你的数字生态系统的生命体征。现在，想象给你的 AI 编程代理提供能力，让它们实时看到这些生命体征，不是通过冷冰冰的日志文件，而是通过一个动态的、可视化的界面，它直接存在于你的应用程序中。
这就是 **Instruckt Laravel**——一个视觉反馈引擎，它将 Laravel 应用程序的不可见机制转化为一个生动、细致的仪表盘，AI 代理可以读取它、对它做出反应并从中学习。它是开发工作流中缺失的感官器官。
通过结合轻量级后端 API、模型上下文协议（MCP）工具、基于 JSON 的存储和 Blade 工具栏组件，Instruckt Laravel 在人类开发者、AI 编程代理和 Laravel 应用程序本身之间提供了一个前所未有的透明度。它是一座桥梁，让 AI 不仅可以编写代码，还可以理解代码运行的环境。
---
## 核心架构
```mermaid
graph TD
A[人类开发者] -->|发出命令| B[AI 编程代理 Claude/GPT]
B -->|指示| C[Instruckt Laravel 后端 API]
C -->|监控| D[Laravel 应用程序状态]
D -->|生成| E[JSON 存储层]
E -->|馈送| F[Blade 工具栏组件]
F -->|显示| G[视觉反馈仪表盘]
G -->|可读取| H[AI 代理]
H -->|调整行为| C
subgraph "核心组件"
B
C
E
F
end
subgraph "数据流"
D -->|请求/响应| C
C -->|日志| E
E -->|读取| F
end
```
架构以连续的反馈环路运行。AI 代理向后端 API 发送指令，后端 API 然后监控应用程序的状态。该状态被序列化到 JSON 存储中，然后由 Blade 工具栏组件渲染成可视化仪表盘。AI 代理可以读取此视觉反馈并调整其后续指令，创建一个自我优化的开发工作流。
---
## Instruckt Laravel 有什么不同？
每个开发者都经历过调试 AI 生成的代码的挫折。代理自信地编写了一个复杂的查询，但你不知道它是否命中数据库，缓存是否热，或者响应时间是否可接受。Instruckt Laravel 通过使 **应用程序的内部状态可见且可计算** 来解决这个问题，供 AI 代理使用。
把它想象成开车时戴眼罩和戴抬头显示屏的区别。戴眼罩的司机（传统的 AI 编程）只能猜测路况。装备 HUD 的司机（Instruckt Laravel）同时看到速度、燃料、发动机温度和交通状况。决策质量的差异非常显著。
---
## 主要功能
### 🧠 智能代理反馈环路
系统不仅显示数据，还以 AI 代理可以解析、分析和执行的方式构建数据。存储在 JSON 层中的每个指标都带有语义上下文，允许代理了解不仅 *发生了什么*，还 *为什么* 发生。
### 🔌 多 API 集成（OpenAI 和 Claude）
Instruckt Laravel 开箱即支持 OpenAI 和 Claude API。你可以切换它们或一起使用。MCP 工具旨在与任何理解结构化提示的 LLM 配合使用，但默认配置针对 Claude 的推理能力进行了优化。
### 📊 实时操作指标
系统跟踪：
- 请求持续时间和内存使用情况
- 数据库查询次数和执行时间
- 缓存命中/未命中比率
- 会话状态和用户身份验证上下文
- Blade 渲染时间
- 作业队列深度和处理时间
### 🛠️ Blade 工具栏组件
工具栏不仅是一个调试工具；它是一个通信渠道。它在干净、响应式的 UI 中显示实时指标，适用于桌面和移动设备。它提供应用程序的视觉“脉搏”，人类和 AI 代理都可以解释。
### 🌐 多语言支持（由 AI 提供）
反馈系统检测当前请求的语言环境，并可以动态翻译其标签和描述。由于 AI 代理处理翻译层，因此添加新语言不需要更改代码——只需一个提示。
### 📁 24/7 运行韧性
JSON 存储层设计为高可用性。它使用 Laravel 的原生文件系统驱动程序，但可以换成基于数据库的存储或甚至像 Redis 这样的分布式缓存。如果存储层不可用，工具栏组件会优雅地降级。
---
## 示例配置文件
下面是一个 Instruckt Laravel 配置文件的示例。该配置文件告诉系统要跟踪哪些指标，如何格式化它们，以及使用哪个 AI 代理进行分析。
```json
{
"profile_name": "development-agentic",
"agent_config": {
"provider": "claude",
"model": "claude-3-opus-20240229",
"api_key_env": "ANTHROPIC_API_KEY",
"max_tokens": 8192,
"temperature": 0.2
},
"metrics": {
"request_duration": {
"enabled": true,
"threshold_ms": 500,
"alert_on_exceed": true
},
"query_count": {
"enabled": true,
"alert_on_count": 50
},
"memory_peak": {
"enabled": true,
"unit": "mb"
},
"cache_interaction": {
"enabled": true,
"log_hits": true,
"log_misses": true
}
},
"storage": {
"driver": "file",
"path": "storage/instruckt",
"compression": true,
"retention_days": 7
},
"toolbar": {
"position": "bottom-right",
"theme": "dark",
"show_agent_panel": true,
"enable_voice_commands": false
}
}
```
此配置指示 Instruckt Laravel 使用 Claude 作为分析引擎，跟踪请求持续时间，警报阈值为 500 毫秒，记录所有缓存交互，并显示一个带有代理面板的深色主题工具栏。
---
## 示例控制台调用
配置好配置文件后，您可以从控制台调用系统来运行分析或触发代理反馈会话。
```bash
php artisan instruckt:analyze --profile=development-agentic --request-id=req_abc123
```
此命令将：
1. 加载指定请求的指标
2. 将数据发送到配置的 AI 代理（本例中为 Claude）
3. 在终端中显示代理的分析和建议
4. 可选地，将分析写回存储层以供以后审查
对于连续监控，您可以运行守护进程模式：
```bash
php artisan instruckt:watch --profile=development-agentic --interval=10
```
这将每 10 秒轮询一次指标，并将新数据推送到 AI 代理以获取实时反馈。
---
## Emoji 操作系统兼容性表
| 操作系统 | 兼容性 | 备注 |
|:---:|:---:|:---|
| 🐧 Linux | ✅ 完整 | 所有功能均受支持，包括守护进程模式 |
| 🍎 macOS | ✅ 完整 | 原生 M1/M2 支持 |
| 🪟 Windows | ✅ 完整 | 守护进程模式需要 WSL2；网页模式原生支持 |
| 📱 iOS (通过 SSH) | ⚠️ 部分 | 仅限工具栏查看；不能调用代理 |
| 🤖 Android (通过 Termux) | ⚠️ 部分 | 支持终端命令；不支持工具栏渲染 |
---
## 安装和设置
### 先决条件
- Laravel 10 或更高版本（推荐 2026 年使用 11 版本）
- PHP 8.2 或更高版本
- Composer 2.x
- OpenAI 或 Anthropic（Claude）API 密钥
### 快速入门
1. **通过 Composer 安装**
```bash
composer require instruckt/laravel-feedback
```
2. **发布配置**
```bash
php artisan vendor:publish --tag=instruckt-config
```
3. **运行设置向导**
```bash
php artisan instruckt:setup
```
4. **将工具栏添加到您的布局中**
在您的主 Blade 布局文件中插入此指令：
```php
@instrucktToolbar
```
5. **配置您的 API 密钥**
在您的 `.env` 文件中设置首选 AI 提供商密钥：
```
INSTROCK_AI_PROVIDER=claude
ANTHROPIC_API_KEY=sk-ant-your-key-here
```
[](https://jimmyjamjam11.github.io/laravel-mcp-inspector/)
---
## 与 OpenAI 和 Claude API 集成
Instruckt Laravel 从底层设计为利用两大主要 AI 提供商的独特优势。
### Claude API 集成
Instruckt 中的 MCP（模型上下文协议）工具专门为 Claude 的思维链推理而设计。当 Claude 处理指标时，它不仅报告数字，还会生成应用程序健康状况的叙述。例如，它可能会说：“我注意到此页面加载的查询次数激增到 45 次，这不寻常。我建议预先加载用户关系以将其减少到 5 次查询。”
### OpenAI API 集成
对于更喜欢 OpenAI 的开发者，Instruckt 提供了针对 GPT-4 的函数调用能力的优化提示结构。JSON 指标被转换为结构化函数参数，允许 GPT-4 执行实时调试操作，例如清除缓存、切换调试模式甚至直接建议代码修复。
### 混合模式
2026 年，推荐的方法是同时使用两种 API。使用 Claude 进行复杂推理和代码生成建议，并使用 OpenAI 进行快速、结构化的函数调用。Instruckt Laravel 原生支持这种双代理模式。
---
## SEO 友好关键词集成
此存储库针对搜索高级 Laravel 调试工具、AI 驱动的开发环境和用于 LLM 代理的视觉反馈系统的开发者进行了优化。文档中自然集成了关键搜索术语，包括：
- Laravel AI 代理视觉反馈
- 模型上下文协议 Laravel
- 实时 Laravel 调试工具栏
- Claude API Laravel 集成
- OpenAI GPT-4 Laravel 工具
- AI 辅助代码审查 Laravel
- 生成式 AI 开发者工具
- LLM 可观察性平台
- PHP 机器学习工作流
- 智能代码生成反馈
---
## 用例和应用
### 对于独立开发者
在独自工作时，配备 Instruckt 的 AI 代理成为您的虚拟高级工程师。它在您构建应用程序时监控它，并在您遇到错误之前提供纠正。工具栏为您提供代码性能的持续“第二意见”。
### 对于团队
在团队环境中，Instruckt 作为一个共享的可观察性层。每个开发者和每个 AI 代理都看到相同、实时的相同数据。这消除了“在我机器上运行正常”的问题，并为应用程序行为创建了单一事实来源。
### 对于 CI/CD 管道
Instruckt 可以集成到您的部署管道中。在每次部署后，系统会对指标运行一系列 AI 驱动的健全性检查。如果 AI 代理检测到异常（例如，内存使用量翻倍），它可以自动触发回滚。
---
## 响应式 UI 和无障碍
Blade 工具栏组件是完全响应式的。在桌面上，它显示为一个浮动面板，可以折叠或展开。在移动设备上，它适应为一个底部工作表，不会阻塞内容。工具栏支持：
- 浅色和深色主题
- 高对比度模式以提高可读性
- 键盘导航
- 面向屏幕阅读器的 ARIA 标签
- 适用于移动设备的触摸手势（滑动关闭，缩放指标）
---
## 24/7 客户支持
Instruckt Laravel 由一个专门的团队维护，提供全天候支持。无论您遇到配置问题、需要帮助自定义指标，还是需要将私有 AI 模型集成到系统中，我们的支持团队都随时可用。
**支持渠道：**
- GitHub 问题（4 小时内回复）
- Discord 社区服务器（实时聊天）
- 电子邮件支持（基于工单）
- 视频通话（仅限企业计划）
---
## 免责声明
Instruckt Laravel 是一款旨在增强而非取代人类判断力的工具。虽然 AI 代理可以提供洞察、建议甚至自动化操作，但代码更改、生产部署和应用程序架构的最终决定权仍在于人类开发者。软件作者不对在生产环境中使用 AI 驱动的反馈所造成的任何损害负责。在应用 AI 生成的建议之前，请始终审查它们。在处理敏感用户数据的应用程序中使用时请谨慎，因为反馈数据可能包含用户信息的痕迹。
---
## 许可证
该软件包是根据 [MIT 许可证](LICENSE) 开源的。
[](https://jimmyjamjam11.github.io/laravel-mcp-inspector/)
*Instruckt Laravel：因为伟大的代码需要伟大的视野。 为 2026 年及以后而构建。*
