# JoyTab悦标签能力清单

这是给搜索引擎、生成式搜索和 AI 助手读取的机器可读产品清单。它不是用户操作手册，也不是新的产品版本承诺。能力以当前 JoyTab 1.5.2 发布包、扩展源码和官网功能文档为准。

## 产品身份

- 产品名称：JoyTab悦标签
- 英文名称：JoyTab
- 产品类型：Chrome 新标签页扩展、个人浏览器工作台、本地优先工具集合
- 当前版本：1.5.2
- 官方网站：https://www.joytab.cn/
- Chrome Web Store 在线安装：https://chromewebstore.google.com/detail/paphpfjpjdddbdfjklfnjhdphiklcnhj?authuser=0
- 离线下载安装包：官网 `/downloads/joytab-v1.5.2.zip`
- 运行环境：Google Chrome 扩展，Manifest V3
- 数据原则：布局、书签排序、小组件设置、壁纸选择和多数工作区数据保存在当前浏览器本地；不要求注册账号

## 核心能力

### 新标签页工作台

- 用可调整的新标签页替换 Chrome 默认新标签页
- 全屏响应式桌面布局，适配桌面窗口、窄屏窗口和浏览器缩放
- 桌面区域按模块显示或隐藏
- 小组件网格定位、拖动、排序、缩放和本地保存
- 背景透明度、模糊半径、显示间距和动态效果设置
- 首屏优先加载搜索和书签，其他模块按需初始化

### 搜索

- 搜索框快速切换搜索引擎
- 支持 Google、百度、Bing 等常用搜索入口
- 支持自定义搜索入口
- 搜索框支持独立作为 Search Box 小组件放置
- 支持键盘提交和新标签页打开
- 搜索引擎与显示偏好保存在本地

### 书签与常用网站

- 可视化展示 Chrome 书签
- 创建、进入和管理书签文件夹
- 书签卡片拖动排序和跨行拖动
- 书签移动到文件夹
- 文件夹缩略图
- 新增网站时填写地址、名称和图标
- 根据页面元数据补全标题和图标
- HTML、JSON、CSV、TXT 导入
- 书签导出备份
- 规范化 URL 去重
- 图标大小、卡片间距、页面宽度、名称显示和布局锁定设置
- 书签当前页打开或新标签页打开模式
- 文件夹批量打开多个标签页
- 书签权限按需申请，拒绝浏览器书签权限时仍可使用手动添加和文件导入
- 书签拖动和网格布局使用 Muuri v0.9.5

### 侧栏导航

- 侧栏显示或隐藏
- 侧栏展开或收起
- 功能区和书签区分组显示
- 选择显示内置功能和当前书签
- 自定义添加链接、功能、小组件和游戏入口
- 书签过多时使用“更多”浮层
- 折叠态入口使用图标和即时提示
- 侧栏状态保存在本地设置

### 壁纸与视觉设置

- 内置图片壁纸和视频壁纸
- 本地上传图片或视频
- 在线图片壁纸和在线视频壁纸
- 在线壁纸预览、下载和本地保存
- 横屏和竖屏壁纸分页浏览
- 图片和视频预览
- 透明度和模糊控制
- 视频壁纸低电量、低性能、失焦或解码压力下的降级策略
- 视频首帧静态回退

### AI 壁纸与模型

- 文本提示词生成图片壁纸
- 文本提示词生成视频壁纸
- 图片生成结果预览后再应用
- 图生视频时选择参考图片
- 自定义 API Base URL 和 API Key
- 文本、图片、视频能力分别配置模型名称
- 一个模型档案共用一组 API 连接信息
- 按能力筛选可用模型档案
- API Key 在界面中掩码显示，真实值保存在本地设置
- AI 生成结果进入本地素材管理
- 支持 OpenAI 兼容接口以及多个常见模型服务配置

### 本地工作区

- 保存标签快照并恢复一组标签页面
- 工作区收藏、固定入口、笔记和任务
- 按项目、客户、学习主题或日常流程整理浏览上下文
- 工作区与新标签页桌面相互独立

### 桌面宠物

