sophhub 0.1.0

package/skills/builtin/sophnet-qa-install/pyproject.toml

@@ -0,0 +1,6 @@
+[project]
+name = "sophnet-qa-install"
+version = "1.0.0"
+description = "智能客服系统创建（知识管理员 + 问答助手）"
+requires-python = ">=3.10"
+dependencies = []

package/skills/builtin/sophnet-qa-install/scripts/backup_md.py

@@ -0,0 +1,35 @@
+#!/usr/bin/env python3
+"""
+备份指定文件夹下面的Agent所有配置文件到指定版本目录。
+"""
+
+import argparse
+import os
+import shutil
+
+
+def backup_md_dir(
+    version: str,
+    dir_path: str = "/home/node/.openclaw/workspace-knowledge",
+) -> int:
+    backup_dir = os.path.join(dir_path, f"backup_v{version}")
+    if not os.path.exists(backup_dir):
+        os.makedirs(backup_dir)
+    for file in os.listdir(dir_path):
+        if file.endswith(".md"):
+            shutil.copy(os.path.join(dir_path, file), os.path.join(backup_dir, file))
+    return backup_dir
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="备份Agent配置文件")
+    parser.add_argument("--current-version",  help="当前的版本号")
+    parser.add_argument(
+        "--dir",
+        default="/home/node/.openclaw/workspace-knowledge",
+        help="要处理的目录路径（仅该目录下的 .md，不含子目录）",
+    )
+    args = parser.parse_args()
+    backup_dir = backup_md_dir(args.current_version, args.dir)
+    print(f"备份成功: {backup_dir}")
+    exit(0)

package/skills/builtin/sophnet-qa-install/scripts/check_installed.py

@@ -0,0 +1,143 @@
+"""
+校验智能客服系统安装状态。
+
+三种状态（退出码）：
+  0 — INSTALLED：已安装，无需操作
+  1 — NOT_INSTALLED：未安装
+  2 — UPDATABLE：可更新
+
+同时输出配置状态（CONFIG_FOUND / CONFIG_NOT_FOUND）。
+当状态为 UPDATABLE 且配置存在时，额外输出已有的 ADMIN_NAME / QA_NAME。
+"""
+
+import argparse
+import json
+import os
+import sys
+
+
+def get_workspace_root(config_path: str) -> str:
+    """从 openclaw.json 所在目录推导 workspace 根目录（.openclaw）。"""
+    return os.path.dirname(os.path.abspath(config_path))
+
+
+def step2_artifacts_exist(workspace_root: str) -> bool:
+    """检查 Step 2 要创建的目录和软链接是否已存在。"""
+    base = os.path.join(workspace_root, "workspace-knowledge")
+    workspace_qa = os.path.join(base, "workspace-qa")
+
+    if not os.path.isdir(workspace_qa):
+        return False
+    return True
+
+
+def agents_already_in_config(config_path: str) -> bool:
+    """检查 openclaw.json 中是否已包含 knowledge-admin 和 qa-agent。"""
+    if not os.path.exists(config_path):
+        return False
+    try:
+        with open(config_path, "r", encoding="utf-8") as f:
+            config = json.load(f)
+    except (json.JSONDecodeError, OSError):
+        return False
+    agents = config.get("agents", {}).get("list", [])
+    ids = {a.get("id") for a in agents if isinstance(a, dict) and a.get("id")}
+    return "knowledge-admin" in ids and "qa-agent" in ids
+
+
+def get_agent_names(config_path: str) -> tuple[str, str]:
+    """从 openclaw.json 读取 knowledge-admin 和 qa-agent 的显示名称。"""
+    admin_name, qa_name = "客服管理员", "客服助手"
+    try:
+        with open(config_path, "r", encoding="utf-8") as f:
+            config = json.load(f)
+        for agent in config.get("agents", {}).get("list", []):
+            if not isinstance(agent, dict):
+                continue
+            if agent.get("id") == "knowledge-admin" and agent.get("name"):
+                admin_name = agent["name"]
+            elif agent.get("id") == "qa-agent" and agent.get("name"):
+                qa_name = agent["name"]
+    except (json.JSONDecodeError, OSError):
+        pass
+    return admin_name, qa_name
+
+
+def parse_version(v: str) -> tuple:
+    """将版本号字符串解析为可比较的整数元组。"""
+    try:
+        return tuple(int(x) for x in v.strip().split("."))
+    except (ValueError, AttributeError):
+        return ()
+
+
+def get_installed_version(workspace_root: str) -> str | None:
+    """读取 workspace-knowledge/git_version 中的版本号。"""
+    version_file = os.path.join(workspace_root, "workspace-knowledge", "git_version")
+    if not os.path.isfile(version_file):
+        return None
+    try:
+        with open(version_file, "r", encoding="utf-8") as f:
+            return f.read().strip()
+    except OSError:
+        return None
+
+
+def check_installed(config_path: str, target_version: str) -> int:
+    """
+    判断安装状态。
+    返回: 0=已安装, 1=未安装, 2=可更新
+    """
+    workspace_root = get_workspace_root(config_path)
+
+    if not step2_artifacts_exist(workspace_root):
+        return 1
+
+    installed_version = get_installed_version(workspace_root)
+    if installed_version is None or parse_version(installed_version) < parse_version(target_version):
+        return 2
+
+    if not agents_already_in_config(config_path):
+        return 1
+
+    return 0
+
+
+def main():
+    parser = argparse.ArgumentParser(description="校验智能客服系统安装状态")
+    parser.add_argument(
+        "--config",
+        default="/home/node/.openclaw/openclaw.json",
+        help="openclaw.json 路径",
+    )
+    parser.add_argument(
+        "--version",
+        required=True,
+        help="目标版本号（例：1.0.1）",
+    )
+    args = parser.parse_args()
+
+    config_path = args.config
+    status = check_installed(config_path, args.version)
+    config_exists = agents_already_in_config(config_path)
+
+    if status == 0:
+        print("INSTALLED")
+        print("CONFIG_FOUND" if config_exists else "CONFIG_NOT_FOUND")
+        sys.exit(0)
+    elif status == 2:
+        print("UPDATABLE")
+        print("CONFIG_FOUND" if config_exists else "CONFIG_NOT_FOUND")
+        if config_exists:
+            admin_name, qa_name = get_agent_names(config_path)
+            print(f"ADMIN_NAME={admin_name}")
+            print(f"QA_NAME={qa_name}")
+        sys.exit(2)
+    else:
+        print("NOT_INSTALLED")
+        print("CONFIG_FOUND" if config_exists else "CONFIG_NOT_FOUND")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/builtin/sophnet-qa-install/scripts/update_config.py

