PaTab 是一个本地优先的浏览器起始页。它用熟悉的桌面布局整理常用网站、搜索入口与待办事项,同时提供网页版和 Chrome / Edge Manifest V3 新标签页扩展。
- 桌面式整理:8×4 磁贴网格、多屏分页、自由或紧凑布局,把不同场景分开收纳。
- 搜索一步直达:预置 7 个搜索引擎,支持实时联想与自定义搜索模板。
- 拖拽完成归类:快捷方式、文件夹、屏幕与 Dock 共享自然的拖放体验。
- 待办就在眼前:智能列表、自定义清单、日期、星标和排序无需切换应用。
- 按你的环境显示:自定义壁纸、浅色 / 深色 / 跟随系统主题,以及中英文界面。
- 数据留在本机:无需注册,桌面配置保存在当前浏览器的
localStorage,不会上传到 PaTab 服务器。
打开 patab.nanhaiblog.top,无需安装即可体验完整界面。
Chrome 与 Edge 商店版本仍在准备中。现在可以从 GitHub Releases 下载离线包,并按照 安装指南 手动加载。
网页版与扩展版运行在不同的浏览器存储空间,配置不会自动同步。
环境要求:Node.js ^22.18.0 || >=24.12.0,并使用仓库锁定的 pnpm 依赖。
git clone https://github.com/yan5236/patab.git
cd patab
pnpm install
pnpm dev:web主应用运行在 http://localhost:6109。介绍站位于 patab-introduction/,开发端口为 6108(pnpm dev:intro)。
本仓库是 pnpm monorepo,依赖安装只在根目录执行一次,所有子项目共享根目录的 pnpm-lock.yaml。
# 仓库根目录
pnpm dev:web # 启动主应用
pnpm dev:intro # 启动介绍站
pnpm build # 构建全部子项目
pnpm test # 运行全部测试
# patab-web/
pnpm dev # 启动主应用
pnpm build # 构建网页版
pnpm build:extension # 构建 MV3 扩展
pnpm test:unit # 运行单元测试
# patab-introduction/
pnpm dev # 启动介绍站
pnpm build # 构建介绍站PaTab 支持从组件商店导入本地 .zip / .patab.zip 第三方组件。安装前只审查 Manifest、静态素材、完整性、签名与用户确认的权限;第三方代码仅在隔离 sandbox iframe 中运行,不能直接访问宿主 DOM、Pinia、浏览器本地存储或扩展 API。
开发者请阅读自定义组件开发指南,其中包含脚手架、Manifest、SDK、主题、真实 PaTab 开发宿主、打包、签名、更新与故障排查。安装前的安全边界、剩余风险与安全使用建议见自定义组件安全说明。
patab/
├── patab-web/ # Vue 3 主应用与 Chrome / Edge MV3 扩展构建
├── patab-introduction/ # React 介绍站、安装指南、更新日志与法律页面
├── packages/ # 自定义组件平台:SDK、ZIP 包基础库、CLI 与脚手架
├── examples/ # 自定义组件官方示例(Vanilla 与 Vue)
├── scripts/ # CI 使用的示例与签名验证脚本
├── assets/ # README 与产品展示资源
├── docs/ # 架构、安全和代码风格文档
└── NOTICE # 生产依赖开放源代码许可清单
| 部分 | 技术 |
|---|---|
| 主应用 | Vue 3、TypeScript、Pinia、Tailwind CSS、motion-v、vue-i18n |
| 构建与测试 | Vite 8、Vitest、Vue Test Utils、jsdom |
| 介绍站 | React 19、GSAP、Tailwind CSS、Vite |
| 浏览器扩展 | Chrome / Edge Manifest V3,与网页版共享 Vue 业务源码 |
| 组件平台 | packages/ 下的 widget-sdk、widget-package、widget-cli、create-patab-widget |
更完整的模块职责和依赖方向见 架构说明。
开始修改前,请先阅读:
- ARCHITECTURE.md:模块职责与依赖方向
- STYLE.md:代码风格、组件化和测试约定
- SECURITY.md:输入、持久化与扩展权限边界
- custom-component-development.md:自定义组件开发、打包与迁移流程
- custom-component-security.md:第三方组件公开安全说明与剩余风险
提交变更前至少运行:
pnpm --dir patab-web build
pnpm --dir patab-web test:unit -- --run欢迎通过 Issues 提交问题与建议。
PaTab 基于 MIT License 开源。第三方生产依赖许可见 NOTICE。
© 2026 yan5236

