用途：把 Gmail 历史邮件挖掘为结构化平面文件，生成联系人、客户、通信记录与关键事实，存储于 ~/.cortex/，无需服务器，文件由用户自己持有。
主要能力：提供挖掘运行、干跑（--dry-run，只挖不写）、指定起始日期（--from YYYY-MM-DD）和批次大小（--batch-size）等命令；运行结束后脚本打印运行报告，需原样展示给用户。文件操作前先读 {skill_path}/references/file-schema.md 了解存储格式。
首次安装与初始化：用 which gws 检查，缺失时提示 npm install -g @googleworkspace/cli 并执行 gws auth setup；用 python3 -c "import anthropic" 检查，缺失时提示 pip install anthropic（托管 Python 可用 pip install anthropic --break-system-packages）；首次运行需 mkdir -p ~/.cortex/originals，初始化 contacts.json、clients.json、communications.jsonl、knowledge.jsonl、files.jsonl 及 state.json。
常用命令：python3 {skill_path}/scripts/cortex-mine.py，可加 --dry-run、--from 2024-01-01、--batch-size 25。
常见错误：gws: command not found 需装 gws CLI；AuthError / 403 需运行 gws auth setup；ANTHROPIC_API_KEY not set 需设置环境变量或写入 ~/.cortex/.env；ModuleNotFoundError: anthropic 需 pip install anthropic。
调度：可在 Claude Code Desktop 的 Cowork > Scheduled > New Task 中每日运行；CLI 用 /loop 24h run the cortex-mine skill；cron 示例为 0 6 * * * cd ~ && ANTHROPIC_API_KEY=sk-... python3 /path/to/cortex-mine.py。
环境变量：CORTEX_DIR 默认 ~/.cortex；ANTHROPIC_API_KEY 提取所需；CORTEX_BATCH_SIZE 默认 50；CORTEX_OWNER_EMAIL 用于从联系人中排除自己的邮箱。导出到 Obsidian、SQLite、Notion、CRM 或自定义 API 的适配方式见 {skill_path}/references/export-adapters.md，预过滤规则见 prefilter-patterns.md。
限制：依赖 gws CLI 与 anthropic 模块及 ANTHROPIC_API_KEY；其余费用、价格、平台与效果信息暂未提供。