@@ -0,0 +1,142 @@
+"""
+OpenClaw 配置更新脚本
+
+向 openclaw.json 中追加 knowledge-admin、qa-agent 以及 main 三个 agent 的配置。
+"""
+
+import argparse
+import json
+import os
+import secrets
+import sys
+
+def get_api_secret(config_path: str = "/home/node/.openclaw/openclaw.json"):
+    if not os.path.exists(config_path):
+        raise FileNotFoundError(f"Config file not found: {config_path}")
+    try:
+        with open(config_path, "r", encoding="utf-8") as f:
+            config = json.load(f)
+    except json.JSONDecodeError:
+        raise ValueError(f"Invalid JSON in config file: {config_path}")
+    channels = config.get("channels", {})
+    bot_api_channel_config = channels.get("bot-api", {})
+    if not bot_api_channel_config:
+        return None
+    accounts_config = bot_api_channel_config.get("accounts", {})
+    if not accounts_config:
+        return None
+    qa_agent_config = accounts_config.get("qa-agent", {})
+    if not qa_agent_config:
+        return None
+    return qa_agent_config.get("apiSecret", None)
+
+
+def update_config(admin_name: str, qa_name: str, config_path: str = "/home/node/.openclaw/openclaw.json"):
+    if not os.path.exists(config_path):
+        raise FileNotFoundError(f"Config file not found: {config_path}")
+
+    with open(config_path, "r", encoding="utf-8") as f:
+        config = json.load(f)
+
+    admin_agent_config = {
+        "id": "knowledge-admin",
+        "workspace": "/home/node/.openclaw/workspace-knowledge",
+        "identity": {
+            "name": admin_name,
+            "theme": admin_name,
+            "emoji": "🤖"
+        },
+        "subagents": {
+            "allowAgents": ["qa-agent"]
+        }
+    }
+    qa_agent_config = {
+        "id": "qa-agent",
+        "workspace": "/home/node/.openclaw/workspace-knowledge/workspace-qa",
+        "identity": {
+            "name": qa_name,
+            "theme": qa_name,
+            "emoji": "💁"
+        },
+        "tools": {
+            "deny": ["exec", "web_search", "web_fetch"]
+        }
+    }
+    main_agent_config = {
+        "id": "main",
+        "workspace": "/home/node/.openclaw/workspace",
+        "identity": {
+            "name": "main",
+            "theme": "main",
+            "emoji": "🦞"
+        }
+    }
+
+    qa_agent_account_config = {
+        "agentId": "qa-agent",
+        "name": qa_name,
+        "apiSecret": secrets.token_hex(32),
+        "enabled": True
+    }
+    config.setdefault("agents", {})
+    agents = config.get("agents", {}).get("list", [])
+    has_main = False
+    for agent in agents:
+        aid = agent.get("id") if isinstance(agent, dict) else None
+        if aid == "main":
+            has_main = True
+        elif aid == "knowledge-admin":
+            raise ValueError("知识管理员 agent 已存在")
+        elif aid == "qa-agent":
+            raise ValueError("客服助手 agent 已存在")
+
+    if not has_main:
+        agents.append(main_agent_config)
+    agents.append(admin_agent_config)
+    agents.append(qa_agent_config)
+    config["agents"]["list"] = agents
+
+    # 启用 bot-api 插件（用 setdefault 保证 plugins.entries 与 bot-api 存在，避免 KeyError）
+    plugins = config.get("plugins", {})
+    entries = plugins.setdefault("entries", {})
+    entries.setdefault("bot-api", {})["enabled"] = True
+    config["plugins"] = plugins
+
+    # 添加客服子系统的channel配置
+    channels = config.get("channels", {})
+    bot_api_channel_config = channels.get("bot-api", {})
+    if bot_api_channel_config:
+        accounts_config = bot_api_channel_config.get("accounts", {})
+        accounts_config["qa-agent"] = qa_agent_account_config
+        bot_api_channel_config["accounts"] = accounts_config
+    else:
+        bot_api_channel_config = {
+            "accounts": {
+                "qa-agent": qa_agent_account_config
+            }
+        }
+    channels["bot-api"] = bot_api_channel_config
+    config["channels"] = channels
+
+    with open(config_path, "w", encoding="utf-8") as f:
+        json.dump(config, f, indent=4, ensure_ascii=False)
+    return True
+
+
+def main():
+    parser = argparse.ArgumentParser(description="向 openclaw.json 注入客服 agent 配置")
+    parser.add_argument("--admin-name", default="客服管理员", help="知识管理员显示名称")
+    parser.add_argument("--qa-name", default="客服助手", help="客服助手显示名称")
+    parser.add_argument("--config", default="/home/node/.openclaw/openclaw.json", help="openclaw.json 路径")
+    args = parser.parse_args()
+    try:
+        update_config(args.admin_name, args.qa_name, args.config)
+        print(f"✅ 配置更新成功：管理员={args.admin_name}, 客服={args.qa_name}")
+        print(f"客服助手 API Secret: {get_api_secret(args.config)}")
+    except Exception as e:
+        print(f"❌ 配置更新失败：{e}")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/builtin/sophnet-qa-install/scripts/update_md.py

