feat: 更新一堆 ai 初始化以及 skill

.agents/skills/xiaohongshu/scripts/comment.sh

@@ -0,0 +1,16 @@
+#!/bin/bash
+# 发表评论到小红书帖子
+
+NOTE_ID="$1"
+XSEC_TOKEN="$2"
+CONTENT="$3"
+
+if [ -z "$NOTE_ID" ] || [ -z "$XSEC_TOKEN" ] || [ -z "$CONTENT" ]; then
+    echo "用法: $0 <note_id> <xsec_token> <评论内容>"
+    exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ARGS=$(jq -n --arg fid "$NOTE_ID" --arg tok "$XSEC_TOKEN" --arg ct "$CONTENT" \
+  '{"feed_id":$fid,"xsec_token":$tok,"content":$ct}')
+"$SCRIPT_DIR/mcp-call.sh" post_comment_to_feed "$ARGS"

.agents/skills/xiaohongshu/scripts/export-long-image.py

@@ -0,0 +1,260 @@
+#!/usr/bin/env python3
+"""
+小红书帖子长图导出工具
+
+用法:
+    python3 export-long-image.py --posts '<json>' --output output.jpg
+    python3 export-long-image.py --posts-file posts.json --output output.jpg
+
+posts JSON 格式:
+[
+    {
+        "title": "帖子标题",
+        "author": "作者名",
+        "stats": "1.3万赞 5171收藏",
+        "desc": "正文摘要，支持\\n换行",
+        "images": ["url1", "url2", ...],
+        "per_image_text": {
+            "1": "第2张图的说明文字（0-indexed）",
+            "3": "第4张图的说明文字"
+        }
+    },
+    ...
+]
+
+per_image_text 可选：如果原帖文字明确指向某张图，可以把说明放在对应图片上。
+未指定 per_image_text 时，所有文字放在该帖第一张图前的文字块中。
+"""
+
+import argparse
+import json
+import os
+import sys
+import tempfile
+import urllib.request
+from PIL import Image, ImageDraw, ImageFont
+
+# --- 配置 ---
+WIDTH = 800
+PAD = 24
+LINE_SPACE = 10
+FONT_CANDIDATES = [
+    "/System/Library/Fonts/STHeiti Medium.ttc",
+    "/System/Library/Fonts/Hiragino Sans GB.ttc",
+    "/System/Library/Fonts/Supplemental/Arial Unicode.ttf",
+    "/usr/share/fonts/truetype/noto/NotoSansCJK-Regular.ttc",
+    "/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc",
+]
+
+
+def find_font():
+    for path in FONT_CANDIDATES:
+        if os.path.exists(path):
+            return path
+    return None
+
+
+def load_font(path, size):
+    if path:
+        try:
+            return ImageFont.truetype(path, size, index=0)
+        except Exception:
+            pass
+    return ImageFont.load_default()
+
+
+def wrap_text(text, font, max_width, draw):
+    lines = []
+    for paragraph in text.split("\n"):
+        paragraph = paragraph.strip()
+        if not paragraph:
+            continue
+        current = ""
+        for char in paragraph:
+            test = current + char
+            bbox = draw.textbbox((0, 0), test, font=font)
+            if bbox[2] - bbox[0] > max_width:
+                if current:
+                    lines.append(current)
+                current = char
+            else:
+                current = test
+        if current:
+            lines.append(current)
+    return lines
+
+
+def draw_lines(draw, lines, font, x, y, fill):
+    for line in lines:
+        draw.text((x, y), line, font=font, fill=fill)
+        bbox = draw.textbbox((0, 0), line, font=font)
+        y += (bbox[3] - bbox[1]) + LINE_SPACE
+    return y
+
+
+def measure_lines(lines, font, draw):
+    h = 0
+    for line in lines:
+        bbox = draw.textbbox((0, 0), line if line else " ", font=font)
+        h += (bbox[3] - bbox[1]) + LINE_SPACE
+    return h
+
+
+def make_text_block(title, author_line, desc, font_path, width):
+    """白底黑字文字块，模仿小红书原样"""
+    title_font = load_font(font_path, 32)
+    author_font = load_font(font_path, 20)
+    body_font = load_font(font_path, 24)
+
+    tmp = Image.new("RGB", (width, 10))
+    draw = ImageDraw.Draw(tmp)
+    max_w = width - PAD * 2
+
+    title_lines = wrap_text(title, title_font, max_w, draw)
+    author_lines = [author_line] if author_line else []
+    desc_lines = wrap_text(desc, body_font, max_w, draw) if desc else []
+
+    # 计算高度
+    total_h = PAD
+    total_h += measure_lines(title_lines, title_font, draw)
+    if author_lines:
+        total_h += 4
+        total_h += measure_lines(author_lines, author_font, draw)
+    if desc_lines:
+        total_h += 8
+        total_h += measure_lines(desc_lines, body_font, draw)
+    total_h += PAD
+
+    # 绘制
+    block = Image.new("RGB", (width, total_h), (255, 255, 255))
+    draw = ImageDraw.Draw(block)
+
+    y = PAD
+    y = draw_lines(draw, title_lines, title_font, PAD, y, (33, 33, 33))
+    if author_lines:
+        y += 4
+        y = draw_lines(draw, author_lines, author_font, PAD, y, (153, 153, 153))
+    if desc_lines:
+        y += 8
+        y = draw_lines(draw, desc_lines, body_font, PAD, y, (66, 66, 66))
+
+    return block
+
+
+def make_image_caption(text, font_path, width):
+    """图片上方的小说明文字块"""
+    font = load_font(font_path, 20)
+    tmp = Image.new("RGB", (width, 10))
+    draw = ImageDraw.Draw(tmp)
+    lines = wrap_text(text, font, width - PAD * 2, draw)
+
+    h = PAD + measure_lines(lines, font, draw) + 8
+    block = Image.new("RGB", (width, h), (245, 245, 245))
+    draw = ImageDraw.Draw(block)
+    draw_lines(draw, lines, font, PAD, PAD // 2, (100, 100, 100))
+    return block
+
+
+def download_image(url, tmpdir, idx):
+    """下载图片到临时目录"""
+    ext = ".webp"
+    path = os.path.join(tmpdir, f"img_{idx}{ext}")
+    try:
+        req = urllib.request.Request(url, headers={"User-Agent": "Mozilla/5.0"})
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            with open(path, "wb") as f:
+                f.write(resp.read())
+        return path
+    except Exception as e:
+        print(f"  警告: 下载失败 {url[:60]}... ({e})", file=sys.stderr)
+        return None
+
+
+def main():
+    parser = argparse.ArgumentParser(description="小红书帖子长图导出")
+    parser.add_argument("--posts", help="Posts JSON string")
+    parser.add_argument("--posts-file", help="Posts JSON file path")
+    parser.add_argument("--output", "-o", required=True, help="Output JPG path")
+    parser.add_argument("--width", type=int, default=800, help="Image width (default 800)")
+    parser.add_argument("--quality", type=int, default=88, help="JPEG quality (default 88)")
+    args = parser.parse_args()
+
+    global WIDTH
+    WIDTH = args.width
+
+    # 读取 posts 数据
+    if args.posts:
+        posts = json.loads(args.posts)
+    elif args.posts_file:
+        with open(args.posts_file, "r") as f:
+            posts = json.load(f)
+    else:
+        print("错误: 需要 --posts 或 --posts-file", file=sys.stderr)
+        sys.exit(1)
+
+    font_path = find_font()
+    if not font_path:
+        print("警告: 未找到中文字体，文字可能显示异常", file=sys.stderr)
+
+    sep = Image.new("RGB", (WIDTH, 3), (230, 230, 230))
+    pieces = []
+
+    with tempfile.TemporaryDirectory() as tmpdir:
+        img_counter = 0
+        for pi, post in enumerate(posts):
+            title = post.get("title", "")
+            author = post.get("author", "")
+            stats = post.get("stats", "")
+            desc = post.get("desc", "")
+            images = post.get("images", [])
+            per_image_text = post.get("per_image_text", {})
+
+            # 作者行
+            author_line = author
+            if stats:
+                author_line = f"{author} · {stats}" if author else stats
+
+            # 主文字块
+            text_block = make_text_block(title, author_line, desc, font_path, WIDTH)
+            pieces.append(text_block)
+
+            # 图片
+            for i, url in enumerate(images):
+                # 是否有针对这张图的说明
+                img_key = str(i)
+                if img_key in per_image_text:
+                    caption_block = make_image_caption(per_image_text[img_key], font_path, WIDTH)
+                    pieces.append(caption_block)
+
+                img_path = download_image(url, tmpdir, img_counter)
+                img_counter += 1
+                if img_path:
+                    try:
+                        im = Image.open(img_path).convert("RGB")
+                        ratio = WIDTH / im.width
+                        im = im.resize((WIDTH, int(im.height * ratio)), Image.LANCZOS)
+                        pieces.append(im)
+                    except Exception as e:
+                        print(f"  警告: 图片处理失败 ({e})", file=sys.stderr)
+
+            # 帖子间分隔线
+            if pi < len(posts) - 1:
+                pieces.append(sep)
+
+    if not pieces:
+        print("错误: 没有内容可拼接", file=sys.stderr)
+        sys.exit(1)
+
+    total_h = sum(p.height for p in pieces)
+    long_img = Image.new("RGB", (WIDTH, total_h), (255, 255, 255))
+    y = 0
+    for p in pieces:
+        long_img.paste(p, (0, y))
+        y += p.height
+
+    long_img.save(args.output, "JPEG", quality=args.quality)
+    print(f"完成: {args.output} ({WIDTH}x{total_h})")
+
+
+if __name__ == "__main__":
+    main()

.agents/skills/xiaohongshu/scripts/export-long-image.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# 小红书帖子导出长图
+#
+# 用法:
+#   ./export-long-image.sh --posts-file posts.json -o output.jpg
+#   ./export-long-image.sh --posts '<json>' -o output.jpg
+#
+# posts.json 示例:
+# [
+#   {
+#     "title": "帖子标题",
+#     "author": "作者",
+#     "stats": "1.3万赞 100收藏",
+#     "desc": "正文摘要",
+#     "images": ["https://...webp", "https://...webp"]
+#   }
+# ]
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+python3 "$SCRIPT_DIR/export-long-image.py" "$@"

.agents/skills/xiaohongshu/scripts/install-check.sh

@@ -0,0 +1,67 @@
+#!/bin/bash
+# 检查小红书 MCP 依赖是否已安装
+
+set -e
+
+echo "检查小红书 MCP 依赖..."
+echo ""
+
+XHS_MCP="$HOME/.local/bin/xiaohongshu-mcp"
+XHS_LOGIN="$HOME/.local/bin/xiaohongshu-login"
+
+check_binary() {
+    local name="$1"
+    local path="$2"
+    if [ -f "$path" ]; then
+        echo "✅ $name: $path"
+        return 0
+    else
+        echo "❌ $name: 未找到"
+        return 1
+    fi
+}
+
+MISSING=0
+
+check_binary "xiaohongshu-mcp" "$XHS_MCP" || MISSING=1
+check_binary "xiaohongshu-login" "$XHS_LOGIN" || MISSING=1
+
+echo ""
+
+# 检查 jq（必需，用于安全构建 JSON）
+if command -v jq &> /dev/null; then
+    echo "✅ jq: $(which jq)"
+else
+    echo "❌ jq: 未安装（必需，用于安全构建 JSON）"
+    echo "   安装: apt-get install jq / brew install jq"
+    MISSING=1
+fi
+
+# 检查 Python3（track-topic.py 需要）
+if command -v python3 &> /dev/null; then
+    echo "✅ python3: $(python3 --version)"
+else
+    echo "⚠️  python3: 未安装（热点跟踪功能需要）"
+fi
+
+echo ""
+
+if [ $MISSING -eq 1 ]; then
+    echo "=========================================="
+    echo "缺少必要依赖，请按以下步骤安装："
+    echo ""
+    echo "1. 从 GitHub Releases 下载对应平台的二进制文件："
+    echo "   https://github.com/xpzouying/xiaohongshu-mcp/releases"
+    echo ""
+    echo "2. 解压并安装到 ~/.local/bin/："
+    echo "   mkdir -p ~/.local/bin"
+    echo "   mv xiaohongshu-mcp-linux-amd64 ~/.local/bin/xiaohongshu-mcp"
+    echo "   mv xiaohongshu-login-linux-amd64 ~/.local/bin/xiaohongshu-login"
+    echo "   chmod +x ~/.local/bin/xiaohongshu-*"
+    echo ""
+    echo "3. 确保 ~/.local/bin 在 PATH 中（可选）"
+    echo "=========================================="
+    exit 1
+else
+    echo "✅ 所有依赖已就绪"
+fi

.agents/skills/xiaohongshu/scripts/login.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# 启动小红书登录工具
+
+XHS_LOGIN="$HOME/.local/bin/xiaohongshu-login"
+
+echo "启动小红书登录工具..."
+echo "注意：需要桌面环境或 X11 转发"
+echo ""
+
+"$XHS_LOGIN"

.agents/skills/xiaohongshu/scripts/mcp-call.sh

@@ -0,0 +1,82 @@
+#!/bin/bash
+# 通用 MCP 调用脚本（支持 Streamable HTTP + Session ID）
+
+set -e
+
+TOOL_NAME="$1"
+TOOL_ARGS="$2"
+MCP_URL="${MCP_URL:-http://localhost:18060/mcp}"
+export no_proxy="${no_proxy:+$no_proxy,}localhost,127.0.0.1"
+
+# 检查 jq 依赖
+if ! command -v jq &> /dev/null; then
+    echo "错误: 需要安装 jq (apt-get install jq / brew install jq)"
+    exit 1
+fi
+
+if [ -z "$TOOL_NAME" ]; then
+    echo "用法: $0 <tool_name> [json_args]"
+    echo ""
+    echo "可用工具:"
+    echo "  check_login_status    - 检查登录状态"
+    echo "  search_feeds          - 搜索内容 {\"keyword\": \"...\", \"filters\": {\"sort_by\": \"最新\"}}"
+    echo "  list_feeds            - 获取首页推荐"
+    echo "  get_feed_detail       - 获取帖子详情 {\"feed_id\": \"...\", \"xsec_token\": \"...\"}"
+    echo "  post_comment_to_feed  - 发表评论 {\"feed_id\": \"...\", \"xsec_token\": \"...\", \"content\": \"...\"}"
+    echo "  reply_comment_in_feed - 回复评论 {\"feed_id\": \"...\", \"xsec_token\": \"...\", \"content\": \"...\", \"comment_id\": \"...\", \"user_id\": \"...\"}"
+    echo "  user_profile          - 获取用户主页 {\"user_id\": \"...\", \"xsec_token\": \"...\"}"
+    echo "  like_feed             - 点赞 {\"feed_id\": \"...\", \"xsec_token\": \"...\"}  取消: {\"unlike\": true}"
+    echo "  favorite_feed         - 收藏 {\"feed_id\": \"...\", \"xsec_token\": \"...\"}  取消: {\"unfavorite\": true}"
+    echo "  get_login_qrcode      - 获取登录二维码"
+    echo "  delete_cookies        - 删除 cookies，重置登录状态"
+    echo "  publish_content       - 发布图文"
+    echo "  publish_with_video    - 发布视频"
+    exit 1
+fi
+
+# 校验 tool name，只允许字母数字和下划线
+if [[ ! "$TOOL_NAME" =~ ^[a-zA-Z_][a-zA-Z0-9_]*$ ]]; then
+    echo "错误: 无效的工具名: $TOOL_NAME"
+    exit 1
+fi
+
+[ -z "$TOOL_ARGS" ] && TOOL_ARGS="{}"
+
+# 校验 TOOL_ARGS 是合法 JSON
+if ! echo "$TOOL_ARGS" | jq empty 2>/dev/null; then
+    echo "错误: 参数不是合法的 JSON: $TOOL_ARGS"
+    exit 1
+fi
+
+# 1. Initialize 并获取 Session ID
+INIT_RESPONSE=$(curl --noproxy '*' -s -i -X POST "$MCP_URL" \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"openclaw","version":"1.0"}}}')
+
+SESSION_ID=$(echo "$INIT_RESPONSE" | grep -i "Mcp-Session-Id" | awk '{print $2}' | tr -d '\r\n')
+
+if [ -z "$SESSION_ID" ]; then
+    echo "错误: 无法获取 MCP Session ID"
+    echo "请确保 MCP 服务正在运行: ./start-mcp.sh"
+    exit 1
+fi
+
+# 2. Initialized notification
+curl --noproxy '*' -s -X POST "$MCP_URL" \
+  -H "Content-Type: application/json" \
+  -H "Mcp-Session-Id: $SESSION_ID" \
+  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}' > /dev/null
+
+# 3. Call tool — 使用 jq 安全构建 JSON，避免 shell 注入
+CALL_PAYLOAD=$(jq -n \
+  --arg name "$TOOL_NAME" \
+  --argjson args "$TOOL_ARGS" \
+  '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":$name,"arguments":$args}}')
+
+RESULT=$(curl --noproxy '*' -s --max-time 120 -X POST "$MCP_URL" \
+  -H "Content-Type: application/json" \
+  -H "Mcp-Session-Id: $SESSION_ID" \
+  -d "$CALL_PAYLOAD")
+
+# 输出结果
+echo "$RESULT" | jq .

