Clawhub Sync

# ClawHub 同步白名单配置文件
# 只同步这里列出的 skill，未列出的不会被同步
# 格式：skill 目录名（与 skills/ 下的目录名一致）
# 如需启用某个 skill，删除其所在行开头的 #

# ===== 法律相关 =====
legal-qa-extractor:
legal-text-format:
litigation-analysis:
legal-proposal-generator:
patent-analysis:
trademark-assistant:

# ===== 文档处理 =====
md2word:
mineru-ocr:
piclist-upload:
de-ai-polish:

# ===== 搜索与研究 =====
multi-search:
repo-research:

# ===== 媒体处理 =====
svg-article-illustrator:
funasr-transcribe:
wechat-article-fetch:

# ===== 效率工具 =====
skill-lint:
skill-manager:
git-batch-commit:

# ===== 暂不发布 =====
# 使用 # 注释掉不想发布的 skill

#  clawhub-sync:
#  douyin-batch-download:
#  universal-media-downloader:
#  minimax-web-search:
#  minimax-image-understand:
#  course-generator:
#  agent-reach:
#  github-star-manager:

# ClawHub 同步记录
# 记录每次同步的 skill 状态、版本和 git 信息
#
# 字段说明：
#   version: 同步时的版本号
#   last_sync: 最后同步时间 (ISO 8601)
#   git_hash: 同步时的 commit hash
#   status: synced / pending / failed
#   changelog_summary: 变更摘要
#   url: ClawHub 发布地址
#   publish_id: ClawHub 内部 ID

records:
  # ===== 法律相关 =====
  legal-qa-extractor:
    version: null
    last_sync: null
    git_hash: null
    status: pending
    changelog_summary: null
    url: null
    publish_id: null

  litigation-analysis:
    version: null
    last_sync: null
    git_hash: null
    status: pending
    changelog_summary: null
    url: null
    publish_id: null

  trademark-assistant:
    version: "1.5.0"
    last_sync: "2026-03-24T16:42:00+08:00"
    git_hash: "f5f0726"
    status: synced
    changelog_summary: "新增商标说明撰写、图形商标分析、商品清单生成、申请材料归档功能"
    url: "https://clawhub.ai/skills/trademark-assistant"
    publish_id: "k97fmhvcnrh1tn2msya98nbxxd83gspe"

  # ===== 文档处理 =====
  md2word:
    version: null
    last_sync: null
    git_hash: null
    status: pending
    changelog_summary: null
    url: null
    publish_id: null

  # ===== 效率工具 =====
  skill-lint:
    version: null
    last_sync: null
    git_hash: null
    status: pending
    changelog_summary: null
    url: null
    publish_id: null

MIT License

Copyright (c) 2025 杨卫薪律师（微信ywxlaw）

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

#!/bin/bash
# prepare-publish.sh - 准备技能发布目录
# 用法: prepare-publish.sh <skill-path>
#
# 此脚本创建一个临时目录，只包含符合 .gitignore 规则的文件，
# 用于 ClawHub CLI 发布。
#
# 过滤规则（双重过滤）：
# 1. 项目根目录的 .gitignore（如果存在）
# 2. 技能内部的 .gitignore（如果存在）
#
# 参数:
#   skill-path - 技能目录路径（相对或绝对路径）
#
# 输出:
#   临时目录路径

set -e

# 颜色定义
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m' # No Color

# 帮助信息
usage() {
    echo "用法: prepare-publish.sh <skill-path>"
    echo ""
    echo "参数:"
    echo "  skill-path - 技能目录路径（相对或绝对路径）"
    echo ""
    echo "功能:"
    echo "  创建临时目录用于 ClawHub 发布，自动应用 .gitignore 过滤规则。"
    echo ""
    echo "过滤规则（双重过滤）:"
    echo "  1. 项目根目录的 .gitignore（自动检测）"
    echo "  2. 技能内部的 .gitignore（如果存在）"
    echo ""
    echo "示例:"
    echo "  prepare-publish.sh skills/trademark-assistant"
    echo "  prepare-publish.sh /path/to/skills/trademark-assistant"
    exit 1
}

