shuiyuan-cache-skill

name	shuiyuan-cache-skill
description	Use when the user needs cache-first or live-search access to Shuiyuan topics through the external shuiyuan_exporter repository.

Shuiyuan Cache Wrapper

这是一个 thin wrapper。真正的运行时代码位于外部 WncFht/shuiyuan_exporter 仓库中；cache、auth 和导出目录都位于当前 skill 目录之外。

外部依赖仓库

• GitHub repo: WncFht/shuiyuan_exporter
• 默认 clone 路径：$HOME/Desktop/src/shuiyuan_exporter
• 环境变量：SHUIYUAN_EXPORTER_REPO
• source override key：repo:WncFht/shuiyuan_exporter
• 安装命令：在 agent-basic-skill 仓根目录运行 python scripts/install_skill.py shuiyuan-cache-skill

安装器会读取同目录下的 external-repos.json；它只在显式安装时检查或 clone 外部仓，运行时 resolver 仍然只做检测不做安装。

先解析外部仓路径

优先级：

1. 显式参数：--repo-root
2. 环境变量：SHUIYUAN_EXPORTER_REPO
3. 本地 source override：repo:WncFht/shuiyuan_exporter
4. 默认候选路径：$HOME/Desktop/src/shuiyuan_exporter

解析示例：

python scripts/resolve_shuiyuan_paths.py --json

如果你需要具体运行细节，按需读取：

• references/runbook.md
• references/runtime_layout.md
• references/output_schema.md
• references/topic-study-workflow.md
• references/troubleshooting.md

Runtime 路径

• SHUIYUAN_CACHE_ROOT 默认回退到 ~/.local/share/shuiyuan-cache-skill
• 认证状态、cookie、SQLite 数据库、媒体缓存都必须继续留在当前 skill 目录之外

推荐命令

REPO_ROOT="$(python scripts/resolve_shuiyuan_paths.py --print repo_root)"
CACHE_ROOT="${SHUIYUAN_CACHE_ROOT:-$HOME/.local/share/shuiyuan-cache-skill}"

uv run --project "$REPO_ROOT" python -m shuiyuan_cache.cli.auth_cli status \
  --cache-root "$CACHE_ROOT/cache" \
  --cookie-path "$CACHE_ROOT/cookies.txt" \
  --check-live

约定

• 不要把 cache/、auth.json、browser_profile/ 或导出结果塞进 skill 目录
• 若缺少外部仓，请先运行 python scripts/install_skill.py shuiyuan-cache-skill，或自行 clone WncFht/shuiyuan_exporter 后再设置 SHUIYUAN_EXPORTER_REPO