Teddy9710/smartpages
Teddy9710/smartpages has 71 GitHub stars and 1 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 19:28 UTC. Last push 2026-11-12.
可以做什么
- 🧭 User guides Record a product workflow and turn it into a clear, step-by-step guide. - 🧪 Test cases Capture a browser flow and generate structured QA documentation. - 🐞 Bug reports Reproduce an issue once and preserve every action and screenshot.
实测星标增长
- 24小时
- 0
- 7天
- 更新延迟
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
a scribe-like FREE chrome plugin working on AI generating manual
开发工具README.zh-CN.md
原文
SmartPages
把浏览器操作流程变成专业文档
只需录制一次点击和截图,即可使用你选择的 AI 模型生成可编辑的
用户指南、教程、测试用例和 Bug 报告。
下载稳定版 · 从源码构建 · 示例文档 · 项目文档 · English
录制 → 生成 → 优化 → 导出
SmartPages 能生成什么?
🧭 用户指南录制一次产品操作,自动整理成清晰的分步指南。 |
🧪 测试用例捕获真实浏览器流程,生成结构化的 QA 文档。 |
🐞 Bug 报告复现一次问题,完整保留每一步操作和截图。 |
SmartPages 省去文档工作中最耗时的部分:操作完成后,再重新整理每一个步骤、截图和说明。
它如何工作
- 录制——正常完成网页操作,SmartPages 自动捕获动作和步骤截图。
- 生成——选择文档目标,使用 GPT、Gemini、Claude、DeepSeek 或其他兼容模型生成初稿。
- 交付——直接编辑或继续优化,然后按需要保存、复制或导出。
快速开始
如需稳定、可直接安装的插件版本,请从 GitHub Releases 下载最新安装包;开发 SmartPages 或体验最新改动时再从源码构建。
1. 构建扩展
git clone https://github.com/Teddy9710/smartpages.git
cd smartpages
npm install
npm run build
2. 加载到 Chrome 或 Edge
- 打开
chrome://extensions/或edge://extensions/。 - 开启开发者模式。
- 点击加载已解压的扩展程序,选择项目中的
dist/目录。
3. 生成第一份文档
- 打开 SmartPages 设置页并配置模型服务商。
- 进入需要记录的网页并开始录制。
- 完成操作、停止录制,然后选择文档目标。
- 在侧边栏中生成、编辑并导出结果。
修改源码后,请重新运行
npm run build并在扩展管理页重新加载。不要直接加载源码根目录。
看看实际效果
核心能力
1.4.0 新增
使用已配置的视觉模型识别扫描版 PDF,文本型 PDF 继续在本地提取。
在文档列表中直接预览内容,不额外保存缩略图图片。
使用自定义分类整理参考文档,并按分类筛选。
通过系统分享面板分享提取后的正文,不支持时自动复制到剪贴板。
**记录真实操作:**捕获点击、输入、SPA 页面跳转、内嵌 frame 交互和步骤截图,并可随时暂停和继续。
**按目标生成:**内置用户指南、教程、测试用例和 Bug 报告等目标,也支持完全自定义提示词。
**控制文档输出:**应用风格指南和示例,选择 Markdown 或 HTML,并配置最大 Token。
**使用参考文档:**上传 TXT、Markdown、HTML、RTF、PDF 或 DOCX;支持扫描版 PDF OCR、内容预览、分类筛选和正文分享。
**交付前继续编辑:**编辑渲染后的文档或 Markdown 源码;可裁剪截图、添加框选、编号、模糊和文字标注,并使用 AI 二次优化。
**导出到不同场景:**复制或导出为 Markdown、HTML、纯文本、Word、ZIP、图片和 PDF。
**保留文档历史:**保存到授权的本地文件夹,也可选择配置 Supabase 云同步。
模型支持
SmartPages 支持:
- **OpenAI-compatible Chat Completions:**OpenAI、Gemini、GLM、DeepSeek、MiniMax、Kimi、OpenRouter、SiliconFlow、DashScope,以及自定义兼容服务。
- **Anthropic Messages API:**通过 Anthropic 使用 Claude 模型。
服务商、Base URL、模型和 API Key 均由你选择,对应服务的限制和费用也由你掌控。每个服务商会独立保存自己的连接配置;API Key 默认保存在当前浏览器的扩展数据中,扩展重载或浏览器重启后仍可使用。
默认保护隐私
- SmartPages 不会把 API Key 提交到代码仓库或同步到云端。开启“在此设备上记住 API Key”时会保存到当前浏览器配置;关闭后则仅保留在会话存储中,完全退出浏览器后清除。
- 录制内容只在生成文档时发送到你配置的模型 API。
- 只有显式启用“模型支持图片输入”后,步骤截图才会发送给多模态模型;已隐藏的截图不会发送,每次请求最多附带 12 张。
- 上传的文档会尽可能在本地解析;只有显式开启 AI OCR 后,扫描版 PDF 页面才会发送到你配置的视觉模型,每份文档最多 12 页。
- Supabase 同步默认关闭,只有完成配置、登录并主动保存后才会上传。
- 本地历史只能访问你通过浏览器目录选择器明确授权的文件夹。
- 动态 HTML 在渲染和导出前会经过清理,扩展页面使用 Manifest V3 CSP。
即使生成提示词会要求遮蔽敏感信息,录制时仍应避开密码、Token、证件号等内容。
高级工作流
SmartPages 还可以导出机器可读的 .smartpages.json 工作流,在安全检查下进行本地回放,并通过实验性的 MCP Bridge 将经过批准的工作流提供给本地 Agent。
项目文档
开发与贡献
npm run dev # watch 模式构建 dist/
npm test # 运行测试
npm run lint # ESLint 检查
npm run typecheck # TypeScript 类型检查
npm run build # 生成可加载的 dist/
npm run verify # 运行完整验证
欢迎提交 Issue 和 Pull Request。贡献前请阅读中文贡献指南或English contributing guide。
许可证
SmartPages 采用双许可证模式:
| 使用场景 | 许可证 | 说明 |
|---|---|---|
| 个人、学习、非商业用途 | GPL v3 | 可免费使用、修改和分发;衍生作品需继续开源 |
| 商业用途 | 商业许可证 | 集成到商业产品、SaaS 或企业部署前需另行获得授权 |
版权所有者(汪鸿儒 / Hongru Wang)保留所有商业权利。商业授权咨询请通过 GitHub Issues 联系作者。