# 检查参数
if [ -z "$1" ] || [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
    usage
fi

SKILL_PATH="$1"

# 转换为绝对路径
if [ "${SKILL_PATH:0:1}" != "/" ]; then
    SKILL_PATH="$(cd "$(dirname "$SKILL_PATH")" 2>/dev/null && pwd)/$(basename "$SKILL_PATH")"
fi

# 检查技能目录是否存在
if [ ! -d "$SKILL_PATH" ]; then
    echo -e "${RED}错误: 技能目录不存在: $SKILL_PATH${NC}"
    exit 1
fi

# 检查 SKILL.md 是否存在
if [ ! -f "$SKILL_PATH/SKILL.md" ] && [ ! -f "$SKILL_PATH/skill.md" ]; then
    echo -e "${RED}错误: 技能目录中未找到 SKILL.md: $SKILL_PATH${NC}"
    exit 1
fi

# 获取技能名称
SKILL_NAME=$(basename "$SKILL_PATH")

# 确定项目根目录（从技能路径向上查找包含 .git 的目录）
PROJECT_ROOT=""
CURRENT_DIR="$SKILL_PATH"
while [ "$CURRENT_DIR" != "/" ]; do
    if [ -d "$CURRENT_DIR/.git" ]; then
        PROJECT_ROOT="$CURRENT_DIR"
        break
    fi
    CURRENT_DIR=$(dirname "$CURRENT_DIR")
done

if [ -z "$PROJECT_ROOT" ]; then
    echo -e "${YELLOW}警告: 未找到 Git 仓库根目录，将只使用技能内部的 .gitignore${NC}"
fi

# 创建临时目录
TEMP_DIR="/tmp/clawhub-publish-$SKILL_NAME"
echo -e "${GREEN}准备发布目录: $TEMP_DIR${NC}"

# 清理旧的临时目录
rm -rf "$TEMP_DIR"

# 构建 rsync 参数
RSYNC_ARGS=(
    -av                    # 归档模式，显示详细信息
    --delete               # 删除目标目录中多余的文件
    --exclude='.git/'      # 排除 Git 目录
    --exclude='node_modules/'  # 排除 node_modules
    --exclude='__pycache__/'   # 排除 Python 缓存
    --exclude='.DS_Store'      # 排除 macOS 系统文件
    --exclude='**/.env'        # 排除环境变量文件（防止凭证泄露）
    --exclude='**/*.db'        # 排除数据库文件
    --exclude='**/*.sqlite'    # 排除 SQLite 文件
    --exclude='**/logs/'       # 排除日志目录
    --exclude='**/output/'     # 排除输出目录
    --exclude='**/downloads/'  # 排除下载目录
    --exclude='**/archive/'    # 排除运行时缓存目录
)

# 检查项目根目录的 .gitignore
PROJECT_GITIGNORE=""
if [ -n "$PROJECT_ROOT" ] && [ -f "$PROJECT_ROOT/.gitignore" ]; then
    PROJECT_GITIGNORE="$PROJECT_ROOT/.gitignore"
    echo -e "${BLUE}[1] 使用项目根目录 .gitignore: $PROJECT_GITIGNORE${NC}"
fi

# 检查技能内部的 .gitignore
SKILL_GITIGNORE=""
if [ -f "$SKILL_PATH/.gitignore" ]; then
    SKILL_GITIGNORE="$SKILL_PATH/.gitignore"
    echo -e "${BLUE}[2] 使用技能内部 .gitignore: $SKILL_GITIGNORE${NC}"
fi

# 应用过滤规则
# 优先使用 git ls-files（100% 精确匹配 Git 追踪状态，避免 rsync 解析 gitignore 不完整导致敏感文件泄露）
# 仅在非 Git 环境下回退到 rsync + 硬编码排除规则

if [ -n "$PROJECT_ROOT" ]; then
    RELATIVE_PATH="${SKILL_PATH#$PROJECT_ROOT/}"
    RELATIVE_PATH="${RELATIVE_PATH%/}"

    echo -e "${GREEN}复制文件到临时目录（git ls-files 模式）...${NC}"

    COPIED=0
    while IFS= read -r -d '' FILE; do
        DEST="${FILE#$RELATIVE_PATH/}"
        DEST_DIR="$TEMP_DIR/$(dirname "$DEST")"
        mkdir -p "$DEST_DIR"
        cp "$PROJECT_ROOT/$FILE" "$TEMP_DIR/$DEST"
        COPIED=$((COPIED + 1))
    done < <(cd "$PROJECT_ROOT" && git ls-files -z -- "$RELATIVE_PATH")

    if [ "$COPIED" -eq 0 ]; then
        echo -e "${RED}错误: git ls-files 未返回任何文件，确认技能已提交${NC}"
        exit 1
    fi
    echo -e "${GREEN}已复制 $COPIED 个文件到临时目录${NC}"
else
    if [ -n "$PROJECT_GITIGNORE" ] || [ -n "$SKILL_GITIGNORE" ]; then
        [ -n "$PROJECT_GITIGNORE" ] && RSYNC_ARGS+=(--filter=":- $PROJECT_GITIGNORE")
        [ -n "$SKILL_GITIGNORE" ] && RSYNC_ARGS+=(--filter=":- $SKILL_GITIGNORE")
    else
        echo -e "${YELLOW}警告: 未找到任何 .gitignore 文件，将只排除默认目录${NC}"
    fi

    echo -e "${GREEN}复制文件到临时目录（rsync 模式）...${NC}"
    rsync "${RSYNC_ARGS[@]}" "$SKILL_PATH/" "$TEMP_DIR/"
fi

# 强制清理 rsync 可能遗漏的运行时目录（.gitignore 路径相对于项目根时 rsync 无法匹配）
for _DIR in archive output downloads logs; do
    [ -d "$TEMP_DIR/$_DIR" ] && rm -rf "$TEMP_DIR/$_DIR" && echo -e "${YELLOW}强制移除: $_DIR/${NC}"
done

# 统计文件数量
FILE_COUNT=$(find "$TEMP_DIR" -type f | wc -l | tr -d ' ')
echo -e "${GREEN}已复制 $FILE_COUNT 个文件到临时目录${NC}"

# 列出被排除的重要文件类型（用于验证）
echo ""
echo -e "${BLUE}=== 临时目录内容预览 ===${NC}"
ls -la "$TEMP_DIR" | head -20

# 输出临时目录路径（最后一行）
echo ""
echo "$TEMP_DIR"