sophhub 0.2.1 → 0.2.2

package/skills/md2pdf-converter/src/scripts/md2pdf-local.sh

@@ -0,0 +1,291 @@
+#!/bin/bash
+
+# ==============================================================================
+# md2pdf-local.sh
+# 描述: 离线版 Markdown 转 PDF (完整版 Emoji + 本地缓存)
+# 版本: 2.0 (Twemoji 完整版)
+# 核心: Pandoc + WeasyPrint + Local Emoji Cache (Twemoji 完整版)
+# ==============================================================================
+
+set -e
+
+# --- 配置项 ---
+CACHE_DIR="$HOME/.cache/md2pdf"
+EMOJI_DIR="$CACHE_DIR/emojis"
+EMOJI_MAPPING="$CACHE_DIR/emoji_mapping.json"
+# 使用 Twemoji 14.0.0 完整版 (彩色 PNG, 3660个文件)
+TWEMOJI_VERSION="14.0.0"
+TWEMOJI_URL="https://github.com/twitter/twemoji/archive/refs/tags/v${TWEMOJI_VERSION}.tar.gz"
+
+# --- 检查参数 ---
+if [ "$#" -ne 2 ]; then
+    echo "用法: $0 <input.md> <output.pdf>"
+    exit 1
+fi
+
+INPUT_FILE="$1"
+OUTPUT_FILE="$2"
+TEMP_DIR=$(mktemp -d)
+HTML_TEMP="$TEMP_DIR/temp.html"
+LUA_FILTER="$TEMP_DIR/emoji_twemoji.lua"
+CSS_STYLE="$TEMP_DIR/style.css"
+EMOJI_JS="$TEMP_DIR/emoji_data.js"
+
+# --- 清理函数 ---
+cleanup() {
+    rm -rf "$TEMP_DIR"
+}
+trap cleanup EXIT
+
+# --- 1. 检查并下载 Twemoji 完整版 (只需执行一次) ---
+ensure_twemoji() {
+    if [ -f "$EMOJI_MAPPING" ]; then
+        echo "✅ Twemoji 资源已缓存: $EMOJI_DIR"
+        echo "   映射表: $EMOJI_MAPPING"
+        return 0
+    fi
+
+    echo "🚧 正在设置 Twemoji ${TWEMOJI_VERSION}..."
+    mkdir -p "$CACHE_DIR"
+
+    # 下载 GitHub 的 tar.gz 包
+    echo "   下载 Twemoji..."
+    wget -q --show-progress -O "$CACHE_DIR/twemoji.tar.gz" "$TWEMOJI_URL"
+
+    # 解压 Twemoji
+    echo "   解压 Twemoji..."
+    tar -xzf "$CACHE_DIR/twemoji.tar.gz" -C "$CACHE_DIR"
+
+    # Twemoji 目录结构: twemoji-14.0.0/assets/72x72/
+    # 移动到最终目录
+    mv "$CACHE_DIR/twemoji-${TWEMOJI_VERSION}/assets/72x72" "$EMOJI_DIR"
+
+    # 清理
+    rm -rf "$CACHE_DIR/twemoji-${TWEMOJI_VERSION}" "$CACHE_DIR/twemoji.tar.gz"
+
+    echo "   Twemoji 已缓存至: $EMOJI_DIR"
+
+    # 生成 emoji 映射表
+    echo "   生成 emoji 映射表..."
+    python3 /home/ltx/.openclaw/workspace/skills/md2pdf-converter/scripts/generate_emoji_mapping.py
+
+    echo "✅ Twemoji 完整版已准备就绪"
+}
+
+ensure_twemoji
+
+# --- 2. 生成 Lua Filter (使用 emoji 映射表) ---
+cat << 'EOF' > "$LUA_FILTER"
+-- 使用 emoji 映射表的 Lua Filter
+
+-- 读取 emoji 映射表
+local emoji_mapping = {}
+local mapping_file = io.open("EMOJI_MAPPING_PLACEHOLDER", "r")
+
+if mapping_file then
+    local json_str = mapping_file:read("*all")
+    mapping_file:close()
+
+    -- 解析 JSON (使用简单的正则表达式提取)
+    for k, v in json_str:gmatch('"([^"]*)"%s*:%s*"([^"]*)"') do
+        emoji_mapping[k] = v
+    end
+end
+
+function Str(el)
+    local text = el.text
+    if #text == 0 then
+        return nil
+    end
+
+    -- 检查文本是否包含 emoji
+    local contains_emoji = false
+    for p, c in utf8.codes(text) do
+        -- Emoji 范围检测 (更全面)
+        if (c >= 0x1F600 and c <= 0x1F64F) or -- Emoticons
+           (c >= 0x1F300 and c <= 0x1F5FF) or -- Misc Symbols and Pictographs
+           (c >= 0x1F680 and c <= 0x1F6FF) or -- Transport and Map
+           (c >= 0x1F900 and c <= 0x1F9FF) or -- Supplemental Symbols and Pictographs
+           (c >= 0x2600 and c <= 0x26FF) or   -- Misc Symbols
+           (c >= 0x2700 and c <= 0x27BF) or   -- Dingbats
+           (c >= 0x1F1E0 and c <= 0x1F1FF) or -- Regional Indicator Symbols
+           (c >= 0x1F200 and c <= 0x1F2FF) or -- Enclosed Alphanumerics
+           (c >= 0x2B50 and c <= 0x2BFF) or   -- Glagolitic Supplement
+           (c >= 0x1F004 and c <= 0x1F0FF) or   -- Mahjong Tiles
+           (c >= 0x1F0C0 and c <= 0x1F0FF) or   -- Domino Tiles
+           (c >= 0x0FE0 and c <= 0x0FE0) or   -- Variation Selectors
+           (c >= 0x1F300 and c <= 0x1F5FF) or -- Misc Symbols
+           (c >= 0x1F680 and c <= 0x1F6FF) then -- Transport and Map
+            contains_emoji = true
+            break
+        end
+    end
+
+    -- 如果不包含 emoji，直接返回 nil
+    if not contains_emoji then
+        return nil
+    end
+
+    -- 如果包含 emoji，逐字符处理
+    local new_inlines = {}
+    local emoji_dir = "EMOJI_DIR_PLACEHOLDER"
+
+    for p, c in utf8.codes(text) do
+        local emoji_char = utf8.char(c)
+        local is_emoji = false
+
+        -- 检测 emoji
+        if (c >= 0x1F600 and c <= 0x1F64F) or -- Emoticons
+           (c >= 0x1F300 and c <= 0x1F5FF) or -- Misc Symbols and Pictographs
+           (c >= 0x1F680 and c <= 0x1F6FF) or -- Transport and Map
+           (c >= 0x1F900 and c <= 0x1F9FF) or -- Supplemental Symbols and Pictographs
+           (c >= 0x2600 and c <= 0x26FF) or   -- Misc Symbols
+           (c >= 0x2700 and c <= 0x27BF) or   -- Dingbats
+           (c >= 0x1F1E0 and c <= 0x1F1FF) or -- Regional Indicator Symbols
+           (c >= 0x1F200 and c <= 0x1F2FF) or -- Enclosed Alphanumerics
+           (c >= 0x2B50 and c <= 0x2BFF) or   -- Glagolitic Supplement
+           (c >= 0x1F004 and c <= 0x1F0FF) or   -- Mahjong Tiles
+           (c >= 0x1F0C0 and c <= 0x1F0FF) or   -- Domino Tiles
+           (c >= 0x0FE0 and c <= 0x0FE0) or   -- Variation Selectors
+           (c >= 0x1F300 and c <= 0x1F5FF) or -- Misc Symbols
+           (c >= 0x1F680 and c <= 0x1F6FF) then -- Transport and Map
+            is_emoji = true
+        end
+
+        if is_emoji then
+            -- 查找对应的文件名
+            local filename = emoji_mapping[emoji_char]
+
+            if filename then
+                -- 构建本地 file:// 路径
+                local url = "file://" .. emoji_dir .. "/" .. filename
+
+                -- 生成 HTML img 标签
+                local img_html = string.format(
+                    '<img src="%s" class="emoji" alt="%s" style="height:1.1em;width:1.1em;vertical-align:-0.2em;display:inline-block;margin:0 0.05em;">',
+                    url,
+                    emoji_char
+                )
+
+                table.insert(new_inlines, pandoc.RawInline('html', img_html))
+            else
+                -- 如果找不到对应的文件，保持原字符
+                table.insert(new_inlines, pandoc.Str(emoji_char))
+            end
+        else
+            table.insert(new_inlines, pandoc.Str(emoji_char))
+        end
+    end
+
+    if #new_inlines > 0 then
+        return new_inlines
+    else
+        return nil
+    end
+end
+EOF
+
+# 替换 Lua 模板中的路径占位符
+sed -e "s|EMOJI_DIR_PLACEHOLDER|$EMOJI_DIR|g; s|EMOJI_MAPPING_PLACEHOLDER|$EMOJI_MAPPING|g" "$LUA_FILTER" > "${LUA_FILTER}.tmp"
+mv "${LUA_FILTER}.tmp" "$LUA_FILTER"
+
+# --- 3. 生成 CSS 样式 ---
+cat << 'EOF' > "$CSS_STYLE"
+@page {
+    size: A4;
+    margin: 2.5cm;
+    @bottom-center {
+        content: "Page " counter(page);
+        font-family: "AR PL UMing CN", "Noto Sans SC", sans-serif;
+        font-size: 9pt;
+        color: #888;
+    }
+}
+
+body {
+    font-family: "AR PL UMing CN", "AR PL SungtiL GB", "AR PL KaitiM GB", "Noto Sans SC", "Noto Sans CJK SC", "Microsoft YaHei", sans-serif;
+    line-height: 1.6;
+    font-size: 11pt;
+    color: #333;
+}
+
+/* Emoji 样式：确保彩色 PNG 正确显示 */
+img.emoji {
+    height: 1.1em;
+    width: 1.1em;
+    vertical-align: -0.2em;
+    display: inline-block;
+    margin: 0 0.05em;
+    /* 强制彩色显示 */
+    image-rendering: auto;
+}
+
+h1, h2, h3 {
+    font-family: "AR PL UMing CN", "AR PL SungtiL GB", "AR PL KaitiM GB", "Noto Sans SC", sans-serif;
+    font-weight: bold;
+    color: #2c3e50;
+}
+
+h1 {
+    border-bottom: 2px solid #eee;
+    padding-bottom: 0.3em;
+}
+
+code {
+    background-color: #f5f5f5;
+    padding: 2px 4px;
+    border-radius: 3px;
+    font-family: "Menlo", "Monaco", monospace;
+}
+
+pre {
+    background-color: #f5f5f5;
+    padding: 1em;
+    border-radius: 5px;
+    overflow-x: auto;
+}
+
+blockquote {
+    border-left: 4px solid #ddd;
+    padding-left: 1em;
+    color: #777;
+    font-style: italic;
+}
+
+table {
+    border-collapse: collapse;
+    width: 100%;
+    margin: 1em 0;
+}
+
+th, td {
+    border: 1px solid #ddd;
+    padding: 8px;
+    text-align: left;
+}
+
+th {
+    background-color: #f8f9fa;
+}
+EOF
+
+# --- 4. 执行转换 ---
+
+echo "📝 正在处理 Markdown (使用 Twemoji 完整版 ${TWEMOJI_VERSION})..."
+pandoc "$INPUT_FILE" \
+    --lua-filter="$LUA_FILTER" \
+    --css="$CSS_STYLE" \
+    --metadata title=" " \
+    --standalone \
+    -o "$HTML_TEMP"
+
+echo "🖨️  正在生成 PDF..."
+weasyprint "$HTML_TEMP" "$OUTPUT_FILE"
+
+echo "✨ 转换成功: $OUTPUT_FILE"
+echo ""
+echo "📊 Emoji 信息:"
+echo "   - 版本: Twemoji ${TWEMOJI_VERSION}"
+echo "   - 数量: 3660 个彩色 PNG (包含变体)"
+echo "   - 大小: 72x72px"
+echo "   - 位置: $EMOJI_DIR"

