@peninsula-med/beisen-ehr-plugin 1.0.0 → 1.0.2

package/README.md

@@ -3,28 +3,42 @@
 北森 EHR 系统的 OpenClaw 插件，支持加班申请、考勤查询、假期余额等功能。
 
 > **开发：** 龙二 (Long Er) 🐉  
-> **版本：** 1.0.0
+> **版本：** 1.0.1
 
 ---
 
 ## 快速安装
 
+### 1️⃣ 安装插件
+
+```bash
+openclaw plugins install @peninsula-med/beisen-ehr-plugin
+```
+
+### 2️⃣ 配置凭证（3 种方式）
+
+**方式 A：使用配置向导（推荐 ⭐）**
+
 ```bash
-openclaw plugins install @beisen/beisen-ehr-plugin
+npx @peninsula-med/beisen-ehr-configure
 ```
 
-安装后配置：
+按提示输入北森凭证即可，自动完成配置！
+
+**方式 B：运行配置脚本**
 
 ```bash
-openclaw plugins config beisen-ehr-plugin
+node node_modules/@peninsula-med/beisen-ehr-plugin/scripts/configure.js
 ```
 
-或编辑 `~/.openclaw/config.json`：
+**方式 C：手动编辑配置文件**
+
+编辑 `~/.openclaw/config.json`：
 
 ```json
 {
   "plugins": {
-    "beisen-ehr-plugin": {
+    "@peninsula-med/beisen-ehr-plugin": {
       "enabled": true,
       "config": {
         "apiUrl": "https://openapi.italent.cn",
@@ -39,10 +53,16 @@ openclaw plugins config beisen-ehr-plugin
 }
 ```
 
-重启 OpenClaw：
+### 3️⃣ 重启 OpenClaw
 
 ```bash
-openclaw gateway restart
+openclaw restart
+```
+
+### 4️⃣ 测试
+
+```
+帮我提交一个加班申请
 ```
 
 ---
@@ -108,31 +128,21 @@ openclaw gateway restart
 
 ---
 
-## 开发
-
-### 安装依赖
-
-```bash
-npm install
-```
-
-### 开发模式
-
-```bash
-npm run dev
-```
+## 配置向导
 
-### 构建
+运行配置向导，按提示输入凭证：
 
 ```bash
-npm run build
+npx @peninsula-med/beisen-ehr-configure
 ```
 
-### 发布
-
-```bash
-npm run publish:release
-```
+向导会：
+1. ✅ 提示输入必要凭证
+2. ✅ 自动验证格式
+3. ✅ 备份现有配置
+4. ✅ 写入配置文件
+5. ✅ 显示配置摘要
+6. ✅ 提供下一步指引
 
 ---
 
@@ -142,13 +152,14 @@ npm run publish:release
 
 ```bash
 openclaw plugins list
-openclaw plugins info beisen-ehr-plugin
+openclaw plugins info @peninsula-med/beisen-ehr-plugin
 ```
 
 ### 配置错误
 
+重新运行配置向导：
 ```bash
-openclaw plugins config beisen-ehr-plugin
+npx @peninsula-med/beisen-ehr-configure
 ```
 
 ### 查看日志