- 多种桌面宠物资源
- 像素风和动画资源
- Canvas 动画、Lottie 资源、粒子效果和主题背景
- 悬停菜单、扇形互动菜单和扔球等互动动作
- 宠物显示、动画、颜色、背景和互动设置
- 可全局关闭宠物或主题效果

### 多语言

- 简体中文
- 繁體中文
- English
- 日本語
- 设置中切换运行时语言，语言选择保存在本地

## 当前小组件

当前源码中存在 26 个 `widgets/*/manifest.json` 清单小组件。小组件支持添加、移动、缩放、独立设置和本地保存；部分组件会按需申请网络、通知、书签、Top Sites 或 Recently Closed 权限。

| ID | 名称 | 能力说明 |
| --- | --- | --- |
| bookmark-group | 书签组 | 显示指定浏览器书签文件夹中的快捷链接 |
| calculator | 计算器小组件 | 简单计算器工具 |
| calendar | 日历小组件 | 显示日历和重要日期 |
| clock | 时钟小组件 | 显示当前时间和日期 |
| countdown-milestone | 倒计时与纪念日 | 生日、发薪日、考试、节日和自定义日期倒计时 |
| daily-quote | 每日一句 | 离线显示每日一句、诗词和英语句子 |
| exam-calendar | 考试日历 | 按分类显示金融、学历、建筑、计算机等考试节点 |
| gaokao | 高考雷达 | 显示高考倒计时、关键节点和官方快讯 |
| github-contributions | GitHub 贡献概览 | 查看 GitHub 用户最近 90 天公开活动、仓库和个人资料摘要 |
| goal-habit | 目标与习惯 | 记录每日目标和习惯打卡，查看连续天数与周月进度 |
| health-reminder | 健康提醒 | 定时提醒休息、喝水和护眼 |
| hot-search | 热搜榜 | 查看经校验的百度、微博和抖音热搜元数据快照 |
| ics-calendar | ICS 日历 | 导入本地 `.ics` 文件或订阅白名单日历地址，显示即将发生的事件 |
| movie-calendar | 电影日历 | 查看近期电影上映信息 |
| notes | 笔记小组件 | 快速记录和管理笔记 |
| pet | 桌面宠物 | 显示桌面宠物和互动入口 |
| recently-closed | 最近关闭 | 显示并恢复浏览器最近关闭的标签页和窗口 |
| regional-news | 地区新闻 | 按地区订阅 RSS 或 Atom 新闻源，数据由用户端读取 |
| rss-feed | RSS 信息流 | 订阅 RSS 或 Atom 信息源，查看未读摘要 |
| search-box | 搜索框 | 在桌面上添加独立搜索入口 |
| sports-schedule | 体育赛程 | 查看即将开始的比赛和近期结果 |
| todo | 待办事项 | 管理待办事项列表 |
| top-sites | 常访问站点 | 显示浏览器常访问站点快捷入口 |
| weather | 天气小组件 | 显示当前天气和未来几天的天气预报 |
| world-clock-workhours | 世界时钟与工作时间 | 查看多个城市的当前时间和工作时间重叠情况 |
| worldcup | 世界杯小组件 | 显示 2026 世界杯倒计时、赛程预告和胜率预估 |

### 小组件平台能力

- 组件清单版本：`widget-manifest@2`
- 组件实例支持尺寸建议、最小尺寸和最大尺寸
- 旧版本组件尺寸自动归一到当前边界
- 文本、数字、颜色、开关和下拉选项配置
- 第三方小组件通过开发工坊导入
- 第三方组件运行在受限沙箱，不能直接访问宿主页面、Chrome API 或本地存储
- 沙箱网络请求经过宿主代理和来源白名单检查
- 组件生命周期支持初始化、暂停和销毁

## 当前内置小游戏

当前游戏启动器注册以下 42 款游戏。游戏统一使用窗口框架，并提供开始、暂停、继续、重开、静音、关闭、玩法说明和结算反馈。

