一览

Last updated: 2026-06-08

语言：中文 | English

官网：https://yilan.app GitHub：https://github.com/mutuyihao/yilan 社区讨论：https://discord.gg/MWWDwXZ2TV

一览是一个基于 Manifest V3 的 Chromium 扩展，用来在浏览器里完成“抽取网页/视频来源 -> 生成摘要 -> 继续加工 -> 本地沉淀 -> 专注阅读”这一整条链路。

当前版本已经不是单一的摘要工具，而是一个本地优先的网页阅读工作台：

• 自动抽取网页正文、标题、作者、发布时间和站点信息。
• 支持 YouTube 视频页：优先使用可用字幕和翻译字幕，必要时通过页面播放器信息、watch HTML、InnerTube 和元信息回退恢复摘要来源，并在字幕可用时支持导出字幕。
• 支持 Bilibili 视频页：识别视频元信息，按“B 站官方 AI 总结 -> 可用字幕 -> 标题/简介等页面信息”的顺序构建摘要来源，并在字幕可用时支持导出字幕。
• 识别页面类型，并按页面类型推荐摘要策略。
• 支持 简短总结、标准总结、详细分析、关键要点 四种主摘要模式。
• 支持 行动项、术语表、问答卡片 三种二次生成模式。
• 在侧栏中查看来源信息、可信与控制状态、历史与收藏、基础诊断。
• 入口可优先复用当前页面的历史摘要，命中后直接展示旧结果，并保留“重新生成”更新当前页。
• 在同一页面的 SPA 路由切换中，侧栏会刷新页面上下文，但默认不会自动发起新的模型请求。
• 支持把当前摘要打开到独立的新标签页阅读器，并根据 Markdown 标题生成文档导航。
• 支持复制当前摘要、Markdown 导出和带来源链接的长截图分享卡。
• 设置页支持厂商预设、显式或自动 Endpoint Mode、OpenAI 兼容接口的模型列表刷新、明暗模式、四套色彩方案、入口状态检查，并且默认自动保存。
• 当前测试基线已经分成 Node 功能矩阵 + 静态契约 与 Playwright 浏览器主链路 两层，用来给后续重构和技术债治理兜底。

当前边界

• 项目是 本地优先 + BYOK 形态，没有内建账号体系或云同步。
• 无痕模式只控制“是否写入本地历史”，不会阻止页面内容、视频元信息或字幕被发送到你配置的模型服务。
• YouTube 总结目前面向 youtube.com/watch、youtube.com/shorts/...、youtube.com/embed/...、youtube.com/live/... 和 youtu.be/... 视频页；播放列表、频道页、搜索页、社区页等其他 YouTube 页面不属于稳定视频摘要范围。
• 在 YouTube 视频页，一览会尝试从页面读取播放器响应，并可能从浏览器请求 YouTube watch、player 和 caption 相关端点来定位字幕、翻译字幕或元信息。字幕来源可用时会作为摘要主来源；如果只剩标题、频道、时长和简介等元信息，结果会降级为视频信息概要。
• YouTube 字幕、翻译字幕、播放器响应和 InnerTube 回退依赖 YouTube 页面与接口可用性；接口变更、地区限制、登录态差异、视频未开放字幕或字幕请求失败时，结果可能降级、失败或只能基于元信息生成。
• Bilibili 总结目前只面向 bilibili.com/video/BV... 视频页；番剧、直播、专栏、动态、收藏夹、搜索页等其他 B 站页面不属于稳定支持范围。
• 在 Bilibili 视频页，一览会从浏览器请求 B 站的视频信息、官方 AI 总结、播放器和字幕接口。如果官方 AI 总结可用，主摘要可以直接使用该结果，不再额外请求你配置的模型服务；如果需要走字幕或页面信息回退，相关文本可能会发送给你配置的模型服务。
• Bilibili 官方 AI 总结、字幕、分 P 信息和登录态依赖 B 站页面与接口可用性；接口变更、权限限制、地区限制、未登录或视频未提供字幕时，结果可能降级、失败或只能基于标题/简介生成。
• 一览不是 YouTube 或 Bilibili 官方产品，也不代表相关平台对本扩展的授权、背书或保证。摘要和导出的字幕只用于个人阅读辅助，不应视为官方转写、完整内容替代或事实准确性保证；请遵守视频版权、平台规则和原作者权益。
• 历史只保存在当前浏览器 profile 的 IndexedDB 中。
• 扩展目前面向 Chromium 浏览器，使用右键菜单和 Alt + S 作为主要入口。

快速开始

1. 加载扩展

1. 打开 Chrome、Edge 或其他 Chromium 浏览器。
2. 进入扩展管理页。
3. 打开“开发者模式”。
4. 选择“加载已解压的扩展程序”。
5. 选择当前项目目录。

2. 配置模型

1. 点击扩展图标打开设置页。 2.（可选）创建 配置方案，保存多套连接配置并快速切换。
2. 在 连接 标签中选择 Provider 服务商。
3. 确认推荐 Base URL；多地址服务商可点“更改地址”切换。
4. 填写 API Key，按需覆盖 模型名称。
5. 等待自动保存完成后点击“测试连接”。