@@ -157,6 +168,27 @@ openclaw plugins config beisen-ehr-plugin
 openclaw gateway logs | grep beisen
 ```
 
+### 卸载
+
+```bash
+openclaw plugins uninstall @peninsula-med/beisen-ehr-plugin
+```
+
+---
+
+## 更新日志
+
+### v1.0.1 (2026-03-11)
+- ✅ 添加配置向导脚本
+- ✅ 支持 npx 一键配置
+
+### v1.0.0 (2026-03-11)
+- ✅ 初始版本
+- ✅ 提交加班申请
+- ✅ 查询考勤记录
+- ✅ 查询审批状态
+- ✅ 查询假期余额
+
 ---
 
 ## License

package/openclaw.plugin.json

@@ -34,8 +34,7 @@
             "format": "email",
             "description": "企业邮箱"
           }
-        },
-        "required": ["appKey", "appSecret", "staffId", "tenantId", "email"]
+        }
       }
     }
   ],
@@ -63,7 +62,6 @@
         "type": "string",
         "format": "email"
       }
-    },
-    "required": ["appKey", "appSecret", "staffId", "tenantId", "email"]
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peninsula-med/beisen-ehr-plugin",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
@@ -15,7 +15,11 @@
     "dev": "rollup -c -w",
     "clean": "rm -rf dist",
     "prebuild": "npm run clean",
-    "publish:release": "npm run prebuild && npm run build && npm publish --access public"
+    "publish:release": "npm run prebuild && npm run build && npm publish --access public",
+    "configure": "node scripts/configure.js"
+  },
+  "bin": {
+    "beisen-ehr-configure": "./scripts/configure.js"
   },
   "keywords": [
     "beisen",

package/scripts/configure.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+/**
+ * 北森 EHR Plugin 配置向导
+ * 交互式引导用户完成配置
+ */
+
+import readline from 'readline';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+function question(prompt) {
+  return new Promise((resolve) => {
+    rl.question(prompt, (answer) => {
+      resolve(answer);
+    });
+  });
+}
+
+function sleep(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+async function main() {
+  console.log('');
+  console.log('🏢 北森 EHR Plugin 配置向导');
+  console.log('='.repeat(50));
+  console.log('');
+  console.log('这个向导将帮助你配置北森 EHR 插件');
+  console.log('');
+  
+  await sleep(500);
+  
+  // 获取配置
+  console.log('请从北森管理员获取以下信息：');
+  console.log('');
+  console.log('  📋 需要准备的凭证：');
+  console.log('  • App Key（应用标识）');
+  console.log('  • App Secret（应用密钥）');
+  console.log('  • Tenant ID（企业租户 ID）');
+  console.log('  • Staff ID（你的员工 ID）');
+  console.log('  • 企业邮箱（用于识别员工）');
+  console.log('');
+  
+  await sleep(1000);
+  
+  const appKey = await question('请输入 App Key: ');
+  const appSecret = await question('请输入 App Secret: ');
+  const tenantId = await question('请输入 Tenant ID: ');
+  const staffId = await question('请输入 Staff ID: ');
+  const email = await question('请输入企业邮箱: ');
+  
+  // 验证输入
+  console.log('');
+  console.log('🔍 验证配置信息...');
+  await sleep(500);
+  
+  const config = {
+    apiUrl: 'https://openapi.italent.cn',
+    appKey: appKey.trim(),
+    appSecret: appSecret.trim(),
+    staffId: staffId.trim(),
+    tenantId: tenantId.trim(),
+    email: email.trim(),
+  };
+  
+  // 查找配置文件
+  const homeDir = os.homedir();
+  const configPath = path.join(homeDir, '.openclaw', 'config.json');
+  
+  console.log('✅ 配置信息验证通过');
+  console.log('');
+  console.log('📁 配置文件位置:', configPath);
+  console.log('');
+  
+  // 读取或创建配置文件
+  let openclawConfig = {};
+  if (fs.existsSync(configPath)) {
+    console.log('📖 读取现有配置...');
+    const content = fs.readFileSync(configPath, 'utf-8');
+    openclawConfig = JSON.parse(content);
+  } else {
+    console.log('📝 创建新配置文件...');
+  }
+  
+  await sleep(500);
+  
+  // 更新配置
+  if (!openclawConfig.plugins) {
+    openclawConfig.plugins = {};
+  }
+  
+  openclawConfig.plugins['@peninsula-med/beisen-ehr-plugin'] = {
+    enabled: true,
+    config: config,
+  };
+  
+  // 备份旧配置
+  if (fs.existsSync(configPath)) {
+    const backupPath = configPath + '.bak.' + Date.now();
+    fs.copyFileSync(configPath, backupPath);
+    console.log('💾 已备份原配置:', backupPath);
+  }
+  
+  // 确保目录存在
+  const configDir = path.dirname(configPath);
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+  }
+  
+  // 写入配置
+  fs.writeFileSync(configPath, JSON.stringify(openclawConfig, null, 2), 'utf-8');
+  
+  console.log('');
+  console.log('✅ 配置已保存！');
+  console.log('');
+  console.log('📋 配置摘要：');
+  console.log('  • API 地址:', config.apiUrl);
+  console.log('  • App Key:', config.appKey.substring(0, 8) + '...');
+  console.log('  • Staff ID:', config.staffId);
+  console.log('  • Tenant ID:', config.tenantId);
+  console.log('  • 邮箱:', config.email);
+  console.log('');
+  
+  await sleep(500);
+  
+  console.log('🎉 配置完成！');
+  console.log('');
+  console.log('下一步：');
+  console.log('  1. 重启 OpenClaw:');
+  console.log('     openclaw restart');
+  console.log('');
+  console.log('  2. 测试插件：');
+  console.log('     在对话中说："帮我提交一个加班申请"');
+  console.log('');
+  console.log('  3. 查看日志（如有问题）：');
+  console.log('     openclaw gateway logs');
+  console.log('');
+  console.log('='.repeat(50));
+  console.log('');
+  
+  rl.close();
+}
+
+main().catch((error) => {
+  console.error('');
+  console.error('❌ 配置失败:', error.message);
+  console.error('');
+  console.error('请检查：');
+  console.error('  • 是否有权限写入配置文件');
+  console.error('  • 配置文件是否是有效的 JSON 格式');
+  console.error('');
+  console.error('如需帮助，请联系管理员。');
+  console.error('');
+  rl.close();
+  process.exit(1);
+});