codewave-openclaw-installer 2.3.1 → 2.3.2

package/README.md

@@ -70,6 +70,29 @@ npx codewave-openclaw-installer
 4. `postflight`：重启 OpenClaw Gateway，并运行统一检查输出最终状态
 5. `channel-bootstrap`：检测到飞书或钉钉线索时，按官方入口自动安装并初始化
 
+## Skill 使用埋点
+
+自动上报埋点到追踪服务器：
+
+### 埋点时机
+
+1. **安装完成时**：上报 `skill_name: "用户安装"`
+2. **使用 skill 时**：上报具体的 skill 名称
+
+### 上报数据示例
+
+```json
+{
+  "skill_name": "用户安装",
+  "user_id": "your-hostname",
+  "timestamp": "2026-04-13T14:53:15.000Z"
+}
+```
+
+- **设备标识**: 直接使用设备 hostname
+- **静默失败**: 埋点失败不影响安装和 skill 使用
+- **详细文档**: 见 [docs/skill-tracking.md](docs/skill-tracking.md)
+
 ## 目录结构
 
 ```

package/bin/install.mjs

@@ -1400,6 +1400,209 @@ async function runPostflight(context) {
   }
 }
 
+/**
+ * 为非 CLI skill 注入埋点代码
+ */
+async function injectSkillTracking() {
+  const extensionDir = join(homedir(), '.openclaw', 'extensions', 'codewave-openclaw-installer');
+  
+  if (!existsSync(extensionDir)) {
+    console.log(dim(`  ↺ 扩展目录不存在，跳过 skill 埋点注入`));
+    return;
+  }
+
+  // 1. risk-alert (Node.js)
+  const riskAlertScript = join(extensionDir, 'skills', 'risk-alert', 'scripts', 'risk-alert.js');
+  if (existsSync(riskAlertScript)) {
+    let content = readFileSync(riskAlertScript, 'utf8');
+    
+    // 检查是否已经注入过
+    if (!content.includes('上报埋点')) {
+      const trackCode = `
+// 上报埋点（静默失败）
+try {
+  const trackScript = path.join(os.homedir(), '.openclaw/extensions/codewave-openclaw-installer/bin/track-skill-usage.mjs');
+  if (fs.existsSync(trackScript)) {
+    execSync(\`node "\${trackScript}" "risk-alert"\`, { stdio: 'ignore', timeout: 3000 });
+  }
+} catch (e) {
+  // 静默失败
+}
+`;
+      
+      // 在 require 语句后插入
+      content = content.replace(
+        /(const path = require\('path'\);)/,
+        `$1\nconst os = require('os');\n${trackCode}`
+      );
+      
+      writeFileSync(riskAlertScript, content);
+      console.log(green(`  ✓ risk-alert 埋点注入成功`));
+    }
+  }
+
+  // 2. ppt-master (Python)
+  const pptMasterDir = join(extensionDir, 'skills', 'ppt-master', 'scripts');
+  if (existsSync(pptMasterDir)) {
+    // 创建 track_skill.py
+    const trackSkillPy = join(pptMasterDir, 'track_skill.py');
+    const trackSkillCode = `#!/usr/bin/env python3
+"""
+PPT Master skill 埋点工具
+在 Python 脚本中调用以上报使用埋点
+"""
+
+import os
+import json
+import socket
+from datetime import datetime
+from urllib import request
+from urllib.error import URLError
+
+TRACK_API_URL = "http://117.187.202.190:8000/api/track"
+TRACK_TIMEOUT = 3  # 3秒超时
+
+
+def track_skill_usage(skill_name="ppt-master", silent=True):
+    """
+    上报 skill 使用埋点
+    
+    Args:
+        skill_name: skill 名称
+        silent: 静默模式，失败不抛出异常
+    
+    Returns:
+        bool: 是否成功
+    """
+    try:
+        data = {
+            "skill_name": skill_name,
+            "user_id": socket.gethostname(),
+            "timestamp": datetime.utcnow().strftime("%Y-%m-%dT%H:%M:%S.000Z")
+        }
+        
+        req = request.Request(
+            TRACK_API_URL,
+            data=json.dumps(data).encode('utf-8'),
+            headers={'Content-Type': 'application/json'}
+        )
+        
+        with request.urlopen(req, timeout=TRACK_TIMEOUT) as response:
+            return response.status == 200
+            
+    except (URLError, Exception) as e:
+        if not silent:
+            print(f"[Track] Error: {e}")
+        return False
+
+
+if __name__ == "__main__":
+    import sys
+    skill_name = sys.argv[1] if len(sys.argv) > 1 else "ppt-master"
+    success = track_skill_usage(skill_name, silent=False)
+    print(f"{'✓' if success else '✗'} Tracked: {skill_name}")
+    sys.exit(0 if success else 1)
+`;
+    
+    writeFileSync(trackSkillPy, trackSkillCode);
+    chmodSync(trackSkillPy, 0o755);
+    
+    // 修改 project_manager.py
+    const projectManagerPy = join(pptMasterDir, 'project_manager.py');
+    if (existsSync(projectManagerPy)) {
+      let content = readFileSync(projectManagerPy, 'utf8');
+      
+      if (!content.includes('上报埋点')) {
+        content = content.replace(
+          /(from urllib\.parse import urlparse)/,
+          `$1\n\n# 上报埋点（静默失败）\ntry:\n    from track_skill import track_skill_usage\n    track_skill_usage("ppt-master")\nexcept Exception:\n    pass`
+        );
+        
+        writeFileSync(projectManagerPy, content);
+      }
+    }
+    
+    console.log(green(`  ✓ ppt-master 埋点注入成功`));
+  }
+}
+
+/**
+ * 创建 CLI wrapper 用于自动上报埋点
+ */
+async function createCliWrappers() {
+  const wrappers = [
+    {
+      name: 'razel-cli',
+      binPath: join(homedir(), '.local', 'bin', 'razel-cli'),
+      mapping: {
+        popo: 'popo-doc',
+        'meeting-prd': 'meeting-to-prd',
+        'm2p': 'meeting-to-prd',
+      },
+    },
+    {
+      name: 'razel-py-cli',
+      binPath: join(homedir(), '.local', 'bin', 'razel-py-cli'),
+      mapping: {
+        'meeting-prd': 'meeting-to-prd',
+        speech: 'speed-to-text',
+        's2t': 'speed-to-text',
+        pmo: 'pmo-weekly-report',
+      },
+    },
+  ];
+
+  for (const { name, binPath, mapping } of wrappers) {
+    if (!existsSync(binPath)) {
+      console.log(dim(`  ↺ ${name} 不存在，跳过 wrapper 创建`));
+      continue;
+    }
+
+    const realPath = `${binPath}.real`;
+    
+    // 备份原始命令（如果还没备份）
+    if (!existsSync(realPath)) {
+      cpSync(binPath, realPath);
+    }
+
+    // 生成 mapping 的 case 语句
+    const caseStatements = Object.entries(mapping)
+      .map(([key, value]) => `  ${key})\n    TRACK_NAME="${value}"\n    ;;`)
+      .join('\n');
+
+    // 生成 wrapper 脚本
+    const wrapperScript = `#!/bin/bash
+
+# ${name} wrapper - 自动上报埋点
+# 原始命令已备份到 ${name}.real
+
+# 提取 skill 名称（第一个参数）
+SKILL_NAME="\${1:-unknown}"
+
+# 映射 CLI 子命令到 skill 名称
+case "$SKILL_NAME" in
+${caseStatements}
+  *)
+    TRACK_NAME="${name}-\${SKILL_NAME}"
+    ;;
+esac
+
+# 异步上报埋点（后台进程，不阻塞）
+node ~/.openclaw/extensions/codewave-openclaw-installer/bin/track-skill-usage.mjs "$TRACK_NAME" >/dev/null 2>&1 &
+
+# 等待一小段时间确保埋点请求发出（不影响性能）
+sleep 0.1
+
+# 调用真实命令，传递所有参数和返回码
+exec "$(dirname "$0")/${name}.real" "$@"
+`;
+
+    writeFileSync(binPath, wrapperScript);
+    chmodSync(binPath, 0o755);
+    console.log(green(`  ✓ ${name} wrapper 创建成功`));
+  }
+}
+
 async function main() {
   const context = createInstallContext(process.platform);
 
@@ -1477,6 +1680,28 @@ async function main() {
   console.log(cyan('    razel-py-cli --help'));
   console.log(cyan('    razel-cli --help'));
   console.log('');
+
+  // 创建 CLI wrapper 用于埋点追踪
+  try {
+    await createCliWrappers();
+  } catch (err) {
+    console.warn(yellow(`  ⚠ 创建 CLI wrapper 失败: ${err.message}`));
+  }
+
+  // 为非 CLI skill 注入埋点代码
+  try {
+    await injectSkillTracking();
+  } catch (err) {
+    console.warn(yellow(`  ⚠ Skill 埋点注入失败: ${err.message}`));
+  }
+
+  // 上报安装埋点
+  try {
+    const { trackSkillUsage } = await import(join(PKG_ROOT, 'bin', 'track-skill-usage.mjs'));
+    await trackSkillUsage('用户安装', { silent: true });
+  } catch {
+    // 静默失败，不影响安装流程
+  }
 }
 
 main().catch((err) => {

package/bin/track-skill-usage.mjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+/**
+ * Skill 使用埋点追踪器
+ * 当用户使用 skill 时自动上报到埋点服务器
+ */
+
+import { hostname } from 'node:os';
+
+const TRACK_API_URL = 'http://117.187.202.190:8000/api/track';
+const TRACK_TIMEOUT = 3000; // 3秒超时
+
+/**
+ * 获取设备唯一标识（直接使用 hostname）
+ */
+function getDeviceId() {
+  return hostname();
+}
+
+/**
+ * 上报 skill 使用埋点
+ * @param {string} skillName - skill 名称
+ * @param {object} options - 可选参数
+ * @returns {Promise<boolean>}
+ */
+export async function trackSkillUsage(skillName, options = {}) {
+  const {
+    userId = getDeviceId(),
+    apiUrl = TRACK_API_URL,
+    timeout = TRACK_TIMEOUT,
+    silent = true, // 静默模式，失败不影响主流程
+  } = options;
+
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+
+    const response = await fetch(apiUrl, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        skill_name: skillName,
+        user_id: userId,
+        timestamp: new Date().toISOString(),
+      }),
+      signal: controller.signal,
+    });
+
+    clearTimeout(timeoutId);
+
+    if (!response.ok && !silent) {
+      console.warn(`[Track] Failed to track skill usage: ${response.status}`);
+      return false;
+    }
+
+    return true;
+  } catch (error) {
+    if (!silent) {
+      console.warn(`[Track] Error tracking skill usage: ${error.message}`);
+    }
+    return false;
+  }
+}
+
+/**
+ * 从 SKILL.md 的 frontmatter 提取 skill name
+ */
+export function extractSkillName(skillMdContent) {
+  const match = skillMdContent.match(/^---\s*\nname:\s*(.+?)\s*\n/m);
+  return match ? match[1].trim() : null;
+}
+
+// CLI 模式
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const skillName = process.argv[2];
+  if (!skillName) {
+    console.error('Usage: track-skill-usage.mjs <skill-name>');
+    process.exit(1);
+  }
+
+  trackSkillUsage(skillName, { silent: false })
+    .then((success) => {
+      if (success) {
+        console.log(`✓ Tracked: ${skillName}`);
+      } else {
+        console.error(`✗ Failed to track: ${skillName}`);
+        process.exit(1);
+      }
+    })
+    .catch((error) => {
+      console.error(`✗ Error: ${error.message}`);
+      process.exit(1);
+    });
+}

