agent-pulse

原文：🇺🇸 英文

已翻译

包含 1 个脚本检查通过 / 未检测到疑似敏感代码

使用Agent Pulse检查Hermes、Claude Code、Codex、DeepSeek、OpenClaw、Copilot、Aider、Qwen、OpenCode、Goose、Cursor、Antigravity和Amp日志中的本地AI-agent活动。当用户询问AI-agent会话、令牌、工具/搜索调用、模型使用情况、估算成本、预算、预测、健康检查、报告、设置诊断、Web/API/指标导出或MCP集成相关问题时使用。

41.8k次下载

来源jane-o-o-o-o/agent-pulse-skill

添加于2026-08-08

NPX安装

npx skill4agent add jane-o-o-o-o/agent-pulse-skill agent-pulse

SKILL.md 内容（中文）

查看翻译对照 →

Agent Pulse

用途

将已安装的

agent-pulse

CLI作为本地AI-agent活动的权威数据源。PyPI包名为

agentpulse-cli

，而命令仍为

agent-pulse

。优先选择运行命令并汇总输出，而非阅读Agent Pulse的源代码。

在Windows上运行命令前务必启用UTF-8，因为Agent Pulse的输出包含表情符号和框线绘制字符：

powershell

$env:PYTHONUTF8='1'
$env:PYTHONIOENCODING='utf-8'

如果

agent-pulse

不在PATH中，请先询问用户是否同意安装依赖。若用户同意，可安装PyPI包或尝试从本地项目检出目录运行：

powershell

pip install agentpulse-cli

powershell

python -m agent_pulse.cli --version

源平台标识

当用户询问单个agent工具而非所有本地数据时，使用

-P/--platform

参数：

text

hermes, claude, codex, deepseek, openclaw, copilot, aider, qwen,
opencode, goose, cursor, antigravity, amp

命令选择

首先参考以下命令选择表：

用户需求	运行命令
当前状态	`agent-pulse status --json`
完整仪表盘	`agent-pulse --json` 或 `agent-pulse --no-banner`
演示数据	`agent-pulse demo --json`
设置诊断	`agent-pulse doctor --json`
近期会话	`agent-pulse --json --hours 24 --limit 20`
热门会话	`agent-pulse top --sort tokens --json`
高成本会话	`agent-pulse top --sort cost --json --hours 168`
模型成本分析	`agent-pulse models --json`
模型排名	`agent-pulse leaderboard --json --rank-by efficiency`
成本优化建议	`agent-pulse optimize --json`
预算状态	`agent-pulse budget --json`
成本预测	`agent-pulse forecast --json`
成本异常检测	`agent-pulse anomaly --json`
健康/CI检查	`agent-pulse health --json`
综合评分	`agent-pulse score --json`
会话搜索	`agent-pulse search "<query>" --json`
时段对比	`agent-pulse compare --json`
项目对比	`agent-pulse compare-projects --json`
活动日历	`agent-pulse heatmap --json`
智能建议	`agent-pulse insights --json`
Prometheus指标	`agent-pulse metrics --format prometheus`
导出报告	`agent-pulse export -f markdown` 或 `agent-pulse export-html`
Web仪表盘	`agent-pulse web --port 8765`
REST API	`agent-pulse api --port 8766`
MCP工具	`agent-pulse mcp --list-tools`

若已安装的命令缺少某个选项，运行

agent-pulse <command> --help

并调整使用最接近的支持选项。

工作流程

仅当用户询问数据缺失原因、设置帮助，或常规数据命令未返回会话时，才先运行
```
agent-pulse doctor --json
```
。
尽可能使用JSON输出。汇总关键字段：会话、令牌、工具、搜索调用、模型细分、源平台细分、估算成本、警告信息。
针对限定范围的问题使用时间过滤器。“近期”默认设为24小时，“本周”默认设为168小时：

powershell

agent-pulse status --json --hours 24
agent-pulse --json --hours 168 --limit 50

当用户询问特定agent系统时，使用平台过滤器：

powershell

agent-pulse --json -P codex --hours 24
agent-pulse --json -P claude --hours 24
agent-pulse top --json -P aider --sort cost
agent-pulse status --json -P cursor

针对成本相关问题，结合汇总、模型和热门会话视图：

powershell

agent-pulse status --json --hours 24
agent-pulse models --json --hours 24
agent-pulse top --sort cost --json --hours 24
agent-pulse optimize --json --hours 168

针对趋势和风险相关问题，使用预测/历史/对比/异常检测命令：

powershell

agent-pulse forecast --json
agent-pulse history --json
agent-pulse compare --json
agent-pulse anomaly --json

针对设置问题，先使用发现命令再猜测路径：

powershell

agent-pulse doctor --json
agent-pulse scan --json --details
agent-pulse config show

结果解读

将
```
total_cost_usd
```
视为基于Agent Pulse本地模型定价表的估算值。
同时报告成本和令牌用量；低成本模型仍可能有极高的令牌消耗。

区分

codex

、

claude

、

hermes

、

deepseek

、

openclaw

、

aider

、

cursor

、

opencode

和

goose

等源平台。

若
```
doctor
```
报告缺失可选源平台、缺失
```
dev_root
```
或可选Web依赖，请提及这些信息。
若未显示任何会话，先检查
```
doctor
```
结果，再尝试扩大时间范围，例如
```
--hours 168
```
。
在给出总统计数据前，确认用户是否要求了源平台(
```
-P
```
)过滤、模型过滤或项目对比。
若命令输出纯文本而非JSON，或因安装版本过旧导致运行失败，运行
```
agent-pulse <command> --help
```
并使用最接近的支持选项。

报告

若需要简短的易读答案，运行JSON命令并汇总结果。

若需要生成文件，优先使用：

powershell

agent-pulse report --period daily
agent-pulse export -f markdown
agent-pulse export-html

不要编造精确的节省金额或成本数据，以CLI输出为准。

集成

仅当用户要求浏览器仪表盘或程序化服务器时，才使用Web和API扩展功能。安装缺失的扩展前请先询问用户：

powershell

pip install "agentpulse-cli[web]"
agent-pulse web --port 8765
agent-pulse api --port 8766

针对监控流水线：

powershell

agent-pulse metrics --format prometheus
agent-pulse health --cost-limit 100 --token-limit 1000000 --json

MCP集成

当用户希望其他AI客户端查询Agent Pulse时，使用MCP模式：

powershell

agent-pulse mcp --list-tools
agent-pulse mcp

解释MCP时，需说明它暴露了状态、预测、热门会话、模型分析、优化、健康检查、搜索和排行榜等工具。

本地辅助工具

本技能包含

scripts/run_agent_pulse_snapshot.py

，它会运行一组精简的、支持JSON的Agent Pulse检查，并打印合并后的汇总信息：

powershell

python scripts/run_agent_pulse_snapshot.py --hours 24 --days 7

agent-pulse

NPX安装

标签

SKILL.md 内容（中文）

Agent Pulse

用途

源平台标识

命令选择

工作流程

结果解读

报告

集成

MCP集成

本地辅助工具