lightclawbot 1.1.1 → 1.1.2

package/dist/public/data/scripts/manifest.json

@@ -0,0 +1,11 @@
+{
+  "generatedAt": "2026-04-10T11:27:01.831Z",
+  "cdnBase": "https://cloudcache.tencent-cloud.com/qcloud/tea/app/data/scripts",
+  "files": {
+    "preflight.sh": {
+      "hashed": "preflight.9af62b39.sh",
+      "hash": "9af62b39",
+      "size": 7262
+    }
+  }
+}

package/dist/public/data/scripts/preflight.9af62b39.sh

@@ -0,0 +1,191 @@
+#!/bin/bash
+
+# ========== lightclawbot 插件前置检查脚本 ==========
+# 用途：快速判断 lightclawbot 插件是否可用
+# 特点：
+#   1. 减少文件 I/O 次数（一次读取配置文件，复用解析结果）
+#   2. 与 OpenClaw 源码逻辑保持一致（plugins.enabled/deny/allow/entries）
+#   3. 支持传参指定插件 ID
+#
+# 输出：最后一行固定为 RESULT:{...} JSON，供前端解析
+#   - 可用：       RESULT:{"status":"ok","version":"x.y.z"}
+#   - 缺 openclaw：RESULT:{"status":"need_openclaw","reason":"...","desc":"..."}
+#   - 需要安装/配置：RESULT:{"status":"need_install","reason":"...","desc":"..."}
+#   - reason: 固定错误码（前端用于判断分支）
+#   - desc:   检测命令的实际输出（可选，用于排查问题）
+#
+# 使用方式：
+#   本地执行：  bash preflight.sh [plugin_id]
+#   CDN 执行：  bash <(curl -fsSL https://your-cdn.com/preflight.sh) [plugin_id]
+#   默认检查：  lightclawbot
+
+# ---------- 配置 ----------
+id="${1:-lightclawbot}"           # 支持传参指定插件 ID
+cfg="$HOME/.openclaw/openclaw.json"
+plugin_dir="$HOME/.openclaw/extensions/${id}"
+
+# ---------- 加载 nvm 环境 ----------
+# bash xxx.sh 启动的是非交互式 shell，不会自动 source ~/.bashrc，
+# 如果用户通过 nvm 安装 node，脚本中的 node / openclaw 命令都找不到。
+# 提前加载 nvm，让后续所有步骤都能使用 nvm 管理的 node。
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+# ---------- 工具函数 ----------
+result_exit() {
+  local status="$1"
+  local reason="$2"
+  local desc="${3:-}"
+  local exit_code="${4:-1}"
+  # 转义 desc 中的特殊字符，保证输出合法 JSON
+  desc="${desc//\\/\\\\}"
+  desc="${desc//\"/\\\"}"
+  desc="${desc//$'\n'/\\n}"
+  desc="${desc//$'\r'/}"
+  if [ -n "$desc" ]; then
+    echo "RESULT:{\"status\":\"${status}\",\"reason\":\"${reason}\",\"desc\":\"${desc}\"}"
+  else
+    echo "RESULT:{\"status\":\"${status}\",\"reason\":\"${reason}\"}"
+  fi
+  exit "$exit_code"
+}
+
+result_ok() {
+  echo "RESULT:{\"status\":\"ok\",\"version\":\"${1}\"}"
+  exit 0
+}
+
+# ---------- 1. 检查配置文件是否存在 ----------
+
+if [ ! -f "$cfg" ]; then
+  result_exit "error" "config_not_found" "$(ls "$cfg" 2>&1)"
+fi
+
+# ---------- 2. 验证配置文件 JSON 格式 ----------
+# openclaw 通过即 node 可用，用 node 做一次轻量校验
+
+json_check_output=$(node -e "JSON.parse(require('fs').readFileSync(process.argv[1],'utf8'))" "$cfg" 2>&1)
+if [ $? -ne 0 ]; then
+  result_exit "error" "config_json_invalid" "$json_check_output"
+fi
+
+# ---------- 3. 检查 openclaw 是否可用 ----------
+
+if ! command -v openclaw &>/dev/null; then
+  oc_which_output=$(which openclaw 2>&1) || true
+  result_exit "error" "openclaw_not_available" "${oc_which_output:-openclaw not found in PATH=${PATH}}"
+fi
+
+# ---------- 3a. 检查 openclaw 版本是否满足最低要求 ----------
+
+min_version="2026.2.3"
+# 兼容多种输出格式：
+#   "OpenClaw 2026.3.24 (cff6dc9)"  →  2026.3.24
+#   "2026.2.3"                       →  2026.2.3
+oc_version_output=$(openclaw -v 2>&1)
+current_version=$(echo "$oc_version_output" | head -1 | sed 's/[()]//g' | grep -oE '[0-9]{4}\.[0-9]+\.[0-9]+' | head -1)
+
+if [ -z "$current_version" ]; then
+  result_exit "error" "openclaw_version_unknown" "$oc_version_output"
+fi
+
+# 比较版本号：将 a.b.c 转为数值后逐段比较
+version_lt() {
+  local IFS='.'
+  local i a=($1) b=($2)
+  for ((i = 0; i < 3; i++)); do
+    if (( ${a[i]:-0} < ${b[i]:-0} )); then return 0; fi
+    if (( ${a[i]:-0} > ${b[i]:-0} )); then return 1; fi
+  done
+  return 1  # 相等时不算小于
+}
+
+if version_lt "$current_version" "$min_version"; then
+  result_exit "error" "openclaw_version_too_old" "current: ${current_version}, required: >=${min_version}"
+fi
+
+# ---------- 3b. 检查 Gateway 是否可用 ----------
+
+gateway_output=$(openclaw gateway health --json 2>&1)
+if [ $? -ne 0 ]; then
+  result_exit "need_install" "gateway_not_healthy" "$gateway_output"
+fi
+
+# ---------- 4. 检查插件目录是否已安装 ----------
+
+if [ ! -d "$plugin_dir" ] || [ ! -f "$plugin_dir/package.json" ]; then
+  result_exit "need_install" "plugin_not_installed" "$(ls -la "$plugin_dir/package.json" 2>&1)"
+fi
+
+# ---------- 5. 单次 node 调用完成所有配置项检查 ----------
+# 一次启动 V8，顺序执行全部校验
+# 通过环境变量安全传参，避免 shell 注入风险
+# 输出格式：RESULT:{...} 与 bash 工具函数保持一致
+
+PREFLIGHT_CFG="$cfg" PREFLIGHT_ID="$id" PREFLIGHT_PLUGIN_DIR="$plugin_dir" \
+node -e '
+  const fs = require("fs");
+  const cfgPath   = process.env.PREFLIGHT_CFG;
+  const pluginId  = process.env.PREFLIGHT_ID;
+  const pluginDir = process.env.PREFLIGHT_PLUGIN_DIR;
+
+  function fail(status, reason, desc) {
+    const obj = { status, reason };
+    if (desc !== undefined) obj.desc = String(desc);
+    console.log("RESULT:" + JSON.stringify(obj));
+    process.exit(1);
+  }
+
+  const cfg = JSON.parse(fs.readFileSync(cfgPath, "utf8"));
+
+  // 5a. 全局插件系统检查（plugins.enabled 默认 true，仅显式 false 禁用）
+  if (cfg.plugins?.enabled === false) {
+    fail("need_install", "plugins_globally_disabled", "plugins.enabled = " + JSON.stringify(cfg.plugins?.enabled));
+  }
+
+  // 5b. deny 黑名单（优先级高于 allow，与 OpenClaw 源码一致）
+  if (Array.isArray(cfg.plugins?.deny) && cfg.plugins.deny.includes(pluginId)) {
+    fail("need_install", "plugin_in_denylist", "plugins.deny = " + JSON.stringify(cfg.plugins.deny));
+  }
+
+  // 5c. plugins.entries 启用状态
+  if (cfg.plugins?.entries?.[pluginId]?.enabled !== true) {
+    fail("need_install", "plugin_not_enabled", "plugins.entries." + pluginId + ".enabled = " + JSON.stringify(cfg.plugins?.entries?.[pluginId]?.enabled));
+  }
+
+  // 5d. allow 白名单（非空时必须在列表中）
+  const allow = cfg.plugins?.allow;
+  if (Array.isArray(allow) && allow.length > 0 && !allow.includes(pluginId)) {
+    fail("need_install", "plugin_not_in_allowlist", "plugins.allow = " + JSON.stringify(allow));
+  }
+
+  // 5e. plugins.installs 安装记录（可选，仅警告，默认不阻塞）
+  // 如需严格检查，取消下面的注释：
+  // if (!cfg.plugins?.installs?.[pluginId]) {
+  //   fail("need_install", "plugin_install_record_missing", "plugins.installs." + pluginId + " = " + JSON.stringify(cfg.plugins?.installs?.[pluginId]));
+  // }
+
+  // 5f. channels 启用状态
+  if (cfg.channels?.[pluginId]?.enabled !== true) {
+    fail("need_install", "channel_not_enabled", "channels." + pluginId + ".enabled = " + JSON.stringify(cfg.channels?.[pluginId]?.enabled));
+  }
+
+  // 5g. channels apiKeys 配置
+  const apiKeys = cfg.channels?.[pluginId]?.apiKeys;
+  if (!Array.isArray(apiKeys) || apiKeys.length === 0) {
+    fail("need_install", "apikeys_empty", "channels." + pluginId + ".apiKeys = " + JSON.stringify(apiKeys));
+  }
+
+  // 5h. 读取插件版本
+  let version = "unknown";
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pluginDir + "/package.json", "utf8"));
+    version = pkg.version || "unknown";
+  } catch (e) {}
+
+  // 全部通过
+  console.log("RESULT:" + JSON.stringify({ status: "ok", version }));
+'
+
+# 将 node 的退出码传递给 bash
+exit $?

