使用说明
我最后的反馈
AI辅助工作流的开发人员配套GUI。提供交互式反馈、集成开发工具和知识管理——所有这些都在一个与您的AI编码代理配合使用的桌面应用程序中。
使用 光标, VS代码副本, 克莱恩, 帆板运动, 法典,以及任何支持 模型上下文协议.
内置于 我们走吧2.0+反应19 --二进制文件只有11MB。
特性
核心——互动反馈
| 特性 | 描述 |
|---|---|
| 反馈窗口 | 当代理请求反馈时,本机桌面弹出 |
| Markdown渲染 | 代理工作摘要显示为丰富的Markdown,带有KaTeX数学和Mermaid图 |
| 多呼叫者支持 | 多个AI客户端同时连接——标签切换、调用者合并、别名、重新排序 |
| 图像附件 | 文件选择器、Ctrl+V剪贴板粘贴或拖放(最多5张图像) |
| 结构化问题 | 客服可以在反馈表单中显示单选按钮选项或自由文本输入 |
| 快捷操作 | 一键预设响应(开始、继续、分析、修复等) |
| 自定义提示 | 放下 .prompt.md 文件进入 mcp_prompts/ 创建可点击的提交按钮 |
| MCP配置助手 | 内置配置生成器,具有自动检测的安装路径和一键复制功能 |
| 转移和拆分 | 将反馈转发给另一个来电者;将请求拆分为单独的子会话 |
| 会话导航 | 四种查看模式——活动、最近、搜索和每个呼叫者的历史记录 |
内置面板
| 面板 | 说明 |
|---|---|
| 终端 | 全PTY终端,支持多标签、缓冲区持久性和PS1感知输出 |
| Git | 日志历史记录、分阶段/非分阶段差异细分和一键快速备份 |
| 预览浏览器 | 嵌入式浏览器面板,用于检查正在运行的开发服务器或本地文件 |
| 我最后一次聊天(MLC) | 知识库侧面板——浏览、搜索、收藏和预览Markdown文档 |
| 项目资源 | 当前工作区的目录树浏览器 |
| 订阅 | 在一个位置监视仪表板提要、API使用情况和模型平衡 |
通用
| 特性 | 描述 |
|---|---|
| 双重主题 | 黑暗和光明主题支持 |
| 双语 | 完整的中英文界面 |
| 托盘+自动启动 | 带显示/退出的系统托盘;系统启动时的可选启动 |
| 单一实例 | 自动重用正在运行的实例 |
| 持久历史 | 所有会话、呼叫者和草稿反馈在重新启动后仍然有效 |
| 码头面板 | 可调整三列停靠布局的大小——在列之间拖动面板 |
运作原理
AI Agent ──stdio──▶ MCP Server (Node.js) ──TCP IPC──▶ Tauri Desktop App (GUI)
▲ ↓
│ User Feedback
│ ↓
AI Agent ◀── Text + Images ◀─────────────────────────── Submit
- AI客户端调用
interactive_feedback通过MCP协议的工具 mcp/mlfb/index.mjs通过TCP IPC连接到Tauri桌面应用程序- 用户查看代理的工作总结、撰写反馈并附加图像
- 反馈(文本+图像)通过MCP返回给代理
桌面应用程序在第一次调用时自动启动,并在后续请求中重复使用。在客户端断开连接时,所有挂起的会话都会自动取消。
快速开始
先决条件
- Node.js 18+
1.安装依赖项
npm install
2.配置您的AI工具
MCP入口点为 mcp/mlfb/index.mjs。将下面的路径替换为您的实际安装路径。
光标
增添 ~/.cursor/mcp.json (全球)或 <project>/.cursor/mcp.json (每个项目):
{
"mcpServers": {
"my-last-feedback": {
"command": "node",
"args": ["/path/to/my-last-feedback/mcp/mlfb/index.mjs"],
"timeout": 600,
"autoApprove": ["interactive_feedback"]
}
}
}
VS代码(副本)
增添 .vscode/mcp.json 在您的项目中:
{
"servers": {
"my-last-feedback": {
"command": "node",
"args": ["/path/to/my-last-feedback/mcp/mlfb/index.mjs"],
"timeout": 600
}
}
}
法典
编辑 ~/.codex/config.toml:
[mcp_servers."my-last-feedback"]
type = "stdio"
command = "node"
args = ["/path/to/my-last-feedback/mcp/mlfb/index.mjs"]
tool_timeout_sec = 64800
enabled = true
[mcp_servers."my-last-feedback".tools.interactive_feedback]
approval_mode = "approve"
关于基于Codex钩子的试剂名称注入,请参见 dist/codex-hooks/ 和 dist/SETUP.md.
Cline/风帆/其他
使用相同 command / args 工具MCP设置中的模式。模板可在以下网址获得 mcp.json.template.
内置 MCP配置助手 (齿轮图标→ 常规选项卡)可以根据您的实际安装路径自动生成正确的配置。
3.添加代理说明
将这些规则添加到AI工具的自定义说明中:
| 工具 | 位置 |
|---|---|
| 光标 | <project>/.cursor/rules/interactive_feedback.instructions.md |
| VS代码 | .github/copilot-instructions.md 或 .vscode/*.instructions.md |
| Codex | 复制内容 dist/prompt.instructions.md 根据您的食品法典委员会指示 |
| Cline | 设置中的自定义说明 |
## MUST FOLLOW:
Whenever you're about to complete a user request, call the interactive_feedback tool.
## Rules:
- Call interactive_feedback when user confirmation is needed (testing, terminal commands, reports, questions)
- Call interactive_feedback before completing any user request
- Keep calling interactive_feedback until the user's feedback is empty, then end the request
- Every interactive_feedback call MUST include request_type.
## Agent Identity (agent_name)
- agent_name is required. Use the 4-character identifier assigned by the feedback response or hook context.
- Do not invent or replace agent_name. If unknown, obtain the assigned identifier before calling interactive_feedback.
- On ALL subsequent calls, you MUST pass that identifier back as agent_name.
## Request Type (request_type)
- request_type is required in every call.
- Allowed values: analysis, completion, planning, document.
- Use analysis for analysis or reports, completion for finished work, planning for plans, document for document-related tasks.
- request_type is metadata for categorization and visual display only; it does not change tool behavior, permissions, routing, or available capabilities.
## Questions Feature
- When you need the user to supplement information or choose from options, use the questions parameter.
- questions is an array of { label, options? }. With options → radio buttons; without → free-text input.
- Questions are short labels only. Describe full context in summary, use questions for concise choices.
## Transfer Feature (transfer_to_alias)
- When user feedback contains transfer instructions (e.g. "send this to Alice"), set transfer_to_alias to the target alias in the next interactive_feedback call.
- Once transfer is triggered, continue calling interactive_feedback normally — the new caller will handle the remaining workflow.
4.完成
代理现在将在需要您确认时弹出一个反馈窗口。
工具参考
interactive_feedback
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project_directory |
string |
是 | 项目目录的完整路径 |
summary |
string |
是 | Markdown格式的工作总结(否 \n 逃逸序列) |
request_name |
string |
是 | 简洁的任务标题(5-10个字),显示在标题栏中 |
request_type |
string |
是 | 其中之一 analysis, completion, planning, document |
agent_name |
string |
是 | 4个字符的大写十六进制标识符。在后续通话中传递分配的ID |
questions |
array |
否 | 结构化问题: [{ label: string, options?: string[] }] |
transfer_to_alias |
string |
否 | 通过别名将会话转移给另一个调用者 |
返回值
返回MCP内容块列表(TextContent 和 ImageContent):
[
{ "type": "text", "text": "User feedback text" },
{ "type": "image", "data": "<base64>", "mimeType": "image/png" }
]
图像附件
| 方法 | 如何 |
|---|---|
| 文件选择器 | 单击附加按钮 |
| 剪贴板 | 在反馈区域按Ctrl+V |
| 拖放 | 将文件拖到窗口上 |
| 限制 | 值 |
|---|---|
| 最大图像数 | 5 |
| 每张图像的最大值 | 5 MB |
| 最大总计 | 20 MB |
| 格式 | PNG、JPG、GIF、WEBP、BMP |
自定义提示按钮
地方 .prompt.md 文件在 mcp_prompts/ 目录:
---
name: "Run Tests"
description: "Ask the agent to run the test suite"
icon: "play"
---
Please run the full test suite and report any failures.
单击按钮会将提示内容附加到反馈中并立即提交。
可用图标
book file file-text edit code terminal search message chat brain lightbulb star folder settings database link list check play zap compass layers globe target shield clock tag tool box hash wand sparkles clipboard rocket bug summary knowledge magic refresh send download upload alert info
设置
通过标题栏中的齿轮图标打开:
| 选项卡 | 内容 |
|---|---|
| 通用 | 自动启动,MCP配置助手 |
| 显示 | 主题(黑暗/光明),语言(中文/EN) |
| 提示 | 启用/禁用自定义提示按钮 |
| 关于 | 版本信息 |
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
MLF_APP_PATH |
覆盖Tauri二进制路径 | 自动检测 |
MLF_DEV |
在开发模式下运行(单独的数据目录) | 取消设置 |
MLF_CALLER_NAME |
覆盖呼叫者显示名称 | codex |
| 变量(Rust后端) | 描述 | 默认值 |
|---|---|---|
MLFB_REMOTE_ENABLED |
启用远程HTTP+WS服务器(实验) | 取消设置 |
实验特征(开发中)
这些特性存在于代码库中,但 未发货 在当前版本中。它们可能被置于功能标志之后,需要手动选择加入,或者实现不完整。
MLRA——多代理长时间运行的代理工作流
一个用于多代理、多阶段自主工作流的编排平台,具有人在环监督。
| 组件 | 状态 |
|---|---|
| Daemon(编排器、路由器、IPC网桥) | 代码已完成,未发货 |
| CEO/专家/检查员MCP服务器 | 代码完整,未发货 |
| 前端UI(MLRA视图、角色图标、舞台流水线) | 代码完成,UI隐藏(VITE_DISABLE_MLRA_UI=true) |
| 工作子代理池 | 已禁用(WORKER_ENABLED=false),代码保留 |
看 .myLastChat/MLC_MLRA_v2_三Server重构架构.md 和 mcp/mlra/ 了解架构细节。
安卓配套应用(android-mlfb/)
基于Kotlin的Android应用程序,用于接收和响应来自移动设备的反馈请求。通过Gradle与Tauri桌面应用程序分开构建。
看 android-mlfb/README.md 获取构建说明。
远程服务器
HTTP+WebSocket服务器(remote.rs)使移动客户端能够通过Tailscale进行连接。目前为阶段0骨架——只有 /api/health 端点已实现。通过以下方式选择加入 MLFB_REMOTE_ENABLED=1.
代理控制台
完整的子进程管理后端(agent_process.rs)--启动、写入stdin、读取stdout/stderr、杀死。React前端是完整的,但隐藏在后面 VITE_DISABLE_AGENT_UI=true.
从源头构建
需求
- Node.js 18+
- 锈蚀1.70+(含货物)
- Visual Studio生成工具(Windows)
构建
# Install dependencies
npm install
cd app && npm install
# Development mode
npx tauri dev
# Production build
npx tauri build --no-bundle
# Package for distribution
bash scripts/package-win.sh
输出: app/src-tauri/target/release/app.exe (Windows)或 app/src-tauri/target/release/app (macOS/Linux)
看 构建.md 获取完整的构建指南和 贡献.md 获取存储库维护指南。
项目结构
my-last-feedback/
├── mcp/ # MCP servers (Node.js)
│ ├── common/ # Shared utilities (port discovery, child launcher, bootstrap)
│ ├── mlfb/ # My Last Feedback MCP server
│ │ ├── index.mjs # Entry point (stdio MCP server)
│ │ ├── app-ipc.mjs # TCP IPC bridge to the Tauri app
│ │ ├── http-server.mjs # Optional HTTP MCP server
│ │ └── tools/ # Tool definitions
│ └── mlra/ # MLRA multi-agent orchestration (development / not shipped)
├── app/ # Tauri 2.0 desktop application
│ ├── src/ # React 19 frontend
│ │ ├── components/ # UI components
│ │ ├── store/ # Zustand state management
│ │ ├── i18n/ # Internationalization (en/zh)
│ │ └── transport/ # IPC transport layer
│ └── src-tauri/ # Rust backend
│ └── src/ # Tauri commands, IPC, terminal, preview browser, git, etc.
├── mcp_prompts/ # Custom prompt button templates
├── dist/ # Distribution package & Codex hooks
│ ├── codex-hooks/ # Codex hook scripts
│ └── win-x64/ # Windows x64 release package
├── android-mlfb/ # Android companion app (in development)
├── scripts/ # Build & packaging scripts (Win/Mac)
├── BUILD.md # Build guide
└── CONTRIBUTING.md # Repository maintenance guide
技术栈
| 层 | 技术 |
|---|---|
| 桌面框架 | Tauri 2.0 |
| 前端 | React 19+TypeScript+Vite 7 |
| CSS | 顺风CSS 4 |
| 国家管理 | Zustand 5 |
| 终端 | xterm.js 6 |
| Markdown | 反应Markdown+评论gfm+KaTeX+美人鱼 |
| 国际化 | i18next |
| MCP协议 | @modelcontextprotocol/sdk 1.12 |
| 后端 | Rust 2021(tokio、axum、便携式pty) |
文档
完整文档可在 https://anthropics.github.io/my-last-feedback/
本地文档开发
# Install dependencies
npm install
# Start documentation dev server
npm run docs:dev
# Build documentation
npm run docs:build
# Preview built documentation
npm run docs:preview
文档结构
- 指南:介绍、功能、安装、快速启动
- 发展:设置、架构、贡献、构建指南
- API:MCP协议、Tauri命令、IPC通信
- 发布:变更日志和版本历史
许可证
MIT许可证——见 许可证 全文。