← 返回目录

Agentpack

社区

面向 AI 编码代理的本地任务状态账本

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 20 / 438
Stars: ★ 18 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 无需凭据
许可证: MIT
最近提交: 7 天前

68FMRS · C

Agentpack 是特定领域的 MCP 服务器，面向注重隐私的开发者，他们希望各种本地 AI 代理接替者之间的任务状态具有延续性。它提供核心概念，如任务护照与检查点，但官方文档未提供完整工具清单，这限制了无记录的初始集成。

最强项 · 安全与权限 16/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

16/20

维护活跃度

13/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 11/20: README声称有CI徽章、npm test、MCP冒烟测试和文档化工具契约，结构合理且零运行时依赖降低了故障面；但评审仅读到README/清单，未见测试代码或CI配置文件本身，无法核实握手与工具行为匹配，故按静态校准不上12。
安全与权限 16/20: 安全姿态描述良好：本地文件、无网络调用、无遥测、npm provenance、ignore-scripts、锁文件、秘密脱敏；任务门默认警告而非阻断属合理默认。未见红线问题。扣分因均为主张而非源码可验证的证据，且 hooks 写入客户端配置的副作用未逐项披露。
维护活跃度 13/20: 版本1.6.0、MIT许可、CI徽章、SECURITY.md、发布流程文档、npm provenance均指向积极维护；17星属冷门但未弃用。无缺陷报告与问题响应记录可核实，故不给更高分。
文档质量 15/20: 文档分层清晰（INTEGRATIONS、CLI、MCP、TASK-PASSPORT、DEMOS、VISION、SECURITY），含示例与限制说明，但工具参数与故障排查细节未直接展示，部分假定未验证。
安装易用性 13/20: 安装路径明确：npm全局安装、init、每客户端install命令、doctor诊断，Node 20+要求清晰；但具体客户端配置示例未在提供材料中展示，且需手动重启连接，扣至13。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要在编码代理会话中保持任务连续性的开发者
希望本地存储并可能手动审查任务状态的团队
熟悉 Claude Code、Cursor 或 Codex 并希望提高一致性的人

不适合谁

需要云同步或协作功能的用户（本地优先）
没有 Node.js 20+ 或希望使用单个二进制文件可能更专注的用户
希望与现有问题追踪器或项目管理工具集成（Agentpack 不提供此类集成）的用户

所需权限

访问本地仓库文件系统（.agentpack/ 目录）
通过 npm 全局安装软件包（agentpack-cli）
根据配置可执行 git hooks（任务门）

风险与副作用

审阅欠佳或配置错误可能导致状态记录不准确或错失上下文
本地文件可能被意外修改或删除
secret 值的尽力脱敏，但并不保证完整
任务门可能导致代理被阻止，如果配置不当

安装接入

准备工作

运行环境：Node.js 20+

需要 Node.js >= 20。全局安装 agentpack-cli。然后进入仓库：agentpack init 初始化；agentpack install claude --write 或 agentpack install codex/cursor 设置客户端。重启或重新连接客户端后即可使用。可用 agentpack doctor 验证设置。

验证是否装好

在仓库中运行 agentpack init 和 agentpack install claude --write，重启客户端后，运行 agentpack doctor 验证配置，并在会话开始时确认代理能加载 Agentpack 的任务上下文。

常见排障

运行 agentpack doctor 检查设置。
确保 Node.js >= 20。
验证并重启客户端以加载 MCP server。
以 agentpack resume --preset agent --query "topic" 等方式检查 CLI 状态。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

加载 Agentpack 的当前任务状态，继续上次未完成的工作
把我们刚确定的架构决策记录到任务账本里
在 .agentpack/ 里创建一个检查点，包含当前状态和下一步行动
检查当前改动是否偏离了活动任务的范围

使用场景

处理不稳定的测试或重构，任务耗时较长

在 Claude Code、Cursor、Codex 或其他 MCP 客户端间切换任务

几天后需要继续任务

在 monorepo 的多个部分上并行工作，并保持任务焦点

详细介绍

Agentpack 是一个本地优先的 MCP 服务器，为 AI 编码代理保留任务状态。它在你的仓库中维护一个可审查的任务账本（.agentpack/），记录目标、决策、死胡同、验证证据和检查点。代理通过 MCP 工具在会话期间记录重要状态，随后的会话（无论是同一代理压缩后、不同客户端还是未来的你）都会加载该状态并从中断处继续。Agentpack 还生成项目指令（AGENTS.md、CLAUDE.md、Cursor 规则）以指导代理何时加载和记录状态，并提供 CLI 供人类检查和手动交接。核心功能包括任务护照、任务门控（通过 hook 警告或阻止越界编辑）和预算上下文输出。