Skip to content

HTools v1.0.12

Choose a tag to compare

@shaoyouvip shaoyouvip released this 18 Jul 04:13
· 23 commits to main since this release

HTools v1.0.12

后台管理

  • 重构后台工具、文章和内容流管理页面。
  • 统一分类、搜索、排序、清空筛选及新增操作的布局和交互。
  • 统一工具、文章和内容卡片的状态按钮、更多操作菜单及键盘操作。
  • 优化新增、编辑、删除、同步、发布和转换操作的并发保护。
  • 修复快速连续操作时旧请求覆盖新结果的问题。
  • 操作完成后保留当前筛选、排序和滚动位置。
  • 改善桌面端、手机端及小屏幕下的弹窗、侧栏和操作区布局。

系统设置

  • 系统设置划分为“站点信息”“服务设置”“管理设置”三个分区。
  • 支持自定义网站名称、图标、首页文案和页脚内容。
  • 支持后台编辑关于页面、隐私政策和服务条款的中英文内容。
  • 完善订阅源、GitHub 提交、代理访问、管理员密码、备份恢复和恢复默认设置。
  • 各项服务的配置保存与开启、关闭操作相互独立,避免未保存内容被意外提交。
  • 完善配置校验、错误提示、请求重试和读取超时处理。

Umami 访问统计

  • 新增 Umami 统计配置。
  • 支持填写统计脚本地址和 Website ID。
  • 配置完整后可在后台开启或关闭。
  • 只有配置完整且开启时,前台才会加载原生 Umami 统计脚本。
  • Umami 配置已纳入完整备份、恢复和恢复默认设置。

Cloudflare Turnstile

  • 新增 Cloudflare Turnstile 人机验证。
  • 可同时保护管理员登录和前端工具提交。
  • 配置 TURNSTILE_SITE_KEY 和 TURNSTILE_SECRET_KEY 后,可在后台开启或关闭。
  • 未完整配置环境变量时无法开启验证。
  • 关闭后前台不会加载 Turnstile 组件。
  • 登录和工具提交共用统一的服务端验证逻辑及错误处理。

GitHub 工具提交

  • 优化前端提交工具页面的整体布局。
  • GitHub 登录入口统一放置在页面标题操作区。
  • 登录前“GitHub 登录”和登录后“退出 GitHub”使用相同的黑色主按钮、尺寸及悬停效果。
  • 移除登录成功后“项目信息”上方重复显示的“已登录”提示。
  • 优化电脑端和手机端的 Turnstile 与提交按钮布局。
  • 提交成功后继续创建公开 GitHub Issue。
  • 增加重复工具、待审核 Issue、提交频率和请求异常处理。
  • 修复 GitHub 登录状态读取缓慢、偶发不显示及旧状态覆盖问题。

工具与文章

  • 优化工具和文章的服务端搜索、分类筛选及稳定分页。
  • 工具、文章和内容流使用独立排序及筛选状态。
  • 优化工具精选、文章发布与草稿切换。
  • 工具编辑器读取 GitHub 仓库信息时,不再覆盖请求期间用户手动修改的字段。
  • 修改 GitHub 项目地址后,旧仓库请求和旧预览不会回写当前表单。
  • 统一文章标题、工具卡片标题和公共文字层级。

内容流

  • 支持从 RSS 源同步外部内容。
  • 同步内容可临时预览、筛选并转为站内文章。
  • 支持对比来源正文与当前文章内容,并选择是否更新。
  • 优化内容源预览、同步、搜索、来源筛选和稳定分页。
  • 修改订阅源地址、关闭编辑器或快速切换内容源时,会取消或忽略旧请求。
  • 新建内容源成功但首次同步失败时,会明确区分保存结果和同步结果。
  • 优化 HTML 转 Markdown 的标题、列表、代码块、图片、链接和引用处理。
  • 避免重复转换已有文章时覆盖不应修改的内容。

导入导出与链接检测

  • “导入导出”和“链接检测”调整为独立后台菜单。
  • 导入和导出使用独立容器。
  • 导入前可检测总数、有效数量、重复项、缺失字段、新增、更新和跳过数量。
  • 支持跳过已有 URL 或覆盖更新。
  • 导出当前工具库为兼容的 htools.json 文件。
  • 链接检测支持项目地址和演示站点检测、状态筛选及结果导出。
  • 统一导入统计、导出统计和链接检测统计的文字层级及移动端双列布局。
  • 优化检测结果中的项目地址、演示站点按钮和表格显示。

