Repository navigation
Releases
Releases · shaoyouvip/htools
v1.0.33: 支持自定义分类图标,统一品牌兜底与加载重试
- 支持为工具、文章、订阅内容和消息推送的分类自定义图标,可选默认图标、128 个可搜索线性图标、图片地址或静态 SVG 代码。分类图标随完整备份导出和恢复,未设置图标时继续使用默认值。
- 更换圆形默认品牌 Logo,兼容圆形和方形自定义图片,统一页面、浏览器图标与图片加载失败后的兜底。已有自定义 Logo 保持优先,升级不会覆盖用户的图标设置;同步更新演示截图。
- 完善前台页面的加载失败提示与手动重试,区分文章不存在和网络异常,避免读取请求一直停留在加载状态。统一订阅内容、链接检测等处的中英文网络错误提示,修复公开页面误显示本地预览说明的问题。
- 后台设置重试时保留错误面板与按钮,减少页面跳动;修复切换语言、修改密码后部分设置加载状态异常,以及旧请求覆盖新状态的问题。
- 补齐恢复备份前的未保存提醒与保存按钮忙碌状态,精简设置说明,完善筛选按钮的选中状态和无障碍提示。
- 优化代码块复制反馈,成功才显示“已复制”,失败时给出明确提示;提示出现或消失时保留正文展开状态、选区和键盘焦点。
- 将订阅内容“转为文章”入口统一为文档图标,使操作含义更清楚。
v1.0.29: 修复并发与推送状态,统一交互并优化列表加载
本次更新改善 Telegram 推送、列表加载、内容编辑和后台操作体验。
- Telegram 推送:修复保存草稿后切换图片与文字消息时的更新异常,完善发送结果不确定时的重试确认和正在推送记录的删除保护,兼容旧推送记录与备份。
- 订阅同步:修复同步期间删除订阅、修改配置或恢复备份后,旧内容重新写入的问题。
- 列表加载:修复工具、文章、订阅内容和消息推送重试时旧记录再次显示、错误提示被覆盖的问题;订阅追加加载减少重复统计,保留首屏计数。
- Markdown 编辑:修复代码示例被误清理,以及跨行代码预览和复制异常;保留代码中的标签、链接和 HTML 示例。
- 表单与服务设置:修复旧上传和 AI 生成结果写入新表单的问题;完善恢复备份后的设置刷新,以及图床开关、未保存内容和保存超时的处理。
- 操作体验:完善推送分类删除确认及批量操作后的刷新反馈;统一分类筛选、分页、操作菜单、导入选项和通知反馈,补充添加文章的操作说明。
- 登录校验:修复并发请求可能绕过密码失败次数限制的问题。
- 默认工具目录:更新内置工具数据,共收录 160 条工具。
- 翻译清理:移除中英文翻译中未使用的旧版本文案及对应类型声明。
v1.0.23
新增
- RSSHub 订阅:订阅地址支持
rsshub://路由写法,在后台“服务设置”配置 RSSHub 实例地址后,新增、编辑、预览和同步都会自动解析为真实请求地址。 - Workers AI:可选接入 Cloudflare Workers AI,用于生成简介、摘要和标签,并把常见文档转换为 Markdown。
- ImgBed 图床:可选接入 CloudFlare ImgBed,在后台直接为工具预览图、文章封面和 Telegram 推送图片上传图片并自动回填公开地址。
- 按分类批量同步:未选中具体订阅时可一次同步当前分类下的全部订阅,结果汇总为一条提示。
- 订阅地址去重:新增订阅时会检查地址是否已存在,避免重复添加同一个源。
改进
- 订阅内容改为三栏工作区:左侧分类与订阅、中间条目列表、右侧阅读区。点击条目直接在页面内阅读正文,不再跳转新标签页;窄屏改用弹窗浏览。
- 分类交互:点击分类名筛选该分类内容,双击或点击前置箭头展开收起订阅;左侧分类顺序跟随分类排序设置。
- 站点图标:工具库与订阅内容使用同一套站点图标逻辑,加载中和获取失败都显示统一的网站图标占位,不再显示名称首字母。
- 手机端卡片:标题、日期与简介分行显示,操作按钮固定在卡片右上角,长标题不再挤压简介。
- 图标请求:延长站点图标获取失败后的缓存时间,减少上游服务异常时的重复请求。
修复
- 修复站点图标获取失败后,列表中同一位置换成其他工具或订阅时仍无法显示图标的问题。
其他
- 更新开发依赖,修复其中的已知安全问题。
v1.0.20:内容流消息推送与后台体验升级
新增功能
- 内容流条目现已支持手动推送到 Telegram,可直接推送或保存为草稿。
- 消息推送新增“内容流”来源筛选,并支持独立的推送分类管理。
- 推送记录改为独立保存资源快照,工具、文章或内容流后续修改不会自动覆盖已经编辑的推送内容。
- 工具、文章和内容流推送支持主动“同步来源”,需要时可重新读取关联内容并覆盖当前编辑字段。
- 手动添加推送时支持读取 GitHub 仓库元数据,与工具管理共用相同的读取逻辑和界面。
消息推送优化
- 工具、文章、内容流和自定义消息共用统一的编辑器、预览、分类和推送管理逻辑。
- 完整 Markdown 正文可直接编辑标题、简介、地址和标签,编辑字段与正文保持双向同步。
- 项目地址、演示地址、本站浏览和原文地址统一使用 Markdown 链接格式。
- 标签输入支持
#Cloudflare #Worker #Pages等连续 Hashtag,并自动转换为标准标签。 - 推送图片继续默认关闭,可按单条消息独立设置。
- 已推送状态按钮现在会给出明确提示,不会重复推送或保留异常焦点。
- 删除原工具、文章或内容流条目后继续保留推送记录,方便查看历史消息。
后台体验优化
- 工具、文章和消息推送中的名称、简介、地址、标签及图片字段统一使用公共组件。
- GitHub 仓库信息读取在工具管理和手动推送中复用同一套界面与逻辑。
- 优化公共分类管理、弹窗、按钮、骨架屏和移动端布局的一致性。
- 修复消息推送列表长时间停留在骨架屏的问题,并在请求异常时提供重新加载提示。
- 修复部分按钮关闭弹窗后仍保留高亮或焦点的问题。
- 前端搜索占位文案去掉多余的省略号。
- 减少站点图标在页面切换和菜单操作时的重复请求。
数据与兼容性
- 数据库结构升级至版本 15,新增内容流推送类型,并保留原有推送记录、分类和资源快照。
- 已部署的旧数据库会自动执行兼容迁移,不会删除原有工具、文章、内容源或推送数据。
- 完整备份与恢复现已覆盖内容流推送记录、分类和设置,并继续排除 Token、Secret、管理员密码等敏感信息。
- 备份恢复只接受当前最新的完整备份格式,不再兼容旧版备份结构。
HTools v1.0.18
HTools v1.0.18
本版本继续完善 Telegram 消息推送、后台交互、备份恢复和服务设置,统一现有公共组件与加载结构。
Telegram 消息推送
- Telegram 编辑、浏览、保存、首次推送和更新统一使用同一份完整 Markdown 消息。
- 项目地址、演示地址、文章地址、标签和固定消息尾巴按正文规则处理,避免重复附加。
- 支持工具、文章和自定义消息的手动推送与草稿管理。
- 统一“恢复默认 / 保存内容 / 消息推送 / 更新推送 / 保存草稿”等操作文案。
- 工具和文章卡片继续使用轻量推送入口,完整编辑能力集中在消息推送页面。
- 消息推送管理页支持浏览、编辑、推送、更新和删除,并保留本站推送记录。
- 删除本站记录不会删除 Telegram 中已经发送的消息。
- 优化消息推送页面骨架、浏览按钮遮罩和桌面端、手机端卡片尺寸。
- Telegram 手机端底部操作按钮保持一行、等宽和同高度。
后台管理与交互
- 每个 Markdown 编辑器独立维护“编辑内容 / 浏览内容”模式,不再通过浏览器存储全局联动。
- 首次进入浏览模式以及刷新、切换页面后,编辑和浏览区域保持一致高度。
- 内容流卡片复用文章管理的状态操作与下拉菜单结构,保留打开原文入口。
- 服务设置中的订阅源、GitHub 提交、Umami、Turnstile、Telegram 和代理统一使用公共滑动开关。
- 开关支持键盘焦点、无障碍状态和配置缺失时的禁用处理,移除卡片底部重复的开启 / 关闭按钮。
- 服务设置和管理设置骨架按真实标题、简介、帮助文字和段落数量生成,减少刷新闪烁与布局跳动。
- 优化系统设置卡片高度、操作区对齐和 Telegram 服务关闭提示布局。
备份恢复与数据库
- 完整备份恢复仅接受当前
version: "4"结构,并明确包含 Telegram 推送记录。 - 备份数量摘要包含 Telegram 推送记录与设置数量,导出内容不包含 Bot Token。
- 初始数据库结构直接使用版本 12,Telegram 消息表原生支持自定义消息类型。
- 保留旧版 D1 数据升级到当前结构所需的迁移逻辑,避免影响已有数据。
文档与资源
- 清理已无引用的默认 SVG favicon 声明,站点自定义图标继续由公共站点信息逻辑管理。
- 同步更新环境变量示例、Telegram 配置说明和部署文档。
HTools v1.0.14
HTools v1.0.14
- 修复语言与主题菜单点击外部区域后偶发不关闭的问题。
- 统一前台、后台侧栏及管理员登录页的网站名称、图标和副标题。
- 后台“基本信息”修改后,全站品牌信息同步生效。
- 优化管理员登录页结构,移除重复的后台标题与简介。
- 统一后台工具库入口与前台工具入口的图标。
HTools v1.0.13
HTools v1.0.13
本次版本重新设计了公开工具提交流程,移除 GitHub OAuth 登录和用户令牌存储,并完善后台安全、服务默认状态、移动端交互及项目文档。
工具提交
- 移除前端 GitHub OAuth 登录、回调、退出和用户会话存储。
- 不再由 HTools 服务端代用户创建 GitHub Issue。
- 填写 GitHub 仓库地址后,由访客浏览器直接读取公开仓库信息。
- 支持自动读取与手动刷新 GitHub 仓库名称、简介和标签。
- 提交前检查项目是否已被本站收录。
- 未收录项目会生成预填 Issue,并前往 GitHub 由用户确认创建。
- 新增中英文工具提交 Issue 模板。
- 提交页不会保存 GitHub 访问令牌或未提交表单。
GitHub 仓库信息
- 后台配置
GITHUB_TOKEN时,通过 Pages Functions 使用认证额度读取仓库信息。 - 未配置 Token 时,自动改由管理员浏览器请求 GitHub 公开 API。
- 公开提交页始终使用访客浏览器读取,不消耗站点 Token。
- 保留仓库信息自动补全和手动强制刷新能力。
管理员安全
- Cloudflare Turnstile 仅用于保护管理员登录,不再加载到公开提交页。
- 即使环境变量配置完整,Turnstile 仍默认关闭,需要管理员在后台手动开启。
- 修改管理员密码后,其他设备的旧后台会话立即失效。
- 当前浏览器自动换发新会话,无需重新登录。
- 禁止将新密码设置为当前密码。
- 当前密码错误不再误触发全局退出。
- 修正网络异常时错误标红密码字段的问题。
服务设置
以下功能在新部署时全部默认关闭,需要管理员完成配置后手动开启:
- 我的订阅源
- GitHub 提交
- Cloudflare Turnstile
- 代理访问
- Umami 访问统计
数据库升级
- 数据库结构升级到版本 9。
- 自动清理不再使用的 GitHub OAuth 状态表、用户会话表及相关索引。
- 工具、文章、内容源、内容条目和站点设置保持不变。
- 已部署站点无需手动执行数据库迁移。
后台体验
- 统一后台标题、字段、正文、状态、表格和统计文字层级。
- 统一真实页面结构骨架,减少异步加载时的跳动。
- 修复移动端分类选择、卡片操作焦点和按钮高亮残留。
- 统一内容流转文章弹窗与工具编辑弹窗的圆角和操作结构。
- 优化导入导出、链接检测、系统设置和内容流的响应式显示。
- 修复多处手机端遮挡、裁切、错位和内容显示不完整问题。
- 修复桌面端缩窄后,分类筛选默认文字在展开时上下跳动的问题。
- 修复顶部操作栏换为两行布局时,搜索框与清空筛选按钮高度不一致的问题。
隐私与文档
- 更新隐私政策和服务条款。
- 补充 GitHub 公开提交、管理员会话、Turnstile、Umami 和外部资源说明。
- 明确本站不保存访客 GitHub 登录资料、访问令牌或未提交表单。
- 精简中英文 README,补充 Cloudflare、MIT License 和最新版本徽章。
- 更新前台工具库与后台工具库截图。
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。
建议升级前先在后台导出完整备份。
HTools v1.0.10
HTools v1.0.10
本版本优化后台 GitHub 仓库信息读取,降低未认证 API 限额和重复请求对使用体验的影响。
主要更新
- 支持通过 Cloudflare Secret
GITHUB_TOKEN发起服务端认证请求,提高 GitHub API 可用额度。 - 增加 1 小时仓库元数据新鲜缓存,并保留 24 小时缓存用于后续复验。
- 缓存过期或手动刷新时使用 ETag 条件请求,仓库未变化时继续复用已有数据。
- 合并前端同一仓库的并发元数据请求,减少自动读取和手动操作造成的重复访问。
- GitHub OAuth 用户令牌继续仅用于公开提交登录和创建 Issue,不参与仓库元数据读取。
- 中英文部署文档和本地环境变量示例已补充
GITHUB_TOKEN配置说明。
配置说明
在 Cloudflare Pages 项目的 Variables and Secrets 中添加:
GITHUB_TOKEN=你的只读 GitHub Token建议将其设置为 Secret,并只授予读取公开仓库元数据所需的最小权限。本地测试时写入被 Git 忽略的 .dev.vars。
验证
npm run build通过。- 已验证认证请求、缓存命中和 ETag 强制复验。
- 已通过 Edge CDP 检查后台新增工具和 GitHub 信息读取交互。
- 已检查 1366×768、1920×1080、2560×1440 和 390×844 布局。
HTools v1.0.0
HTools v1.0.0
HTools v1.0.0 是项目公开发布的首个正式版本。本版本已将仓库历史初始化为干净的首次提交,方便后续部署、分发和二次开发。
主要功能
- 支持工具导航首页、工具分类、文章、关于页面和公开提交工具页面。
- 支持后台管理工具、文章、内容流、分类、站点设置、备份恢复和链接检测。
- 支持 RSS / Atom 内容源同步,并可将内容流条目转为站内文章。
- 支持 GitHub OAuth 提交工具建议,提交后创建 GitHub Issue。
- 支持后台读取 GitHub 仓库信息,自动补全工具名称、简介、封面、标签等信息。
- 支持 Cloudflare Pages Functions + D1 部署。
- 支持简体中文和英文界面。
部署说明
构建命令:
npm run build构建输出目录:
dist必须配置的环境变量:
ADMIN_PASSWORD必须绑定的 D1 数据库变量名:
DB备注
本版本为公开库初始化版本,旧开发历史已清理,仅保留当前稳定代码作为 v1.0.0 发布基线。
发布页面里:
- 标签选:`v1.0.0`
- 发布标题:`HTools v1.0.0`
- 不要勾选预发布
- 勾选/保持 `Set as the latest release` 就行