Operations Pulse

Operations Pulse

一个本地优先的循环编排器，让运维工作实用且可解释。

Operations Pulse 将定期检查转化为证据，将证据转化为持久工单，再将工单转化为可供审查的运维记忆。默认情况下，它无需付费服务即可运行：只需 Node.js、SQLite、Git、本地文件和本地日志，就能获得有用的运行脉搏。

这是一个 Openly Useful 项目：实用的事物，以开放的方式打造。

请参阅实时且安全处理凭据的设置指南： operations-pulse-five.vercel.app。

v0.1 版本包含什么

• SQLite 工单和运行脉搏台账。
• 用于检查仓库状态、文档和已配置日志文件的只读本地检查。
• 一个包含自描述工具和结构化结果的 MCP 服务。
• 一个适用于 Codex 和兼容 Agent 的可移植 operations-pulse 技能。
• 用于运维、信号审查、分诊和集成的可选角色定义。
• 一个连接目录和引导式设置流程，可区分免费／本地、订阅、主机 OAuth、自托管和自带凭据等方式。
• 完整的迁移台账：已导入、已改写、已引用或已排除。

免费优先快速入门

要求：Node.js 24 或更高版本。默认工作流无需 API 密钥。

npm install
npm run build
node packages/core/dist/cli.js init
node packages/core/dist/cli.js pulse run --root .
node packages/core/dist/cli.js tickets list

配置可选的只读适配器，且不将凭据放入仓库、SQLite 数据库、MCP 参数或聊天记录中：

export OPERATIONS_PULSE_GITHUB_TOKEN='stored by your shell or secret manager'
node packages/core/dist/cli.js connections configure \
  --id github --mode env-token \
  --credential-env OPERATIONS_PULSE_GITHUB_TOKEN
node packages/core/dist/cli.js connections test --id github
node packages/core/dist/cli.js pulse run --root . --connections github

在已通过 GitHub CLI 完成身份验证的本地计算机上，零拷贝方式可以仅使用该会话进行只读检查；其令牌绝不会被存储或打印：

gh auth login
node packages/core/dist/cli.js connections configure --id github --mode github-cli
node packages/core/dist/cli.js connections test --id github

基于浏览器的 apps/site 选择器会生成这些安全的设置步骤。它绝不会收集凭据。主机 OAuth 仍在主机自己的授权界面中进行。

通过 stdio 运行 MCP 服务：

npm run mcp

数据库默认位置为 .operations-pulse/pulse.sqlite。使用 OPERATIONS_PULSE_DB 覆盖该路径。

安全模型

除非工具或命令明确说明会写入，否则 Operations Pulse 均为只读。除非明确启用 --create-tickets（或等效的 MCP 参数），否则运行脉搏不会创建工单。连接在配置前均处于禁用状态，凭据绝不会存储在目录中，对外可见或付费的操作则必须经过单独的人工审批。

连接记录只保留 ID、非机密设置、端点和环境变量引用。connections disconnect 会从本地台账中移除该引用。初始适配器均为只读：IMAP 未读邮件计数元数据、GitHub 身份、Linear 查看者身份、Sentry 项目访问权限和 PostHog 项目访问权限。v0.1 不提供任何远程修改适配器。

可选心跳

在任何可运行 Node 的环境中运行有界前台心跳：

node packages/core/dist/cli.js heartbeat serve --interval-minutes 30 --root .

在 macOS 上，检查并明确安装用户级 LaunchAgent：

node packages/core/dist/cli.js schedule plan --interval-minutes 30 --root .
node packages/core/dist/cli.js schedule install --confirm-install --interval-minutes 30 --root .

MCP 工具、模型响应或页面加载都绝不会安装调度器。移除需要执行 schedule uninstall --confirm-uninstall。

仓库结构

• packages/core — SQLite 账本和确定性检查。
• packages/mcp — MCP stdio 服务。
• skill/operations-pulse — 可移植的 Agent 技能。
• plugins/openai/operations-pulse — 生成的 Codex 技能和 MCP 封装。
• plugins/claude/operations-pulse — 生成的 Claude Code 技能和 MCP 封装。
• .agents/plugins/marketplace.json — 仓库本地 Codex 市场。
• .claude-plugin/marketplace.json — 仓库本地 Claude 市场。
• mcp-registry/operations-pulse/server.json — 待提交的官方 MCP Registry 元数据。
• publisher/publisher.json — 仓库中供使用方读取的公开发布者权威信息镜像。
• agents — 可选角色定义。
• catalog — 启动时显示的工具和连接说明。
• docs — 架构、工作流、连接指南和启动检查清单。
• migrations — 源清单和清理决策。
• vendor — 标明来源的第三方技能包，不会被悄然合并。
• apps/site — 无依赖的项目网站。

状态

此仓库正在为首次公开发布做准备。本地优先的核心是受支持的基准功能。IMAP、GitHub、Linear、Sentry 和 PostHog 均有只读适配器测试；主机 OAuth 需要兼容主机的原生授权流程，且默认不启用任何远程写入适配器。

发布者和注册模式

Openly Useful 是发布者和开发者品牌。openlyuseful.org 提供开源、发布者、政策、安全和支持相关内容；openlyuseful.com 则是 Studio／商业服务页面。Openly Useful LLC 是计划成立的法律实体，目前并未声称其已成立或开始运营。目前，Openly Useful 由其创始人以个人身份运营，创始人所有者已授权对外发布源代码和注册信息，同时继续推进实体设立。

仓库中的 publisher/publisher.json 镜像会读取已发布的权威端点 https://openlyuseful.org/publisher/manifest.json。提供方清单会根据该记录生成公开名称、联系方式、命名空间和政策 URL。暂存的提供方元数据中的仓库 URL 是计划公开的源代码仓库：https://github.com/Openly-Useful/operations-pulse。

规范技能仍为 skill/operations-pulse。提供方封装副本是生成产物，不是可单独编辑的源文件：

npm run registration:sync
npm run registration:check

这些封装会注册可移植技能和不可变的 stdio 命令 npx --yes @openly-useful/[email protected]。它们不会验证账户、安装调度程序、配置适配器或收集凭据。对应的 MCP Registry 标识为 org.openlyuseful/operations-pulse。安装或升级插件后，请启动新的 Codex 任务或重启 Claude Code，以便主机刷新其 MCP 工具。默认情况下，MCP 数据库位于主机进程工作目录下的 .operations-pulse/pulse.sqlite；如需指定路径，请在主机环境中设置 OPERATIONS_PULSE_DB。

允许在本地生成和验证。创建公开仓库、发布软件包、提交至 MCP Registry、提交市场、安装、身份验证和部署都是彼此独立的外部操作。两个可发布工作区都会在 prepublishOnly 阶段采取默认拒绝策略，除非创始人所有者的明确授权、发布者身份、政策来源、命名空间、软件包标识和仓库来源均与公开权威信息一致。LLC 尚在设立中本身并不妨碍发布 npm 产物，因为 Openly Useful 由创始人运营，且授权明确在设立期间生效。命名空间验证、提供方身份验证和提供方审核仍是相关注册或提供方工作流的独立要求。