腾讯元宝会话全量导出 Skill
> 定位：把用户在腾讯元宝里的全部会话原样备份到本地（markdown + json），全程本机、不连任何第三方。
> 适用：用户用 agent 平台想把元宝对话导出来（做第二大脑、检索、整理、迁移）。
一、触发条件
- 用户说「导出元宝聊天记录 / 备份元宝对话 / 把元宝全部会话下载下来」
- 用户想把元宝对话导入个人知识库 / 第二大脑 / 给 AI 助理当上下文
- 用户问「元宝能不能批量导出 / 怎么备份我的 AI 对话」
二、前置认知（重要）
- 必须真人登录：元宝没有官方导出按钮，本 Skill 用「你自己的浏览器」登录后重放接口。
登录动作（扫码/验证码）只能由用户本人完成，agent 不能代扫。agent 的职责是：开浏览器 → 提示用户登录 → 等 → 收尾。 - 全本机、零上传：只连
yuanbao.tencent.com一个域名；Cookie 留在本地浏览器会话文件夹；不调用任何外部 API。这是它和网上野鸡导出工具的本质区别，务必向用户说明以建立信任。 - 耗时：约每分钟 80 条，3000 条约 30–60 分钟。支持断点续传（中断重跑自动跳过已完成）。
三、执行流程
3.1 准备
- 确认本机有 Python 3.10+（
python --version）。没有则提示用户安装并勾选 Add to PATH。 - 脚本已自带
scripts/yuanbao_export.py，首次运行会自动pip install playwright并playwright install chromium（国内自动走 npmmirror 镜像），无需手动装。
3.2 运行（核心）
用 Bash 运行脚本，务必先告诉用户「浏览器会弹出，请在里面登录元宝」：
cd "<本 skill 的 scripts 目录>"
python yuanbao_export.py
- 脚本会打开一个有界面的浏览器。agent 应明确提示用户：
「浏览器已打开，请扫码/验证码登录元宝，登录后左侧出现会话列表即可，不用点会话，回到这里等它自动导出。」 - 若页面空白打不开：提示用户手动在地址栏输入
yuanbao.tencent.com回车再登录（脚本只认后台请求，不在乎页面显示）。 - 登录后脚本自动抓请求头 → 拉列表 → 全量导出，黑窗口滚动进度。
- 导出中可随时 Ctrl+C；重跑会从断点续传。
3.3 运行方式建议
- 导出可能跑几十分钟。建议在 Bash 中用
run_in_background: true启动，完成后系统会通知；
或前台启动并明确告知用户「登录后去忙别的，跑完我会告诉你」。 - 不要因为「等登录」就反复重启脚本——登录态和进度都已落盘。
3.4 收尾与交付
- 产物在 skill 的
scripts/导出结果/： markdown/YYYY/MM/<id>.md—— 给人看的，每轮用## [N] 我/元宝标记json/YYYY/MM/<id>.json—— 原始结构化数据manifest.jsonl—— 总索引（标题/字数/时间/id），便于搜索或喂给下一步- 向用户报告：导出多少条、落在哪个文件夹、怎么看（用记事本/VS Code 打开 markdown）。
- 安全红线：导出的
导出结果是用户私人对话，不要擅自上传、群发、或整包喂给其他外部服务。如需做知识库，优先只建索引（manifest.jsonl）或按「会话内分段」抽取，而非整篇灌入。
四、异常处理
- 提示登录态失效 / 401 / 403：让用户删除 skill 的
scripts/浏览器会话文件夹，重跑即可重新登录。 - Playwright 装不上 / 浏览器内核下载慢：提示手动
pip install playwright+playwright install chromium；脚本会自动回退用本机 Edge/Chrome。 - 一直抓不到登录头：提示确认已登录、左侧有会话列表；可手动点开一个会话触发接口，回黑窗口按 Enter 再等。详见 skill
references/FAQ.md（若未随附，按通用排错：重登 / 换网络 / 删会话重来）。
五、边界
- 仅用于导出用户自己的对话数据，遵守平台服务条款，不批量抓取他人内容。
- 默认请求间隔 0.35s（温和）；如需更保守加
--sleep 0.6。 - 本 Skill 不负责「导出之后的整理/分类/入库」——那是下游任务，可接个人知识库类 Skill。
