Skip to content

Releases

v1.0.33: 支持自定义分类图标,统一品牌兜底与加载重试

Choose a tag to compare

@shaoyouvip shaoyouvip released this 18 Oct 05:43
  • 支持为工具、文章、订阅内容和消息推送的分类自定义图标,可选默认图标、128 个可搜索线性图标、图片地址或静态 SVG 代码。分类图标随完整备份导出和恢复,未设置图标时继续使用默认值。
  • 更换圆形默认品牌 Logo,兼容圆形和方形自定义图片,统一页面、浏览器图标与图片加载失败后的兜底。已有自定义 Logo 保持优先,升级不会覆盖用户的图标设置;同步更新演示截图。
  • 完善前台页面的加载失败提示与手动重试,区分文章不存在和网络异常,避免读取请求一直停留在加载状态。统一订阅内容、链接检测等处的中英文网络错误提示,修复公开页面误显示本地预览说明的问题。
  • 后台设置重试时保留错误面板与按钮,减少页面跳动;修复切换语言、修改密码后部分设置加载状态异常,以及旧请求覆盖新状态的问题。
  • 补齐恢复备份前的未保存提醒与保存按钮忙碌状态,精简设置说明,完善筛选按钮的选中状态和无障碍提示。
  • 优化代码块复制反馈,成功才显示“已复制”,失败时给出明确提示;提示出现或消失时保留正文展开状态、选区和键盘焦点。
  • 将订阅内容“转为文章”入口统一为文档图标,使操作含义更清楚。

v1.0.29: 修复并发与推送状态,统一交互并优化列表加载

Choose a tag to compare

@shaoyouvip shaoyouvip released this 15 Oct 13:51

本次更新改善 Telegram 推送、列表加载、内容编辑和后台操作体验。

  • Telegram 推送:修复保存草稿后切换图片与文字消息时的更新异常,完善发送结果不确定时的重试确认和正在推送记录的删除保护,兼容旧推送记录与备份。
  • 订阅同步:修复同步期间删除订阅、修改配置或恢复备份后,旧内容重新写入的问题。
  • 列表加载:修复工具、文章、订阅内容和消息推送重试时旧记录再次显示、错误提示被覆盖的问题;订阅追加加载减少重复统计,保留首屏计数。
  • Markdown 编辑:修复代码示例被误清理,以及跨行代码预览和复制异常;保留代码中的标签、链接和 HTML 示例。
  • 表单与服务设置:修复旧上传和 AI 生成结果写入新表单的问题;完善恢复备份后的设置刷新,以及图床开关、未保存内容和保存超时的处理。
  • 操作体验:完善推送分类删除确认及批量操作后的刷新反馈;统一分类筛选、分页、操作菜单、导入选项和通知反馈,补充添加文章的操作说明。
  • 登录校验:修复并发请求可能绕过密码失败次数限制的问题。
  • 默认工具目录:更新内置工具数据,共收录 160 条工具。
  • 翻译清理:移除中英文翻译中未使用的旧版本文案及对应类型声明。

v1.0.23

Choose a tag to compare

@shaoyouvip shaoyouvip released this 12 Aug 13:02

新增

  • RSSHub 订阅:订阅地址支持 rsshub:// 路由写法,在后台“服务设置”配置 RSSHub 实例地址后,新增、编辑、预览和同步都会自动解析为真实请求地址。
  • Workers AI:可选接入 Cloudflare Workers AI,用于生成简介、摘要和标签,并把常见文档转换为 Markdown。
  • ImgBed 图床:可选接入 CloudFlare ImgBed,在后台直接为工具预览图、文章封面和 Telegram 推送图片上传图片并自动回填公开地址。
  • 按分类批量同步:未选中具体订阅时可一次同步当前分类下的全部订阅,结果汇总为一条提示。
  • 订阅地址去重:新增订阅时会检查地址是否已存在,避免重复添加同一个源。