加载与交互

  • 全站异步内容统一使用“真实页面结构 + 骨架遮罩”。
  • 骨架会跟随真实标题、简介、输入框、卡片、统计区和响应式布局。
  • 减少数据加载完成时的跳动、闪烁和割裂感。
  • 固定标题、固定说明、导航及无需等待请求的按钮不再显示多余骨架。
  • 后台工具、文章、内容流、导入导出、链接检测和系统设置统一骨架材质及动画。
  • 快速完成的操作不再临时切换旋转图标或“加载中”文字。
  • 按钮异步请求期间保持原文字和原尺寸。

响应式布局

  • 完成前台和后台的桌面端、手机端响应式回归优化。
  • 修复卡片显示不完整、内容裁切、横向溢出、弹层遮挡及底部操作区不可见问题。
  • 优化手机端后台侧栏、编辑抽屉和确认弹窗动画。
  • 系统字体放大、浏览器缩放和小屏幕高度下仍可滚动查看完整内容。
  • 首页桌面端首屏保持独立展示,手机端布局保持原有结构。
  • 统一首页、工具页和文章页底部内容与页脚的间距。

多语言与错误提示

  • 清理后台工具、文章、内容流和系统设置中的硬编码中文。
  • 移除通过“全部”等界面文字判断当前语言的旧逻辑。
  • 中文界面显示中文提示,英文界面显示英文提示。
  • 统一 API 错误码与前端错误翻译。
  • 避免中文界面直接显示后端返回的英文 error.message。
  • 登录状态失效后自动返回登录页,不再只显示 Unauthorized。

性能与稳定性

  • 后台主组件改为按需加载,普通访客不再下载后台代码。
  • 工具、文章和内容流列表改为服务端分页及稳定游标。
  • 列表接口不再返回不需要的完整文章正文。
  • 增加公共工具和文章独立搜索接口。
  • 公开工具、分类、文章和订阅源使用 Cloudflare 边缘短缓存。
  • 站点设置及代理设置支持 ETag 条件请求。
  • 后台成功修改数据后会更新全局缓存版本,减少不同节点继续读取旧数据。
  • 数据库结构版本会自动记录和升级,部署时无需手动执行 Migration。
  • 优化 RSS 同步批量写入,减少 D1 查询次数和数据库往返。
  • 增加后台实体操作锁,避免同一工具、文章或内容源同时执行冲突操作。

SEO 与公开发现

  • 新增并完善 robots.txt、sitemap.xml、RSS 和 JSON Feed。
  • 统一公开文章地址、封面、发布时间和修改时间。
  • 完善 canonical、Open Graph、文章结构化数据和站点结构化数据。
  • 未知页面、后台页面及预览页面不会被搜索引擎错误收录。
  • RSS、JSON Feed、Sitemap 和文章详情使用统一的公开元数据规则。

文档与部署

  • README 版本号更新为 HTools v1.0.12。
  • README 顶部新增 Telegram 频道、Telegram 群组和部署教程入口。
  • 中英文 README 支持直接切换。
  • 新增完整环境变量表,说明变量用途、是否必需及建议配置类型。
  • 补充 Cloudflare Turnstile 部署说明。
  • public/htools.json 和默认 GitHub Raw 工具源地址支持直接点击访问。
  • scripts/、tests/、tmp/、.dev.vars 和本地更新日志不进入公开仓库。

环境变量

变量 必需 说明
ADMIN_PASSWORD 是 后台初始登录密码及管理员会话签名密钥
GITHUB_TOKEN 否 读取公开 GitHub 仓库信息并提高 API 限额
TURNSTILE_SITE_KEY 否 Cloudflare Turnstile 站点密钥
TURNSTILE_SECRET_KEY 否 Cloudflare Turnstile 服务端私密密钥

Turnstile 的两个变量需要同时配置。重新部署后,还需要在后台“服务设置”中手动开启。

升级说明

从 v1.0.10 升级后直接重新部署即可。现有 D1 数据会保留,应用会自动检查并升级数据库结构,无需手动执行 Migration。

建议升级前先在后台导出完整备份。