@@ -0,0 +1,73 @@
+#!/usr/bin/env python3
+"""
+修改指定目录下所有 .md 文件中的占位符：
+- {{客服助手}} -> qa_name
+- {{知识库管理员}} -> admin_name
+仅处理目标目录本身，不递归子文件夹。
+"""
+
+import argparse
+from pathlib import Path
+
+
+def update_md_in_dir(
+    dir_path: str | Path,
+    qa_name: str = "客服助手",
+    admin_name: str = "客服管理员",
+) -> int:
+    """
+    修改指定目录下所有 .md 文件中的占位符（仅该目录，不含子文件夹）。
+    返回 0 成功，1 目录不存在，2 读写文件失败。
+    """
+    root = Path(dir_path)
+    if not root.is_dir():
+        print(f"错误：目录不存在 {root}")
+        return 1
+
+    md_files = [f for f in root.iterdir() if f.is_file() and f.suffix == ".md"]
+    if not md_files:
+        print(f"在 {root} 下未找到 .md 文件")
+        return 0
+
+    replacements = [
+        ("{{客服助手}}", qa_name),
+        ("{{知识库管理员}}", admin_name),
+    ]
+
+    for path in md_files:
+        try:
+            text = path.read_text(encoding="utf-8")
+        except OSError as e:
+            print(f"错误：无法读取 {path}：{e}")
+            return 2
+        original = text
+        for old, new in replacements:
+            text = text.replace(old, new)
+        if text != original:
+            try:
+                path.write_text(text, encoding="utf-8")
+            except OSError as e:
+                print(f"错误：无法写入 {path}：{e}")
+                return 2
+            print(f"已更新: {path}")
+        else:
+            print(f"无需修改: {path}")
+
+    return 0
+
+
+def main():
+    parser = argparse.ArgumentParser(description="替换 .md 文件中的占位符")
+    parser.add_argument("--qa-name", default="客服助手", help="替换 {{客服助手}} 的值")
+    parser.add_argument("--admin-name", default="客服管理员", help="替换 {{知识库管理员}} 的值")
+    parser.add_argument(
+        "--dir",
+        default="/home/node/.openclaw/workspace-knowledge",
+        help="要处理的目录路径（仅该目录下的 .md，不含子目录）",
+    )
+    args = parser.parse_args()
+    return update_md_in_dir(args.dir, qa_name=args.qa_name, admin_name=args.admin_name)
+
+
+if __name__ == "__main__":
+    exit(main())

