name: clawd-media-track description: "Resource tracking and acquisition workflow for media resources. MUST use when the user asks to get, add, track, monitor, search, acquire, transfer, or initialize movies, TV shows, anime, Pansou resources, or 115 cloud storage items with the clawd-media-track system. For every clawd-media-track task: first read mandatory references in order, identify task type (Type 1/2/3), output step-labeled checkpoints, wait for explicit user confirmation before any side-effecting action, and verify side effects after execution."

clawd-media-track Skill

FIRST ACTIONS (MANDATORY)

Before any clawd-media-track reasoning or tool use:

1. Read references/00-bootstrap-init.md
2. Check whether bootstrap is complete
3. If bootstrap is incomplete, stay in init mode and do not enter Type 1 / 2 / 3 yet
4. If bootstrap is complete, read references/01-environment-contract.md
5. Read references/02-global-constraints.md
6. Read references/03-methods-reference.md
7. Determine whether the task is Type 1, Type 2, or Type 3
8. Read the matching type checklist
9. Output the current checkpoint as [Type X - Step N]
10. STOP and wait for user confirmation before any side-effecting action

DO NOT:

• skip mandatory references
• guess the task type
• claim "no resource" before query completion/retry
• execute transfer/create/delete/mark actions without explicit user confirmation
• skip post-action verification

Critical Safety Notes

This system can make destructive or rate-limit-sensitive 115 calls if used carelessly.

Read the references in order and follow the checklist for the current task type. Do not improvise around them.

In particular:

• Directory targets come from environment-backed CID configuration, not guesswork.
• flatten_directory() is only valid on final landing directories:
  • movie leaf directories directly under MOVIES_CID
  • season leaf directories ending with Season <number>
• Root/media/category directories are protected and must never be used as flatten targets.
• list_files() is shallow by default. Recursive scans on protected directories are blocked for safety.
• If a method raises SAFETY_VIOLATION, stop and report the exact target/path instead of retrying with guesses.
• Code-level guardrails are a backstop, not a substitute for reading the checklist and choosing the correct target.

This skill is split for progressive loading.

Read only what is needed, but never skip required safety/rules for the current task type.

Mandatory Reading Order

For any clawd-media-track task, read in this order:

1. references/00-bootstrap-init.md (init gate for bootstrap Step 1 and Step 2)
2. references/01-environment-contract.md (required config contract after bootstrap)
3. references/02-global-constraints.md (hard safety rules + execution protocol)
4. references/03-methods-reference.md (allowed module methods only)

Then route by task type:

• Type 1 (one-time acquisition: movies / completed series): read references/05-type1-checklist.md
• Type 2 (tracking initialization: ongoing/incomplete): read references/06-type2-checklist.md
• Type 3 (scheduled monitoring / cron): read references/07-type3-checklist.md

Read additional references when needed:

• Error handling, retries, dedup, season split strategy: references/04-error-and-dedup-rules.md
• Directory structure and common mistakes: references/08-directory-and-mistakes.md

Non-Negotiable Rules (Always Enforced)

• MUST follow: Evidence → Derived Facts → Decision before every critical action
• MUST process protected collections with .each(); DO NOT slice/sample/top-N them
• MUST NOT use glue scripts, regex helpers, or ad-hoc string parsing to make decision logic
• MUST execute Type 3 Step 3b (missing-vs-existing coverage branch) without skipping
• MUST bind transfer URLs once and execute via bound variable(s); DO NOT re-extract between decision and transfer
• MUST verify side effects (transfer/delete/mark/create) with re-read checks
• MUST treat any skipped rule as task failure and report honestly

If any hard rule is violated, stop and report failure instead of improvising.

Execution Context

• Project directory: skill repo root
• Python runtime: ./.venv/bin/python
• Auth/config: constructors read environment-backed config; do not hardcode cookies, tokens, base URLs, or CIDs in the skill

File Map

• references/00-bootstrap-init.md
• references/01-environment-contract.md
• references/02-global-constraints.md
• references/03-methods-reference.md
• references/04-error-and-dedup-rules.md
• references/05-type1-checklist.md
• references/06-type2-checklist.md
• references/07-type3-checklist.md
• references/08-directory-and-mistakes.md

Migration Note

This refactor keeps original procedural content but routes detailed material into references for reliability and context efficiency.

你说要哪部电影、剧或番，agent 自己去搜资源，挑最合适的转存进你自己的网盘（夸克 / 115 / 光鸭 / 123 / 天翼），转完读回来确认真的到了，之后缺哪集还会接着补。

点击前往下载：GitHub Releases（macOS / Windows 桌面版）

点击前往赏饭：要饭嘛，不寒碜

交流：本项目积极参与并认可 LINUX DO 社区，许多用户在那里自部署、交流网盘经验，部署问题也能很快得到回应。

安装

桌面版（最省事）

安装后打开 → 在设置里连网盘、填 AI 模型 → 搜片点「获取」。有新版本时应用会提示你下载。

Docker（NAS / 软路由 / 服务器）

git clone https://github.com/fancydirty/mediary-scout && cd mediary-scout
docker compose up -d

打开 http://<主机IP>:3000，在设置里配置。以后在 设置 → 更新 里一键升级，也可以设成每天自动更新。国内构建加速、Tailscale / Cloudflare Tunnel 远程访问、多用户、备份，以及让 AI agent 替你部署的提示词，都在 部署指南。

两种形态下，自带 OpenAI 兼容的 AI 模型接口都是可选升级（key 只存在你自己的实例里）。未配置 AI 模型时，默认使用 Kilo Code 的公共免费模型池（无需注册；获取任务的对话上下文——搜索查询、任务与留言内容、候选结果、文件名等——会发送给 Kilo 及其上游模型提供商）。影视信息开箱即用。资源搜索用 PanSou：Docker 版自带一个，桌面版默认用公共实例，可以在设置里换成你自己的；可选再接 Prowlarr 找磁力。

支持的网盘

• 夸克：分享链转存，PanSou 上资源最多。
• 115：分享链 + 磁力。
• 123网盘：分享链 + 磁力，免费账号也能转存，扫码登录。连接教程
• 光鸭云盘：分享链 + 磁力，粘 token 登录。连接教程
• 天翼云盘：分享链转存，扫码登录，电影资源偏少。连接教程

各盘资源量对比、为什么只支持这五家：网盘评估。

更多文档

• 部署指南
• Agent API：让 Claude Code、Codex 等编程 agent 直接操作巡影
• 架构速览

免责声明

巡影是开源、自部署的软件，不提供、也永远不会提供托管服务：你自己跑实例，自带网盘和 AI 模型的凭证。它做的就是你本可以在自己网盘里手动完成的那些文件操作。详见项目定位。与 115、夸克、光鸭、123、天翼、TMDB 及任何索引器均无隶属关系。

致谢

• PanSou：资源搜索后端
• Prowlarr：索引器管理（可选）
• p115client：115 API 参考
• p123client：123网盘 API 参考
• AList：光鸭云盘 API 参考（drivers/guangyapan）
• cloud189-auto-save / cloudpan189-api：天翼云盘 API 参考
• TMDB：影视元数据（本产品未获 TMDB 认证或背书）

Star History