package/dist/public/data/scripts/preflight.sh

@@ -0,0 +1,191 @@
+#!/bin/bash
+
+# ========== lightclawbot 插件前置检查脚本 ==========
+# 用途：快速判断 lightclawbot 插件是否可用
+# 特点：
+#   1. 减少文件 I/O 次数（一次读取配置文件，复用解析结果）
+#   2. 与 OpenClaw 源码逻辑保持一致（plugins.enabled/deny/allow/entries）
+#   3. 支持传参指定插件 ID
+#
+# 输出：最后一行固定为 RESULT:{...} JSON，供前端解析
+#   - 可用：       RESULT:{"status":"ok","version":"x.y.z"}
+#   - 缺 openclaw：RESULT:{"status":"need_openclaw","reason":"...","desc":"..."}
+#   - 需要安装/配置：RESULT:{"status":"need_install","reason":"...","desc":"..."}
+#   - reason: 固定错误码（前端用于判断分支）
+#   - desc:   检测命令的实际输出（可选，用于排查问题）
+#
+# 使用方式：
+#   本地执行：  bash preflight.sh [plugin_id]
+#   CDN 执行：  bash <(curl -fsSL https://your-cdn.com/preflight.sh) [plugin_id]
+#   默认检查：  lightclawbot
+
+# ---------- 配置 ----------
+id="${1:-lightclawbot}"           # 支持传参指定插件 ID
+cfg="$HOME/.openclaw/openclaw.json"
+plugin_dir="$HOME/.openclaw/extensions/${id}"
+
+# ---------- 加载 nvm 环境 ----------
+# bash xxx.sh 启动的是非交互式 shell，不会自动 source ~/.bashrc，
+# 如果用户通过 nvm 安装 node，脚本中的 node / openclaw 命令都找不到。
+# 提前加载 nvm，让后续所有步骤都能使用 nvm 管理的 node。
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+
+# ---------- 工具函数 ----------
+result_exit() {
+  local status="$1"
+  local reason="$2"
+  local desc="${3:-}"
+  local exit_code="${4:-1}"
+  # 转义 desc 中的特殊字符，保证输出合法 JSON
+  desc="${desc//\\/\\\\}"
+  desc="${desc//\"/\\\"}"
+  desc="${desc//$'\n'/\\n}"
+  desc="${desc//$'\r'/}"
+  if [ -n "$desc" ]; then
+    echo "RESULT:{\"status\":\"${status}\",\"reason\":\"${reason}\",\"desc\":\"${desc}\"}"
+  else
+    echo "RESULT:{\"status\":\"${status}\",\"reason\":\"${reason}\"}"
+  fi
+  exit "$exit_code"
+}
+
+result_ok() {
+  echo "RESULT:{\"status\":\"ok\",\"version\":\"${1}\"}"
+  exit 0
+}
+
+# ---------- 1. 检查配置文件是否存在 ----------
+
+if [ ! -f "$cfg" ]; then
+  result_exit "error" "config_not_found" "$(ls "$cfg" 2>&1)"
+fi
+
+# ---------- 2. 验证配置文件 JSON 格式 ----------
+# openclaw 通过即 node 可用，用 node 做一次轻量校验
+
+json_check_output=$(node -e "JSON.parse(require('fs').readFileSync(process.argv[1],'utf8'))" "$cfg" 2>&1)
+if [ $? -ne 0 ]; then
+  result_exit "error" "config_json_invalid" "$json_check_output"
+fi
+
+# ---------- 3. 检查 openclaw 是否可用 ----------
+
+if ! command -v openclaw &>/dev/null; then
+  oc_which_output=$(which openclaw 2>&1) || true
+  result_exit "error" "openclaw_not_available" "${oc_which_output:-openclaw not found in PATH=${PATH}}"
+fi
+
+# ---------- 3a. 检查 openclaw 版本是否满足最低要求 ----------
+
+min_version="2026.2.3"
+# 兼容多种输出格式：
+#   "OpenClaw 2026.3.24 (cff6dc9)"  →  2026.3.24
+#   "2026.2.3"                       →  2026.2.3
+oc_version_output=$(openclaw -v 2>&1)
+current_version=$(echo "$oc_version_output" | head -1 | sed 's/[()]//g' | grep -oE '[0-9]{4}\.[0-9]+\.[0-9]+' | head -1)
+
+if [ -z "$current_version" ]; then
+  result_exit "error" "openclaw_version_unknown" "$oc_version_output"
+fi
+
+# 比较版本号：将 a.b.c 转为数值后逐段比较
+version_lt() {
+  local IFS='.'
+  local i a=($1) b=($2)
+  for ((i = 0; i < 3; i++)); do
+    if (( ${a[i]:-0} < ${b[i]:-0} )); then return 0; fi
+    if (( ${a[i]:-0} > ${b[i]:-0} )); then return 1; fi
+  done
+  return 1  # 相等时不算小于
+}
+
+if version_lt "$current_version" "$min_version"; then
+  result_exit "error" "openclaw_version_too_old" "current: ${current_version}, required: >=${min_version}"
+fi
+
+# ---------- 3b. 检查 Gateway 是否可用 ----------
+
+gateway_output=$(openclaw gateway health --json 2>&1)
+if [ $? -ne 0 ]; then
+  result_exit "need_install" "gateway_not_healthy" "$gateway_output"
+fi
+
+# ---------- 4. 检查插件目录是否已安装 ----------
+
+if [ ! -d "$plugin_dir" ] || [ ! -f "$plugin_dir/package.json" ]; then
+  result_exit "need_install" "plugin_not_installed" "$(ls -la "$plugin_dir/package.json" 2>&1)"
+fi
+
+# ---------- 5. 单次 node 调用完成所有配置项检查 ----------
+# 一次启动 V8，顺序执行全部校验
+# 通过环境变量安全传参，避免 shell 注入风险
+# 输出格式：RESULT:{...} 与 bash 工具函数保持一致
+
+PREFLIGHT_CFG="$cfg" PREFLIGHT_ID="$id" PREFLIGHT_PLUGIN_DIR="$plugin_dir" \
+node -e '
+  const fs = require("fs");
+  const cfgPath   = process.env.PREFLIGHT_CFG;
+  const pluginId  = process.env.PREFLIGHT_ID;
+  const pluginDir = process.env.PREFLIGHT_PLUGIN_DIR;
+
+  function fail(status, reason, desc) {
+    const obj = { status, reason };
+    if (desc !== undefined) obj.desc = String(desc);
+    console.log("RESULT:" + JSON.stringify(obj));
+    process.exit(1);
+  }
+
+  const cfg = JSON.parse(fs.readFileSync(cfgPath, "utf8"));
+
+  // 5a. 全局插件系统检查（plugins.enabled 默认 true，仅显式 false 禁用）
+  if (cfg.plugins?.enabled === false) {
+    fail("need_install", "plugins_globally_disabled", "plugins.enabled = " + JSON.stringify(cfg.plugins?.enabled));
+  }
+
+  // 5b. deny 黑名单（优先级高于 allow，与 OpenClaw 源码一致）
+  if (Array.isArray(cfg.plugins?.deny) && cfg.plugins.deny.includes(pluginId)) {
+    fail("need_install", "plugin_in_denylist", "plugins.deny = " + JSON.stringify(cfg.plugins.deny));
+  }
+
+  // 5c. plugins.entries 启用状态
+  if (cfg.plugins?.entries?.[pluginId]?.enabled !== true) {
+    fail("need_install", "plugin_not_enabled", "plugins.entries." + pluginId + ".enabled = " + JSON.stringify(cfg.plugins?.entries?.[pluginId]?.enabled));
+  }
+
+  // 5d. allow 白名单（非空时必须在列表中）
+  const allow = cfg.plugins?.allow;
+  if (Array.isArray(allow) && allow.length > 0 && !allow.includes(pluginId)) {
+    fail("need_install", "plugin_not_in_allowlist", "plugins.allow = " + JSON.stringify(allow));
+  }
+
+  // 5e. plugins.installs 安装记录（可选，仅警告，默认不阻塞）
+  // 如需严格检查，取消下面的注释：
+  // if (!cfg.plugins?.installs?.[pluginId]) {
+  //   fail("need_install", "plugin_install_record_missing", "plugins.installs." + pluginId + " = " + JSON.stringify(cfg.plugins?.installs?.[pluginId]));
+  // }
+
+  // 5f. channels 启用状态
+  if (cfg.channels?.[pluginId]?.enabled !== true) {
+    fail("need_install", "channel_not_enabled", "channels." + pluginId + ".enabled = " + JSON.stringify(cfg.channels?.[pluginId]?.enabled));
+  }
+
+  // 5g. channels apiKeys 配置
+  const apiKeys = cfg.channels?.[pluginId]?.apiKeys;
+  if (!Array.isArray(apiKeys) || apiKeys.length === 0) {
+    fail("need_install", "apikeys_empty", "channels." + pluginId + ".apiKeys = " + JSON.stringify(apiKeys));
+  }
+
+  // 5h. 读取插件版本
+  let version = "unknown";
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pluginDir + "/package.json", "utf8"));
+    version = pkg.version || "unknown";
+  } catch (e) {}
+
+  // 全部通过
+  console.log("RESULT:" + JSON.stringify({ status: "ok", version }));
+'
+
+# 将 node 的退出码传递给 bash
+exit $?