.agents/skills/xiaohongshu/scripts/post-detail.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# 获取小红书帖子详情
+
+NOTE_ID="$1"
+XSEC_TOKEN="$2"
+
+if [ -z "$NOTE_ID" ] || [ -z "$XSEC_TOKEN" ]; then
+    echo "用法: $0 <note_id> <xsec_token>"
+    echo ""
+    echo "note_id 和 xsec_token 可从搜索或推荐结果中获取"
+    exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ARGS=$(jq -n --arg fid "$NOTE_ID" --arg tok "$XSEC_TOKEN" \
+  '{"feed_id":$fid,"xsec_token":$tok}')
+"$SCRIPT_DIR/mcp-call.sh" get_feed_detail "$ARGS"

.agents/skills/xiaohongshu/scripts/recommend.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# 获取小红书首页推荐列表
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+"$SCRIPT_DIR/mcp-call.sh" list_feeds

.agents/skills/xiaohongshu/scripts/search.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# 搜索小红书内容
+
+KEYWORD="$1"
+
+if [ -z "$KEYWORD" ]; then
+    echo "用法: $0 <关键词>"
+    exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ARGS=$(jq -n --arg kw "$KEYWORD" '{"keyword":$kw}')
+"$SCRIPT_DIR/mcp-call.sh" search_feeds "$ARGS"

