Star Stream

简介 / Introduction

Star Stream 是一个美观的 Chrome 浏览器扩展，为用户提供个性化的书签新标签页体验。它允许用户以网格或列表视图查看书签，管理待办事项，并自定义新标签页的外观。

Star Stream is a beautiful Chrome browser extension that provides users with a personalized bookmark new tab page experience. It allows users to view bookmarks in grid or list views, manage to-do lists, and customize the appearance of the new tab page.

功能特性 / Features

书签管理 / Bookmark Management

• 网格视图和列表视图展示书签
• 文件夹导航支持
• 书签搜索功能
• Grid view and list view for bookmarks
• Folder navigation support
• Bookmark search functionality

待办事项 / To-Do List

• 每周任务管理
• 子任务支持
• 截止日期设置
• Weekly task management
• Subtask support
• Deadline setting

搜索功能 / Search Functionality

• 书签内搜索
• 多搜索引擎支持（百度、Google、Bing、DuckDuckGo）
• Bookmark search
• Multiple search engines support (Baidu, Google, Bing, DuckDuckGo)

自定义选项 / Customization Options

• 多种背景选择（纯色、渐变色、图片）
• 可调节网格布局
• 网站图标显示开关
• Multiple background options (solid color, gradient, image)
• Adjustable grid layout
• Website favicon display toggle

其他功能 / Other Features

• 书签导出为 Markdown 格式
• 农历节日显示
• 日历视图
• Bookmark export to Markdown format
• Lunar calendar festival display
• Calendar view

安装方法 / Installation

从 Chrome 网上应用店安装 / Install from Chrome Web Store

1. 访问 Chrome 网上应用店
2. 搜索 "Star Stream"
3. 点击 "添加至 Chrome"
4. Visit Chrome Web Store
5. Search for "Star Stream"
6. Click "Add to Chrome"

开发者模式安装 / Install via Developer Mode

1. 克隆或下载此仓库
2. 打开 Chrome 浏览器，访问 chrome://extensions/
3. 开启右上角的 "开发者模式"
4. 点击 "加载已解压的扩展程序"
5. 选择项目文件夹
6. Clone or download this repository
7. Open Chrome browser and go to chrome://extensions/
8. Enable "Developer mode" in the top right corner
9. Click "Load unpacked"
10. Select the project folder

使用说明 / Usage

基本操作 / Basic Operations

• 安装后，每次打开新标签页将显示 Star Stream 界面
• 点击书签可直接访问
• 点击文件夹可进入子目录
• After installation, Star Stream interface will appear on every new tab
• Click on bookmarks to access them directly
• Click on folders to enter subdirectories

搜索功能 / Search Function

• 在搜索框中输入关键词
• 选择搜索范围（书签或网络）
• 按 Enter 键执行搜索
• Enter keywords in the search box
• Select search scope (bookmarks or web)
• Press Enter to execute search

待办事项管理 / To-Do List Management

• 点击 "待办事项" 视图切换
• 点击 "添加任务" 按钮创建新任务
• 使用复选框标记任务完成状态
• Click "To-Do" view switch
• Click "Add Task" button to create new tasks
• Use checkboxes to mark task completion status

设置自定义 / Settings Customization

• 点击右下角齿轮图标打开设置面板
• 调整背景、布局和其他选项
• 点击 "保存设置" 应用更改
• Click the gear icon in the bottom right to open settings panel
• Adjust background, layout and other options
• Click "Save Settings" to apply changes

技术架构 / Technical Architecture

主要文件 / Main Files

• manifest.json - 扩展配置文件 / Extension manifest file
• newtab.html/css/js - 新标签页界面 / New tab page interface
• popup.html/css/js - 弹出窗口界面 / Popup window interface
• background.js - 后台脚本 / Background script
• lunar.js - 农历计算模块 / Lunar calendar calculation module

核心模块 / Core Modules

• 书签管理模块 / Bookmark management module
• 搜索模块 / Search module
• 待办事项模块 / To-do list module
• 设置模块 / Settings module
• 日历模块 / Calendar module

开发指南 / Development Guide

项目结构 / Project Structure

star-stream/
├── manifest.json
├── background.js
├── newtab.html
├── newtab.css
├── newtab.js
├── popup.html
├── popup.js
├── style.css
├── lunar.js
├── icons/
└── screenshots/

开发环境 / Development Environment

• 任何支持 HTML/CSS/JavaScript 的现代浏览器
• 文本编辑器或 IDE
• Chrome 浏览器用于测试扩展
• Any modern browser supporting HTML/CSS/JavaScript
• Text editor or IDE
• Chrome browser for testing the extension

构建和测试 / Build and Test

1. 克隆仓库 / Clone repository
2. 在 Chrome 中以开发者模式加载扩展 / Load extension in Chrome in developer mode
3. 进行修改和测试 / Make modifications and test

贡献指南 / Contribution Guide

欢迎提交 Issue 和 Pull Request 来改进此项目。

Issues and Pull Requests are welcome to improve this project.

许可证 / License

MIT License

版权所有 (c) 2025 Star Stream

特此免费授予任何获得本软件及相关文档文件（"软件"）副本的人，无限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利，并允许向其提供本软件的人员这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中。

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

MIT License

Copyright (c) 2025 Star Stream

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.