EXTENSION_README.md

TODOStack Chrome 插件安装指南

📦 插件文件说明

TODOStack Chrome 插件包含以下文件：

TODOStack/
├── manifest.json          # 插件配置文件
├── popup.html            # 插件弹窗页面
├── popup.css             # 插件弹窗样式
├── popup.js              # 插件弹窗逻辑
├── background.js         # 后台脚本
├── index.html            # 完整页面（可选）
├── styles.css            # 完整页面样式
├── script.js             # 完整页面逻辑
├── icons/                # 图标文件夹
│   ├── icon16.png        # 16x16 图标
│   ├── icon32.png        # 32x32 图标
│   ├── icon48.png        # 48x48 图标
│   └── icon128.png       # 128x128 图标
└── generate_icons.html   # 图标生成工具

🔧 安装步骤

1. 准备图标文件

首先需要生成插件图标：

1. 在浏览器中打开 generate_icons.html
2. 点击各个尺寸下的"下载"按钮
3. 将下载的文件重命名并放入 icons 文件夹：
   • 16x16 图标 → icon16.png
   • 32x32 图标 → icon32.png
   • 48x48 图标 → icon48.png
   • 128x128 图标 → icon128.png

2. 安装插件

1. 打开 Chrome 扩展程序页面

   • 在地址栏输入：chrome://extensions/
   • 或者：菜单 → 更多工具 → 扩展程序

2. 启用开发者模式

   • 在页面右上角打开"开发者模式"开关

3. 加载插件

   • 点击"加载已解压的扩展程序"
   • 选择 TODOStack 文件夹
   • 点击"选择文件夹"

4. 确认安装

   • 插件应该出现在扩展程序列表中
   • 浏览器工具栏会显示 TODOStack 图标

🎯 使用方法

插件弹窗功能

点击浏览器工具栏中的 TODOStack 图标，会打开紧凑的弹窗界面：

• 添加任务：在输入框中输入任务，按 Enter 或点击 + 按钮
• 完成任务：点击 ✓ 按钮完成栈顶任务
• 查看栈顶：点击 👁 按钮高亮显示栈顶任务
• 清空栈：点击 🗑 按钮清空所有任务
• 查看历史：点击历史按钮查看已完成任务
• 统计信息：点击统计按钮查看详细数据

完整页面功能

• 点击弹窗右上角的 🔗 按钮打开完整页面
• 完整页面包含所有功能，包括拖拽排序
• 支持数据导入/导出

智能徽章

• 插件图标上会显示当前待完成任务数量
• 有任务时显示蓝色徽章，无任务时隐藏

⌨️ 快捷键

• Ctrl/Cmd + Enter：快速添加任务
• Ctrl/Cmd + Backspace：完成栈顶任务

💾 数据存储

• 所有数据使用 Chrome 存储 API 保存
• 数据在不同设备间不会同步（本地存储）
• 卸载插件会清除所有数据

🔧 故障排除

插件无法加载

1. 确保所有文件都在正确位置
2. 检查 manifest.json 文件格式是否正确
3. 确保图标文件存在且命名正确

功能异常

1. 打开开发者工具查看控制台错误
2. 尝试重新加载插件
3. 检查 Chrome 版本是否支持 Manifest V3

数据丢失

1. 检查是否意外清除了浏览器数据
2. 确认插件没有被禁用或卸载

🚀 功能特色

🏗️ 栈操作

• 完整的栈数据结构实现
• 可视化的栈状态显示
• 拖拽排序支持

🎨 用户界面

• 现代化设计风格
• 响应式布局
• 流畅动画效果

📊 数据管理

• 自动保存功能
• 历史记录追踪
• 统计信息展示

📝 版本信息

• 版本：1.0.0
• 兼容性：Chrome 88+
• Manifest 版本：V3

🤝 技术支持

如果遇到问题或有建议，请：

1. 检查本文档的故障排除部分
2. 查看浏览器控制台的错误信息
3. 确保使用最新版本的 Chrome 浏览器

---

享受高效的栈式任务管理体验！ 🎉