package/skills/builtin/sophnet-training-install/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: sophnet-training-install
+description: 创建或更新智能培训系统（培训管理员 + 培训助手），包括工作空间初始化、模板下载、角色配置和配置文件注入。当用户要求创建培训系统、更新培训系统、智能培训、培训知识库时使用。
+version: 1.0.3
+---
+
+# 智能培训系统创建与更新
+
+创建或更新包含「培训管理员」和「培训助手」两个 Agent 的智能培训系统。创建和更新共用同一套流程（Step 2～6），区别仅在于：新安装需收集参数（Step 1），更新则复用已有配置并需用户确认。
+
+## Processing Mode
+
+**STRICT SERIAL PROCESSING ONLY** — 按顺序逐步执行，不要拆分子任务或并行处理。
+
+## Prerequisites
+
+- Python 3.10+
+- unzip
+
+## 流程
+
+### Step 0: 校验安装状态
+
+执行校验脚本，根据返回状态决定后续流程。`{version}` 取自本文件 frontmatter 中的 `version` 字段：
+
+```bash
+uv run {baseDir}/scripts/check_installed.py --version {version}
+```
+
+脚本输出三种状态：
+
+#### 退出码 0 — `INSTALLED`（已安装，无需操作）
+
+向用户展示以下提示，并**终止流程**（不再执行 Step 1～6）。其中「培训子系统的API Secret」从 `openclaw.json` 的 `channels.bot-api.accounts["training-qa"].apiSecret` 读取（与 `scripts/update_config.py` 中 `get_api_secret` 一致）。
+
+```
+智能培训系统已经安装，无需重复安装。
+
+📂 知识库目录：/home/node/.openclaw/workspace-training/knowledge
+🤖 管理员会话：training-admin
+💁 培训助手会话：training-qa
+🔑 培训子系统的API Secret: <api_secret>
+
+📝 常用命令（在 training-admin 会话中使用）：
+  • 通过附件按钮上传文件，并输入：将文档加入知识库
+  • 将 https://xxx 中的内容加入到知识库
+  • 将 xxx 写入到知识库
+  • 昨天客户都问了哪些问题
+  • 昨天客户都有哪些反馈
+  • 删除 xxx 知识库
+```
+
+#### 退出码 2 — `UPDATABLE`（可更新）
+
+文件已存在但版本低于目标版本，有新版本可用。脚本会额外输出已有配置中的 `ADMIN_NAME` 和 `QA_NAME`（如 `ADMIN_NAME=培训管理员`、`QA_NAME=培训助手`）。
+
+**必须先向用户确认，禁止直接更新。** 向用户展示以下提示并等待回复。其中 `{current_version}` 从 `check_installed.py` 输出或 `workspace-training/git_version` 文件获取：
+
+```
+智能培训系统检测到新版本可用（{current_version} → {version}）。
+
+⚠️ 更新说明：
+  • 更新不会修改知识库内容
+  • 更新会重置 Agent 设置（角色配置等将恢复为模板默认值）
+  • 更新前会自动备份当前 Agent 配置到 backup_v{current_version} 目录
+
+是否确认更新？请回复「确认更新」或「取消」。
+```
+
+- 若用户回复确认（如"确认更新"、"确认"、"更新"、"好的"、"是"等肯定回复）：先执行配置备份，再**跳过 Step 1**，使用脚本输出的 `admin_name` 和 `qa_name`，从 Step 2 开始执行更新流程。
+- 若用户回复取消或其他非肯定回复：**终止流程**，不执行任何更新操作。
+
+##### 备份配置（用户确认后、Step 2 前执行）
+
+依次备份主工作空间和 workspace-qa 目录下的 `.md` 配置文件：
+
+```bash
+uv run {baseDir}/scripts/backup_md.py \
+  --current-version {current_version} \
+  --dir /home/node/.openclaw/workspace-training
+```
+
+```bash
+uv run {baseDir}/scripts/backup_md.py \
+  --current-version {current_version} \
+  --dir /home/node/.openclaw/workspace-training/workspace-qa
+```
+
+脚本成功后会输出备份目录路径（如 `备份成功: /home/node/.openclaw/workspace-training/backup_v1.0.1`）。向用户展示备份结果：
+
+```
+✅ 当前 Agent 配置已备份到：
+  • {backup_dir_1}
+正在开始更新...
+```
+
+备份完成后，继续执行 Step 2～6。
+
+#### 退出码 1 — `NOT_INSTALLED`（未安装）
+
+未安装或未完整安装，继续执行 Step 1 开始完整安装流程。
+
+> 校验逻辑：先检查 Step 2 目录与软链接是否存在；若存在则比对 `workspace-training/git_version` 与目标版本号；再检查 openclaw.json 中是否已配置 training-admin 与 training-qa。详见 `scripts/check_installed.py`。
+
+### Step 1: 收集参数
+
+向用户确认以下两个角色名称（有默认值，用户可直接回车跳过）：
+
+| 参数         | 说明               | 默认值     |
+| ------------ | ------------------ | ---------- |
+| `admin_name` | 培训管理员显示名称 | 培训管理员 |
+| `qa_name`    | 培训助手显示名称   | 培训助手   |
+
+### Step 2: 创建目录结构
+
+```bash
+mkdir -p /home/node/.openclaw/workspace-training/workspace-qa/
+mkdir -p /home/node/.openclaw/workspace-training/knowledge/
+```
+
+在 workspace-qa 下创建指向上级 knowledge 的软链接：
+
+```bash
+cd /home/node/.openclaw/workspace-training/workspace-qa/
+ln -sf ../knowledge knowledge
+```
+
+### Step 3: 下载模板文件
+
+```bash
+cd /home/node/.openclaw/workspace-training/
+wget -O workspace-training.zip https://oss-upload-temp.sophnet.com/workspace-training_v{version}.zip
+unzip -o workspace-training.zip
+rm -f workspace-training.zip
+```
+
+### Step 4: 替换占位符
+
+使用脚本替换 .md 文件中的 `{{培训助手}}` 和 `{{知识库管理员}}` 占位符。
+
+先替换主工作空间目录（不含子文件夹）：
+
+```bash
+uv run {baseDir}/scripts/update_md.py \
+  --dir /home/node/.openclaw/workspace-training \
+  --qa-name "{qa_name}" \
+  --admin-name "{admin_name}"
+```
+
+再替换 workspace-qa 目录（不含子文件夹）：
+
+```bash
+uv run {baseDir}/scripts/update_md.py \
+  --dir /home/node/.openclaw/workspace-training/workspace-qa \
+  --qa-name "{qa_name}" \
+  --admin-name "{admin_name}"
+```
+
+> `{baseDir}` 为本 skill 所在目录，`{qa_name}` 和 `{admin_name}` 替换为 Step 1 收集的值。
+
+### Step 5: 更新 openclaw.json
+
+```bash
+uv run {baseDir}/scripts/update_config.py \
+  --admin-name "{admin_name}" \
+  --qa-name "{qa_name}"
+```
+
+### Step 6: 完成提示
+
+全部执行成功后，向用户展示以下信息。其中「培训子系统的API Secret」取 Step 5 中 `update_config.py` 输出里的「培训助手 API Secret」；若未保留该输出，可从 `openclaw.json` 的 `channels.bot-api.accounts["training-qa"].apiSecret` 读取（与 `scripts/update_config.py` 中 `get_api_secret` 一致）。
+
+```
+✅ 您的智能培训系统已创建完成！
+
+📂 知识库目录：/home/node/.openclaw/workspace-training/knowledge
+🤖 管理员会话：training-admin
+💁 培训助手会话：training-qa
+🔑 培训子系统的API Secret: <api_secret>
+
+📌 快速上手：
+1. 将知识库文档上传至 knowledge 目录
+2. 切换到 training-admin 会话，输入：处理一下 knowledge 里面的文档
+3. 完成知识库初步创建后，即可通过 training-qa 对外提供问答服务
+
+📝 常用管理命令（在 training-admin 会话中使用）：
+  • 通过附件按钮上传文件，并输入：将文档加入知识库
+  • 将 https://xxx 中的内容加入到知识库
+  • 将 xxx 写入到知识库
+  • 昨天客户都问了哪些问题
+  • 昨天客户都有哪些反馈
+  • 删除 xxx 知识库
+```
+
+## Error Handling
+
+- **已安装检测**：Step 0 使用 `check_installed.py` 检测安装状态；`INSTALLED` 直接展示常用命令并结束，不执行 Step 1～6
+- **可更新检测**：`UPDATABLE` 先提示用户有新版本并说明更新影响（不修改知识库、会重置 Agent 设置），等待用户明确确认后才执行备份 + Step 2～6 完成更新；用户未确认则终止流程
+- **目录已存在**：Step 2 使用 `mkdir -p`，已有目录不会报错
+- **模板已下载**：Step 3 使用 `unzip -o` 覆盖已有文件
+- **占位符替换失败**：Step 4 中 `update_md.py` 退出码非 0 表示失败（1=目录不存在，2=读写文件失败）；应中止后续步骤并向用户报错，不要继续执行 Step 5～6
+- **Agent 已存在**：Step 5 中 `update_config.py` 会检测重复并报错；若未执行 Step 0 而直接到 Step 5 报错，可提示用户「智能培训已安装」，并给出上述常用命令
+
+## ⚠️ FORBIDDEN OPERATIONS
+
+**Do NOT:**
+
+- 修改 knowledge/ 目录下的知识库内容
+- 直接编辑 openclaw.json（必须通过脚本）
+- 跳过占位符替换步骤
+- 检测到可更新时未经用户确认直接执行更新（必须等用户明确回复确认）