package/skills/sophnet-bot-client/skill.json

@@ -0,0 +1,20 @@
+{
+  "name": "sophnet-bot-client",
+  "version": "1.0.0",
+  "types": [
+    "store"
+  ],
+  "displayName": "远程BotAPI连接器",
+  "description": "为代理配置远程 Bot API 连接，支持 raw 与 proxy 两种模式，并提供连接配置与移除能力。",
+  "changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2026-04-13",
+      "changes": [
+        "初次提交"
+      ]
+    }
+  ],
+  "createdAt": "2026-04-13",
+  "updatedAt": "2026-04-13"
+}

package/skills/sophnet-bot-client/src/SKILL.md

@@ -0,0 +1,255 @@
+---
+name: sophnet-bot-client
+description: |
+  为代理配置远程 Bot API 连接。支持两种模式：
+  - raw: 注入 curl 模板（无权限强制）
+  - proxy: 注入权限代理，程序化权限检查（推荐）
+commands:
+  - /bot-client setup — 配置远程连接
+  - /bot-client remove — 移除远程连接
+metadata:
+  openclaw:
+    emoji: "🔗"
+    requires:
+      bins: ["uv"]
+      env: []
+---
+
+# Bot API Client Skill
+
+为代理注入远程协作能力。
+
+**两种模式：**
+
+- **raw**（旧模式）：将 curl 模板 + 凭据路径写入 AGENTS.md，代理直接用 curl 对话。权限仅靠 LLM 文本约束。
+- **proxy**（推荐）：通过 `bot_client_safe.sh` → `bot_client_proxy.py` 代理链路，**程序化检查权限后**再转发请求。凭据对代理不可见。
+
+## 强制要求：工作目录
+
+**所有命令必须在本 skill 目录下执行：**
+
+```bash
+SKILL_DIR="<本skill的sophnet-bot-client目录绝对路径>"
+cd "$SKILL_DIR"
+```
+
+## Python 运行环境（uv）
+
+**所有 Python 执行必须使用 `uv run --project .`，禁止直接使用 `python` 或 `pip install`。**
+
+首次使用需初始化：
+
+```bash
+cd "$SKILL_DIR" && uv sync --project .
+```
+
+---
+
+## Processing Mode
+
+**STRICT SERIAL PROCESSING ONLY** — 按顺序逐步执行，不要拆分子任务或并行处理。
+
+---
+
+## 命令参考
+
+### setup — 配置远程连接
+
+**proxy 模式（推荐）：**
+
+```bash
+cd "$SKILL_DIR" && uv run --project . python scripts/bot_client_setup.py setup \
+  --agent-id "<本地代理 ID>" \
+  --url "https://{远端 Sophnet 实例域名}/bot-api/v2/{远端 account_id}/chat" \
+  --secret "<远端 api_secret>" \
+  --remote-agent-id "<远端 agent ID>" \
+  --mode proxy
+```
+
+**raw 模式（旧模式）：**
+
+```bash
+cd "$SKILL_DIR" && uv run --project . python scripts/bot_client_setup.py setup \
+  --agent-id "<本地代理 ID>" \
+  --url "https://{远端 Sophnet 实例域名}/bot-api/v2/{远端 account_id}/chat" \
+  --secret "<远端 api_secret>" \
+  --remote-agent-id "<远端 agent ID>"
+```
+
+| 参数                | 必填 | 说明                                                         |
+| ------------------- | ---- | ------------------------------------------------------------ |
+| `--agent-id`        | 是   | **本地**代理 ID                                              |
+| `--url`             | 是   | **远端** Bot API URL，格式为 `https://{远端 Sophnet 实例域名}/bot-api/v2/{远端 account_id}/chat` |
+| `--secret`          | 是   | **远端** API Secret（Bearer token）                          |
+| `--remote-agent-id` | 是   | **远端**目标 agent ID                                        |
+| `--mode`            | 否   | `proxy`（默认）或 `raw`（旧模式）；**必须用 `proxy`，`raw` 模式下 credentials 写到错误位置，激活检查永远不通过** |
+
+**proxy 模式执行逻辑：**
+
+1. 在 admin_dir（`/home/node/.config/sophnet-customer-admin/<agent-id>/`）中保存凭据（对代理不可见）
+2. 在 AGENTS.md 追加「远程协作」章节（仅包含 `bot_client_safe.sh` 调用模板，无 curl/凭据）
+3. 将 `bot_client_safe.sh` 添加到 exec 白名单
+4. 设置 AGENTS.md 为只读（chmod 444）
+5. 幂等：重复执行会替换已有章节和凭据
+
+**raw 模式执行逻辑：**
+
+1. 在代理 workspace 的 `data/bot_credentials.json` 中保存凭据
+2. 在 AGENTS.md 末尾追加「远程协作」章节（含 curl 模板、会话管理指令）
+3. 幂等：重复执行会替换已有章节和凭据
+
+### remove — 移除远程连接
+
+```bash
+cd "$SKILL_DIR" && uv run --project . python scripts/bot_client_setup.py remove \
+  --agent-id "<本地代理 ID>"
+```
+
+| 参数         | 必填 | 说明            |
+| ------------ | ---- | --------------- |
+| `--agent-id` | 是   | **本地**代理 ID |
+
+**执行逻辑：**
+
+1. 从该代理的 AGENTS.md 中删除「远程协作」章节
+2. 删除该代理的远端凭据文件（workspace/data 和 admin_dir 均清理）
+
+---
+
+## 常见工作流
+
+### 工作流 1：为受管代理开通安全远程对话（推荐）
+
+先用 `agent_manager_cli.py` 创建代理（获得权限记录 + exec 白名单），再用 proxy 模式绑定。
+
+**示例：** 本地代理 `vip-reader` 连接到远端实例 `moltbot-xxxx.sophnet.com` 上的 `memory_manager` agent：
+
+```bash
+cd "$SKILL_DIR" && uv run --project . python scripts/bot_client_setup.py setup \
+  --agent-id "vip-reader" \
+  --url "https://moltbot-xxxx.sophnet.com/bot-api/v2/memory_manager-api/chat" \
+  --secret "remote_secret_abc123" \
+  --remote-agent-id "memory_manager" \
+  --mode proxy
+```
+
+其中：
+- `vip-reader`：本地已创建的代理
+- `moltbot-xxxx.sophnet.com`：远端 Sophnet 实例域名
+- `memory_manager-api`：远端 Bot-API 的 account_id
+- `remote_secret_abc123`：远端的 API Secret
+- `memory_manager`：远端 agent ID
+
+### 工作流 2：更换远端地址或密钥
+
+直接重新运行 setup，会自动替换：
+
+```bash
+cd "$SKILL_DIR" && uv run --project . python scripts/bot_client_setup.py setup \
+  --agent-id "vip-reader" \
+  --url "https://moltbot-yyyy.sophnet.com/bot-api/v2/new-account-api/chat" \
+  --secret "new_remote_secret_456" \
+  --remote-agent-id "new_remote_agent" \
+  --mode proxy
+```
+
+### 工作流 3：断开远程连接
+
+```bash
+cd "$SKILL_DIR" && uv run --project . python scripts/bot_client_setup.py remove \
+  --agent-id "vip-reader"
+```
+
+---
+
+## 输出格式
+
+**所有命令输出 JSON 到 stdout。**
+
+### 成功（setup）
+
+```json
+{
+  "status": "ok",
+  "action": "setup_bot_client",
+  "agent_id": "vip-reader",
+  "url": "https://moltbot-xxxx.sophnet.com/bot-api/v2/memory_manager-api/chat",
+  "remote_agent_id": "memory_manager",
+  "workspace": "/home/node/.openclaw/workspace-customer-agents/vip-reader",
+  "credentials_file": "/home/node/.config/sophnet-customer-admin/vip-reader/bot_credentials.json"
+}
+```
+
+### 成功（remove）
+
+```json
+{
+  "status": "ok",
+  "action": "remove_bot_client",
+  "agent_id": "vip-reader",
+  "removed_section": true,
+  "removed_files": ["bot_credentials.json", "bot_session.txt"],
+  "workspace": "/home/node/.openclaw/workspace-customer-agents/vip-reader"
+}
+```
+
+### 失败
+
+```json
+{
+  "status": "error",
+  "action": "setup_bot_client",
+  "message": "Workspace not found: ...",
+  "fix": "请先使用 customer-agent create 创建代理"
+}
+```
+
+---
+
+## 安全说明
+
+### proxy 模式（推荐）
+
+- 凭据存储在 `/home/node/.config/sophnet-customer-admin/<agent-id>/`，对代理完全不可见
+- AGENTS.md 仅包含 `bot_client_safe.sh` 调用模板，无 curl 命令、无凭据路径
+- `bot_client_proxy.py` 在发送前检查 `permissions.json` 中的权限记录
+- 请求 payload 中附带 `senderPermissions`，供服务端/接收方双重校验
+- AGENTS.md 设为只读（chmod 444），防止代理篡改
+- exec 白名单限制代理只能运行 `bot_client_safe.sh`
+
+### raw 模式（旧模式）
+
+- Secret 存储在 `data/bot_credentials.json`（代理可见）
+- AGENTS.md 包含 curl 模板和凭据文件路径
+- 权限仅靠 LLM 文本约束，无程序化强制
+
+### 通用
+
+- `--remote-agent-id` 必须填写为分发方 agent 的 ID，以确保权限链路正确传递
+
+## 已知问题：Docker 环境下 .sh 脚本无执行权限
+
+**现象：** 代理执行 `bot_client_safe.sh` 时报 `Permission denied`（exit code 126）。
+
+**原因：** `clawhub` 在 gateway 启动后才安装 skill，`.sh` 脚本可能没有执行权限。
+
+**已有的自动修复机制（无需手动操作）：**
+
+1. `bot_client_setup.py setup` 在查找 `.sh` 脚本时会自动补上执行权限
+2. `docker-entrypoint.sh` 后台每 15 秒检测并修复缺少执行权限的 `.sh` 文件（需使用最新版 entrypoint 重新构建镜像）
+
+**如果仍遇到此问题（老镜像未重建）：**
+
+```bash
+# 在容器内手动执行
+find /home/node/.openclaw/skills -name '*.sh' -exec chmod +x {} \;
+```
+
+## ⚠️ FORBIDDEN OPERATIONS
+
+**Do NOT:**
+
+- 直接编辑代理的 AGENTS.md（必须通过本脚本）
+- 将 secret 明文写入 AGENTS.md 或其他非凭据文件中
+- 在未创建代理的情况下执行 setup（必须先用 customer-agent create）
+- 对需要权限约束的场景使用 raw 模式（应使用 proxy 模式）

package/skills/sophnet-bot-client/src/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "sophnet-bot-client"
+version = "0.1.0"
+description = "Bot API client setup — inject remote collaboration instructions into sub-agent AGENTS.md"
+requires-python = ">=3.10"
+dependencies = []
+
+[tool.hatch.build.targets.wheel]
+packages = ["scripts"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"