Repository navigation
HTools v1.0.12
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。
建议升级前先在后台导出完整备份。