一个功能强大的网页评分桌面应用，专为从 Excel 文件中高效批量评估网页而设计。

当前版本：v1.0.4

1. 启动应用后，点击顶部的 📥 Download Sample Excel 按钮
2. 保存模板到您希望的位置（如：my_web_pages.xlsx）
3. 编辑模板，填入您的网页评分数据
4. 加载文件，点击 📁 Select Excel File 选择您编辑好的Excel文件

• 📊 Excel 集成: 动态选择和处理 Excel 文件，自动识别列结构
• 🌐 内嵌浏览器: 使用 Electron BrowserView 直接查看网页内容
• ⚡ 智能评分: 支持 Pass/Fail 快速评分，完全自定义快捷键系统
• 🏷️ 高级标签系统: 7个可编辑预设标签 + 无限自定义标签
• 📸 智能截图: 一键截图并自动保存，避免 Excel 字符限制
• 📝 实时备注: 问题输入框支持实时编辑和自动保存
• 💾 智能保存: 多时机自动保存，确保数据安全
• ⌨️ 完全自定义快捷键: 11个功能的快捷键完全可定制
• 🎯 用户友好: 紧凑布局，一屏操作，响应式设计

• Electron: 跨平台桌面应用框架
• Node.js: 后端逻辑处理
• XLSX: Excel 文件读写
• HTML/CSS/JavaScript: 前端界面
• Electron Builder: 应用打包工具

• ZIP 压缩包: Web Page Scorer-1.0.4-mac.zip (~102MB)

• ZIP 压缩包: Web Page Scorer-1.0.4-arm64-mac.zip (~95MB)

💡 新版本说明: 从v1.0.4开始，我们提供样例Excel模板下载功能，让用户更容易上手使用！

• 安装程序: Web Page Scorer Setup 1.0.4.exe (~146MB)
• 便携版: Web Page Scorer 1.0.4.exe (~146MB)

📋 详细安装说明请查看 doc/RELEASE_NOTES_v1.0.4.md

• Node.js 16+
• npm 或 yarn

1. 克隆项目

git clone https://github.com/XiaoDcs/web-page-scorer.git
cd web-page-scorer

2. 安装依赖

npm install

3. 开发模式运行

npm start

4. 构建应用

# 构建所有平台
npm run build:all

# 仅构建 Mac 版本
npm run build:mac

# 仅构建 Windows 版本
npm run build:win

# 使用构建脚本（推荐）
./script/build.sh          # Mac/Linux
script/build.bat           # Windows

web-page-scorer/
├── main.js                    # Electron 主进程
├── index.html                 # 应用界面
├── package.json               # 项目配置
├── README.md                  # 项目说明
├── doc/                       # 文档目录
│   ├── CHANGELOG.md           # 更新日志
│   ├── RELEASE.md             # 发布说明
│   ├── HOW_TO_RELEASE.md      # 发布指南
│   ├── FIXES_v1.0.2.md        # 修复记录
│   ├── RELEASE_NOTES.md       # 发布说明
│   ├── RELEASE_NOTES_v1.0.1.md # v1.0.1发布说明
│   └── RELEASE_SUMMARY_v1.0.2.md # v1.0.2发布总结
├── script/                    # 脚本目录
│   ├── build.sh               # Mac/Linux 构建脚本
│   ├── build.bat              # Windows 构建脚本
│   ├── create_sample_excel.js # 创建样例Excel文件脚本
│   └── prepare-release.sh     # 发布准备脚本
├── test_data/                 # 测试数据目录
│   └── test_link.xlsx         # 测试用Excel文件
├── dist/                      # 构建输出目录
├── screenshots/               # 截图存储目录
├── assets/                    # 资源文件目录
├── public/                    # 公共文件目录
│   └── sample_template.xlsx   # 样例Excel模板文件
├── src/                       # 源代码目录
└── node_modules/              # 依赖包

• 获取模板: 启动应用，点击 📥 Download Sample Excel 下载样例模板
• 编辑数据: 在Excel中填入您需要评分的网页信息
  • description: 填写网页描述（如："产品介绍页面"）
  • link: 填写完整的网页URL
  • thumbnail_link: （可选）填写缩略图链接
• 保存文件: 保存为 .xlsx 格式

• 选择文件: 点击 📁 Select Excel File 选择您准备的Excel文件
• 开始浏览: 应用自动加载第一个网页，右侧显示页面信息
• 评分操作:
  • 查看内嵌浏览器中的网页内容
  • 使用 ✅ Pass 或 ❌ Fail 按钮评分
  • 或使用快捷键：↑ 通过，↓ 失败

• 问题标签: 点击预设标签或添加自定义标签
  • 预设标签：有争议性、涉及敏感话题等
  • 自定义标签：双击编辑，右键删除
  • 快捷键：Ctrl+1~9 快速添加标签
• 截图记录: 点击 📸 Screenshot 保存当前页面截图
• 备注说明: 在文本框中添加详细的问题描述

• 页面切换:
  • 点击 ← Previous / Next → 按钮
  • 使用方向键 ← / → 快速切换
  • 设置中启用"Auto-advance on Pass"自动跳转
