核心功能: 本技能提供自动化配置和灵活的参数设置、工作流程和效率等能力。

运维看板(专业版)

付费版进阶功能

功能能力

能力模块

会话管理

定时任务

应用场景

运维场景：成本监控与预算告警

追踪AI Agent的用量消耗和API费用，设置预算阈值，超支时自动告警：

curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/cost/summary
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/cost/by-session
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"monthly_budget": 500, "alert_threshold": 0.8}' \
     http://localhost:3000/api/cost/budget
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     "http://localhost:3000/api/cost/trend?period=monthly"

管理场景：批量会话清理

定期清理过期会话，释放系统资源：

curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/sessions?status=all
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"action": "archive", "older_than_days": 7}' \
     http://localhost:3000/api/sessions/batch
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"action": "terminate", "status": "error"}' \
     http://localhost:3000/api/sessions/batch

故障恢复场景：定时任务重试

定时任务执行失败时，通过看板触发重试并检查结果：

curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     "http://localhost:3000/api/cron?status=failed"
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"task": "daily-report"}' \
     http://localhost:3000/api/cron/run-now
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/cron/history/daily-report

合规场景：审计日志导出

导出完整操作审计日志，用于合规审查：

curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     "http://localhost:3000/api/audit/logs?start=2026-01-01&end=2026-01-31"
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     "http://localhost:3000/api/audit/export?format=json" > audit-report.json

操作步骤

前置条件

1. Node.js 18+ 已安装
2. 运维看板服务已部署并运行
3. 已设置DASHBOARD_AUTH环境变量

环境配置

创建.env文件配置完整运行参数：

DASHBOARD_PORT=3000
DASHBOARD_HOST=localhost
DASHBOARD_AUTH=your_auth_here
DASHBOARD_CORS_ORIGINS=http://localhost:3000
OPS_DASHBOARD_LOAD_KEYS_ENV=0
OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=0
OPS_DASHBOARD_ENABLE_CONFIG_ENDPOINT=0
OPS_DASHBOARD_ENABLE_SYSTEMCTL_RESTART=0
OPS_DASHBOARD_ENABLE_MUTATING_OPS=0
OPS_DASHBOARD_ALLOW_ATTACHMENT_FILEPATH_COPY=0
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_TMP=0
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_WORKSPACE=0
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_HOME=0

依赖说明

运行环境

4. Agent平台：支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
5. 操作系统：Windows / macOS / Linux（系统级操作需Linux）
6. Node.js：18.0及以上版本
7. 运行时：运维看板服务需持续运行

第三方依赖

API Key 配置

8. 运维看板Token：通过DASHBOARD_AUTH环境变量配置
9. 服务商API Key：存储在keys.env文件中，需设置OPS_DASHBOARD_LOAD_KEYS_ENV=1加载
10. 存储位置：所有密钥文件存储在项目根目录（已加入.gitignore）
11. 禁止：在代码或配置文件中硬编码任何API Key或Token
12. 安全建议：生产环境使用反向代理（如Nginx）添加额外的认证层

可用性分类

13. 分类：MD+EXEC（纯Markdown指令，需要exec命令行执行能力）
14. 说明：基于Markdown的AI Skill，通过自然语言指令驱动Agent执行运维看板全量API操作

参数说明

输出规范

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

异常管理

依赖说明(补充)

• OpenAI GPT → 智谱GLM-4 / 百度文心一言 / 通义千问 / DeepSeek

案例展示

安全防护体系

专业版提供四层安全防护，所有高敏感功能默认关闭，需通过环境变量显式启用：

DASHBOARD_AUTH=your_auth_here
DASHBOARD_CORS_ORIGINS=https://dashboard.example.com,https://ops.example.com
OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=1    # 允许调用AI服务商API
OPS_DASHBOARD_ENABLE_CONFIG_ENDPOINT=1   # 暴露配置端点
OPS_DASHBOARD_ENABLE_MUTATING_OPS=1      # 允许变更操作
OPS_DASHBOARD_ENABLE_SYSTEMCTL_RESTART=1 # 允许系统重启
OPS_DASHBOARD_ALLOW_ATTACHMENT_FILEPATH_COPY=1
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_TMP=1
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_WORKSPACE=1
OPS_DASHBOARD_ALLOW_ATTACHMENT_COPY_FROM_HOME=1

成本分析与预算管理

curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/cost/summary
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     "http://localhost:3000/api/cost/by-session?limit=50"
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/cost/by-model
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{
       "monthly_budget": 1000,
       "alert_threshold": 0.8,
       "alert_webhook": "https://hooks.example.com/alert"
     }' \
     http://localhost:3000/api/cost/budget
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
period=daily&days=30"

变更操作与备份

curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"type": "full", "description": "变更前备份"}' \
     http://localhost:3000/api/backup/create
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/backup/list
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"backup_id": "backup-001"}' \
     http://localhost:3000/api/backup/restore
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"model": "qwen2.5:7b"}' \
     http://localhost:3000/api/ops/update-model
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"key": "temperature", "value": "0.3"}' \
     http://localhost:3000/api/ops/update-config

告警通知配置

curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/alerts/rules
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "成本超支告警",
       "metric": "cost",
       "threshold": 800,
       "operator": ">",
       "webhook": "https://hooks.example.com/alert",
       "enabled": true
     }' \
     http://localhost:3000/api/alerts/rules
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/alerts/history
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"alert_id": "alert-001", "action": "acknowledge"}' \
     http://localhost:3000/api/alerts/acknowledge

审计日志与合规

curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/audit/logs
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
start=2026-01-01&end=2026-01-31"
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
format=json" > audit.json

服务商审计集成

export OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=1
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/provider/openai/usage
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/provider/anthropic/usage
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/provider/comparison

系统级操作

export OPS_DASHBOARD_ENABLE_SYSTEMCTL_RESTART=1
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{"service": "agent-service"}' \
     http://localhost:3000/api/ops/systemctl-restart
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/ops/system-status

敏感数据深度扫描

curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/security/scan
curl -X POST -H "Authorization: Bearer $DASHBOARD_AUTH" \
     -H "Content-Type: application/json" \
     -d '{
       "patterns": ["auth=", "API_CRED", "SENSITIVE", "PASSPHRASE", "COOKIE"],
       "paths": ["./config", "./.env"]
     }' \
     http://localhost:3000/api/security/scan
curl -H "Authorization: Bearer $DASHBOARD_AUTH" \
     http://localhost:3000/api/security/history

热门问题

Q1: 变更操作返回403禁止访问？

变更操作需启用OPS_DASHBOARD_ENABLE_MUTATING_OPS=1环境变量。该功能默认关闭以防误操作。启用后还需在请求中携带有效的认证凭证.

Q2: 成本数据为空或不准确？

成本追踪依赖于Agent会话的用量使用记录。确保Agent正确上报用量统计。服务商审计数据需启用OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=1并配置服务商API Key.

Q3: 告警Webhook未收到通知？

检查Webhook URL是否可从服务端访问。测试网络连通性，确认Webhook服务正常响应。查看/api/alerts/history中告警记录的状态.

Q4: 服务商审计调用报错？

确保已设置OPS_DASHBOARD_ENABLE_PROVIDER_AUDIT=1，且在keys.env文件中配置了服务商API Key。使用OPS_DASHBOARD_LOAD_KEYS_ENV=1加载密钥文件.

Q5: systemctl重启失败？

系统重启功能仅支持用户级服务（非root）。确保OPS_DASHBOARD_ENABLE_SYSTEMCTL_RESTART=1已启用，且目标服务配置为用户级systemd服务.

Q6: 批量操作超时？

批量操作涉及大量会话时可能超时。建议分批执行，每批不超过100条。检查/api/audit/logs确认已完成的操作数量.

Q7: 审计日志占用磁盘过大？

配置日志保留策略，定期清理过期日志。通过/api/audit/export导出后归档，再清理服务端日志.

Q8: 备份恢复后配置不一致？

备份恢复会覆盖当前配置。建议在非高峰期执行恢复操作，并在恢复后验证关键配置项。恢复前先创建当前状态的备份.

Q9: 安全扫描误报如何处理？

安全扫描基于模式匹配，可能产生误报。将误报项添加到白名单配置中，后续扫描将跳过这些项.

Q10: 多人同时操作导致冲突？

专业版通过审计日志记录所有操作。建议团队制定操作规范，高峰期避免并发变更操作。关键操作使用检查点机制.

异常处理架构

技术创新

效率提升量化分析

差异化对比

核心痛点解决

诊断与修复

安全责任声明

1. [与「运维看板(专业版)」相关的安全注意事项]
   • 确保API凭证安全，避免泄露。
   • 定期更新系统，修复已知安全漏洞。
   • 对敏感数据进行加密存储和传输。
   • 限制访问权限，确保只有授权用户可以访问系统。
   • 实施审计日志记录，以便于追踪和调查安全事件。

功能总览

• 自动化执行: 全功能实时运维监控看板，支持成本分析、变更操作、告警通知与审计日志。运维看板专业版是面向团队和企业的完整运维监控方案，在
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

用户疑问解答

Q1: 运维看板(专业版)支持哪些输入格式？

A1: 全功能实时运维监控看板，支持成本分析、变更操作、告警通知与审计日志。运维看板专业版是面向团队和企业的完整运维监控方案，在免费版基础上解锁成本分析与用量统计、变更。支持文本指令和结构化参数输入，具体格式参考使用流程章节。

Q2: 需要配置API Key吗？

A2: 是的，部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求，并通过环境变量安全配置。

Q3: 命令行执行失败怎么办？

A3: 检查命令参数是否正确，确认运行环境支持exec能力。如遇权限问题，请参照错误处理章节排查。

核心功能特点

运维看板专业版是面向团队和企业的完整运维监控方案，在

• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

实操说明

1. 配置API凭证: 在环境变量中设置对应的API Key
2. 初始化连接: 使用提供的凭证建立API连接
3. 调用接口: 传入必要参数执行API调用
4. 准备文件: 确认文件路径正确且格式受支持
5. 执行处理: 调用对应的处理函数
6. 查看结果: 检查输出文件或返回数据
7. 检查环境: 确认运行时和依赖已安装
8. 执行命令: 使用正确的参数格式执行
9. 查看输出: 检查命令输出和退出码

核心属性

运维看板专业版是面向团队和企业的完整运维监控方案，在

• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果