agent

Stakpak Agent 是一个开源智能体，定位为“让代码自动上线”，它常驻在你的机器上 24/7，保持应用运行，只在需要人工时发出通知。官方称其提供 PaaS 的全部优势，但没有锁定。

用途

Stakpak 面向 DevOps 工作，可用于生成基础设施代码、调试 Kubernetes、配置 CI/CD、自动化部署，而无需将生产环境密钥直接交给 LLM。

主要能力

• 安全机制：Secret Substitution 让 LLM 在不看到凭据的情况下使用凭据；Warden Guardrails 在网络层阻止破坏性操作；内置 DevOps Playbooks 提供精选 DevOps 知识库。
• Autopilot（24/7 自主运行时）：提供生命周期别名进行一键设置/启动/停止，也支持规范子命令。远程 VM 运行前需安装 Docker 并确保当前用户可访问，建议 2GB+ 内存，小型 Linux 主机强烈建议配置 Swap，Linux 用户服务可能需要 linger 以在注销后继续运行。stakpak up 启动前会进行预检，stakpak autopilot doctor 可用于部署就绪检查。
• 配置：~/.stakpak/config.toml 控制 profile 行为（model、allowed_tools、auto_approve、system_prompt、max_turns、provider credentials）；~/.stakpak/autopilot.toml 控制运行时接线（schedules、channels、notification routes、service/server settings）。schedule 和 channel 的 profile 相互独立：schedule --profile monitoring 控制该计划启动的运行行为，channel --profile ops 控制来自 Slack/Telegram/Discord 入站消息的会话行为，notification --target "#ops" 仅控制通知发送位置。通知路由使用 channel（传输方式，如 slack、telegram、discord）和 target（传输内的目的地，如 Slack #ops 或 C1234567890）。
• 安全强化：mTLS 端到端加密 MCP；动态密钥替换；安全密码生成；隐私模式可脱敏 IP 地址和 AWS 账户 ID 等敏感数据。
• DevOps 工作支持：异步任务管理（后台命令如端口转发、服务器，带跟踪和取消）；实时进度流（Docker 构建、部署等长时间进程实时更新）；基础设施代码索引（自动本地索引和语义搜索 Terraform、Kubernetes、Dockerfile、GitHub Actions）；文档研究智能体（内置网络搜索技术文档、云提供商、开发框架）；子智能体（专用研究智能体，用于代码探索和沙箱分析，通过 --enable-subagents 启用）；批量消息批准；可逆文件操作（自动备份和恢复）。
• 自适应智能：Rule Books 可定制智能体行为，内置标准操作程序、手册和组织策略；持久知识让智能体从交互中学习，记住事件、资源和环境细节。

使用方式

安装支持 Linux、macOS、Windows。Homebrew（Linux & macOS）可安装并更新；也可从 GitHub Releases 下载对应平台二进制。官方提供包含常用 CLI 工具（docker、kubectl、aws cli、gcloud、azure cli 等）的镜像。

可使用自己的 Anthropic 或 OpenAI API 密钥、自定义 OpenAI 兼容端点，或 Stakpak API 密钥。

• 选项 A：使用 Stakpak API 密钥（无需信用卡），运行 stakpak 并按说明创建新密钥。
• 选项 B：不使用 Stakpak API 密钥，创建 ~/.stakpak/config.toml，可选择 BYOK（使用 Anthropic/OpenAI 密钥）、自带 LLM（本地 OpenAI 兼容端点如 Ollama、LM Studio）或混合内置与自定义提供商。

启动 TUI：stakpak；使用 Docker 启动 TUI。

MCP 相关：可作为安全 MCP 代理或通过 MCP 服务器暴露安全强化工具。工具模式包括 local（仅文件操作和命令执行，无需 API 密钥）、remote（AI 驱动的代码生成和搜索工具，需 API 密钥）、combined（默认，需 API 密钥）。额外标志：--disable-secret-redaction（不推荐，明文打印密钥）、--privacy-mode、--enable-slack-tools。MCP 代理服务器可通过配置文件多路复用多个上游 MCP 服务器，配置文件发现顺序为 ~/.stakpak/mcp.toml 或 ~/.stakpak/mcp.json、.stakpak/mcp.toml 或 .stakpak/mcp.json、./mcp.toml 或 ./mcp.json。可通过 CLI 添加服务器或直接在 ~/.stakpak/mcp.toml 定义，使用 disabled = true 可保留配置但不加载。

Agent Client Protocol (ACP)：标准化协议，使 AI 智能体可直接集成 Zed 等代码编辑器，提供实时 AI 聊天、实时代码分析、工具执行、会话持久化、流式响应、智能体计划等功能。需安装 Stakpak，配置 Zed 编辑器（在 ~/.config/zed/settings.json 添加），启动 ACP 智能体，然后在 Zed 中点击 Assistant (✨) → + → New stakpak thread 使用。

Rulebook 管理：使用 Stakpak Rulebooks 管理 SOP、手册和运行手册，Rulebooks 是带 YAML frontmatter 的 markdown 文件。

Shell 补全：支持 bash、elvish、fish、powershell、zsh 的 tab 补全。

Shell 模式：可从输入栏显式执行系统命令，详见 Shell Mode 文档了解后台与前台执行。

平台测试：提供 Windows CLI 功能综合测试报告，包括安装、配置及与 WSL2 和 Docker 的集成。

适用场景

适合需要自动化 DevOps 流程、安全地让 AI 参与生产环境操作、希望减少人工值守的开发和运维团队。

限制

官方未提供具体收费、价格或效果数据；部分功能（如子智能体）需特定标志启用；远程 VM 运行有 Docker、内存、Swap 等前置要求；使用 Stakpak API 密钥时 Brave 用户可能遇到自动重定向到 localhost 端口的问题，需手动复制密钥。