改进

  • 订阅内容改为三栏工作区:左侧分类与订阅、中间条目列表、右侧阅读区。点击条目直接在页面内阅读正文,不再跳转新标签页;窄屏改用弹窗浏览。
  • 分类交互:点击分类名筛选该分类内容,双击或点击前置箭头展开收起订阅;左侧分类顺序跟随分类排序设置。
  • 站点图标:工具库与订阅内容使用同一套站点图标逻辑,加载中和获取失败都显示统一的网站图标占位,不再显示名称首字母。
  • 手机端卡片:标题、日期与简介分行显示,操作按钮固定在卡片右上角,长标题不再挤压简介。
  • 图标请求:延长站点图标获取失败后的缓存时间,减少上游服务异常时的重复请求。

修复

  • 修复站点图标获取失败后,列表中同一位置换成其他工具或订阅时仍无法显示图标的问题。

其他

  • 更新开发依赖,修复其中的已知安全问题。

v1.0.20:内容流消息推送与后台体验升级

Choose a tag to compare

@shaoyouvip shaoyouvip released this 05 Aug 01:40

新增功能

  • 内容流条目现已支持手动推送到 Telegram,可直接推送或保存为草稿。
  • 消息推送新增“内容流”来源筛选,并支持独立的推送分类管理。
  • 推送记录改为独立保存资源快照,工具、文章或内容流后续修改不会自动覆盖已经编辑的推送内容。
  • 工具、文章和内容流推送支持主动“同步来源”,需要时可重新读取关联内容并覆盖当前编辑字段。
  • 手动添加推送时支持读取 GitHub 仓库元数据,与工具管理共用相同的读取逻辑和界面。

消息推送优化

  • 工具、文章、内容流和自定义消息共用统一的编辑器、预览、分类和推送管理逻辑。
  • 完整 Markdown 正文可直接编辑标题、简介、地址和标签,编辑字段与正文保持双向同步。
  • 项目地址、演示地址、本站浏览和原文地址统一使用 Markdown 链接格式。
  • 标签输入支持 #Cloudflare #Worker #Pages 等连续 Hashtag,并自动转换为标准标签。
  • 推送图片继续默认关闭,可按单条消息独立设置。
  • 已推送状态按钮现在会给出明确提示,不会重复推送或保留异常焦点。
  • 删除原工具、文章或内容流条目后继续保留推送记录,方便查看历史消息。

后台体验优化

  • 工具、文章和消息推送中的名称、简介、地址、标签及图片字段统一使用公共组件。
  • GitHub 仓库信息读取在工具管理和手动推送中复用同一套界面与逻辑。
  • 优化公共分类管理、弹窗、按钮、骨架屏和移动端布局的一致性。
  • 修复消息推送列表长时间停留在骨架屏的问题,并在请求异常时提供重新加载提示。
  • 修复部分按钮关闭弹窗后仍保留高亮或焦点的问题。
  • 前端搜索占位文案去掉多余的省略号。
  • 减少站点图标在页面切换和菜单操作时的重复请求。

数据与兼容性

  • 数据库结构升级至版本 15,新增内容流推送类型,并保留原有推送记录、分类和资源快照。
  • 已部署的旧数据库会自动执行兼容迁移,不会删除原有工具、文章、内容源或推送数据。
  • 完整备份与恢复现已覆盖内容流推送记录、分类和设置,并继续排除 Token、Secret、管理员密码等敏感信息。
  • 备份恢复只接受当前最新的完整备份格式,不再兼容旧版备份结构。

HTools v1.0.18

Choose a tag to compare

@shaoyouvip shaoyouvip released this 02 Aug 21:23

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

Choose a tag to compare

@shaoyouvip shaoyouvip released this 20 Jul 03:33

HTools v1.0.14

  • 修复语言与主题菜单点击外部区域后偶发不关闭的问题。
  • 统一前台、后台侧栏及管理员登录页的网站名称、图标和副标题。
  • 后台“基本信息”修改后,全站品牌信息同步生效。
  • 优化管理员登录页结构,移除重复的后台标题与简介。
  • 统一后台工具库入口与前台工具入口的图标。

HTools v1.0.13

Choose a tag to compare

@shaoyouvip shaoyouvip released this 20 Jul 01:00

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

Choose a tag to compare

@shaoyouvip shaoyouvip released this 18 Jul 04:13

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

Choose a tag to compare

@shaoyouvip shaoyouvip released this 10 Jul 23:35

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

Choose a tag to compare

@shaoyouvip shaoyouvip released this 02 Jul 11:56

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` 就行