• 批量跳转: 在设置面板使用"Jump to page"功能
• 自动保存: 应用自动保存评分结果到Excel文件
• 手动保存: 按 Ctrl+S 或点击 💾 Save 手动保存

• 自定义快捷键: 点击 ⌨️ Custom Shortcuts 配置个性化快捷键
• 预加载优化: 在设置中调整预加载页面数量提升性能
• 外部浏览器: 点击 🔗 Open in Browser 在系统浏览器中查看
• 全屏截图: 点击缩略图可以全屏查看

1. 启用"Auto-advance on Pass"自动跳转功能
2. 对于明显合格的页面直接按 ↑ 键通过
3. 对于有问题的页面使用 Ctrl+数字 快速添加标签
4. 使用预加载功能减少页面加载等待时间

1. 使用预设标签快速分类常见问题
2. 自定义标签记录特定项目的专门问题
3. 文本备注添加详细的问题描述和建议
4. 截图功能保存视觉证据

1. 合理设置预加载数量（建议5-10页）
2. 使用页面跳转功能快速定位
3. 定期手动保存避免数据丢失
4. 合理安排工作批次避免疲劳评分

💡 所有快捷键均可自定义！ 在设置面板中点击"⌨️ Custom Shortcuts"进行个性化配置

1. 有争议性
2. 涉及敏感话题
3. 过于主观评价
4. 负面语言
5. 过于标题党
6. 挑战政策/制度
7. 图片无法加载

• 添加标签: 点击 "+ Add Tag" 按钮
• 编辑标签: 双击任意标签进行编辑
• 删除标签: 右键点击自定义标签删除
• 快捷键: 前9个标签自动获得 Ctrl+1~9 快捷键
• 持久化: 所有标签更改自动保存到本地

• 标题行必须: 第一行为列标题，应用会自动识别
• 链接完整性: 确保所有链接都是完整的URL（包含 http:// 或 https://）
• 数据一致性: 保持每行数据格式的一致性
• 文件编码: 使用UTF-8编码支持中文内容

• 列名灵活: 系统支持多种列名变体（如：description/query、image/thumbnail等）
• 空值处理: 评分相关列（result、issue、screenshot）可以为空，系统会自动填充
• 路径相对性: 截图路径会自动保存为相对路径，便于文件迁移

• 不要在链接列中包含非URL内容
• 不要手动修改result列的数值格式
• 避免在description列中使用过长的文本（建议<200字符）

在应用中点击 📥 Download Sample Excel 按钮即可获取包含示例数据的模板文件，您可以基于此模板快速开始您的网页评分工作。

使用 electron-builder 进行跨平台打包：

• Mac: 生成 DMG 和 ZIP 格式，支持 Intel 和 Apple Silicon
• Windows: 生成 NSIS 安装程序和便携版
• 代码签名: 支持 Mac 代码签名（需配置证书）
• 自动更新: 预留更新机制接口

本项目采用 GNU General Public License v3.0 (GPL-3.0) 开源许可证。

• 自由使用: 在任何目的下使用本软件
• 自由分发: 复制和分发本软件
• 自由修改: 修改源代码以适应您的需求
• 商业使用: 在商业环境中使用本软件

• 保留许可证: 在分发时保留原始许可证声明
• 开源修改: 如果分发修改版本，必须以相同许可证开源
• 标注更改: 明确标注您对源代码的修改
• 提供源码: 分发时必须提供或承诺提供源代码

• 专利保护: 贡献者授予您专利使用权，但如果您起诉他人专利侵权则失效
• 责任免除: 软件按"现状"提供，作者不承担任何保证责任
• 商标权: 许可证不授予商标使用权

完整的GPL-3.0许可证文本请查看项目根目录的 LICENSE 文件，或访问：
https://www.gnu.org/licenses/gpl-3.0.html

我们选择GPL-3.0许可证是为了：

• 保证开源: 确保修改版本继续开源，惠及整个社区
• 共享改进: 鼓励开发者分享代码改进和功能增强
• 自由软件: 维护用户的自由使用权，防止专有化
• 社区发展: 促进开源社区的健康发展和知识共享

欢迎提交 Issue 和 Pull Request！

版本: 1.0.4
最后更新: 2025年5月27日

• 📋 详细用户指南: doc/USER_GUIDE.md - 完整的使用教程和最佳实践
• 🔄 版本更新日志: doc/RELEASE_NOTES_v1.0.4.md - v1.0.4详细更新内容
• 🛠️ 发布指南: doc/HOW_TO_RELEASE.md - 开发者发布说明

• v1.0.4 (2025-05-27): 样例Excel模板下载功能 + 完整用户指南 + 文档全面升级
• v1.0.3 (2025-05-27): 全局快捷键系统增强 + 缩略图预览优化 + 构建流程改进
• v1.0.2 (2025-05-27): 完全自定义快捷键系统 + 高级标签管理
• v1.0.1 (2024-05-26): 智能预加载 + 自动跳转功能
• v1.0.0 (2024-05-26): 初始发布版本

📋 完整更新日志请查看 doc/RELEASE_NOTES_v1.0.4.md