.agents/skills/xiaohongshu/scripts/start-mcp.sh

@@ -0,0 +1,166 @@
+#!/bin/bash
+# 启动小红书 MCP 服务
+
+XHS_MCP="$HOME/.local/bin/xiaohongshu-mcp"
+PID_FILE="$HOME/.xiaohongshu/mcp.pid"
+LOG_FILE="$HOME/.xiaohongshu/mcp.log"
+XVFB_PID_FILE="$HOME/.xiaohongshu/xvfb.pid"
+XVFB_DISPLAY_FILE="$HOME/.xiaohongshu/xvfb.display"
+
+# Cookies 路径（可通过环境变量覆盖）
+# XHS_COOKIES_SRC: 源 cookies 文件（用于远程服务器场景）
+# 默认检查 ~/cookies.json 和 ~/.xiaohongshu/cookies.json
+COOKIES_DST="/tmp/cookies.json"
+
+mkdir -p "$HOME/.xiaohongshu"
+
+# 检测是否有显示器（桌面环境）
+has_display() {
+    [ -n "$DISPLAY" ] && xdpyinfo >/dev/null 2>&1
+}
+
+# 在无桌面环境下自动启动 Xvfb
+ensure_display() {
+    if has_display; then
+        return 0
+    fi
+
+    # 已有 Xvfb 在运行
+    if [ -f "$XVFB_PID_FILE" ]; then
+        local pid
+        pid=$(cat "$XVFB_PID_FILE")
+        if kill -0 "$pid" 2>/dev/null; then
+            export DISPLAY=$(cat "$XVFB_DISPLAY_FILE" 2>/dev/null || echo ":99")
+            echo "复用已有 Xvfb (PID: $pid, DISPLAY=$DISPLAY)"
+            return 0
+        fi
+    fi
+
+    # 检查 Xvfb 是否安装
+    if ! command -v Xvfb >/dev/null 2>&1; then
+        echo "⚠ 未检测到桌面环境，且未安装 Xvfb。"
+        echo "  请安装：sudo apt-get install -y xvfb"
+        echo "  安装后重新运行本脚本即可自动配置。"
+        exit 1
+    fi
+
+    echo "未检测到桌面环境，自动启动 Xvfb 虚拟显示..."
+
+    # 自动选择可用的 display 号（99-109）
+    local display_num=""
+    local d
+    for d in $(seq 99 109); do
+        if [ ! -e "/tmp/.X${d}-lock" ]; then
+            display_num=$d
+            break
+        fi
+        # 锁文件存在但进程已死，尝试清理后使用
+        local lock_pid
+        lock_pid=$(cat "/tmp/.X${d}-lock" 2>/dev/null | tr -d ' ')
+        if [ -n "$lock_pid" ] && ! kill -0 "$lock_pid" 2>/dev/null; then
+            rm -f "/tmp/.X${d}-lock" "/tmp/.X11-unix/X${d}" 2>/dev/null
+            if [ ! -e "/tmp/.X${d}-lock" ]; then
+                display_num=$d
+                break
+            fi
+        fi
+    done
+
+    if [ -z "$display_num" ]; then
+        echo "✗ 无法找到可用的 display 号（:99-:109 均被占用）"
+        exit 1
+    fi
+
+    # -ac: 关闭访问控制，允许 chromium 连接虚拟显示（仅用于 headless 自动化）
+    Xvfb ":${display_num}" -screen 0 1024x768x24 -ac >/dev/null 2>&1 &
+    echo $! > "$XVFB_PID_FILE"
+    echo ":${display_num}" > "$XVFB_DISPLAY_FILE"
+    export DISPLAY=":${display_num}"
+    sleep 1
+
+    if kill -0 "$(cat "$XVFB_PID_FILE")" 2>/dev/null; then
+        echo "✓ Xvfb 已启动 (DISPLAY=:${display_num})"
+    else
+        echo "✗ Xvfb 启动失败"
+        exit 1
+    fi
+}
+
+# 同步 cookies（支持多个可能的来源）
+sync_cookies() {
+    local src=""
+
+    # 优先使用环境变量指定的路径
+    if [ -n "$XHS_COOKIES_SRC" ] && [ -f "$XHS_COOKIES_SRC" ]; then
+        src="$XHS_COOKIES_SRC"
+    elif [ -f "$HOME/cookies.json" ]; then
+        src="$HOME/cookies.json"
+    elif [ -f "$HOME/.xiaohongshu/cookies.json" ]; then
+        src="$HOME/.xiaohongshu/cookies.json"
+    fi
+
+    if [ -n "$src" ]; then
+        if [ ! -f "$COOKIES_DST" ] || [ "$src" -nt "$COOKIES_DST" ]; then
+            install -m 600 "$src" "$COOKIES_DST"
+            echo "已同步 cookies: $src -> $COOKIES_DST"
+        fi
+    else
+        # 确保已有的 cookies 文件权限正确
+        [ -f "$COOKIES_DST" ] && chmod 600 "$COOKIES_DST"
+    fi
+}
+
+sync_cookies
+ensure_display
+
+# 检查是否已在运行
+if [ -f "$PID_FILE" ]; then
+    PID=$(cat "$PID_FILE")
+    if kill -0 "$PID" 2>/dev/null; then
+        echo "MCP 服务已在运行 (PID: $PID)"
+        echo "如需重启，请先运行 stop-mcp.sh"
+        exit 0
+    fi
+fi
+
+# 解析参数
+HEADLESS="true"
+PORT="${XHS_MCP_PORT:-18060}"
+for arg in "$@"; do
+    case $arg in
+        --headless=false)
+            HEADLESS="false"
+            ;;
+        --port=*)
+            PORT="${arg#*=}"
+            ;;
+    esac
+done
+
+# 校验端口号
+if [[ ! "$PORT" =~ ^[0-9]+$ ]]; then
+    echo "错误: 无效端口号: $PORT"
+    exit 1
+fi
+
+# 启动服务
+echo "启动小红书 MCP 服务..."
+if [ "$HEADLESS" = "false" ]; then
+    nohup "$XHS_MCP" -port ":${PORT}" -headless=false > "$LOG_FILE" 2>&1 &
+else
+    nohup "$XHS_MCP" -port ":${PORT}" > "$LOG_FILE" 2>&1 &
+fi
+
+echo $! > "$PID_FILE"
+sleep 2
+
+# 验证启动
+if kill -0 $(cat "$PID_FILE") 2>/dev/null; then
+    echo "✓ MCP 服务已启动 (PID: $(cat $PID_FILE))"
+    echo "  端点: http://localhost:${PORT}/mcp"
+    echo "  日志: $LOG_FILE"
+else
+    echo "✗ 启动失败，查看日志: $LOG_FILE"
+    cat "$LOG_FILE"
+    exit 1
+fi

