指南
rezero.md 使用指南
rezero.md 能把任意公开网站转换成基于证据的 Markdown 文档，供你的 AI 编程助手直接阅读。它完全在终端中运行——无需浏览器扩展、无需账号、无需安装。
开始之前
- Node.js 22 或更高版本（用 node -v 检查）。
- 在项目文件夹中打开的终端。
- 开始时无需账号，也无需 API 密钥。
快速上手
只需一条命令。npx 会在首次运行时自动下载包，无需预先安装。
1. 分析一个网站
指向任意公开 URL。它会抓取公开页面，并在当前文件夹的 .rezero/<domain>/ 中写入 8 个 Markdown 文档。
$ npx rezero-md analyze https://linear.app2. 或用 init 为你的助手生成配套文件
init 会执行相同的分析，并额外在项目根目录写入助手上下文文件（CLAUDE.md、AGENTS.md、.cursor 规则等），让 AI 工具自动识别。
$ npx rezero-md init https://linear.app你会得到什么
.rezero/<domain>/ 中会生成 8 个基于证据的文档，每个都将观察、推断与建议分开呈现:
init 会在项目根目录添加助手就绪的上下文文件，让编程工具无需配置即可读取:
工作原理
每个文档都遵循同一个诚实原则——证据先于观点。它是为了学习一个产品是如何构建的，而绝不是为了克隆它。
观察 (Observe)
公开的元数据、结构、链接、界面 token 与技术特征——只取页面实际提供的内容。
推断 (Infer)
带有可见置信度的谨慎假设，明确标注为猜测而非事实。
建议 (Recommend)
可迁移的指导，帮你把某个模式适配到自己的产品，而不是照搬原作。
在你的 AI 工具中使用
产出是仓库中的纯 Markdown，任何助手都能读取。常见工具的用法:
Claude Code
自动识别。Claude Code 会读取仓库根目录的 CLAUDE.md 和 AGENTS.md。在该文件夹运行 claude，并让它使用 rezero.md 参考资料。
Cursor
自动识别。生成的 .cursor/rules/rezero.mdc 会引导 Cursor 的建议。你也可以在聊天中用 @ 引用 .rezero/ 内的文件。
Codex CLI
自动读取 AGENTS.md。在文件夹中运行 codex，或指向 .rezero/<domain>/ 中的文档。
Gemini CLI
在提示词中引用生成的 Markdown——例如“把 .rezero/<domain>/ 里的文件当作设计上下文”。
其他任意助手
Windsurf、Cline、Continue 等：全部是 .rezero/ 中的纯 Markdown，把这些文件加入工具上下文即可。
完整 AI 生成（可选）
没有密钥时，rezero.md 会写入确定性的初始文档，让你立刻看到结构。若需完整的 AI 撰写分析，请设置 GEMINI_API_KEY（或 OPENAI_API_KEY）。你的密钥和文件都只留在本机。
$ export GEMINI_API_KEY=your_key_here$ npx rezero-md init https://linear.app故障排查
命令没有反应或提示 “not found”。
先用 node -v 确认 Node.js 22 以上，再运行 npx rezero-md analyze <url>。npx 会在首次运行时下载包，无需全局安装。
文档看起来很单薄或很笼统。
这是无密钥时的初始产出。若需完整分析，请设置 GEMINI_API_KEY（或 OPENAI_API_KEY），或浏览已完整生成的资料库。
出现 “No public HTML pages could be fetched.”。
目标必须是允许抓取的公开页面。请使用网站的公开落地页 URL，并确认它没有登录墙、也不屏蔽爬虫。
文件生成在哪里？
在你运行命令的文件夹下的 .rezero/<domain>/ 中；使用 init 时还会生成 CLAUDE.md、AGENTS.md 等上下文文件。
想亲自试试？
浏览已分析的产品，或用一条命令生成你自己的。