mirrord：将本地进程接入Kubernetes集群
让任何本地进程（包括AI编码代理）像在Kubernetes Pod中一样运行，获得真实的环境变量、网络和流量。
证据显示：README明确说明需要CAP_NET_ADMIN、CAP_NET_RAW、CAP_SYS_PTRACE、CAP_SYS_ADMIN等Linux capabilities，并允许通过配置禁用部分capabilities，体现了最小权限原则的部分考虑。用户需要选择pod进行模拟，但未明确要求每次操作都确认。数据流透明性方面，README解释了流量、文件、环境变量的路由方式，但未提供详细的日志或审计。敏感数据处理未明确说明。依赖安全性方面，Cargo.toml中使用了多个git依赖和固定rev，但未提供依赖漏洞扫描证据。外部影响方面，工具会在集群中启动pod并修改路由，但用户可配置。回滚方面，未提供明确的回滚机制。来源归属方面，未验证发布者身份。扣分原因：用户确认机制不明确，敏感数据处理未说明，依赖安全证据不足，回滚机制缺失，发布者未验证。
证据显示：项目结构清晰，Cargo.toml中workspace成员定义明确，README与代码结构一致。依赖可用性方面，使用固定rev的git依赖和crates.io依赖，但未提供依赖锁定文件（如Cargo.lock）的可见性。失败消息方面，未提供明确的错误处理文档。扣分原因：失败消息文档不足，依赖锁定未明确。
证据显示：README明确面向开发者和AI编码代理，提供了VS Code、IntelliJ、CLI等多种使用场景。能力边界方面，说明了可禁用的capabilities及其影响。触发精度方面，用户需明确选择目标pod。环境适配方面，支持Linux、macOS、Windows，并提供了安装方式。扣分原因：能力边界描述较简略，未详细说明各功能的具体限制。
证据显示：README结构清晰，包含安装、使用、工作原理、FAQ等章节。安装说明详细，提供了多种安装方式。命名稳定，项目名称和命令一致。示例和FAQ提供了基本使用示例。已知限制方面，仅提及capabilities禁用可能影响功能，未全面列出。许可证为MIT，明确。版本和变更日志方面，Cargo.toml中版本为3.246.0，但未提供CHANGELOG文件。维护责任方面，有SECURITY.md和贡献指南。扣分原因：已知限制不全面，缺少CHANGELOG。
证据显示：输出可用性方面，工具提供CLI和IDE集成，输出为进程运行结果。边际价值方面，解决了本地开发与Kubernetes环境不一致的问题，对开发者和AI代理有显著价值。成本效益方面，安装和使用成本较低，但需要Kubernetes集群。扣分原因：未提供性能基准或成本分析。
证据显示：README中的声明（如'works first-class with Claude Code'）未提供具体验证证据。跨来源佐证方面，有ADOPTERS.md和社区Slack，但未提供独立验证。事实与推断分离方面，README区分了功能描述和配置选项，但未明确标注哪些是推断。扣分原因：声明缺乏可追溯证据，跨来源佐证不足。
- 该工具需要较高的Linux capabilities，可能带来安全风险，应谨慎配置。
- 发布者身份未验证，使用前应评估信任度。
- 依赖安全性证据不足，建议检查依赖漏洞。
这个 Agent 能做什么，适合哪些场景？
mirrord 是一个开发者工具，允许你在本地运行进程（如 Node.js 应用或 AI 编码代理）时，将其流量、文件访问和环境变量通过目标 Pod 路由到 Kubernetes 集群中。它同时支持 VS Code 扩展、IntelliJ 插件和 CLI 工具，使开发者无需部署即可获得真实集群的反馈。对于 AI 编码代理（如 Claude Code、Cursor、Codex 等），mirrord 使他们能够访问真实的服务响应、队列内容和环境变量，从而生成更准确的代码。该工具由 MetalBear 开发，MIT 许可，被多家公司采用。
mirrord 在目标 Pod 所在节点上启动一个辅助 Pod，该 Pod 将目标 Pod 的入站流量镜像到你的本地进程，并将本地进程的出站流量、文件读写和环境变量通过辅助 Pod 路由到目标 Pod。具体操作包括：使用 mirrord exec <command> --target <target-path> 启动本地进程；VS Code 和 IntelliJ 插件提供 GUI 集成；支持配置禁用特定 Linux capabilities（如 CAP_NET_ADMIN）来调整功能。
- 后端开发者：在本地调试微服务时，希望使用真实的集群环境变量和依赖服务，而无需部署。
- AI 编码代理（如 Claude Code、Codex）：在生成代码时，需要读取真实的 API 响应或队列数据，以验证代码的正确性。
- 运维工程师：在 CI/CD 流水线中，使用 mirrord CLI 快速验证代码变更对集群的影响。
- 全栈开发者：使用 VS Code 扩展在编辑器内直接调试，无需切换终端。
- 使用 IntelliJ IDEA 的开发者：通过插件在 IDE 内启动调试，选择命名空间和 Pod 进行模拟。
这个 Agent 有哪些优点和局限？
- 无需部署即可获得真实集群的反馈，缩短开发循环。
- 同时支持 VS Code、IntelliJ 和 CLI，适应不同工作流。
- 与多个 AI 编码代理（Claude Code、Cursor、Codex）集成，提升生成代码的准确性。
- 支持对 Linux capabilities 进行配置，适应安全要求。
- 依赖 Kubernetes 集群和 kubeconfig，需要集群访问权限。
- 需要启动辅助 Pod，可能消耗集群资源。
- 某些功能（如文件写入、环境变量）可能需要额外的 Linux capabilities，默认需要
CAP_SYS_ADMIN等，可能不适用于受限环境。 - 需要学习和配置，对新手可能有一定门槛。
如何安装或部署这个 Agent？
安装 mirrord CLI（macOS）：brew install metalbear-co/mirrord/mirrord。其他方式：curl -fsSL https://raw.githubusercontent.com/metalbear-co/mirrord/main/scripts/install.sh | bash。Nix 用户：nix profile install nixpkgs#mirrord。Windows 用户：choco install --pre mirrord。VS Code 扩展：从 [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=MetalBear.mirrord) 获取。IntelliJ 插件：从 [JetBrains Plugin](https://plugins.jetbrains.com/plugin/19772-mirrord) 获取。前提：需要可访问的 Kubernetes 集群和配置好的 kubeconfig。
如何使用这个 Agent？
首先确保 kubeconfig 正确指向目标集群。然后运行：mirrord exec node app.js --target pod/my-pod 即可将本地 Node.js 应用接入指定 Pod。对于 VS Code，安装扩展后点击状态栏的 'Enable mirrord'，开始调试并选择要模拟的 Pod。对于 IntelliJ，点击工具栏的 mirrord 图标，选择命名空间和 Pod 后开始调试。对于 AI 编码代理，参考 [metalbear-co/skills](https://github.com/metalbear-co/skills) 获取现成的配置。
这个 Agent 与同类方案有什么区别？
与 Telepresence 类似，但 mirrord 专注于镜像流量和文件系统，并提供更简单的 CLI 和 IDE 集成。
常见问题
mirrord 会修改我的集群吗？
需要 Kubernetes 管理员权限吗？
mirrord 支持哪些编程语言？
如何关闭不需要的 capabilities？
MIRRORD_AGENT_DISABLED_CAPABILITIES 设置，例如 CAP_NET_RAW,CAP_SYS_PTRACE，但会限制某些功能。