tgravity-work-mcn-index

TGravity Work MCN Index 是一个面向本地 MCN Markdown 资产的关系索引与校验 Skill。它负责校验和重建 MCN 资产关系视图，不修改业务事实，只从 frontmatter 派生索引和正文阅读链接。品牌-达人合作事实只来自 COL 合作记录中的 brand_id、creator_id 和 brief_id。

用途

当用户要点击品牌看到合作达人、点击达人看到合作品牌时使用。
当用户要查品牌-达人合作矩阵、检查关系是否悬空、填充 Obsidian [[links]] 时使用。
当用户要在品牌页看到 ## 合作过的达人，或在达人页看到 ## 合作过的品牌时使用。
当用户要在导出前校验 MCN 资产时使用。

主要能力

扫描本地 MCN Markdown 资产。
校验稳定 ID、重复 ID、悬空 relationships。
生成品牌-达人合作矩阵、达人合作历史。
可回填正文 Markdown 双链。

使用方式

先确认扫描目录，默认使用当前项目的 tgravity-work-data/mcn/。

运行基础索引命令：

python3 skills/tgravity-work-mcn-index/scripts/mcn_index.py --root "<项目根目录>"

如果用户要求填充正文双链，或要在品牌/达人档案内看到合作历史，先预演：

python3 skills/tgravity-work-mcn-index/scripts/mcn_index.py --root "<项目根目录>" --fill-links --dry-run

预演输出符合预期后，再正式回填：

python3 skills/tgravity-work-mcn-index/scripts/mcn_index.py --root "<项目根目录>" --fill-links

正式回填默认会先把被修改的源 Markdown 备份到 tgravity-work-data/mcn/.backups/fill-links-*/。除非用户明确要求且项目已有版本管理，不使用 --no-backup。

执行前需读取 references/asset-contract.md、references/index-contract.md、references/index-workflow.md。

输出

输出生成文件路径、资产数、关系数、重复 ID、悬空关系数、正文回填文件数和备份目录。如果存在错误，不要假装完成，应列出必须修复的 Markdown 文件。

生成文件包括：

tgravity-work-data/mcn/indexes/关系索引.csv tgravity-work-data/mcn/indexes/关系总览.md tgravity-work-data/mcn/indexes/品牌-达人矩阵.csv tgravity-work-data/mcn/indexes/达人合作历史.csv tgravity-work-data/mcn/indexes/悬空关系检查.md

限制与禁止

不把生成的 CSV 当源数据修改。
不凭正文 [[链接]] 判断合作事实。
不把推荐匹配当合作历史。
不接受手写“合作过”relationship；它只能由索引从 COL 记录派生为阅读展示。
不默认扫描整台电脑。
不手改生成区； 到  之间由脚本重建。

技能介绍