Sigrank

SigRank CLI 与 MCP

读取本地 AI 使用情况、检查 Token 级联，并可选择将签名快照发布到 SignalAF 上的 SigRank 排行榜。

npx sigrank

网站 · 快速开始 · MCP 配置 · 工具与适配器参考 · 隐私

功能介绍

• 从受支持的本地 AI 会话日志中读取使用元数据。
• 显示可用时间范围内的输入、输出、缓存写入和缓存读取计数。
• 在本地计算 Yield、Leverage、Velocity、SNR 和 10xDEV。
• 提供终端仪表盘和供 AI 客户端使用的 MCP 工具。
• 仅在你选择发布时提交签名遥测数据。

此工具评估可观测的 Token 处理模式，而非模型质量、工作质量、生产力或业务成果。如果某个数据源未单独提供某项指标，适配器可能会估算该指标；相关限制已记录在适配器参考中。

快速开始

需要 Node.js 20 或更高版本。无需全局安装。

本地探索

npx sigrank                       # interactive dashboard in a terminal
npx sigrank board --once          # public leaderboard, one-shot
npx sigrank board --window 7d --once

仪表盘包含 Dashboard、Trends、Compare、Board、Watch 和 Connect 选项卡。使用 1–6 或方向键切换，按 R 刷新，按 Q 退出。

发布自己的快照

1. 在 signalaf.com 登录，并在 Settings 中创建连接码。
2. 注册此设备，然后检查试运行载荷。
3. 准备好后提交并发布。

npx sigrank enroll
npx sigrank submit --dry-run
npx sigrank submit

注册会将设备签名密钥绑定到你的运营者账户。私钥保留在你的设备上。服务端会验证并重新计算已提交遥测数据的评分；本地预览不保证对应公开排名。

如需重复使用，可选择全局安装，以使用相同命令：

npm install -g sigrank
sigrank

连接 MCP 客户端

将此服务添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "sigrank": {
      "command": "npx",
      "args": ["-y", "sigrank"]
    }
  }
}

在没有终端的情况下启动时，入口点会自动运行 MCP stdio 服务。MCP 工具名称由客户端调用；它们不是 shell 命令。

任务	工具
检查本地使用情况	tokenpull、rank_windows、tokenpull_compare
根据提供的计数进行计算	rank_paste、get_sigrank_standard_record
读取公开结果	get_leaderboard、get_operator、discover_peers
探索可能的变更	diagnose_cascade、simulate_change、suggest_improvements
注册并提交	enroll、submit_verified

完整列表、参数和适配器路径请参阅 CLI 和 MCP 参考。通过 submit_verified 发布需要设置 confirm: true；设置 dry_run: true 可检查载荷而不发布。

命令指南

命令	用途
sigrank	打开终端仪表盘
sigrank board --once	打印公开排行榜
sigrank compare --platform codex	审核各可用本地来源的 Token 计数
sigrank watch --window 7d	监视本地使用情况更新
sigrank enroll	使用连接码绑定设备
sigrank submit --dry-run	检查签名提交内容，但不发送
sigrank submit	发布已验证的提交
sigrank proxy	启动可选的环回使用代理
sigrank --help	显示当前命令参考

可选用量代理

某些客户端不会在会话文件中保留提供商报告的全部用量。如果客户端支持自定义 API 基础 URL，sigrank proxy 可以捕获兼容的 Anthropic 或 OpenAI API 流量中的用量。

代理默认关闭，且仅绑定到环回地址。它会在内存中转发发往提供商的请求／响应内容和凭据，但不会持久化这些内容。其本地用量日志包含令牌计数和元数据。使用前请参阅隐私约定。

测量方式

四个令牌支柱共同参与计算：

Yield (Υ) = (cache_read × output) / input²
Leverage  = cache_read / input
Velocity  = output / input
SNR       = output / (input + output)
10xDEV    = log₁₀(Leverage)

此软件包通过 sigrank CLI/MCP 兼容命令分发 Upsilon 测量引擎。SigRank 是 SignalAF 上的公开排行榜和证明平台。TTEOP 定义协议语义；MO§ES™ 是治理框架。

实现通过 token-cascade 将规范计算委托给 tteop-spec。请参阅 TTEOP 实现配置文件和协议兼容性说明。

隐私

本地查看不会发布你的用量。签名提交包含四个支柱，以及账户／设备标识符、签名、平台／版本信息、计数和报告元数据。注册时还会发送设备标签。

提示词文本、响应文本、源代码、仓库内容和本地文件路径均不属于排名提交载荷。可选代理对内容的临时处理，与持久化或提交的内容相互独立。

请阅读完整载荷和隐私详情，并使用 submit --dry-run 查看将要发送的内容。

开发

git clone https://github.com/SunrisesIllNeverSee/sigrank-mcp.git
cd sigrank-mcp
npm install
npm test
npm run test:packaged

在终端中运行 node index.mjs 以打开仪表板，或在 MCP 客户端中配置已检出的入口点。发布版本由仓库明确的发布工作流管理；提交文档不会发布 npm 版本。

相关项目

• sigrank-app — SignalAF 网站、个人资料、公开 API 和排行榜。
• token-cascade — 此软件包使用的测量实现。
• TTEOP — 协议规范和语义。

贡献与安全

请参阅贡献指南。请在 GitHub Issues 中提交错误报告；请通过安全政策私下报告漏洞。

许可证

MIT。