skills-smartbadge-ops

skills-smartbadge-ops

智能工牌录音管道(归档 → 清洗 → 讯飞转录 → DeepSeek 报告)的全功能 AI 运维技能(Claude Code Skill)。

一个技能覆盖:巡检、故障自诊断、补跑/重试、OSS 同步、列表排查、报告解读、月报/年报按需聚合分析、线上部署核验。

快速开始

# 1. 安装(Windows): 把本目录链接到 Claude 全局技能目录
cmd /c mklink /D "C:\Users\11729\.claude\skills\smartbadge-ops" "D:\1\skills-smartbadge-ops"

# 2. 登录(在任意位置,技能会自行定位)
node <技能目录>/scripts/api.mjs login <密码>

# 3. 一键核查
node <技能目录>/scripts/check-online.mjs

之后 Claude 中直接提问即可(如「昨天管道有问题吗」「帮我出 8 月月报」),技能通过「确认门」交互流程逐步完成。

环境要求

项	要求
Node	>= 18(内建 fetch,零 npm 依赖)
Python	仅 verify-online.py 需要,含 playwright
网络	可达 recording.sh-lami.com(或本地后端)
凭据	登录密码;OSS 凭据自动发现自项目 server/.env

脚本一览

脚本	用途
scripts/api.mjs	任意接口调用(login/get/post/env、--raw、--base)
scripts/check-online.mjs	线上 12 项断言一键核查(登录/health/错误/归档/列表/实时分流/心跳/设备/互斥)
scripts/verify-online.py	浏览器 5 页走查,0 pageerror 断言
scripts/oss.mjs	OSS 直连列举(顶层统计/前缀明细/--json/--find-env)
scripts/report-aggregate.mjs	区间聚合:窗口内报告 + 逐日对账 → 缺失清单与补跑建议(月报/年报原料)
scripts/fetch-report-text.mjs	报告正文拉取(HTML→纯文本,供 AI 深度分析)
scripts/lib.mjs	共享库(凭据回退链/token/httpJson/htmlToText;内部使用)
templates/monthly-report.md	月报/年报八段分析结构模板
templates/report-html.html	可选 HTML 产物模板

凭据与安全

• 本仓库不含任何密钥。登录 token 缓存 .token;OSS 凭据从项目 server/.env 自动发现。
• 凭据定位回退链:--env 参数 > 环境变量 SMARTBADGE_ENV_FILE > 自动发现(本仓库同级/兄弟目录中名称含 device|smartbadge 且带 server/.env 的项目)> 已导出的 OSS_* 环境变量。
• 排查凭据定位:node scripts/oss.mjs --find-env。

与项目内旧技能的关系

本项目内旧的 .claude/skills/smartbadge-pipeline-ops 已被本独立仓库取代(内容迁移并扩展至月报/年报与确认门交互)。安装本技能后,直接以 smartbadge-ops 使用即可。

版本

v1.0.0 — 2026-09-04,首次发布