package/skills/builtin/sophnet-training-install/pyproject.toml

@@ -0,0 +1,6 @@
+[project]
+name = "sophnet-training-install"
+version = "1.0.0"
+description = "智能培训系统创建（知识管理员 + 问答助手）"
+requires-python = ">=3.10"
+dependencies = []

package/skills/builtin/sophnet-training-install/scripts/backup_md.py

@@ -0,0 +1,35 @@
+#!/usr/bin/env python3
+"""
+备份指定文件夹下面的Agent所有配置文件到指定版本目录。
+"""
+
+import argparse
+import os
+import shutil
+
+
+def backup_md_dir(
+    version: str,
+    dir_path: str = "/home/node/.openclaw/workspace-training",
+) -> int:
+    backup_dir = os.path.join(dir_path, f"backup_v{version}")
+    if not os.path.exists(backup_dir):
+        os.makedirs(backup_dir)
+    for file in os.listdir(dir_path):
+        if file.endswith(".md"):
+            shutil.copy(os.path.join(dir_path, file), os.path.join(backup_dir, file))
+    return backup_dir
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="备份Agent配置文件")
+    parser.add_argument("--current-version",  help="当前的版本号")
+    parser.add_argument(
+        "--dir",
+        default="/home/node/.openclaw/workspace-training",
+        help="要处理的目录路径（仅该目录下的 .md，不含子目录）",
+    )
+    args = parser.parse_args()
+    backup_dir = backup_md_dir(args.current_version, args.dir)
+    print(f"备份成功: {backup_dir}")
+    exit(0)