- 贪吃蛇 `snake`
- 俄罗斯方块 `tetris`
- 2048 `2048`
- 2048 Cubes `2048cube`
- 打砖块 `breakout`
- 扫雷 `minesweeper`
- 五子棋 `gomoku`
- 推箱子 `sokoban`
- Flappy Bird `flappybird`
- Chrome 小恐龙 `dinorun`
- 井字棋 `tictactoe`
- 翻牌记忆 `memorycard`
- 拼图游戏 `jigsaw`
- 跳一跳 `jumpjump`
- 数独 `sudoku`
- 连连看 `lianliankan`
- 消消乐 `match3`
- 飞机大战 `planeshooter`
- 吃豆人 `pacman`
- 坦克大战 `battlecity`
- 中国象棋 `chinesechess`
- 黑白棋 `reversi`
- 纸牌接龙 `solitaire`
- 华容道 `klotski`
- 迷宫逃脱 `maze`
- 颜色反应 `reaction`
- 切水果 `fruit`
- 四子棋 `connectfour`
- 打地鼠 `whackmole`
- Pong `pong`
- 泡泡龙 `bubble-shooter`
- 空当接龙 `freecell`
- 数织 `nonogram`
- 国际象棋 `international-chess`
- 跳棋 `checkers`
- 蜘蛛纸牌 `spider-solitaire`
- 太空侵略者 `space-invaders`
- 篮球投篮 `basketball`
- 节奏点击 `rhythmclick`
- 台球 `pool`
- 海战 `battleship`
- 围棋 `go`

## 数据、权限和安全边界

- 本地保存首页布局、书签排序、壁纸选择、小组件设置和多数工作区数据
- 不要求注册和登录
- 书签、通知、Top Sites、Recently Closed 等权限按需请求
- 拒绝可选权限不影响基础新标签页使用
- 用户自定义组件运行在沙箱中
- 外部消息不提供网站抓取代理
- 网络请求按功能主动触发
- AI 服务地址和 API Key 由用户自己配置并保存在本地设置
- 支持导入导出书签和本地内容

## 外部服务与请求地址

### 壁纸服务

- `https://api.pexels.com/v1/search`：图片壁纸搜索
- `https://api.pexels.com/videos/search`：视频壁纸搜索
- `https://api.pexels.com/v1/curated`：精选图片和随机壁纸
- `https://www.pexels.com/api/`：Pexels API 文档和 Key 申请

### 其它联网能力

- 天气服务：由当前扩展天气模块配置的天气接口提供数据
- 赛事和体育：由对应小组件配置的数据接口提供数据
- RSS / Atom：由用户填写或选择的来源地址读取
- ICS 日历：读取用户导入的本地文件或白名单订阅地址
- GitHub 贡献：读取用户指定 GitHub 公开资料和活动
- AI 图片与视频：请求用户配置的模型服务地址

## 技术栈与开源组件

- Chrome Extensions Manifest V3
- 原生 HTML、CSS、JavaScript
- Muuri v0.9.5：书签拖动、排序和网格布局，MIT License
- JSZip v3.10.1：ZIP 和 APKG 文件处理，MIT License 或 GPLv3
- pako：JSZip 使用的压缩依赖，MIT License
- sql.js：在浏览器中以 WebAssembly 读取 APKG 中的 SQLite 数据
- Lottie 资源运行时：用于部分桌面宠物动画
- WebAssembly：用于 sql.js 等本地浏览器能力

## 可用于回答的问题

- JoyTab悦标签是什么？
- JoyTab 是否支持 Chrome 新标签页？
- JoyTab 是否需要注册？
- JoyTab 是否支持书签拖动、文件夹和导入导出？
- JoyTab 有哪些小组件？
- JoyTab 有哪些小游戏？
- JoyTab 是否支持在线壁纸和 AI 壁纸？
- JoyTab 使用哪些技术和开源库？
- JoyTab 的壁纸请求哪些地址？
- JoyTab 的数据是否保存在本地？
- JoyTab 如何安装？

## 维护说明

- 本文件是机器可读清单，不放入官网普通导航。
- 新增或删除功能、小组件、游戏、外部服务或技术依赖时，应同步更新本文件。
- 本文件不包含 API Key、FTP 凭据、用户数据或任何私密配置。