feat: 小程序阅读记录与资料链路、管理端用户规则、API/VIP/推荐与运营脚本

- miniprogram: reading-records、imageUrl/mpNavigate、多页资料与 VIP 展示调整 - soul-admin: Users/Settings/UserDetailModal、dist 构建产物更新 - soul-api: user/vip/referral/ckb/db、MBTI 头像管理、user_rule_completion、迁移 SQL - .cursor: karuo-party 与飞书文档；.gitignore 忽略 .tmp_skill_bundle Made-with: Cursor
2026-03-23 18:38:23 +08:00
parent cb6e2bff56
commit fa3da12b16
82 changed files with 5621 additions and 2723 deletions
--- a/scripts/pack_soul_operation_skills.py
+++ b/scripts/pack_soul_operation_skills.py
@@ -1,48 +1,213 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """
-Soul 运营全链路技能包：将 SKILL + 脚本 + Cursor 入口打成 zip，默认输出到用户「下载」文件夹。
+Soul 运营全链路技能包（精简版）：只打包 SKILL / 脚本 / 小配置，便于另一台机 pip/conda 重装。
+大文件、媒体、Cookie、日志等一律不入包。
+
 用法：
  python3 scripts/pack_soul_operation_skills.py
+输出：
+  ~/Downloads/Soul运营全链路技能包_精简_YYYYMMDD.zip
 """
 from __future__ import annotations

+import datetime as _dt
+import json
+import os
 import shutil
 import sys
 import zipfile
 from pathlib import Path

-STAMP = "20260320"
-BUNDLE_TOP = f"Soul运营全链路技能包_{STAMP}"
+# 单文件超过此大小则跳过（字节）——非「代码/文档类」扩展名
+MAX_FILE_BYTES = 512 * 1024  # 512KB
+
+# 脚本与文档类可放宽（避免误跳过大 .py/.md；仍远小于整包 200MB+）
+CODE_DOC_EXT = frozenset(
+    {
+        ".py",
+        ".md",
+        ".mdc",
+        ".sh",
+        ".bash",
+        ".zsh",
+        ".txt",
+        ".json",
+        ".yaml",
+        ".yml",
+        ".toml",
+        ".cfg",
+        ".ini",
+        ".sql",
+        ".html",
+        ".css",
+        ".js",
+        ".ts",
+        ".tsx",
+        ".jsx",
+        ".svg",
+        ".xml",
+    }
+)
+MAX_CODE_DOC_BYTES = 8 * 1024 * 1024  # 8MB
+
+# 整段目录名匹配则不进包（walk 时不进入）
+SKIP_DIR_NAMES = frozenset(
+    {
+        "__pycache__",
+        ".git",
+        ".svn",
+        ".browser_state",
+        "chromium_data",
+        "node_modules",
+        "venv",
+        ".venv",
+        ".mypy_cache",
+        ".pytest_cache",
+        ".tox",
+        "dist",
+        "build",
+        "eggs",
+        ".eggs",
+        "htmlcov",
+        ".ruff_cache",
+        # Cookie 到新机需重新登录导出，不入包
+        "cookies",
+    }
+)
+
+# 扩展名一律跳过（媒体/模型/压缩包等）
+SKIP_EXTENSIONS = frozenset(
+    {
+        ".mp4",
+        ".mov",
+        ".mkv",
+        ".avi",
+        ".webm",
+        ".m4v",
+        ".flv",
+        ".wmv",
+        ".zip",
+        ".tar",
+        ".gz",
+        ".tgz",
+        ".bz2",
+        ".xz",
+        ".rar",
+        ".7z",
+        ".dmg",
+        ".iso",
+        ".img",
+        ".pt",
+        ".pth",
+        ".onnx",
+        ".ckpt",
+        ".safetensors",
+        ".bin",
+        ".exe",
+        ".dll",
+        ".so",
+        ".dylib",
+        ".wav",
+        ".mp3",
+        ".flac",
+        ".aac",
+        ".m4a",
+        ".npz",
+        ".npy",
+        ".pkl",
+        ".pickle",
+        ".whl",
+        ".parquet",
+        ".arrow",
+    }
+)
+
+# 文件名（不含路径）强制跳过
+SKIP_FILE_NAMES = frozenset(
+    {
+        ".DS_Store",
+        "Thumbs.db",
+        "publish_log.json",  # 分发日志可能巨大
+        ".feishu_tokens.json",  # 凭证，到新机用脚本重新获取更安全；若需带走可自行拷贝
+    }
+)

 # 卡若AI 根目录（按你本机实际修改）
 KARUO_AI = Path("/Users/karuo/Documents/个人/卡若AI")
 CURSOR_SKILLS = Path.home() / ".cursor" / "skills"
 DOWNLOADS = Path.home() / "Downloads"