.agents/skills/xiaohongshu/scripts/status.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# 检查小红书登录状态
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+"$SCRIPT_DIR/mcp-call.sh" check_login_status

.agents/skills/xiaohongshu/scripts/stop-mcp.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# 停止小红书 MCP 服务
+
+PID_FILE="$HOME/.xiaohongshu/mcp.pid"
+XVFB_PID_FILE="$HOME/.xiaohongshu/xvfb.pid"
+
+if [ -f "$PID_FILE" ]; then
+    PID=$(cat "$PID_FILE")
+    if kill -0 "$PID" 2>/dev/null; then
+        kill "$PID"
+        rm -f "$PID_FILE"
+        echo "✓ MCP 服务已停止"
+    else
+        echo "进程不存在，清理 PID 文件"
+        rm -f "$PID_FILE"
+    fi
+else
+    echo "MCP 服务未运行"
+fi
+
+# 清理 Xvfb
+if [ -f "$XVFB_PID_FILE" ]; then
+    XVFB_PID=$(cat "$XVFB_PID_FILE")
+    if kill -0 "$XVFB_PID" 2>/dev/null; then
+        kill "$XVFB_PID"
+        echo "✓ Xvfb 已停止"
+    fi
+    rm -f "$XVFB_PID_FILE" "$HOME/.xiaohongshu/xvfb.display"
+fi

