@peninsula-med/beisen-ehr-plugin 3.0.1 → 3.1.1

package/README.md

@@ -1,7 +1,9 @@
-# 北森 EHR 加班申请插件 v3.0.0 🐉
+# 北森 EHR 加班申请插件 v3.1.0 🐉
 
 专注功能：**加班申请**
 
+**新增**：SKILL.md 技能文档，AI 自动识别何时调用工具！
+
 ## 一键安装
 
 ```bash

package/openclaw.plugin.json

@@ -2,6 +2,7 @@
   "id": "beisen-ehr-plugin",
   "name": "北森 EHR - 加班申请",
   "description": "北森 EHR 加班申请插件",
+  "skills": ["skills/beisen-ehr"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@peninsula-med/beisen-ehr-plugin",
-  "version": "3.0.1",
+  "version": "3.1.1",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
-  "files": ["dist", "openclaw.plugin.json", "README.md"],
+  "files": ["dist", "openclaw.plugin.json", "README.md", "skills"],
   "scripts": {
     "build": "rollup -c",
     "dev": "rollup -c -w",

package/skills/beisen-ehr/SKILL.md

@@ -0,0 +1,189 @@
+---
+name: beisen-ehr
+description: 北森 EHR 系统集成 - 加班申请提交
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🏢",
+        "requires": { "plugins": ["beisen-ehr-plugin"] },
+      },
+  }
+---
+
+# 北森 EHR 加班申请
+
+使用 `beisen_submit_overtime` 工具提交加班申请到北森 EHR 系统。
+
+## 何时调用
+
+当用户提到以下关键词时，应该调用加班申请工具：
+
+- "申请加班"
+- "提交加班"
+- "报加班"
+- "加班申请"
+- "add overtime"
+- "submit overtime"
+
+## 参数说明
+
+### 必需参数
+
+- **startDate** - 开始时间
+  - 格式：`YYYY-MM-DD HH:mm:ss`
+  - 示例：`2026-03-15 09:00:00`
+  - 从用户描述中提取（如"今天晚上 8 点" → `2026-03-13 20:00:00`）
+
+- **stopDate** - 结束时间
+  - 格式：`YYYY-MM-DD HH:mm:ss`
+  - 示例：`2026-03-15 18:00:00`
+  - 从用户描述中提取（如"到 9 点" → `2026-03-13 21:00:00`）
+
+### 可选参数
+
+- **compensationType** - 补偿类型
+  - `0` = 调休假（默认）
+  - `1` = 加班费
+  - 如果用户明确说"要加班费"则设为 1
+
+- **properties** - 自定义字段
+  - JSON 字符串格式
+  - 一般不需要，除非用户有特殊要求
+
+## 使用示例
+
+### 示例 1：普通加班申请
+
+**用户**：申请加班，今天晚上 8 点到 9 点
+
+**调用工具**：
+```json
+{
+  "tool": "beisen_submit_overtime",
+  "arguments": {
+    "startDate": "2026-03-13 20:00:00",
+    "stopDate": "2026-03-13 21:00:00"
+  }
+}
+```
+
+**响应**：
+```
+✅ 加班申请已提交！
+
+- 员工：404183251
+- 邮箱：zhangjiamin@peninsulalaser.com.test
+- 时间：2026-03-13 20:00:00 ~ 2026-03-13 21:00:00
+- 类型：调休假
+```
+
+### 示例 2：周末加班
+
+**用户**：帮我提交一个这周末的加班申请，周六全天
+
+**调用工具**：
+```json
+{
+  "tool": "beisen_submit_overtime",
+  "arguments": {
+    "startDate": "2026-03-15 09:00:00",
+    "stopDate": "2026-03-15 18:00:00"
+  }
+}
+```
+
+### 示例 3：要加班费
+
+**用户**：申请加班，明天上午 9 点到下午 6 点，要加班费
+
+**调用工具**：
+```json
+{
+  "tool": "beisen_submit_overtime",
+  "arguments": {
+    "startDate": "2026-03-14 09:00:00",
+    "stopDate": "2026-03-14 18:00:00",
+    "compensationType": 1
+  }
+}
+```
+
+## 日期时间解析
+
+### 相对时间
+
+- "今天晚上 8 点" → 今天日期的 20:00:00
+- "明天上午 9 点" → 明天日期的 09:00:00
+- "这周末" → 本周六或周日（需要确认）
+- "下周一" → 下周一的日期
+
+### 时间范围
+
+- "全天" → 09:00:00 到 18:00:00
+- "上午" → 09:00:00 到 12:00:00
+- "下午" → 13:00:00 到 18:00:00
+- "晚上" → 19:00:00 到 21:00:00
+
+## 错误处理
+
+### 缺少必需参数
+
+如果用户没有提供完整的时间信息，应该询问：
+
+**用户**：我要申请加班
+
+**回复**：
+```
+好的，请问您要申请什么时间的加班？
+
+请提供：
+- 开始时间（如：今天晚上 8 点）
+- 结束时间（如：今天晚上 9 点）
+```
+
+### 时间段冲突
+
+如果北森返回错误"时间段已有加班记录"：
+
+**回复**：
+```
+⚠️ 该时间段已有加班申请，请问是否需要：
+1. 调整加班时间
+2. 先撤销原有申请
+```
+
+### 认证失败
+
+如果返回 401 错误：
+
+**回复**：
+```
+❌ 认证失败，请联系 IT 管理员检查北森 API 凭证配置
+```
+
+## 前置检查
+
+调用工具前确认：
+
+1. ✅ 插件已加载（`beisen-ehr-plugin`）
+2. ✅ 工具可用（`beisen_submit_overtime`）
+3. ✅ 用户提供了开始和结束时间
+4. ✅ 结束时间 > 开始时间
+
+## 最佳实践
+
+1. **确认时间** - 提交前复述时间，确保理解正确
+2. **默认调休** - 除非用户明确要求加班费，否则默认 compensationType=0
+3. **处理模糊时间** - "这周末"需要确认是周六还是周日
+4. **及时反馈** - 提交后告知用户申请结果和申请 ID
+
+## 相关工具
+
+- `beisen_get_approval_status` - 查询审批状态（后续完善）
+- `beisen_get_leave_balance` - 查询假期余额（后续完善）
+
+---
+
+🐉 **开发**：龙二 (Long Er)
+📦 **插件**：@peninsula-med/beisen-ehr-plugin