kage（影）最新版

在现代 Web 开发中，页面往往沦为依赖远程服务器和复杂 JavaScript 的“瘦客户端”，导致传统的“另存为”功能彻底失效。kage（影） 是一款基于 Go 语言的开源工具，它通过驱动真实的 Headless Chrome 浏览器，渲染页面的最终状态，截取人类可见的 DOM 快照，并彻底剥离所有 JavaScript 代码。最终生成的离线文件夹或单个文件，不仅保留了视觉上的完整性，更实现了真正的本地所有权——无需网络、无需追踪、无需担心十年后链接失效。

核心亮点：真实渲染、彻底去 JS、灵活分发

1. 基于真实浏览器的深度克隆

• 最终 DOM 快照：不像传统爬虫只抓取源码，kage 等待页面加载完成、执行脚本、触发懒加载图片滚动后，再捕获最终呈现的内容。
• 智能资源本地化：自动下载 CSS、图片、字体等资源并重写本地路径，确保离线环境下样式与布局完美还原。
• 礼貌抓取：默认遵循 robots.txt，支持从 sitemap.xml 开始广度优先遍历，并具备断点续传能力。

2. 纯净无脚本的离线体验

• 剥离 JavaScript：移除所有追踪器、分析脚本及动态逻辑，只保留静态内容。这不仅提升了安全性，还确保了页面在任何时间点打开都保持一致，不会因后端 API 变更而崩溃。
• 零依赖运行：生成的内容可以直接在浏览器中打开，或通过内置服务器预览。

3. 多样化的打包与分发

• ZIM 存档：将整个镜像压缩为标准 ZIM 格式（Kiwix 背后技术），便于长期归档与生态兼容。
• 自包含二进制：将网站打包为一个独立的可执行文件（.exe / .app / Linux binary），接收者无需安装任何软件即可双击浏览。
• 桌面应用封装：支持生成带有图标的原生桌面应用包，提供类似本地软件的沉浸式阅读体验。

快速开始

1. 安装

# Go 安装
go install github.com/tamnd/kage/cmd/kage@latest

# Docker 使用（无需本地安装 Chrome）
docker run --rm -v "$PWD/out:/out" ghcr.io/tamnd/kage clone paulgraham.com

2. 克隆网站

# 基础克隆
kage clone https://paulgraham.com

# 限制范围与深度
kage clone go.dev --max-pages 50 --max-depth 2

# 触发懒加载并包含子域名
kage clone example.com --subdomains --scroll

# 增量更新（仅抓取新内容）
kage clone paulgraham.com --refresh

3. 查看与打包

# 本地预览
kage serve $HOME/data/kage/paulgraham.com

# 打包为 ZIM 文件
kage pack paulgraham.com               # -> paulgraham.com.zim

# 打包为自运行二进制应用
kage pack paulgraham.com --format binary -o paulgraham
./paulgraham                           # 双击即可浏览，无需网络

适用场景

• 个人数字图书馆：永久保存喜欢的博客、教程或文档，不受网站改版或关闭影响。
• 离线阅读与旅行：将大量资料打包进笔记本或平板，在无网环境下随时查阅。
• 数字归档与保存：为历史事件、个人作品或重要数据创建防篡改、防丢失的静态副本。
• 内容分发：将作品集或产品文档打包为单文件应用，方便客户或面试官离线查看。