package/dist/src/upload-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload-tool.d.ts","sourceRoot":"","sources":["../../src/upload-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,0BAA0B,CAAC;AAShF,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;CAY5B,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAqI/D"}
+{"version":3,"file":"upload-tool.d.ts","sourceRoot":"","sources":["../../src/upload-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,0BAA0B,CAAC;AAShF,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;CAY5B,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CA4I/D"}

package/dist/src/upload-tool.js

@@ -23,7 +23,7 @@ export const uploadToolSchema = {
             items: { type: "string" },
             minItems: 1,
             maxItems: 5,
-            description: "需要上传的本地文件路径数组（绝对路径），最多 5 个文件",
+            description: "需要上传的本地文件绝对路径数组，文件必须已写入磁盘，最多 5 个文件",
         },
     },
     required: ["paths"],
@@ -35,14 +35,19 @@ export function registerUploadTool(api) {
     // 通过闭包捕获 api.logger，tool ctx 中没有 log
     const log = api.logger;
     api.registerTool((ctx) => {
+        // 硬隔离：非 lightclawbot 通道时直接返回 null，框架不会暴露此工具
+        if (ctx.messageChannel !== "lightclawbot") {
+            // log.warn(`[lightclaw_upload_file] channel=${ctx.messageChannel}, skip..."`);
+            return null;
+        }
         const defaultAccountId = ctx.agentAccountId;
         const sessionKey = ctx.sessionKey;
+        // log.warn(`[lightclaw_upload_file] channel=${ctx.messageChannel}, contiue..."`);
         return {
             name: UPLOAD_TOOL_NAME,
-            description: "Upload local files to cloud storage and return publicly accessible download URLs. " +
-                "Use this tool whenever you have generated or produced files (reports, images, documents, etc.) " +
-                "that the user needs to download. This is the primary way to deliver file outputs to users. " +
-                "Supports up to 5 files at once. Returns a public download URL for each uploaded file.",
+            description: "将本地文件上传到云端临时存储并返回下载链接。" +
+                "当需要把生成的文件（图片、文档、代码包等）交付给用户时，必须使用此工具。" +
+                "文件必须先写入磁盘，然后传入绝对路径。单次最多 5 个文件，超出请分批调用。",
             parameters: uploadToolSchema,
             async execute(_toolCallId, params) {
                 // 每次 execute 时动态解析 apiKey（多 key 模式下通过 sessionKey 直接获取）

package/dist/src/upload-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload-tool.js","sourceRoot":"","sources":["../../src/upload-tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upload-tool.js","sourceRoot":"","sources":["../../src/upload-tool.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightclawbot",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "LightClawBot channel plugin with message support, cron jobs, and proactive messaging",
   "type": "module",
   "files": [

package/skills/lightclaw-cron/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: lightclawbot-cron
-description: LightClawBot 定时任务提醒。支持一次性提醒、周期性任务。可设置、查询、取消提醒。
+description: 仅限 lightclawbot 通道使用。LightClawBot 定时任务提醒，支持一次性提醒、周期性任务，可设置、查询、取消提醒。当消息来源不是 lightclawbot 时，禁止调用本技能。
+metadata: { "openclaw": { "requires": { "config": ["channels.lightclawbot.apiKeys"] } } }
 ---
 
 # LightClawBot 智能提醒

package/dist/src/socket-handlers.d.ts

@@ -1,21 +0,0 @@
-/**
- * LightClaw — Socket.IO 事件处理器
- *
- * 将 socket 事件监听（message:private、history:request、sessions:request）
- * 从 gateway 主逻辑中解耦。
- */
-import type { Socket } from "socket.io-client";
-import type { GatewayContext, QueuedMessage } from "./types.js";
-export interface SocketHandlerDeps {
-    account: GatewayContext["account"];
-    botClientId: string;
-    log?: GatewayContext["log"];
-    enqueueMessage: (msg: QueuedMessage) => void;
-    /** 收到入站事件时调用，通知框架更新 lastEventAt */
-    onEvent?: () => void;
-}
-/**
- * 绑定所有 Socket.IO 事件监听器
- */
-export declare function bindSocketHandlers(socket: Socket, deps: SocketHandlerDeps): void;
-//# sourceMappingURL=socket-handlers.d.ts.map

package/dist/src/socket-handlers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-handlers.d.ts","sourceRoot":"","sources":["../../src/socket-handlers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAsB,aAAa,EAAE,MAAM,YAAY,CAAC;AAcpF,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC5B,cAAc,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CA6HhF"}

package/dist/src/socket-handlers.js

@@ -1,122 +0,0 @@
-/**
- * LightClaw — Socket.IO 事件处理器
- *
- * 将 socket 事件监听（message:private、history:request、sessions:request）
- * 从 gateway 主逻辑中解耦。
- */
-import { CHANNEL_KEY, EVENT_MESSAGE_PRIVATE, EVENT_HISTORY_REQUEST, EVENT_HISTORY_RESPONSE, EVENT_SESSIONS_REQUEST, EVENT_SESSIONS_RESPONSE, DEFAULT_HISTORY_LIMIT, } from "./config.js";
-import { isDuplicate, debounceHistoryRequest, generateMsgId } from "./dedup.js";
-import { getAssistantRuntime } from "./runtime.js";
-import { readSessionHistoryWithCron, listSessions } from "./history/index.js";
-/**
- * 绑定所有 Socket.IO 事件监听器
- */
-export function bindSocketHandlers(socket, deps) {
-    const { account, botClientId, log, enqueueMessage, onEvent } = deps;
-    // ---- 接收用户消息 ----
-    socket.on(EVENT_MESSAGE_PRIVATE, (data, ack) => {
-        ack?.();
-        log?.info(`[${CHANNEL_KEY}] Received private message: ${JSON.stringify(data)}，botClientId:${botClientId}`);
-        // 回环防御：过滤自身发出的消息
-        if (data.from === botClientId)
-            return;
-        // 跳过控制消息（typing / stream 信号），只处理真实用户消息
-        if (data.kind && data.kind !== "text")
-            return;
-        // 无内容跳过
-        const hasContent = data.content?.trim();
-        const hasFiles = data.files && data.files.length > 0;
-        if (!hasContent && !hasFiles)
-            return;
-        // 去重
-        if (isDuplicate(data.msgId))
-            return;
-        // 通知框架收到入站事件（更新 lastEventAt，防止 stale-socket 误判）
-        onEvent?.();
-        log?.info(`[${CHANNEL_KEY}] Message from ${data.from}: "${(data.content || "").slice(0, 60)}" files=${data.files?.length ?? 0}`);
-        enqueueMessage({
-            senderId: data.from,
-            text: data.content || "",
-            messageId: data.msgId,
-            files: data.files ?? [],
-            timestamp: data.timestamp,
-        });
-    });
-    // ---- 历史消息请求 ----
-    socket.on(EVENT_HISTORY_REQUEST, (data, ack) => {
-        ack?.();
-        if (!data?.from) {
-            log?.warn(`[${CHANNEL_KEY}] History request missing userId, ignoring`);
-            return;
-        }
-        // 回环防御：忽略 bot 自身发出的请求
-        if (data.from === botClientId)
-            return;
-        // 去重：如果有 msgId，走消息级去重
-        if (data.msgId && isDuplicate(data.msgId)) {
-            log?.warn(`[${CHANNEL_KEY}] Duplicate history request (msgId), ignoring`);
-            return;
-        }
-        // 防抖：同一用户高频请求只处理最后一条
-        debounceHistoryRequest(data.from, () => {
-            // 通知框架收到入站事件（更新 lastEventAt，防止 stale-socket 误判）
-            onEvent?.();
-            try {
-                const pluginRuntime = getAssistantRuntime();
-                const currentCfg = pluginRuntime.config.loadConfig();
-                const route = pluginRuntime.channel.routing.resolveAgentRoute({
-                    cfg: currentCfg,
-                    channel: CHANNEL_KEY,
-                    accountId: account.accountId,
-                    peer: { kind: "direct", id: data.from },
-                });
-                const sessionKey = route?.sessionKey ?? `${CHANNEL_KEY}:dm:${data.from}`;
-                const messages = readSessionHistoryWithCron(sessionKey, {
-                    limit: data.limit ?? DEFAULT_HISTORY_LIMIT,
-                    chatOnly: data.chatOnly ?? true,
-                    includeCron: true,
-                });
-                log?.info(`[${CHANNEL_KEY}] History request: userId=${data.from} sessionKey=${sessionKey} found=${messages.length}`);
-                socket.emit(EVENT_HISTORY_RESPONSE, {
-                    msgId: generateMsgId(),
-                    from: botClientId,
-                    to: data.from,
-                    sessionKey,
-                    messages: messages.filter(msg => !!msg.content.trim() || (msg.files && msg.files.length > 0)),
-                });
-            }
-            catch (err) {
-                log?.error(`[${CHANNEL_KEY}] History request error: ${err}`);
-                socket.emit(EVENT_HISTORY_RESPONSE, {
-                    msgId: generateMsgId(),
-                    from: botClientId,
-                    to: data.from,
-                    sessionKey: "",
-                    messages: [],
-                    error: err instanceof Error ? err.message : String(err),
-                });
-            }
-        });
-    });
-    // ---- 会话列表请求 ----
-    socket.on(EVENT_SESSIONS_REQUEST, (data) => {
-        // 通知框架收到入站事件（更新 lastEventAt，防止 stale-socket 误判）
-        onEvent?.();
-        try {
-            const sessions = listSessions();
-            socket.emit(EVENT_SESSIONS_RESPONSE, {
-                requestId: data.requestId,
-                sessions,
-            });
-        }
-        catch (err) {
-            log?.error(`[${CHANNEL_KEY}] Sessions list error: ${err}`);
-            socket.emit(EVENT_SESSIONS_RESPONSE, {
-                requestId: data.requestId,
-                sessions: [],
-                error: err instanceof Error ? err.message : String(err),
-            });
-        }
-    });
-}
-//# sourceMappingURL=socket-handlers.js.map

package/dist/src/socket-handlers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-handlers.js","sourceRoot":"","sources":["../../src/socket-handlers.ts"],"names":[],"mappings":"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"}

package/dist/src/socket-registry.d.ts

@@ -1,53 +0,0 @@
-/**
- * LightClaw — Socket 注册表
- *
- * 让 gateway 启动时注册 socket 实例，
- * outbound 在需要发送消息时可以通过 WS 连接直接发送，
- * 无需走 REST API。
- *
- * 断线缓冲：
- *   当 socket 暂时断开（Socket.IO 自动重连中）时，outbound 消息
- *   会被缓冲在 pendingMessages 队列中，重连后自动 flush 发送。
- *   仅在 gateway 彻底销毁（cleanup）时才删除 entry。
- */
-import type { Socket } from "socket.io-client";
-import type { PrivateMessageData } from "./types.js";
-interface SocketEntry {
-    socket: Socket;
-    botClientId: string;
-    /** 断线期间缓冲的待发消息 */
-    pendingMessages: PrivateMessageData[];
-}
-/** 注册 socket（gateway 首次连接时调用） */
-export declare function registerSocket(accountId: string, socket: Socket, botClientId: string): void;
-/**
- * 注销 socket（gateway 彻底销毁时调用）。
- * 注意：普通断线重连不应调用此函数，只在 cleanup 时调用。
- */
-export declare function unregisterSocket(accountId: string): void;
-/** 获取可用的 socket（仅在 connected 时返回） */
-export declare function getSocket(accountId: string): Pick<SocketEntry, "socket" | "botClientId"> | undefined;
-/** 检查 account 是否有注册的 entry（不管是否 connected） */
-export declare function hasEntry(accountId: string): boolean;
-/** 获取 botClientId（不管 socket 是否 connected） */
-export declare function getBotClientId(accountId: string): string | undefined;
-/**
- * 缓冲一条消息（socket 断开期间由 outbound 调用）。
- * 返回 true 表示成功缓冲，false 表示该 account 没有注册的 entry。
- */
-export declare function bufferMessage(accountId: string, message: PrivateMessageData): boolean;
-/**
- * flush 所有缓冲消息（重连成功后由 gateway 调用）。
- * 返回发送成功 / 失败的计数。
- */
-export declare function flushPendingMessages(accountId: string, log?: {
-    info: (msg: string) => void;
-    warn: (msg: string) => void;
-}): {
-    sent: number;
-    failed: number;
-};
-/** 获取缓冲队列长度（调试/监控用） */
-export declare function getPendingCount(accountId: string): number;
-export {};
-//# sourceMappingURL=socket-registry.d.ts.map

package/dist/src/socket-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-registry.d.ts","sourceRoot":"","sources":["../../src/socket-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOrD,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,eAAe,EAAE,kBAAkB,EAAE,CAAC;CACvC;AASD,iCAAiC;AACjC,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAS3F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAExD;AAMD,qCAAqC;AACrC,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,aAAa,CAAC,GAAG,SAAS,CAIpG;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpE;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAUrF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA8BlC;AAED,uBAAuB;AACvB,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/src/socket-registry.js

@@ -1,111 +0,0 @@
-/**
- * LightClaw — Socket 注册表
- *
- * 让 gateway 启动时注册 socket 实例，
- * outbound 在需要发送消息时可以通过 WS 连接直接发送，
- * 无需走 REST API。
- *
- * 断线缓冲：
- *   当 socket 暂时断开（Socket.IO 自动重连中）时，outbound 消息
- *   会被缓冲在 pendingMessages 队列中，重连后自动 flush 发送。
- *   仅在 gateway 彻底销毁（cleanup）时才删除 entry。
- */
-import { MAX_PENDING_MESSAGES, EVENT_MESSAGE_PRIVATE } from "./config.js";
-/** accountId → SocketEntry */
-const registry = new Map();
-// ============================================================
-// 注册 / 注销
-// ============================================================
-/** 注册 socket（gateway 首次连接时调用） */
-export function registerSocket(accountId, socket, botClientId) {
-    const existing = registry.get(accountId);
-    if (existing) {
-        // 重连场景：更新 socket 引用，保留 pending 队列
-        existing.socket = socket;
-        existing.botClientId = botClientId;
-    }
-    else {
-        registry.set(accountId, { socket, botClientId, pendingMessages: [] });
-    }
-}
-/**
- * 注销 socket（gateway 彻底销毁时调用）。
- * 注意：普通断线重连不应调用此函数，只在 cleanup 时调用。
- */
-export function unregisterSocket(accountId) {
-    registry.delete(accountId);
-}
-// ============================================================
-// 查询
-// ============================================================
-/** 获取可用的 socket（仅在 connected 时返回） */
-export function getSocket(accountId) {
-    const entry = registry.get(accountId);
-    if (entry && entry.socket.connected)
-        return entry;
-    return undefined;
-}
-/** 检查 account 是否有注册的 entry（不管是否 connected） */
-export function hasEntry(accountId) {
-    return registry.has(accountId);
-}
-/** 获取 botClientId（不管 socket 是否 connected） */
-export function getBotClientId(accountId) {
-    return registry.get(accountId)?.botClientId;
-}
-// ============================================================
-// 断线缓冲
-// ============================================================
-/**
- * 缓冲一条消息（socket 断开期间由 outbound 调用）。
- * 返回 true 表示成功缓冲，false 表示该 account 没有注册的 entry。
- */
-export function bufferMessage(accountId, message) {
-    const entry = registry.get(accountId);
-    if (!entry)
-        return false;
-    if (entry.pendingMessages.length >= MAX_PENDING_MESSAGES) {
-        // 队列满了，丢弃最早的消息
-        entry.pendingMessages.shift();
-    }
-    entry.pendingMessages.push(message);
-    return true;
-}
-/**
- * flush 所有缓冲消息（重连成功后由 gateway 调用）。
- * 返回发送成功 / 失败的计数。
- */
-export function flushPendingMessages(accountId, log) {
-    const entry = registry.get(accountId);
-    if (!entry)
-        return { sent: 0, failed: 0 };
-    const pending = entry.pendingMessages.splice(0); // 取出全部并清空
-    if (pending.length === 0)
-        return { sent: 0, failed: 0 };
-    let sent = 0;
-    let failed = 0;
-    for (const msg of pending) {
-        if (!entry.socket.connected) {
-            // socket 又断了，把剩余消息放回去
-            entry.pendingMessages.unshift(...pending.slice(sent + failed));
-            break;
-        }
-        try {
-            entry.socket.emit(EVENT_MESSAGE_PRIVATE, msg);
-            sent++;
-        }
-        catch {
-            failed++;
-            log?.warn(`[socket-registry] Failed to flush buffered message: msgId=${msg.msgId}`);
-        }
-    }
-    if (sent > 0 || failed > 0) {
-        log?.info(`[socket-registry] Flushed pending messages: sent=${sent}, failed=${failed}`);
-    }
-    return { sent, failed };
-}
-/** 获取缓冲队列长度（调试/监控用） */
-export function getPendingCount(accountId) {
-    return registry.get(accountId)?.pendingMessages.length ?? 0;
-}
-//# sourceMappingURL=socket-registry.js.map

package/dist/src/socket-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"socket-registry.js","sourceRoot":"","sources":["../../src/socket-registry.ts"],"names":[],"mappings":"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"}

package/skills/lightclaw-media/SKILL.md

@@ -1,250 +0,0 @@
----
-name: lightclawbot-media
-description: LightClawBot 文件收发能力。用户发来的文件自动下载并保存，AI 生成的文件通过 lightclaw_upload_file 上传后以标准 Markdown 链接返回给用户。禁止使用其他存储工具。
----
-
-# LightClawBot 文件上传与下载
-
-让 AI 帮用户处理文件的上传、下载和分享，通过 LightClawBot 通道投递。
-
----
-
-## ⛔ 最重要的规则（读三遍）
-
-> 1. **上传文件必须使用 `lightclaw_upload_file` 工具，禁止使用其他任何存储工具！**
-> 3. **返回文件给用户时，必须使用标准 Markdown 链接格式：`[文件名](下载链接)`**
->    - ❌ 错误：`下载链接: https://xxx`
->    - ❌ 错误：`📎 文件下载链接: https://xxx`
->    - ✅ 正确：`[report.pdf](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/report.pdf)`
-
----
-
-## 🔧 可用工具
-
-本技能使用以下两个专属工具，**不要使用其他任何文件/存储工具**：
-
-| 工具名 | 用途 | 何时使用 |
-|--------|------|----------|
-| `lightclaw_upload_file` | 上传本地文件到云端，获取公网下载链接 | AI 生成了文件需要分享给用户时 |
-
----
-
-## 📤 上传文件（lightclaw_upload_file）
-
-### 功能
-
-将本地文件上传到云端存储，返回公网可访问的下载链接。支持批量上传（最多 5 个文件）。
-
-### 参数
-
-```json
-{
-  "paths": ["/absolute/path/to/file1.pdf", "/absolute/path/to/file2.xlsx"]
-}
-```
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `paths` | string[] | ✅ | 本地文件绝对路径数组，最多 5 个 |
-
-### ⚠️ 关键约束
-
-1. **必须使用绝对路径**（以 `/` 开头），禁止使用相对路径
-   - ❌ `./output/report.pdf`
-   - ✅ `/Users/xxx/.openclaw/workspace/output/report.pdf`
-2. **文件必须存在**：上传前确认文件已生成并写入磁盘
-3. **单次最多 5 个文件**：超出需分批上传
-
-### 使用示例
-
-**上传单个文件**：
-```json
-{
-  "paths": ["/Users/xxx/.openclaw/workspace/report.pdf"]
-}
-```
-
-**批量上传**：
-```json
-{
-  "paths": [
-    "/Users/xxx/.openclaw/workspace/chart1.png",
-    "/Users/xxx/.openclaw/workspace/chart2.png",
-    "/Users/xxx/.openclaw/workspace/summary.xlsx"
-  ]
-}
-```
-
----
-
-## 📋 返回文件给用户的格式（最重要）
-
-### 🚨🚨🚨 必须使用标准 Markdown 链接格式
-
-> **当需要将文件/文档/图片链接返回给用户时，必须使用标准 Markdown 链接格式：**
->
-> ```
-> [<文件名>](<下载链接>)
-> ```
-
-### ✅ 正确示例
-
-**单个文件**：
-
-```
-好的，报告已生成，请点击下载：
-
-[report.pdf](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/report.pdf)
-```
-
-**多个文件**：
-
-```
-所有文件已准备好：
-
-- [数据分析报告.pdf](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/数据分析报告.pdf)
-- [原始数据.xlsx](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/原始数据.xlsx)
-- [趋势图.png](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/趋势图.png)
-```
-
-**附带说明文字**：
-
-```
-✅ 周报已生成完毕！
-
-[本周工作周报.pdf](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/本周工作周报.pdf)
-
-报告包含了本周的进度汇总和下周计划。
-```
-
-### ❌ 错误示例（绝对不要这样做）
-
-❌ **裸链接**：
-```
-下载链接: https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/report.pdf
-```
-
-❌ **带 emoji 前缀的裸链接**：
-```
-📎 文件下载链接: https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/report.pdf
-```
-
-❌ **使用代码块包裹链接**：
-```
-`https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/report.pdf`
-```
-
-❌ **只返回路径，没有文件名**：
-```
-[下载](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/report.pdf)
-```
-
----
-
-## 📸 接收用户文件
-
-用户通过 LightClawBot 发来的文件（图片、文档等）**自动下载到本地**。文件信息在上下文的【Attachments】字段中，包含：
-
-| 字段 | 说明 |
-|------|------|
-| `name` | 文件名 |
-| `mimeType` | 文件 MIME 类型 |
-| `url` | 文件的公网下载链接 |
-
-本地文件路径在上下文的 `MediaPath` / `MediaPaths` 字段中。
-
-### 处理用户文件的流程
-
-1. **查看上下文**：从 Attachments 获取文件信息
-2. **本地处理**：使用 `MediaPath` 中的本地路径读取和处理文件
-3. **如需返回处理后的文件**：用 `lightclaw_upload_file` 上传 → 用 Markdown 链接返回
-
----
-
-## 🎯 完整使用场景
-
-### 场景 1：用户要求生成报告
-
-**用户**：帮我生成一份数据分析报告
-
-**AI 执行步骤**：
-1. 生成报告文件并保存到本地（如 `/Users/xxx/.openclaw/workspace/数据分析报告.pdf`）
-2. 调用 `lightclaw_upload_file` 上传：
-   ```json
-   { "paths": ["/Users/xxx/.openclaw/workspace/数据分析报告.pdf"] }
-   ```
-3. 获取到下载链接后，以 Markdown 格式回复：
-   ```
-   ✅ 报告已生成：
-
-   [数据分析报告.pdf](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/数据分析报告.pdf)
-   ```
-
-### 场景 2：用户要求处理发来的文件
-
-**用户**：帮我把这个 Excel 转成 PDF（附带了 data.xlsx）
-
-**AI 执行步骤**：
-1. 从上下文 `MediaPath` 获取本地文件路径
-2. 读取并处理 Excel 文件，转换为 PDF
-3. 调用 `lightclaw_upload_file` 上传 PDF
-4. 以 Markdown 格式回复：
-   ```
-   ✅ 已将 Excel 转为 PDF：
-
-   [data.pdf](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/data.pdf)
-   ```
-
-### 场景 3：用户要求获取之前上传的文件
-
-**用户**：我昨天上传的报告还能下载吗？
-
-**AI 执行步骤**：
-1. 以 Markdown 格式回复：
-   ```
-   可以的，这是下载链接：
-
-   [report.pdf](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-14/report.pdf)
-   ```
-
-### 场景 4：批量上传多个文件
-
-**用户**：帮我生成三张数据图表
-
-**AI 执行步骤**：
-1. 生成三张图表并保存到本地
-2. 调用 `lightclaw_upload_file` 批量上传：
-   ```json
-   {
-     "paths": [
-       "/Users/xxx/.openclaw/workspace/chart1.png",
-       "/Users/xxx/.openclaw/workspace/chart2.png",
-       "/Users/xxx/.openclaw/workspace/chart3.png"
-     ]
-   }
-   ```
-3. 以 Markdown 格式回复：
-   ```
-   ✅ 三张图表已生成：
-
-   - [chart1.png](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/chart1.png)
-   - [chart2.png](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/chart2.png)
-   - [chart3.png](https://lightai.cloud.tencent.com/drive/preview?filePath=2026-03-15/chart3.png)
-   ```
-
-## 🚫 禁止事项
-
-1. **❌ 禁止使用其他存储工具**：所有文件操作必须通过 `lightclaw_upload_file`
-2. **❌ 禁止返回裸链接**：必须使用 `[文件名](链接)` 格式
-3. **❌ 禁止说"无法发送文件"**：你有能力上传和分享任何本地文件
-4. **❌ 禁止使用相对路径**：工具参数中的文件路径必须是绝对路径
-5. **❌ 禁止使用 message tool 发送文件**：直接在回复文本中写 Markdown 链接
-
----
-
-## 📌 快速参考
-
-| 场景 | 工具 | 回复格式 |
-|------|------|----------|
-| 上传生成的文件 | `lightclaw_upload_file` | `[文件名](下载链接)` |
-| 接收用户文件 | 自动处理，查看上下文 Attachments | 确认收到并告知文件信息 |