@peninsula-med/beisen-ehr-plugin 3.1.2 → 3.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peninsula-med/beisen-ehr-plugin",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/skills/beisen-ehr/SKILL.md

@@ -13,6 +13,27 @@ metadata:
 
 # 北森 EHR 加班申请
 
+> **🚀 快速开始（开发者必读）**
+>
+> **正确调用方式：**
+> ```bash
+> openclaw agent --message "申请加班，今天晚上 8 点到 9 点"
+> ```
+> Gateway 会自动识别意图并调用 `beisen_submit_overtime` 工具。
+>
+> **避免以下错误方式：**
+> - ❌ `openclaw tools call beisen_submit_overtime` - 不支持
+> - ❌ `openclaw agent --local` - 绕过 Gateway
+> - ❌ 直接用 `node` 调用 API - 绕过插件体系
+>
+> **确认插件已加载：**
+> ```bash
+> openclaw plugins list  # 应显示 beisen-ehr-plugin
+> ```
+>
+> **调试模式：**
+> 在插件 `.env` 中设置 `DEBUG=false`（默认）关闭详细日志，提升响应速度。
+
 使用 `beisen_submit_overtime` 工具提交加班申请到北森 EHR 系统。
 
 ## 何时调用
@@ -185,5 +206,42 @@ metadata:
 
 ---
 
+## 🔧 故障排查
+
+### 响应慢
+
+**可能原因：**
+1. 首次调用需要获取 Token（后续会缓存）
+2. 调试日志过多（设置 `DEBUG=false`）
+3. 网络延迟（北森 API 响应时间）
+
+**解决方法：**
+```bash
+# 检查插件状态
+openclaw plugins list
+
+# 查看 Gateway 日志
+openclaw gateway logs
+
+# 确认 DEBUG=false
+cat .env | grep DEBUG
+```
+
+### 调用失败
+
+**检查清单：**
+- [ ] 插件已加载（`openclaw plugins list`）
+- [ ] `.env` 配置完整（BEISEN_STAFF_ID、BEISEN_EMAIL 等）
+- [ ] 北森 API 权限已开通
+- [ ] 日期格式正确（YYYY-MM-DD HH:mm:ss）
+
+### 不要这样做
+
+- ❌ 直接用 `node` 调用 API（绕过 Token 缓存）
+- ❌ 手动解析工具参数（让 Gateway 自动处理）
+- ❌ 读取 `dist/` 目录文件（构建产物，无需阅读）
+
+---
+
 🐉 **开发**：龙二 (Long Er)
 📦 **插件**：@peninsula-med/beisen-ehr-plugin