package/index.js

@@ -6,15 +6,63 @@
  */
 
 import { emptyPluginConfigSchema } from 'openclaw/plugin-sdk';
+import { trackSkillUsage } from './bin/track-skill-usage.mjs';
+
+// 插件中的 skill 列表（精确匹配，只追踪这些）
+const PLUGIN_SKILLS = new Set([
+  'acceptance-doc-entry',
+  'meeting-to-prd',
+  'pmo-weekly-report',
+  'popo-doc',
+  'popo-robot-api',
+  'ppt-master',
+  'risk-alert',
+  'smart-customer-service',
+  'speed-to-text',
+  'tencent-meeting',
+  'yidun-skill-sec',
+]);
 
 const plugin = {
   id: 'codewave-openclaw-installer',
   name: 'CodeWave Toolkit',
   description: '网易智企 CodeWave 低代码平台 OpenClaw 工具集',
   configSchema: emptyPluginConfigSchema(),
-  register(_api) {
-    // 纯 skills 插件，无需注册 channel/tool
-    // Skills 由 openclaw.plugin.json 中的 "skills" 字段声明，OpenClaw 自动加载
+  register(api) {
+    if (!api.on) return;
+
+    // 监听 before_tool_call 事件
+    // 注意：OpenClaw 的 before_tool_call 传的是 tool 名称（exec、read 等），
+    // 不是 skill 名称。这里同时监听，以便在 OpenClaw 未来支持 skill 级事件时兼容。
+    api.on('before_tool_call', (event) => {
+      const toolName = event.toolName;
+      if (!toolName) return;
+
+      // 精确匹配（使用 Set.has 代替 includes，避免子串误匹配）
+      if (PLUGIN_SKILLS.has(toolName)) {
+        trackSkillUsage(toolName).catch((err) => {
+          console.error(`[CodeWave Track] Failed to track: ${err.message}`);
+        });
+      }
+    });
+
+    // 监听 skill:read 事件（OpenClaw 在读取 SKILL.md 时触发）
+    // 当 AI 读取某个 skill 的 SKILL.md 文件时，可以认为该 skill 被使用了
+    api.on('before_tool_call', (event) => {
+      const { toolName, params } = event;
+      if (toolName !== 'read' || !params?.path) return;
+
+      // 检查是否在读取本插件的 skill 的 SKILL.md
+      const pathStr = String(params.path);
+      for (const skill of PLUGIN_SKILLS) {
+        if (pathStr.includes(`/${skill}/SKILL.md`)) {
+          trackSkillUsage(skill).catch((err) => {
+            console.error(`[CodeWave Track] Failed to track: ${err.message}`);
+          });
+          break;
+        }
+      }
+    });
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codewave-openclaw-installer",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "网易智企 CodeWave OpenClaw 扩展：Skills + CLI 依赖一键安装",
   "type": "module",
   "main": "index.js",

package/skills/ppt-master/scripts/project_manager.py

@@ -18,6 +18,13 @@ from datetime import datetime
 from pathlib import Path
 from urllib.parse import urlparse
 
+# 上报埋点（静默失败）
+try:
+    from track_skill import track_skill_usage
+    track_skill_usage("ppt-master")
+except Exception:
+    pass
+
 try:
     from project_utils import (
         CANVAS_FORMATS,

package/skills/ppt-master/scripts/track_skill.py

@@ -0,0 +1,56 @@
+#!/usr/bin/env python3
+"""
+PPT Master skill 埋点工具
+在 Python 脚本中调用以上报使用埋点
+"""
+
+import os
+import json
+import socket
+from datetime import datetime
+from urllib import request
+from urllib.error import URLError
+
+TRACK_API_URL = "http://117.187.202.190:8000/api/track"
+TRACK_TIMEOUT = 3  # 3秒超时
+
+
+def track_skill_usage(skill_name="ppt-master", silent=True):
+    """
+    上报 skill 使用埋点
+    
+    Args:
+        skill_name: skill 名称
+        silent: 静默模式，失败不抛出异常
+    
+    Returns:
+        bool: 是否成功
+    """
+    try:
+        data = {
+            "skill_name": skill_name,
+            "user_id": socket.gethostname(),
+            "timestamp": datetime.utcnow().strftime("%Y-%m-%dT%H:%M:%S.000Z")
+        }
+        
+        req = request.Request(
+            TRACK_API_URL,
+            data=json.dumps(data).encode('utf-8'),
+            headers={'Content-Type': 'application/json'}
+        )
+        
+        with request.urlopen(req, timeout=TRACK_TIMEOUT) as response:
+            return response.status == 200
+            
+    except (URLError, Exception) as e:
+        if not silent:
+            print(f"[Track] Error: {e}")
+        return False
+
+
+if __name__ == "__main__":
+    import sys
+    skill_name = sys.argv[1] if len(sys.argv) > 1 else "ppt-master"
+    success = track_skill_usage(skill_name, silent=False)
+    print(f"{'✓' if success else '✗'} Tracked: {skill_name}")
+    sys.exit(0 if success else 1)

package/skills/risk-alert/SKILL.md

@@ -1,3 +1,9 @@
+---
+name: risk-alert
+description: "智能风险预警，自动监控飞书群聊消息，识别风险并推送预警卡片"
+version: 1.0.0
+---
+
 # Risk Alert - 智能风险预警 Skill
 
 ## 功能概述

package/skills/risk-alert/scripts/risk-alert.js

@@ -11,6 +11,17 @@
 const { execSync, spawn } = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const os = require('os');
+
+// 上报埋点（静默失败）
+try {
+  const trackScript = path.join(os.homedir(), '.openclaw/extensions/codewave-openclaw-installer/bin/track-skill-usage.mjs');
+  if (fs.existsSync(trackScript)) {
+    execSync(`node "${trackScript}" "risk-alert"`, { stdio: 'ignore', timeout: 3000 });
+  }
+} catch (e) {
+  // 静默失败
+}
 
 const SCRIPTS_DIR = path.join(__dirname);
 const RAW_MESSAGES_MD = path.join(SCRIPTS_DIR, 'raw-messages.md');