知识星球个人内容导出（陪跑版）
帮用户把他自己某个星球里发布的全部主题（普通 talk + 向他人发起的提问 q&a）及评论、楼中楼答复，全量导出为本地 HTML + Markdown 双格式归档，并可选写入腾讯文档。
> ⚠️ 定位：陪跑，不是无人值守。涉及用户账号、登录、写文档的动作，先说清要做什么、是否需要用户操作，等用户确认/授权后再做。导出的产物含用户全部帖子，属个人敏感数据，提醒用户自行保管、勿外传。
English Overview
ZSXQ Personal Content Archive walks you through exporting all of your own posts and replies from a ZSXQ (Knowledge Planet) community — regular posts, Q&A threads you started, comments, and nested replies — into local HTML + Markdown archives, optionally written to Tencent Docs.
Why it matters: ZSXQ offers no built-in one-click backup. Years of your posts, answers, and materials get scattered or lost once you stop using the app. This tool focuses on completeness (no missed Q&A threads — the most common gap) and safety (a guided, step-by-step workflow).
How it works: every action involving your account (login, writing documents) is explained first and requires your confirmation — it never runs silently on your account. After export, a completeness check compares dates and titles to catch anything missed.
Note: only exports your own content from a community you belong to. It does not export other people's communities or scrape public content. Exported data is personal — keep it safe, do not share publicly.
这个 skill 解决什么 / 为什么值得用
知识星球本身不提供一键备份自己全部内容的导出功能。很多人在星球里沉淀了几年的思考、答疑、资料，一旦停用或遗忘，内容就散在 App 里不好找、带不走。
本 skill 的价值，不在"快"，而在全和稳：
- 全：普通帖子、向别人提的问（q&a 类型）、帖下的评论和楼中楼，分三类抓、单独合并，避免「UI 显示 200 条、你只导出 150 条」这种漏抓（q&a 漏抓是最常见的坑，见坑清单）。
- 稳：陪跑式、逐步确认，登录和写文档这类涉及账号的动作都先告知、等授权；产物落在本地，用户自己掌控。
- 可核验：导出后做完整性比对，数日期标题而非拉全文，避免大文档超时翻车。
一句话：它帮你把"散在星球里、带不走的自己"，变成"存在硬盘上、随时能翻的自己"。
开始前（务必）
- 问清：要导出哪个星球？是否本人内容？（只处理用户自己的星球，不碰他人数据）
- 提醒：产物含用户全部帖子与评论，是个人隐私，妥善保管、勿公开发布。
- 全程不要在产物、日志、对话中硬编码用户的星球名、账号 ID、帖子数量、年份等具体信息。
小白用户指导（第一次用也能跑通）
如果你不熟悉命令行，照这一节走就行——不用先懂原理，先跑通，再回头看上面「解决什么」。
你只需要知道的三件事
- 命令行窗口：在 WorkBuddy 里直接跟我说大白话需求即可（比如「帮我导出我星球的内容」），我会把要执行的命令一条条给你，你复制粘贴运行、按提示扫码就行。你不必自己拼命令。
- 扫码登录：第 0 步会让你跑一条登录命令，电脑弹出二维码，用手机知识星球 App 扫一下授权。这一步必须你自己来，我替不了——这是平台账号安全的要求。
- 两个编号：导出要填「星球 id」和「你的用户 id」。别怕，下面有现成命令一键查出来，复制粘贴给我即可，不用手填。
零基础启动清单（照抄顺序跑）
- 先跟我说：「帮我导出我自己的知识星球内容」。我会加载本 skill。
- 跑登录：
zsxq-cli auth login→ 扫码。 - 查你有哪些星球：
zsxq-cli group +list→ 把目标星球的 id 告诉我（或粘贴整段输出）。 - 查你的用户 id：
zsxq-cli api call get_self_info（或zsxq-cli user +info）→ 把user_id那串数字告诉我。 - 之后翻页抓取、生成归档，我一步步带你，你只需要在「是否确认写腾讯文档」这类涉及账号的动作上点一下确认。
第一次最容易卡的点（提前说清）
- 卡在登录：跑
zsxq-cli auth login后没反应/报错？先跑zsxq-cli doctor看配置和健康状态，它会告诉你差什么。 - 查不到 id：
group +list为空？说明还没登录成功，回到第 2 步重扫。 - 命令不认识（如「不是内部命令」）：说明
zsxq-cli没装好。本机随 WorkBuddy 环境就绪则无需装；其他环境按官方说明安装后再试。 - JSON 报错看不懂：把整段报错贴回来给我，我帮你判断是接口名变了（见步骤 3 兜底）还是网络/额度问题，别自己硬猜。
卡住时的自救话术
把下面任意一句发给我，我就能接手：
> 「登录报错了，这是截图/文字：[贴报错]」
> 「group +list 出来是空的，怎么办？」
> 「跑到第 3 步说未知工具，这是输出：[贴输出]」
> 「导出的数量比星球显示的少，帮我补抓」
术语速查（大白话）
| 文档里的词 | 大白话 |
|---|---|
| GROUP_ID（星球 id） | 你要备份的那个星球的编号，从 group +list 里复制 |
| USER_ID（用户 id） | 你本人账号的编号，从 get_self_info 里复制 |
| 游标（cursor） | 翻页用的「翻页书签」，记看到哪页了，下一页接着拉 |
| q&a 帖 | 你向别人发起的「提问」类帖子，不是普通发言 |
| 楼中楼 | 评论下的回复（别人回你的评论，或你回别人的评论） |
工作流（逐步陪跑）
0) 授权登录（需用户亲自操作）
- 让用户执行登录命令并扫码授权：
zsxq-cli auth login。 - 确认登录成功后再继续，不要假设已登录。
1) 确认参数（引导用户自查，不替用户填）
GROUP_ID：目标星球 id（从星球 URL 或zsxq-cli group +list获取）。USER_ID：当前登录用户 id（从zsxq-cli api call get_self_info或zsxq-cli user +info获取）。- 用变量占位，不要写死任何真实值。
> 术语翻译：
> - GROUP_ID（星球 id） = 你要备份的那个星球的编号，长在星球网页地址栏里。
> - USER_ID（用户 id） = 你本人账号的编号，用来区分「哪些帖子是你发的」。
> - 游标（cursor） = 翻页用的"翻页书签"，记下看到哪一页了，下一页从这儿接着拉。
2) 抓 talk 帖（本人普通帖子）
- 翻页
zsxq-cli user +footprints --json --limit 30 [--end-time <t>]，直到has_more=false或next_end_time不前进（游标卡死即停）。 - 过滤条件：
topic.group.group_id == GROUP_ID && topic.owner.user_id == USER_ID。 - 存
my_posts_raw.json。
3) 补抓 q&a 提问（极易漏，关键一步）
zsxq-cli api call get_self_question_topics --params '{"count":30,"topic_filter":"answered"}'zsxq-cli api call get_self_answer_topics --params '{"count":30,"topic_filter":"answered"}'- 翻页，过滤
topic.group.group_id == GROUP_ID。 - ⚠️ 坑：q&a 帖的
owner.user_id是「回答者」不是提问者本人，若只用第 2 步的 owner 过滤会漏掉这类，导致抓取数比星球 UI 的「内容数」少。第 3 步必须单独抓、单独合并。 - 合并 2+3，按
topic_id去重。
> 接口名兜底说明：上述 get_self_question_topics 等是 zsxq MCP 工具名，随版本可能微调。若某次调用报「未知工具」，先跑 zsxq-cli api list 看当前环境真实可用的工具名，再对应替换——本步骤逻辑不变，只是入参名字要对上。这不算 skill 错误，是工具侧版本差异。
4) 抓评论（含楼中楼）
zsxq-cli api call get_topic_comments --params '{"topic_id":"<tid>","limit":30}'limit实测 30 可用；传 100 报「无效的 count」，别传大。- 字段取
comment_id / owner.name / owner.user_id / create_time / text / replied_comment_id / likes_count；楼中楼靠replied_comment_id。 - 按
topic_id聚合存comments_raw.json；失败重试、进度落盘。
5) 生成本地归档（HTML + Markdown）
- 按
create_time[:10]分组到天，每天一个日期标题。 - 每条帖子：
[时:分]+ 附图/附件标记 + 正文（HTML 转义&<>、\n→<br>）。 - 评论区：每条标「评论 · 作者 · 时:分」，楼中楼用「回复 @父评论作者」。
- 同时输出
.html（带排版）与.md（行首特殊符转义防误解析）。 - 给用户本地路径，提醒这是个人数据。
6) 写入腾讯文档（可选，需用户确认）
- 前提：已连接腾讯文档 MCP。
- 新建
manage.create_file，记 file_id。 - 断点续跑：记录已写天数，复用文档只写剩余。
- 每块只写一天（CHUNK=1）：避免单参数过长触发系统报错。
- 每块先取末尾位置再插入。
7) 完整性核验
- 大文档直接拉全文会超时，改用
doc.get_outline数日期标题，与本地发帖天逐一比对（集合/首末/升序）。
适用场景与不适用边界
适合谁 / 什么场景：
- 想把本人在知识星球发的全部内容（帖子 + 评论 + 楼中楼）备份一份本地副本。
- 发现导出数和星球 UI「内容数」对不上，要补抓遗漏（尤其 q&a 提问类）。
- 乐意用命令行、愿意自己扫码登录的人（本 skill 是陪跑，不是全自动）。
不适合 / 明确不做的：
- ❌ 不导出他人星球的内容，也不碰非本人数据。
- ❌ 不用于批量爬取公开内容、不绕过任何平台限制。
- ❌ 不适合「完全不想碰命令行、希望一键全自动」的用户——涉及账号的动作必须本人操作。
- ❌ 写入腾讯文档依赖腾讯文档 MCP 已连接，仅本地归档则不需要。
坑清单（陪跑时提醒用户 / 自查）
- q&a 漏抓：见步骤 3。
- 免费额度上限：写入接口有每日调用上限，耗尽会报错误码；清掉残留进程 + 额度刷新后再续。
- 单参数超长：批量塞入会触发系统「命令行过长」报错，改每天单独写入。
- 杀进程自杀：用进程路径精确匹配，别用含脚本名的模糊匹配（会连执行命令的进程一起杀）。
- 拉全文超时：大文档用大纲数标题核验，别拉全量。
- 接口名随版本变：见步骤 3 兜底说明，以
zsxq-cli api list实时为准。
隐私与边界（始终遵守）
- 不硬编码用户的星球名、账号、数量、年份等。
- 产物是个人敏感数据，提醒用户妥善保管、勿外传。
- 登录、写文档等涉及账号的动作，先告知并取得用户同意再做。
- 只处理用户本人星球，不碰他人数据。
- 本 skill 仅用于用户备份自己的内容，符合平台用户对自身数据的合理使用；不助长任何违规爬取或绕过限制的行为。
出厂铭牌
- 作者：海边小张
- 版本：v1.0.0（2026-08-23）
- 简介：陪用户把本人知识星球里的全部帖子与评论全量导出为本地 HTML/Markdown 归档，可选写入腾讯文档；陪跑式、逐步确认、重完整不重速度。
- 数据/经验来源：作者真实使用经历（本人多次导出自身星球内容沉淀的实战流程与踩坑记录）。
- 触发指令实例（示例）：
- 「帮我把我自己的知识星球里，本人发过的所有帖子和底下的评论，导出备份一份」
- 「导出我的星球内容，含提问和楼中楼」
- 「我星球显示 200 条内容，只抓到 150 条，帮我补抓遗漏」
- 「把我的星球帖子备份成 HTML 和 Markdown」
- 「archive my zsxq topics」
- 不适用边界：不导出他人星球、不批量爬取公开内容、不绕过平台限制；写入腾讯文档需腾讯文档 MCP 已连接。
隐私与安全底线（统一增补 2026-09-03）
敏感个人信息七类，从严处理：生物识别、宗教信仰、特定身份、医疗健康、金融账户、行踪轨迹，以及不满十四周岁未成年人的个人信息——不主动采集、不追问、不记录、不输出、不外传；用户无意说出即跳过并轻提醒；结果输出前二次过滤。
危地不往，乱地不去（安全边界）：识别到用户拟进入高风险或混乱环境（线下见陌生网友、野游野泳或未开发区域、承诺高息回报与荐股、培训贷与押金陷阱、秩序混乱的拥挤现场等），在正常回答之外追加一句轻量避险提醒——不评判、不说教，给出「不去 / 不碰 / 不贷 / 不信」的边界选项，最终决定权在用户。
数据本地优先：个人数据整理默认只落本地文件；联网请求只带关键词、不携带个人数据；用户可随时要求删除已记录内容。
作者与联系
| 渠道 | 账号 |
|---|---|
| 作者 | 广东小张 |
| ima 知识号 | 广东小张 |
| 公众号 | 广东小张的养娃纪事 |
| 微信 | bujuetianyayuan |
用着顺手，或者想聊聊养娃、写作与 AI 实战，欢迎来公众号找我——一个一边倒班一边折腾 AI 的一线工程师父亲。
更新日志
-
v1.6.3（2026-09-25）｜按平台安全规范收敛联系信息章节。
-
v1.0.0（2026-08-23）｜初始发布。新增知识星球个人内容全量导出陪跑流程：① 本人 talk 帖翻页抓取；② q&a 提问单独补抓并去重合并（解决漏抓）；③ 评论与楼中楼聚合；④ 本地 HTML + Markdown 双格式按天归档；⑤ 可选腾讯文档写入（按天断点续跑）；⑥ 完整性核验（大纲数标题）。内置坑清单 6 条与隐私边界纪律。
