知识星球助手使用文档
从安装、登录到帖子导出、附件下载和收藏导出,这里整理了完整的使用流程和常见问题。如果你是第一次使用,建议从「快速开始」开始。
快速开始
第一次使用只需要完成四步:安装客户端、登录知识星球、进入目标星球、配置并开始导出。
- 从官网下载对应系统的安装包(Windows 或 macOS),完成安装。
- 打开客户端,在「知识星球」页面扫码登录。
- 进入目标星球的群组页面,右侧会自动出现导出面板。
- 选择导出格式、日期范围和内容范围,点击「开始抓取」。
安装与系统要求
Windows
支持 Windows 10 / 11 64 位。下载安装包后双击运行,按提示完成安装即可。
如果安装时提示“Windows 已保护你的电脑”,点击“更多信息”,再点击“仍要运行”。这是 Windows 对未签名安装包的正常提示,不影响使用。
macOS
支持 macOS 12 及以上。下载页提供两个安装包,请根据芯片选择:
- Apple Silicon(arm64):M1 / M2 / M3 / M4 及之后的芯片,安装包约 96.4 MB。
- Intel(x64):Intel 芯片的 Mac,安装包约 100.1 MB。
不确定自己的芯片?点击左上角苹果菜单 →「关于本机」,查看「芯片」或「处理器」一栏。
打开 dmg 后,把「知识星球助手」拖进 Applications 文件夹即可。首次打开如果提示“无法验证开发者”,在应用上右键点击 →「打开」,再确认一次就能正常启动。
磁盘空间
Windows 安装包约 97 MB,macOS 安装包约 96–100 MB。导出内容的体积取决于帖子数量、图片和附件大小,建议预留足够的磁盘空间。
登录知识星球
客户端内置浏览器,登录方式与网页版一致:打开「知识星球」页面,使用微信扫码登录。
登录状态保存在本机,下次打开客户端通常不需要重复登录。如果提示登录失效,重新扫码即可。
帖子导出
帖子导出是客户端的核心功能,支持按日期、作者、标签和内容类型筛选。
抓取模式
| 模式 | 说明 |
|---|---|
| 极速(API) | 通过知识星球 API 抓取,速度快,依赖 Cookie 有效性。 |
| 稳定(DOM) | 模拟人工滚动页面,从页面中提取内容,适合 API 不稳定时使用。 |
筛选与选项
- 日期范围:今天、昨天、近一周、近一月、近一季、年初至今或自定义。
- 内容范围:全部、只看星主、精华、仅含文件、作业等。
- 作者筛选:输入作者昵称的一部分即可模糊匹配。
- 标签筛选:按星球标签抓取,支持多选并集。
- 包含评论:可选抓取评论,导出时保留上下文。
- 包含引用链接:解析帖子内的知识星球链接,补齐被引用内容。
断点续传
抓取进度会自动保存在本地。中途停止或关闭客户端后,重新开始抓取可以从上次的位置继续。
附件下载
在左侧菜单进入「文件下载」,可以批量扫描并下载星球中的附件文件。
- 先在「知识星球」页面登录并进入目标星球。
- 切换到「文件下载」,点击「开始扫描」。
- 扫描完成后按文件类型、关键词或数量筛选。
- 点击「开始下载」,客户端会自动跳过已下载的文件。
支持 PDF、Word、Excel、PPT、压缩包、图片、视频和音频。下载完成后会按类型保存到对应子目录。
收藏下载
「收藏下载」用于整理你在知识星球收藏的帖子,支持跨星球筛选和导出。
- 点击「同步全部收藏」,自动拉取收藏列表。
- 按星球、关键词、类型、收藏时间或发布时间筛选。
- 按收藏时间、发布时间或星球排序。
- 支持合并导出,也可以按星球分组导出。
- 选择「帖子 + 附件」或「仅下载附件」时,会自动补全帖子详情。
专栏下载
在「专栏下载」页面选择目标专栏,客户端会加载专栏下的主题列表。勾选需要导出的主题后,可以按帖子、PDF、Word 等格式导出。
专栏导出会补全主题详情、图片和附件,适合整理课程、系列文章和专题内容。
AI 高速模式
AI 高速模式使用知识星球官方 CLI 的 OAuth 登录,适合大批量抓取。首次使用需要扫码授权,授权有效期约 30 天。
- 进入「AI 爬取」页面,点击「开始登录」。
- 使用微信扫码并在手机上确认授权。
- 选择目标星球,配置日期范围、作者和最大数量。
- 预览结果并导出。
AI 高速模式与内置浏览器模式互不影响,可以同时使用。大批量导出时建议优先使用该模式。
导出格式
| 格式 | 适合场景 |
|---|---|
| Markdown (.md) | Obsidian、Notion、飞书等笔记工具,保留结构和图片。 |
| Excel (.xlsx) | 内容索引、选题库、案例库,方便筛选和统计。 |
| PDF (.pdf) | 长期存档、打印和分享,自动嵌入中文字体。 |
| Word (.docx) | 二次编辑、课程讲义、团队内部资料。 |
| HTML | 本地内容归档,浏览器直接打开,图片外置。 |
开启「分文件」后,每条帖子会单独保存为一个文件,文件名格式为「日期-标题-ID」。
授权与激活
未激活时可以免费试用 10 次,单次最多导出 50 条帖子或下载 20 个文件。
| 版本 | 价格 | 权益 |
|---|---|---|
| 标准版 | ¥39.9 | 无限导出、1 台设备、1 年更新 |
| 高级版 | ¥49.9 | 无限导出、受保护文件下载、2 台设备、永久更新、优先支持 |
同一授权码在客户端和插件端通用,但需要分别在两端激活。
激活步骤
- 打开「设置 → 授权管理」。
- 输入授权码,格式为
ZSXQ-XXXXXXXX-XXXXXXXXXXXXX。 - 点击「激活授权」,成功后即可无限导出。
更新与故障排查
检查更新
在「设置」页面点击「检查更新」,下载完成后重启客户端即可完成安装。也可以直接下载最新安装包覆盖安装。
常见问题
- 抓取不到帖子:确认已登录、当前页面是星球群组页面,尝试切换 API / DOM 模式。
- 提示 1059:请求过于频繁,等待一段时间后重试,或减少单次抓取数量。
- 评论为空:部分帖子本身没有评论,也可能是接口限速,稍后重试。
- PDF 中文乱码:确认系统已安装中文字体(如微软雅黑、黑体)。
- 下载速度慢:受知识星球服务器限速影响,建议分批下载。
- 登录失效:重新扫码登录,或切换 AI 高速模式。
- macOS 提示无法验证开发者:在应用上右键点击 →「打开」,或到「系统设置 → 隐私与安全性」里点击「仍要打开」。
- macOS 提示应用已损坏:确认下载的是对应芯片的安装包;如果是从浏览器解压的 zip,重新用 dmg 安装一次。
常见问题
更多购买、插件端和授权问题,可以查看首页的「常见问题」部分。
联系客服
遇到文档没有覆盖的问题,可以加微信咨询:everything_to_notion,备注「知识星球助手」。
购买授权、安装问题和导出异常都可以直接咨询。