AI导哈

GitHub Copilot 人机交互代理

HumanAgent MCP 是一个 VS Code 扩展，通过在 GitHub Copilot 执行操作前强制进行人机对话，增强对 AI 行为的控制，减少不必要的 API 调用，并提供多工作区管理功能。

  • by 3DTek-xyz
  • TypeScript
  • 本地部署
  • 18 星标
  • 更新于
在 GitHub 查看 3DTek-xyz/HumanAgent-MCP

使用说明

HumanAgent MCP

强制GitHub Copilot在行动前与您聊天。停止失控的代理，减少浪费的API调用，允许您从一个接口管理多个工作区。

项目状态

这个项目没有维护，正在寻找新的维护者。

我仍然认为它解决的问题很重要：VS Code中的GitHub Copilot可以默认为过于自主的“什么都做”风格，而这个项目的构建是为了增加更强的人在循环控制。特别是，代理/拦截行为旨在让您覆盖宽松的加农炮默认设置，并将Copilot引导到更慎重的、先签入的工作流程。

我不再经常使用VS Code或GitHub Copilot，所以我不能很好地维护、验证或支持这个扩展。

如果你觉得这种方法很有价值，请随时分叉项目、打开问题或接管维护。

安装

  1. 从打包的安装 .vsix 从源代码捆绑或构建
  2. Copilot自动获取 HumanAgent_Chat 工具
  3. 完成-无需配置
  4. 建议从齿轮菜单中选择“创建覆盖文件”选项。 这将在.vcode目录中创建一个“HumanAgentOverride.json”，并添加一些您想要使用的重要自定义。您可以设置一些“提醒”文本，将其包含在每个惰性气体中——仅此一项就值得。

如果扩展名不再列在VS Code Marketplace中，您仍然可以通过以下方式使用它：

  • 下载版本 .vsix 并使用 Extensions: Install from VSIX...
  • 建立自己的 .vsix 来源于with npx @vscode/vsce package

如何使用

基本工作流程

  1. 让副驾驶做点什么——明确表示你希望通过人工智能聊天得到回复 -Copilot将使用HumanAgent_Chat工具。
  2. 聊天面板打开 -绿点=已连接，显示Copilot的消息
  3. 你回答 -键入答案，单击“发送”（或使用“快速答复”）
  4. 副驾驶继续 -获取您的响应并继续执行任务

VS代码接口

聊天面板 （左侧边栏）：

  • 绿点=已连接到服务器
  • 红点=断开连接（自动重新连接）
  • 快速回复=常见的回复，如“是，请继续”
  • 文本输入=始终启用，发送按钮仅在副驾驶等待时激活

状态指示器：

  • 服务器状态
    • 🟢 绿色=正在运行并已连接
    • 🟠 橙色=启动
    • 🔴 红色=已停止或断开连接
  • 代理状态 （代理服务器运行时出现）
    • 🟢 “代理（已启用）”=在VS代码中运行并启用
    • 🟠 “代理（已禁用）”=正在运行但未启用
    • 🔴 “代理（已停止）”=未运行

Cog菜单 (⚙️):

  • 显示状态-检查服务器状态
  • 启动/停止/重新启动服务器-管理服务器状态
  • 启用/禁用代理-切换代理模式（请参阅下面的代理模式）
  • 安装代理证书-安装HTTPS证书（代理需要）
  • 卸载代理证书-删除证书并禁用代理
  • 创建替代文件-自定义提示替代
  • Name This Chat-设置会话名称
  • 打开Web视图-在浏览器中管理所有工作区
  • 帮助和文档-查看本指南
  • 报告问题/请求功能-GitHub链接

网络界面

从齿轮菜单打开→ 打开Web视图

在一个浏览器选项卡中访问所有工作区聊天，网址为 http://localhost:3737/HumanAgent

  • 查看所有对话
  • 在工作空间之间切换
  • 在您的回复中添加提醒

代理模式（高级）

捕获并显示来自VS Code的HTTP/HTTPS流量，用于调试扩展、市场请求或其他连接。

设置：

  1. Cog菜单→ 安装代理证书（按照系统提示操作）
  2. Cog菜单→ 启用代理
  3. 在web界面的“代理日志”部分查看捕获的请求
  4. 单击任何日志条目展开并查看完整的请求/响应详细信息
  5. 在“代理规则选项卡”中添加代理覆盖规则，或在“代理日志”中打开捕获的代理请求，然后选择创建规则以打开动态规则生成器 注意：启用代理将对所有VSCode工作区执行此操作。

代理规则：

  • 创建重定向、转换或阻止请求的规则
  • 使用JSONata表达式进行高级转换
  • 从web界面中的代理日志选项卡管理规则
  • 看 Proxy-Rules.md 获取详细文档

重要提示：

  • 启用代理之前必须安装证书
  • 仅在启用时捕获流量（橙色/绿色状态）
  • 禁用：齿轮菜单→ 禁用代理
  • 卸载证书：Cog菜单→ 卸载代理证书

故障排除

红点/断开连接：

  • Cog菜单→ 启动服务器
  • 检查VS代码输出面板是否有错误
  • 重新启动VS代码

服务器无法启动：

  • 检查端口3737是否未使用： lsof -i :3737
  • 尝试从齿轮菜单手动重新启动

副驾驶未使用该工具：

  • 工具启动时自动注册
  • 尝试：“使用HumanAgent_Chat与我讨论此问题”

代理不工作：

  • 必须先安装证书（齿轮菜单→ 安装代理证书）
  • 然后启用代理（齿轮菜单→ 启用代理）
  • 检查状态显示带绿点的“代理（已启用）”
  • 证书必须在系统密钥链中受信任（macOS：系统密钥链）

代理显示“已禁用”（橙色圆点）：

  • 代理服务器正在运行，但未在VS代码设置中启用
  • 使用齿轮菜单→ 启用代理（不要手动编辑设置）

发展

按F5调试-开发模式使用端口3738，生产模式使用3737。没有冲突。

隐私和遥测

此扩展程序收集 匿名使用数据 为了帮助改进产品：

我们追踪的内容：

  • 扩展激活/停用
  • 功能使用情况（打开聊天、发送/接收消息）
  • 错误诊断（错误类型，而非内容）
  • 会话指标（消息计数，而非内容）
  • 扩展版本、VS代码版本、操作系统平台
  • 安装后天数

我们不跟踪的内容：

  • ❌ 您的消息内容
  • ❌ 您的姓名、电子邮件或任何个人数据
  • ❌ 工作区路径或文件名
  • ❌ 任何可识别信息

您的隐私：

  • 尊重VS Code的遥测设置
  • 禁用：设置→ 遥测→ 水平→ Off
  • 完全符合GDPR
  • 使用Google Analytics 4进行匿名指标分析

为什么遥测？

  • 帮助我们了解使用了哪些功能
  • 识别要修复的错误和错误
  • 衡量参与度和保留率
  • 指导未来的发展重点

如有疑问： GitHub问题

更多信息

看 README-Additional.md 了解技术细节

演示

完整演示HumanAgent MCP扩展的实际应用，展示实时人机协作

中型文章

https://medium.com/@harperbenwilliam/stop-the-ai-chaos-why-human-in-the-op-beats-fully autonomous制冷剂-eeb0ae17fde9

相关 MCP