-# 在永平项目下临时组装（本仓库内，便于工具写入）
 REPO_ROOT = Path(__file__).resolve().parents[1]
+STAMP = _dt.date.today().strftime("%Y%m%d")
+BUNDLE_TOP = f"Soul运营全链路技能包_精简_{STAMP}"
 STAGING_PARENT = REPO_ROOT / ".tmp_skill_bundle"
 STAGING = STAGING_PARENT / BUNDLE_TOP

-
-def ignore_copy(dirpath: str, names: list[str]) -> list[str]:
-    """排除缓存、浏览器运行时目录（含断链/套接字，会导致 copytree 失败）。"""
-    skip_dirs = {"__pycache__", ".browser_state", "chromium_data"}
-    skip_files = {".DS_Store"}
-    ignored: list[str] = []
-    for n in names:
-        if n in skip_dirs or n in skip_files or n.endswith(".pyc"):
-            ignored.append(n)
-    return ignored
+# 统计
+_stats: dict[str, int] = {"files": 0, "skipped_size": 0, "skipped_ext": 0, "skipped_dir": 0, "skipped_name": 0}


-def copytree(src: Path, dst: Path) -> None:
-    if not src.exists():
-        print(f"SKIP 不存在: {src}", file=sys.stderr)
+def should_skip_file(path: Path) -> tuple[bool, str]:
+    name = path.name
+    if name in SKIP_FILE_NAMES:
+        return True, "name"
+    ext = path.suffix.lower()
+    if ext in SKIP_EXTENSIONS:
+        return True, "ext"
+    try:
+        sz = path.stat().st_size
+    except OSError:
+        return True, "stat"
+    limit = MAX_CODE_DOC_BYTES if ext in CODE_DOC_EXT else MAX_FILE_BYTES
+    if sz > limit:
+        return True, "size"
+    return False, ""
+
+
+def copy_tree_selective(src: Path, dst_root: Path, rel_base: Path) -> None:
+    """将 src 下文件复制到 dst_root / rel_base，遵守跳过规则。"""
+    if not src.is_dir():
+        print(f"SKIP 非目录: {src}", file=sys.stderr)
        return
-    dst.parent.mkdir(parents=True, exist_ok=True)
-    shutil.copytree(src, dst, dirs_exist_ok=True, ignore=ignore_copy)
+    for root, dirnames, filenames in os_walk_topdown(src):
+        root_path = Path(root)
+        # 过滤要进入的子目录
+        for d in list(dirnames):
+            if d in SKIP_DIR_NAMES:
+                dirnames.remove(d)
+                _stats["skipped_dir"] += 1
+        rel = root_path.relative_to(src)
+        for fname in filenames:
+            fp = root_path / fname
+            skip, reason = should_skip_file(fp)
+            if skip:
+                if reason == "size":
+                    _stats["skipped_size"] += 1
+                elif reason == "ext":
+                    _stats["skipped_ext"] += 1
+                elif reason == "name":
+                    _stats["skipped_name"] += 1
+                continue
+            dest_dir = dst_root / rel_base / rel
+            dest_dir.mkdir(parents=True, exist_ok=True)
+            dest = dest_dir / fname
+            shutil.copy2(fp, dest)
+            _stats["files"] += 1
+
+
+def os_walk_topdown(src: Path):
+    """与 os.walk 相同，但用 Path。"""
+    for r, dnames, fnames in os.walk(str(src), topdown=True):
+        yield Path(r), dnames, fnames
+
+
+def copy_cursor_skill(name: str) -> None:
+    src = CURSOR_SKILLS / name
+    if not src.is_dir():
+        print(f"SKIP 无 Cursor skill: {src}", file=sys.stderr)
+        return
+    copy_tree_selective(src, STAGING, Path(".cursor") / "skills" / name)


 def main() -> int:
@@ -50,29 +215,35 @@ def main() -> int:
        print(f"ERROR: 未找到卡若AI目录: {KARUO_AI}", file=sys.stderr)
        return 1

+    global _stats
+    _stats = {k: 0 for k in _stats}
+
    if STAGING.exists():
        shutil.rmtree(STAGING)
    STAGING.mkdir(parents=True)

-    # Cursor 入口
-    csk = STAGING / ".cursor" / "skills"
-    csk.mkdir(parents=True, exist_ok=True)
+    # Cursor 入口（通常只有 SKILL.md）
    for name in ("soul-operation-report", "soul-party-project"):
-        p = CURSOR_SKILLS / name
-        if p.is_dir():
-            copytree(p, csk / name)
+        copy_cursor_skill(name)

-    kai = STAGING / "卡若AI"
-    copytree(
+    kai_rel = Path("卡若AI")
+
+    def pack_sub(src_under_karuo: Path, rel_under_kai: Path) -> None:
+        """src_under_karuo 为卡若AI下的绝对路径；打入包内 卡若AI/rel_under_kai"""
+        if not src_under_karuo.exists():
+            print(f"SKIP 不存在: {src_under_karuo}", file=sys.stderr)
+            return
+        copy_tree_selective(src_under_karuo, STAGING, kai_rel / rel_under_kai)
+
+    pack_sub(
        KARUO_AI / "02_卡人（水）" / "水岸_项目管理",
-        kai / "02_卡人（水）" / "水岸_项目管理",
+        Path("02_卡人（水）") / "水岸_项目管理",
    )
    bridge = KARUO_AI / "02_卡人（水）" / "水桥_平台对接"
    for sub in ("飞书管理", "智能纪要", "Soul创业实验"):
-        copytree(bridge / sub, kai / "02_卡人（水）" / "水桥_平台对接" / sub)
+        pack_sub(bridge / sub, Path("02_卡人（水）") / "水桥_平台对接" / sub)

    wood = KARUO_AI / "03_卡木（木）" / "木叶_视频内容"
-    wdst = kai / "03_卡木（木）" / "木叶_视频内容"
    for sub in (
        "视频切片",
        "多平台分发",
@@ -82,45 +253,74 @@ def main() -> int:
        "小红书发布",
        "快手发布",
    ):
-        copytree(wood / sub, wdst / sub)
+        pack_sub(wood / sub, Path("03_卡木（木）") / "木叶_视频内容" / sub)

    idx = KARUO_AI / "运营中枢" / "工作台" / "00_账号与API索引.md"
    if idx.is_file():
-        (kai / "运营中枢" / "工作台").mkdir(parents=True, exist_ok=True)
-        shutil.copy2(idx, kai / "运营中枢" / "工作台" / idx.name)
+        skip, _ = should_skip_file(idx)
+        if not skip:
+            dest = STAGING / kai_rel / "运营中枢" / "工作台" / idx.name
+            dest.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(idx, dest)
+            _stats["files"] += 1

-    readme = STAGING / "解压后必读.md"
-    readme.write_text(
-        """# Soul 运营全链路技能包
+    # 写入 requirements 汇总（若各目录有 requirements.txt，只列路径提示，不合并）
+    req_hint = STAGING / "重装依赖说明.md"
+    req_hint.write_text(
+        f"""# 重装依赖说明（精简包）

-## 包含内容
+本包**不含**大文件与本地状态，到新电脑请：

- `.cursor/skills/`：`soul-operation-report`、`soul-party-project`
- `卡若AI/02_卡人（水）/水岸_项目管理/`
- `卡若AI/02_卡人（水）/水桥_平台对接/飞书管理/`、`智能纪要/`、`Soul创业实验/`
- `卡若AI/03_卡木（木）/木叶_视频内容/`：视频切片、多平台分发、各平台发布
- `卡若AI/运营中枢/工作台/00_账号与API索引.md`（若源机存在）
+1. **Python**：建议 3.10+；进入各含 `requirements.txt` 的脚本目录执行 `pip install -r requirements.txt`（以各 SKILL 为准）。
+2. **系统**：`ffmpeg`、`ffprobe`（视频切片）；视频转录见 SKILL 中的 **conda mlx-whisper** 环境说明。
+3. **Playwright**（若飞书脚本需要）：`playwright install` 并按脚本说明登录；**`.browser_state` 未打包**。
+4. **多平台分发**：包内**不含 `cookies/` 目录**，需在新机各平台重新登录导出 Cookie（见多平台分发 SKILL）。
+5. **飞书 Token**：精简包默认**不含** `.feishu_tokens.json`，请在新机用脚本流程重新授权；若你刻意要迁移凭证请单独拷贝（注意安全）。

-## 另一台电脑怎么用
+---

-1. 解压后，将 `卡若AI/` **合并**到你本机卡若AI根目录（先备份）。
-2. 将 `.cursor/skills/` 下两个目录复制到 `~/.cursor/skills/`。
-3. 安装 Python/FFmpeg/conda 等依赖，按各 SKILL 与 `Soul创业实验/上传/环境与TOKEN配置.md` 配置 Token、Cookie、永平项目 `.env`。
-4. 文档或脚本里的 `/Users/karuo/...` 需改成本机路径。
+打包策略摘要（自动生成）：

-**安全**：包内可能有凭证说明，勿上传公开网盘。
+- 代码/文档类（`.py`、`.md` 等）单文件大于 **{MAX_CODE_DOC_BYTES // (1024 * 1024)} MB** 跳过；其它类型大于 **{MAX_FILE_BYTES // 1024} KB** 跳过  
+- 跳过扩展名：媒体、压缩包、模型权重等  
+- 跳过目录：`cookies`、`node_modules`、`.browser_state`、`venv` 等  
+
+打包日期：**{STAMP}**
 """,
        encoding="utf-8",
    )

-    for p in list(STAGING.rglob("__pycache__")):
-        if p.is_dir():
-            shutil.rmtree(p, ignore_errors=True)
-    for p in STAGING.rglob("*.pyc"):
-        try:
-            p.unlink()
-        except OSError:
-            pass
+    readme = STAGING / "解压后必读.md"
+    readme.write_text(
+        f"""# Soul 运营全链路技能包（精简版）
+
+## 本包特点
+
+- **体积小**：不含视频/大日志/模型/Cookie 目录等；到新机器按 `重装依赖说明.md` **重装环境与凭证**。
+- **日期**：{STAMP}
+
+## 包含
+
+- `.cursor/skills/`：`soul-operation-report`、`soul-party-project`
+- `卡若AI/` 下水岸、飞书管理、智能纪要、Soul创业实验、视频切片、多平台分发与各平台发布目录中的 **SKILL、脚本、小配置**（受大小与类型过滤）
+
+## 合并步骤
+
+1. 解压后把 `卡若AI/` **合并**进你的卡若AI根目录（先备份）。
+2. 将 `.cursor/skills/` 下两个文件夹复制到 `~/.cursor/skills/`。
+3. 阅读 **`重装依赖说明.md`**，安装 Python 依赖、FFmpeg、conda 环境等。
+4. 配置飞书、妙记、各平台 Cookie、永平 `.env`（见各 SKILL 与 `Soul创业实验/上传/环境与TOKEN配置.md`）。
+
+**安全**：勿将含密钥的压缩包上传公开网盘。
+""",
+        encoding="utf-8",
+    )
+
+    # 打包统计写入 JSON（便于核对）
+    (STAGING / "_pack_stats.json").write_text(
+        json.dumps({**_stats, "max_file_bytes": MAX_FILE_BYTES, "stamp": STAMP}, ensure_ascii=False, indent=2),
+        encoding="utf-8",
+    )

    DOWNLOADS.mkdir(parents=True, exist_ok=True)
    zip_path = DOWNLOADS / f"{BUNDLE_TOP}.zip"
@@ -132,7 +332,11 @@ def main() -> int:
                zf.write(f, arcname.as_posix())

    mb = zip_path.stat().st_size / (1024 * 1024)
-    print(f"完成: {zip_path}  ({mb:.2f} MB)")
+    print(f"完成: {zip_path}")
+    print(f"大小: {mb:.2f} MB | 打入文件数: {_stats['files']}")
+    print(
+        f"跳过: 超体积 {_stats['skipped_size']} | 扩展名 {_stats['skipped_ext']} | 文件名 {_stats['skipped_name']} | 目录 {_stats['skipped_dir']}"
+    )
    print(f"临时目录（可删）: {STAGING}")
    return 0