Okto Pulse

这个 Agent 能做什么，适合哪些场景？

Okto Pulse 是一个本地优先的软件开发生命周期工作台，把故事、构思、细化、规格、冲刺、任务、测试和缺陷组织成可追踪的工作流。它由负责领域模型、治理门禁和知识图谱契约的 `okto-pulse-core`，以及负责 SQLite、Okto Grafx、文件系统、调度器、REST 应用、React 前端和 FastMCP 主机的社区包组成。用户通过浏览器界面检查和引导工作，AI 编码代理则通过本地 MCP 服务创建或更新同一组结构化产物。`okto-pulse serve` 在一个 Python 进程中运行 Web UI/API 与 MCP 监听器，以保持嵌入式图数据库的单写入者模型。其输出包括带血缘关系的规格与执行卡片、验证证据、任务结论、代码调查收据以及可搜索的板级知识图谱。它适合希望自托管项目记忆和治理流程的团队，但并不是替代编码代理的模型或代码执行环境。

典型流程从 okto-pulse init 开始：命令在 ~/.okto-pulse/ 建立本地状态，创建默认看板和代理，并在项目中生成指向 MCP 服务的 .mcp.json。启动 okto-pulse serve 后，人在 http://localhost:8100 使用 Web UI/API，编码代理在 http://localhost:8101/mcp 调用 Core 工具目录。系统把 Stories、Ideation、Refinement、Spec、Sprint、Tasks、Tests 和 Bugs 存为带状态、血缘和验证规则的结构化产物；状态转换会检查规格覆盖、资源准备、测试证据、缺陷追踪、任务结论和独立验证等条件。板级知识图谱会整理规格、缺陷、决策和实现结论，支持相关决策检索、矛盾或过时上下文识别、历史缺陷经验复用以及跨看板的 Global Discovery。CLI 还可执行 okto-pulse code-traceability 调查记录查询、verify-pipeline、KG 健康诊断、模式迁移、回填、JSON-LD 导出和本地指标管理。社区运行时不会自行获取、克隆、浏览或检查源代码；外部代理在自己的环境中完成访问检查和调查，只向 Pulse 提交有界结果。

1. 使用 Codex、Claude Code、Cursor 或类似 MCP 客户端的开发团队，希望在代理写代码前先固化需求、验收标准和测试场景。
2. 维护长期产品的团队，需要从历史规格、决策、缺陷和实现结论中建立可搜索的本地项目记忆。
3. 技术负责人需要用覆盖率、验证证据、任务结论和架构发现门禁约束 AI 辅助交付。
4. 隐私敏感或强调数据控制的团队，希望将 SQLite、图数据库、上传文件和指标保存在自有机器或容器卷中。
5. 大型功能负责人需要先批准规格，再拆分 Sprint 和可审查的实现批次，并保留端到端血缘。
6. 运维人员需要通过健康接口、事件死信队列指标和 KG 恢复命令诊断本地知识图谱。

如何安装或部署这个 Agent？

需要 Python 3.11 或更高版本。通过 PyPI 安装：

pip install okto-pulse

在编码代理将要工作的项目目录初始化：

okto-pulse init

首次运行会尝试把 all-MiniLM-L6-v2 下载到 Hugging Face 缓存，以提供知识图谱语义搜索。下载失败时应用仍会以确定性 stub 模式启动，但语义搜索不可用。无需外部 LLM API 密钥；代理访问本地 MCP 时使用 Pulse 创建或轮换后一次性显示的代理密钥。

如何使用这个 Agent？

启动 Web UI/API 和 MCP 服务：

okto-pulse serve

然后打开 http://localhost:8100，选择默认看板，并创建 Story 或 Ideation。默认 MCP 地址为 http://localhost:8101/mcp；多数代理在项目目录运行时可自动发现生成的 .mcp.json。其结构如下：

{
  "mcpServers": {
    "okto-pulse": {
      "url": "http://localhost:8101/mcp?api_key=dash_..."
    }
  }
}

对于 Codex，在 Pulse 的 Menu → Agents 中创建代理或重新生成密钥，点击 Codex (CLI)，再运行复制出的命令：

codex mcp add okto-pulse --url "<Pulse MCP URL with agent key>"

轮换密钥后需重新复制命令并重启 Codex 会话；旧密钥会失效，看板访问权限仍需在 Pulse 中授予。若修改 MCP 端口，可重新生成代理配置：

okto-pulse init --agents

也可使用发布的容器镜像：

docker run -d --name okto-pulse \
  -e HOST=0.0.0.0 \
  -e MCP_HOST=0.0.0.0 \
  -p 8100:8100 \
  -p 8101:8101 \
  -v okto-pulse-data:/data \
  ghcr.io/oktolabsai/okto-pulse:latest

获取容器中的引导 API 密钥：

docker exec okto-pulse okto-pulse api-key

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题