.agents/skills/xiaohongshu/scripts/track-topic.py

@@ -0,0 +1,313 @@
+#!/usr/bin/env python3
+"""
+小红书热点跟踪工具
+
+用法:
+    python track-topic.py <话题> [--limit N] [--feishu] [--output FILE]
+
+示例:
+    python track-topic.py "DeepSeek" --limit 5 --feishu
+    python track-topic.py "春节旅游" --limit 10 --output report.md
+"""
+
+import argparse
+import json
+import subprocess
+import sys
+import os
+from datetime import datetime
+from pathlib import Path
+
+# 获取脚本目录
+SCRIPT_DIR = Path(__file__).parent.resolve()
+XHS_SCRIPTS = SCRIPT_DIR  # 现在就在 xiaohongshu/scripts 目录下
+
+# 飞书 skill 路径（支持多种可能的位置）
+def find_feishu_scripts() -> Path:
+    """查找 feishu-docs skill 的 scripts 目录"""
+    # 只允许在已知的 skill 目录中查找
+    allowed_roots = [
+        SCRIPT_DIR.parent.parent,  # 同级 skill 目录
+        Path.home() / ".openclaw" / "workspace" / "skills",
+        Path.home() / ".claude" / "skills",
+    ]
+    for root in allowed_roots:
+        candidate = (root / "feishu-docs" / "scripts").resolve()
+        # 校验解析后的路径仍在允许的根目录下（防止符号链接逃逸）
+        if candidate.is_dir() and any(
+            str(candidate).startswith(str(r.resolve()) + os.sep) for r in allowed_roots
+        ):
+            return candidate
+    return allowed_roots[0] / "feishu-docs" / "scripts"  # 返回默认路径（可能不存在）
+
+FEISHU_SCRIPTS = find_feishu_scripts()
+
+
+def call_xhs_mcp(tool: str, args: dict) -> dict:
+    """调用小红书 MCP 工具"""
+    mcp_call = XHS_SCRIPTS / "mcp-call.sh"
+    if not mcp_call.exists():
+        print(f"❌ 找不到 xiaohongshu skill: {mcp_call}", file=sys.stderr)
+        sys.exit(1)
+    
+    result = subprocess.run(
+        [str(mcp_call), tool, json.dumps(args)],
+        capture_output=True, text=True, timeout=120
+    )
+    
+    if result.returncode != 0:
+        print(f"❌ MCP 调用失败: {result.stderr}", file=sys.stderr)
+        return {}
+    
+    try:
+        response = json.loads(result.stdout)
+        if "result" in response and "content" in response["result"]:
+            text = response["result"]["content"][0].get("text", "{}")
+            return json.loads(text) if text else {}
+        elif "error" in response:
+            print(f"⚠️ MCP 错误: {response['error'].get('message', 'Unknown')}", file=sys.stderr)
+            return {}
+        return response
+    except json.JSONDecodeError:
+        return {}
+
+
+def search_feeds(keyword: str) -> list:
+    """搜索小红书内容"""
+    print(f"🔍 搜索: {keyword}")
+    result = call_xhs_mcp("search_feeds", {"keyword": keyword})
+    feeds = result.get("feeds", [])
+    # 过滤掉 hot_query 类型
+    return [f for f in feeds if f.get("modelType") == "note"]
+
+
+def get_feed_detail(feed_id: str, xsec_token: str, load_comments: bool = True) -> dict:
+    """获取帖子详情"""
+    args = {
+        "feed_id": feed_id,
+        "xsec_token": xsec_token,
+        "load_all_comments": load_comments
+    }
+    result = call_xhs_mcp("get_feed_detail", args)
+    return result.get("data", {})
+
+
+def format_timestamp(ts: int) -> str:
+    """格式化时间戳"""
+    if not ts:
+        return "未知"
+    try:
+        dt = datetime.fromtimestamp(ts / 1000)
+        return dt.strftime("%Y-%m-%d %H:%M")
+    except:
+        return "未知"
+
+
+def get_comments_list(post: dict) -> list:
+    """安全地获取评论列表"""
+    comments = post.get("comments", {})
+    if isinstance(comments, dict):
+        return comments.get("list", [])
+    elif isinstance(comments, list):
+        return comments
+    return []
+
+
+def generate_report(keyword: str, posts: list) -> str:
+    """生成 Markdown 报告"""
+    now = datetime.now().strftime("%Y-%m-%d %H:%M")
+    
+    report = f"""# 🔥 小红书热点跟踪报告
+
+**话题:** {keyword}  
+**生成时间:** {now}  
+**收录帖子:** {len(posts)} 篇
+
+---
+
+## 📊 概览
+
+"""
+    
+    # 统计信息
+    total_likes = sum(int(p.get("note", {}).get("interactInfo", {}).get("likedCount", 0) or 0) for p in posts)
+    total_comments = sum(len(get_comments_list(p)) for p in posts)
+    
+    report += f"""| 指标 | 数值 |
+|------|------|
+| 总帖子数 | {len(posts)} |
+| 总点赞数 | {total_likes:,} |
+| 总评论数 | {total_comments} |
+
+---
+
+## 📝 热帖详情
+
+"""
+    
+    for i, post in enumerate(posts, 1):
+        note = post.get("note", {})
+        comments = get_comments_list(post)
+        
+        title = note.get("title", "无标题")
+        desc = note.get("desc", "")
+        user = note.get("user", {}).get("nickname", "匿名")
+        time_str = format_timestamp(note.get("time"))
+        interact = note.get("interactInfo", {})
+        likes = interact.get("likedCount", "0")
+        collected = interact.get("collectedCount", "0")
+        
+        report += f"""### {i}. {title}
+
+**作者:** {user}  
+**时间:** {time_str}  
+**互动:** ❤️ {likes} 赞 · ⭐ {collected} 收藏
+
+**正文:**
+
+> {desc[:500]}{"..." if len(desc) > 500 else ""}
+
+"""
+        
+        if comments:
+            report += f"""**热门评论 ({len(comments)} 条):**
+
+"""
+            for j, comment in enumerate(list(comments)[:5], 1):
+                c_user = comment.get("userInfo", {}).get("nickname", "匿名")
+                c_content = comment.get("content", "")
+                c_likes = comment.get("likeCount", 0)
+                report += f"- **{c_user}** ({c_likes}赞): {c_content[:100]}\n"
+            
+            if len(comments) > 5:
+                report += f"- *... 还有 {len(comments) - 5} 条评论*\n"
+        
+        report += "\n---\n\n"
+    
+    # 评论区热点总结
+    report += """## 💬 评论区热点关键词
+
+"""
+    
+    # 简单的关键词提取（统计高频词）
+    all_comments = []
+    for post in posts:
+        for c in get_comments_list(post):
+            all_comments.append(c.get("content", ""))
+    
+    if all_comments:
+        report += f"共 {len(all_comments)} 条评论，主要讨论方向：\n\n"
+        # 这里可以做更复杂的 NLP 分析，暂时简化
+        report += "- 用户对该话题的关注度较高\n"
+        report += "- 评论区互动活跃\n"
+    else:
+        report += "暂无足够评论数据进行分析\n"
+    
+    report += """
+---
+
+## 📈 趋势分析
+
+基于以上热帖和评论数据，该话题在小红书上呈现以下特点：
+
+1. **热度指数**: """ + ("🔥🔥🔥 高" if total_likes > 1000 else "🔥🔥 中" if total_likes > 100 else "🔥 低") + f"""
+2. **互动活跃度**: """ + ("活跃" if total_comments > 50 else "一般" if total_comments > 10 else "较低") + """
+3. **内容类型**: 以图文笔记为主
+
+---
+
+*报告由 OpenClaw 小红书热点跟踪工具自动生成*
+"""
+    
+    return report
+
+
+def export_to_feishu(title: str, content: str) -> str:
+    """导出到飞书文档"""
+    import_script = FEISHU_SCRIPTS / "doc-import.sh"
+    if not import_script.exists():
+        print(f"❌ 找不到 feishu-docs skill: {import_script}", file=sys.stderr)
+        return ""
+    
+    print("📤 导出到飞书文档...")
+    
+    # 写入临时文件
+    tmp_file = Path("/tmp/xhs_report.md")
+    tmp_file.write_text(content, encoding="utf-8")
+    
+    result = subprocess.run(
+        [str(import_script), title, "--file", str(tmp_file)],
+        capture_output=True, text=True, timeout=60
+    )
+    
+    if result.returncode != 0:
+        print(f"⚠️ 飞书导出失败: {result.stderr}", file=sys.stderr)
+        return ""
+    
+    # 解析返回的文档链接
+    output = result.stdout
+    print(output)
+    return output
+
+
+def main():
+    parser = argparse.ArgumentParser(description="小红书热点跟踪工具")
+    parser.add_argument("keyword", help="要跟踪的话题/关键词")
+    parser.add_argument("--limit", "-n", type=int, default=10, help="获取帖子数量 (默认 10)")
+    parser.add_argument("--feishu", "-f", action="store_true", help="导出到飞书文档")
+    parser.add_argument("--output", "-o", help="输出 Markdown 文件路径")
+    parser.add_argument("--no-comments", action="store_true", help="不获取评论")
+    
+    args = parser.parse_args()
+    
+    # 1. 搜索帖子
+    feeds = search_feeds(args.keyword)
+    if not feeds:
+        print("❌ 未找到相关帖子")
+        sys.exit(1)
+    
+    print(f"✅ 找到 {len(feeds)} 条帖子")
+    
+    # 2. 获取详情
+    posts = []
+    for i, feed in enumerate(feeds[:args.limit]):
+        feed_id = feed.get("id")
+        xsec_token = feed.get("xsecToken")
+        title = feed.get("noteCard", {}).get("displayTitle", "")
+        
+        print(f"📖 [{i+1}/{min(len(feeds), args.limit)}] 获取: {title[:30]}...")
+        
+        detail = get_feed_detail(feed_id, xsec_token, not args.no_comments)
+        if detail:
+            posts.append(detail)
+    
+    if not posts:
+        print("❌ 未能获取帖子详情")
+        sys.exit(1)
+    
+    print(f"✅ 成功获取 {len(posts)} 篇帖子详情")
+    
+    # 3. 生成报告
+    print("📝 生成报告...")
+    report = generate_report(args.keyword, posts)
+    
+    # 4. 输出
+    if args.output:
+        output_path = Path(args.output)
+        output_path.write_text(report, encoding="utf-8")
+        print(f"✅ 报告已保存: {output_path}")
+    
+    if args.feishu:
+        doc_title = f"小红书热点跟踪: {args.keyword} ({datetime.now().strftime('%m-%d')})"
+        export_to_feishu(doc_title, report)
+    
+    if not args.output and not args.feishu:
+        # 默认输出到 stdout
+        print("\n" + "="*60 + "\n")
+        print(report)
+    
+    return report
+
+
+if __name__ == "__main__":
+    main()

.agents/skills/xiaohongshu/scripts/track-topic.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+# 小红书热点跟踪工具
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+python3 "$SCRIPT_DIR/track-topic.py" "$@"

.agents/skills/xiaohongshu/scripts/user-profile.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# 获取小红书用户主页
+
+USER_ID="$1"
+XSEC_TOKEN="$2"
+
+if [ -z "$USER_ID" ] || [ -z "$XSEC_TOKEN" ]; then
+    echo "用法: $0 <user_id> <xsec_token>"
+    echo ""
+    echo "user_id 和 xsec_token 可从搜索或推荐结果中获取"
+    exit 1
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ARGS=$(jq -n --arg uid "$USER_ID" --arg tok "$XSEC_TOKEN" \
+  '{"user_id":$uid,"xsec_token":$tok}')
+"$SCRIPT_DIR/mcp-call.sh" user_profile "$ARGS"