|
|
@@ -48,10 +48,49 @@ node <技能目录>/scripts/check-online.mjs
|
|
|
- 凭据定位回退链:`--env` 参数 > 环境变量 `SMARTBADGE_ENV_FILE` > 自动发现(本仓库同级/兄弟目录中名称含 `device|smartbadge` 且带 `server/.env` 的项目)> 已导出的 `OSS_*` 环境变量。
|
|
|
- 排查凭据定位:`node scripts/oss.mjs --find-env`。
|
|
|
|
|
|
+## 给 AI 的完整配置提示(安装时粘贴)
|
|
|
+
|
|
|
+**步骤 1**:确认技能已就位——本仓库即技能本体(名称 `smartbadge-ops`),已链接到 Claude 全局技能目录:
|
|
|
+
|
|
|
+```bash
|
|
|
+cmd /c mklink /D "%USERPROFILE%\.claude\skills\smartbadge-ops" "本仓库路径"
|
|
|
+```
|
|
|
+
|
|
|
+**步骤 2**:密钥清单。Windows 本机使用时**只需登录密码**(脚本会自动发现同机项目的 `server/.env` 读取 OSS 凭据);跨机/无项目目录环境才需要手工导出 OSS 四项:
|
|
|
+
|
|
|
+| 环境变量 | 必填 | 取值来源 | 说明 |
|
|
|
+|---|---|---|---|
|
|
|
+| `SMARTBADGE_API_BASE` | 否 | 线上 `https://recording.sh-lami.com` | 或本机后端 `http://localhost:3002` |
|
|
|
+| `SMARTBADGE_USERNAME` | 否 | 登录用户名 | 脚本默认 `lami123456` |
|
|
|
+| `SMARTBADGE_PASSWORD` | **是** | API 登录密码(与系统一致) | 唯一必需项 |
|
|
|
+| `OSS_ACCESS_KEY_ID` | 条件 | 本机免配:自动发现 `server/.env` | 仅跨机需导出 |
|
|
|
+| `OSS_ACCESS_KEY_SECRET` | 条件 | 同上 | 仅跨机需导出 |
|
|
|
+| `OSS_REGION` | 条件 | 同上(如 `oss-cn-shanghai`) | 仅跨机需导出 |
|
|
|
+| `OSS_BUCKET` | 条件 | 同上 | 仅跨机需导出 |
|
|
|
+
|
|
|
+**步骤 3**:给 AI 的完整提示词模板(复制粘贴,替换 `<...>` 占位):
|
|
|
+
|
|
|
+```markdown
|
|
|
+# 技能已安装: smartbadge-ops(智能工牌录音管道全功能运维)
|
|
|
+## 环境配置(SMARTBADGE_* 变量)
|
|
|
+SMARTBADGE_API_BASE=https://recording.sh-lami.com
|
|
|
+SMARTBADGE_USERNAME=lami123456
|
|
|
+SMARTBADGE_PASSWORD=<填 API 登录密码>
|
|
|
+# 本机: OSS 四项免配,技能自动发现项目 server/.env
|
|
|
+# 跨机: 手工导出 OSS_ACCESS_KEY_ID/OSS_ACCESS_KEY_SECRET/OSS_REGION/OSS_BUCKET
|
|
|
+## 使用规范
|
|
|
+按 SKILL.md §1 确认门协议执行: 先复述我的问题与方案,回问「是这个意思吗?」;
|
|
|
+只读操作(巡检/列表/对账/聚合)可一句备案继续;写操作(补跑/重试/补传/改配置)必须先罗列将修改的数据面并等我确认。
|
|
|
+## 上线自检
|
|
|
+先运行 node scripts/check-online.mjs 确认 12 项 PASS,再进入我的提问。
|
|
|
+```
|
|
|
+
|
|
|
+**步骤 4**:验证——让 AI 说「做一次每日巡检」,应输出三行简报(PASS 项/警告项/留痕)。
|
|
|
+
|
|
|
## 与项目内旧技能的关系
|
|
|
|
|
|
本项目内旧的 `.claude/skills/smartbadge-pipeline-ops` 已被本独立仓库取代(内容迁移并扩展至月报/年报与确认门交互)。安装本技能后,直接以 `smartbadge-ops` 使用即可。
|
|
|
|
|
|
## 版本
|
|
|
|
|
|
-v1.0.0 — 2026-09-04,首次发布
|
|
|
+v1.0.1 — 2026-09-04,新增「给 AI 的完整配置提示」章节
|
