LarkSnap · 文档导出 · 网页剪藏 · 截图总结

简体中文 | English

Chrome 扩展：飞书 / Lark 文档一键导出 Markdown / PDF / HTML、批量下载附件、离线缓存，还能把 Markdown 写回文档；任意网页（含小红书笔记）一键转 Markdown、整页截图、AI 总结、解除复制限制；下载 B 站 / 抖音 / TikTok 视频。

零配置、纯客户端、内容不外发，兼容企业私有化自建域名。不用去开放平台建应用、申请 API 权限 —— 直接复用浏览器里已登录的 Cookie 和飞书网页自身的内部接口。

直接到 Chrome 应用商店 一键安装，后续版本自动更新。

到 Releases 下载最新 zip 并解压，然后：

1. 打开 chrome://extensions，开启右上角「开发者模式」
2. 点「加载已解压的扩展程序」，选择解压出来的目录

图文步骤见 安装与使用教程。想从源码构建的看文末「开发」一节。

• 工具栏图标：点一下直接打开侧边栏（不再有中间弹窗）；与命令行桥接的连接状态看侧边栏顶部的状态圆点（绿=已连接 / 黄=连接中 / 灰=未连接，点开可复制 Profile）。
• 右键菜单：所有动作收在 LarkSnap 父菜单下——普通网页有整页/选区转 Markdown、整页截图、AI 总结、解除复制限制；飞书文档页另有「导出为 Markdown / PDF / HTML」。
• 键盘快捷键（可在 chrome://extensions/shortcuts 修改）：

右键/快捷键触发的动作结束后，扩展图标会出现绿 ✓ / 红 ! 角标；失败原因打开侧边栏即可查看。侧边栏本身是"当前页功能置顶 + 通用工具常驻"的布局：任何页面都能看到剪藏、截图、AI 总结、页面开关四组通用工具。

1. 浏览器里正常登录飞书 / Lark（公有云或私有化域名均可）。
2. 打开文档页（docx / wiki / sheet 等），点扩展图标打开侧边栏。
   • 私有化域名首次使用会提示授权，点一下按钮即可。
3. 在操作清单里点你要的动作：

即使租户关闭了官方导出，扩展也会自动切换到自解码通道完成导出（会先提示，请仅在获得授权的前提下使用）。

在任意网页打开侧边栏，或直接用页面右键菜单：

在支持的视频页打开侧边栏，点「下载当前视频」：扩展把页面地址交给本地 daemon，由本机的 yt-dlp 下载合并，落到 ~/Downloads/larksnap-video/，进度实时显示在侧边栏底部。

前提：装好 larksnap-fetch 技能（daemon 随技能分发，见下节）并跑过一次让 daemon 拉起， 本机装有 yt-dlp 和 ffmpeg（macOS：brew install yt-dlp ffmpeg）。

装好扩展后，再装一个技能，就能在 Claude Code 里贴飞书链接直接下载到本地：

npx skills add AmbroseX/larksnap --skill larksnap-fetch -g -a claude-code

一条命令搞定技能安装、依赖检查、daemon 常驻，不用先 clone 仓库——脚本只把技能取下来装好， 临时文件用完就删，本机不留源码副本（扩展本体照旧从商店或 Releases 装）。

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/AmbroseX/larksnap/main/install.sh | bash

Windows（PowerShell）：

irm https://raw.githubusercontent.com/AmbroseX/larksnap/main/install.ps1 | iex

它会做四件事：检查 Node 18+ → 把技能装到 ~/.claude/skills/larksnap-fetch → 检查 yt-dlp / ffmpeg（只有下载视频要用，缺了会问你装不装）→ 把 daemon 注册成登录自启的常驻服务， 最后打印装扩展的步骤。daemon 空闲 30 分钟会自退，常驻机制负责再拉起来：

已经 clone 过仓库就直接跑 ./install.sh（Windows 是 .\install.ps1），常用参数：

远程一键命令要带参数时这么写：

curl -fsSL https://raw.githubusercontent.com/AmbroseX/larksnap/main/install.sh | bash -s -- --yes

& ([scriptblock]::Create((irm https://raw.githubusercontent.com/AmbroseX/larksnap/main/install.ps1))) -Yes

装过之后想升级技能（扩展本体由浏览器自己更新），重跑一次带 --update 就行， 它会把技能换成最新版并重启 daemon：

curl -fsSL https://raw.githubusercontent.com/AmbroseX/larksnap/main/install.sh | bash -s -- --update

然后在 Claude Code 里说：

把 https://your-company.feishu.cn/docx/xxxxxxxx 下载到 ./docs

产物按文档标题独立成夹，图片以相对路径内联引用。前提：本机有 Node.js，且扩展已加载进 Chrome（登录态和导出引擎都在扩展里）。详见 skills/larksnap-fetch/SKILL.md。

技能里附带独立脚本，贴 arXiv 链接或裸 ID 就把三种格式一起下载，不需要浏览器扩展，也不需要 pandoc（转换器已打包在技能里）：

下载 https://arxiv.org/abs/2601.18226 到 ./papers

也可以直接跑命令：

node ~/.claude/skills/larksnap-fetch/scripts/arxiv.mjs 2601.18226 ./papers

• 链接和 ID 全兼容：裸 ID、arXiv: 前缀、abs / pdf / html 三种链接、老式 ID（math.GT/0309136）。
• 产物落在 ./papers/2601.18226/ 下：.pdf + .html（本地打开不裂图）+ .md（公式还原为 $...$，图片为 arxiv.org 外链）。
• 部分论文没有 HTML 版属正常，此时只落 PDF 并在输出里提示。

git clone https://github.com/AmbroseX/larksnap.git
cd larksnap
npm install
npm run build      # 生产构建 → dist/，按「安装」一节步骤加载 dist/ 目录
npm run dev        # 或 watch 构建，改代码自动重建
npm run typecheck  # 仅类型检查

工作原理、目录结构、CC 桥接协议、构建发布等技术细节见 docs/架构与技术细节.md，需求规格见 specs/。

• 内容不外发：文档内容、Cookie、登录态全程留在本地浏览器，无后端、不上报任何第三方。
• 匿名使用统计（可关闭）：默认向开发者自建的 Umami 上报功能使用次数与版本号，不含任何文档内容、地址或身份信息，可在设置页一键关闭，详见 PRIVACY.md。
• 权限最小化：私有化域名按需运行时授权，不预先索取全站权限；诊断包已剔除 PII 字段。
• 本工具仅供合法、获授权的文档导出与个人备份用途，请遵守所在组织的数据管理策略与飞书 / Lark 服务条款，滥用后果由使用者自行承担。

有问题、建议或想反馈 bug，欢迎扫码进群交流：

如果这个工具帮到了你，可以请作者喝杯咖啡 ☕：

独立实现，设计中参考了这些开源项目的思路：feishu2md、xiaoyaosearch-feishu-export-md、feishu-doc-helper、feishu-backup、feishu-doc-export、OpenCLI。

Apache License 2.0