说明：

• 设置页默认自动保存，不需要先手动点击保存。
• 文本输入项会在停顿后保存，blur 时也会立即保存。
• 下拉框和开关会立即保存。
• Base URL 默认来自本地 provider catalog；需要代理、私有网关或多地址套餐时可更改。
• Provider / Endpoint Mode 已收进“高级兼容设置”；自定义兼容接口默认展开高级项。连接测试可能缓存可用 endpoint mode，并在网关错误足够明确时自动补齐或去除 /v1。
• 可在设置页为 OpenAI 兼容接口刷新模型列表（需要先填写 API Key）。Anthropic 兼容接口目前仍手动填写模型 ID。
• 内置厂商预设目前包含自定义兼容接口、OpenAI 官方、Anthropic 官方、DeepSeek、Gemini / Google、xAI / Grok、Qwen / 百炼、GLM / 智谱、MiniMax、Doubao / 火山方舟、Hunyuan / 腾讯混元。

3. 使用扩展

1. 打开任意网页。
2. 右键页面选择“用一览总结此页”，或按 Alt + S。
3. 侧栏打开后，会先按入口配置检查是否复用当前页面的历史摘要；命中时直接显示最近一次已完成结果，否则再自动开始生成，或只打开侧栏等待手动触发。
4. 在侧栏中查看摘要、继续生成行动项/术语表/问答卡片、导出可用的 YouTube 或 B 站字幕、管理历史与收藏。
5. 如需更舒服地阅读，点击顶部“阅读”按钮，在新标签页打开专注阅读页面。

开发与验证

最常用的验证入口：

npm test
npm run typecheck
npm run test:e2e

首次运行浏览器端测试前，通常需要先安装 Chromium：

npm run playwright:install

如果 Windows PowerShell 拦截 npm.ps1，可改用：

npm.cmd test
npm.cmd run typecheck
npm.cmd run test:e2e
npm.cmd run playwright:install
node tests/run-tests.js

更详细的覆盖口径、测试分层和新增功能要求见 测试体系。开发流程、手工回归和文档维护规则见 开发者指南。

发版打包

当前正式版门禁：

npm.cmd run typecheck
npm.cmd test
npm.cmd run test:e2e
npm.cmd run package:release

npm.cmd run package:release 会在 release/ 下生成只包含扩展运行文件的发布包，排除测试、Playwright 产物、私有目录、依赖目录和源码文档。发布前按 1.3.0 发版清单 和 Chrome Web Store 文案 检查。

目录结构

.
├─ adapters/                  # Provider 适配层
├─ docs/                      # 文档索引、用户/架构/测试/开发/规划草案
├─ e2e/                       # Playwright 浏览器端测试与扩展 harness
├─ icon/                      # 扩展图标
├─ landing-page/              # 官网静态页
├─ libs/                      # 第三方库
│  ├─ readability.js          # vendored 的 Readability，用于正文抽取
│  ├─ purify.min.js           # DOMPurify，用于净化 Markdown 渲染后的 HTML
│  ├─ marked.min.js           # Marked，用于 Markdown -> HTML 渲染
│  ├─ highlight.min.js        # highlight.js，用于代码块高亮
│  ├─ github-dark.min.css     # Markdown / 代码块高亮样式
│  └─ html2canvas.min.js      # 用于生成长截图分享卡
├─ shared/                    # 领域工具、页面策略、YouTube/Bilibili 来源抽取、可信策略、主题、传输工具、厂商 preset
├─ tests/                     # Node 功能矩阵、单元测试、静态契约
├─ background.js              # 后台编排、连接检查、模型列表、入口状态、运行控制、reader 会话
├─ content.js                 # 页面抽取与侧栏注入
├─ db.js                      # IndexedDB 历史存储与迁移
├─ manifest.json              # 扩展清单
├─ playwright.config.js       # Playwright 配置
├─ popup.html / popup.js      # 设置页、标签切换、自动保存、入口检查
├─ reader.html / reader.js    # 独立阅读页
├─ sidebar.html / sidebar.js  # 侧栏工作流、历史、分享、诊断
└─ style.css                  # 侧栏样式

文档

• 文档索引
• 用户文档
• 技术架构
• 测试体系
• 开发者指南
• 1.3.0 发版清单
• Chrome Web Store 文案
• 隐私政策
• 设计系统
• 升级设计（draft）
• TypeScript + React 迁移设计（draft）
• 协作与贡献
• 更新日志

反馈

正式版问题请优先通过 GitHub Issues 反馈：https://github.com/mutuyihao/yilan/issues。社区讨论入口：https://discord.gg/MWWDwXZ2TV。

License

• 本项目原创代码与文档采用 Apache-2.0，详见 LICENSE。
• libs/ 下随仓库分发的第三方库继续沿用各自上游许可证，详见 THIRD_PARTY_NOTICES.md。
• 如果第三方文件头部声明与本说明存在差异，以该第三方文件内保留的声明和其上游许可证文本为准。

致谢

本项目开发过程中获得了 LINUX DO 社区佬友的帮助，本产品会在社区发布，感谢社区的支持。