Skip to main content

常见问题解答

本章节收集了用户在使用 UTags 过程中常见的问题和解决方法，帮助您快速解决可能遇到的困难。

安装问题​

Q: 我无法在浏览器中安装 UTags 扩展​

A: 可能的原因和解决方法：

  1. 浏览器版本过低：确保您的浏览器是最新版本
  2. 扩展商店访问受限：尝试使用用户脚本方式安装
  3. 安装权限问题：检查您是否有安装浏览器扩展的权限
  4. 扩展冲突：暂时禁用其他可能冲突的扩展，然后重试

Q: 用户脚本安装后没有生效​

A: 请检查以下几点：

  1. 用户脚本管理器：确保您的用户脚本管理器（如 Tampermonkey）正常工作
  2. 脚本启用状态：在用户脚本管理器中确认 UTags 脚本已启用
  3. 网站匹配：检查脚本的网站匹配规则是否包含您访问的网站
  4. 浏览器设置：某些浏览器设置可能会阻止用户脚本运行，检查浏览器的安全设置

Q: 网页应用无法访问​

A: 可能的原因和解决方法：

  1. 网络连接：确保您的网络连接正常
  2. DNS 问题：尝试使用备用域名访问（如 utags.top 或 utags.github.io）
  3. 浏览器缓存：清除浏览器缓存后重试
  4. 地区限制：某些地区可能无法访问主域名，尝试使用备用域名或 VPN

使用问题​

Q: 标签图标没有出现在网页元素上​

A: 可能的原因和解决方法：

  1. 不支持的网站：确认您访问的网站在 UTags 支持列表中
  2. 网站结构变化：网站可能更新了 HTML 结构，需要等待 UTags 更新适配
  3. 扩展/脚本未启用：确认 UTags 扩展或用户脚本已启用
  4. 元素不可标记：某些动态加载的元素可能无法被识别，尝试刷新页面
  5. 自定义设置：检查是否在设置中禁用了标签图标显示

Q: 添加的标签没有保存​

A: 可能的原因和解决方法：

  1. 存储限制：浏览器的本地存储可能已满，尝试清理一些不需要的数据
  2. 权限问题：确保 UTags 有存储数据的权限
  3. 同步冲突：如果使用同步功能，可能存在同步冲突，检查同步设置
  4. 浏览器隐私模式：在隐私模式下，数据可能不会被永久保存

Q: 特殊标签（如 block、hide）不起作用​

A: 可能的原因和解决方法：

  1. 特殊标签设置：检查设置中的特殊标签配置是否正确
  2. 网站兼容性：某些网站可能与特殊标签功能不完全兼容
  3. 动态内容：对于动态加载的内容，可能需要刷新页面或重新应用标签
  4. 标签拼写：确保特殊标签拼写正确，如 block 而不是 Block 或 BLOCK

Q: 网页应用中的书签显示不正确​

A: 可能的原因和解决方法：

  1. 数据同步问题：如果使用同步功能，确保数据已正确同步
  2. 浏览器缓存：清除浏览器缓存后重试
  3. 筛选条件：检查是否有筛选条件导致某些书签不显示
  4. 数据损坏：在极少数情况下，数据可能损坏，尝试从备份恢复

同步问题​

Q: GitHub 同步失败​

A: 可能的原因和解决方法：

  1. 访问令牌问题：

    • 确保个人访问令牌有效且未过期
    • 确保令牌具有正确的权限（repo 或 public_repo）
    • 重新生成令牌并更新设置

  2. 仓库配置问题：

    • 确保仓库名称和路径正确
    • 检查是否有权限访问指定的仓库
    • 确保分支名称正确（如 main 或 master）

  3. 网络问题：

    • 确保能够正常访问 GitHub
    • 检查网络连接和防火墙设置

Q: WebDAV 同步失败​

A: 可能的原因和解决方法：

  1. 服务器配置问题：

    • 确保 WebDAV 服务器地址正确
    • 检查用户名和密码是否正确
    • 确保服务器支持 WebDAV 协议

  2. 权限问题：

    • 确保您有权限在指定路径读写文件
    • 检查服务器的权限设置

  3. 路径问题：

    • 确保文件路径格式正确
    • 某些 WebDAV 服务器可能需要特定的路径格式

Q: 多设备同步数据不一致​

A: 可能的原因和解决方法：

  1. 同步冲突：

    • 如果在多个设备上同时编辑数据，可能会发生冲突
    • 在设置中选择"解决同步冲突"，选择保留哪个版本

  2. 同步频率：

    • 确保所有设备都定期同步数据
    • 在设置中调整自动同步频率

  3. 不同步骤：

    • 确保所有设备使用相同的同步方式和配置
    • 在一个设备上完成更改后，等待同步完成再在其他设备上操作

Q: 如何解决同步冲突​

A: 当发生同步冲突时，请按以下步骤操作：

  1. 在设置中选择"数据同步" -> "解决同步冲突"
  2. 查看冲突详情，了解本地版本和远程版本的差异
  3. 选择以下操作之一：
    • 保留本地版本：使用当前设备上的数据覆盖远程数据
    • 保留远程版本：使用远程数据覆盖当前设备上的数据
    • 合并：尝试自动合并两个版本（可能需要手动调整）
  4. 确认选择后，系统会执行相应的操作并重新同步数据

性能优化​

Q: UTags 扩展/用户脚本导致网页加载变慢​

A: 可以尝试以下优化方法：

  1. 减少标签数量：过多的标签可能会影响性能，考虑整理和合并标签
  2. 禁用不需要的功能：在设置中禁用不常用的功能
  3. 限制网站范围：在设置中限制 UTags 只在特定网站上运行
  4. 优化自定义 CSS：如果使用了复杂的自定义 CSS，尝试简化
  5. 定期清理数据：删除不再需要的标签和书签

Q: 网页应用在大量书签时变慢​

A: 可以尝试以下优化方法：

  1. 使用筛选：减少同时显示的书签数量
  2. 使用列表视图：列表视图比卡片视图性能更好
  3. 禁用预览图：在设置中禁用书签预览图
  4. 分批管理：将书签分成多个批次管理
  5. 使用最新浏览器：确保使用支持最新 Web 技术的浏览器

Q: 同步过程变慢​

A: 可以尝试以下优化方法：

  1. 减少同步频率：在设置中调整自动同步频率
  2. 选择性同步：只同步重要的标签和书签
  3. 分批同步：将数据分成多个文件进行同步
  4. 使用更快的同步服务：比较不同同步方式的性能，选择最适合的
  5. 定期清理同步缓存：在设置中选择"清理同步缓存"

数据备份与恢复​

Q: 如何备份 UTags 数据​

A: 您可以通过以下方式备份数据：

  1. 导出功能：

    • 在浏览器扩展/用户脚本的设置中选择"导出数据"
    • 在网页应用的设置中选择"数据管理" -> "导出书签"
    • 选择导出格式（JSON 格式包含最完整的数据）
    • 保存导出的文件到安全位置

  2. 同步服务备份：

    • 如果使用 GitHub 同步，数据会自动备份在 GitHub 仓库中
    • 如果使用 WebDAV 同步，可以备份 WebDAV 服务器上的数据文件

  3. 定期自动备份：

    • 在网页应用的设置中启用"自动备份"
    • 设置备份频率和保留的备份数量
    • 备份文件会保存在浏览器的下载目录中

Q: 如何恢复 UTags 数据​

A: 您可以通过以下方式恢复数据：

  1. 导入功能：

    • 在浏览器扩展/用户脚本的设置中选择"导入数据"
    • 在网页应用的设置中选择"数据管理" -> "导入书签"
    • 选择之前导出的备份文件
    • 选择导入模式（替换或合并）

  2. 从同步服务恢复：

    • 如果使用 GitHub 同步，可以在设置中选择"从服务器同步"
    • 如果使用 WebDAV 同步，同样可以选择"从服务器同步"

  3. 从自动备份恢复：

    • 在网页应用的设置中选择"数据管理" -> "从备份恢复"
    • 选择要恢复的备份文件
    • 确认恢复操作

Q: 我的数据丢失了，如何找回​

A: 如果您的数据丢失，请尝试以下恢复方法：

  1. 检查同步服务：

    • 如果使用了同步功能，检查同步服务器上是否有数据
    • 在设置中选择"从服务器同步"尝试恢复

  2. 检查浏览器缓存：

    • 在某些情况下，数据可能仍存在于浏览器缓存中
    • 尝试在不同的浏览器配置文件中打开 UTags

  3. 检查自动备份：

    • 如果启用了自动备份功能，检查备份文件
    • 使用最近的备份文件恢复数据

  4. 联系支持：

    • 如果以上方法都无效，可以在 GitHub 仓库中提交 issue 寻求帮助
    • 提供尽可能详细的信息，如使用的浏览器、UTags 版本、数据丢失的情况等

其他问题​

Q: UTags 支持哪些语言​

A: UTags 目前支持以下语言：

  • 英语 (English)
  • 简体中文 (Chinese Simplified)
  • 繁体中文 (Chinese Traditional)
  • 德语 (Deutsch)
  • 西班牙语 (Español)
  • 法语 (Français)
  • 意大利语 (Italiano)
  • 日语 (日本語)
  • 韩语 (한국어)
  • 葡萄牙语 (Português)
  • 俄语 (Русский)
  • 越南语 (Tiếng Việt)

语言会根据浏览器设置自动选择，您也可以在设置中手动选择语言。

Q: 如何贡献翻译或报告翻译错误​

A: 您可以通过以下方式贡献翻译或报告翻译错误：

  1. 在 GitHub 仓库中提交 issue，标记为"翻译"或"本地化"
  2. 直接在 GitHub 上编辑翻译文件并提交 Pull Request
  3. 联系开发团队，提供翻译建议或修正

Q: UTags 是否会收集我的数据​

A: UTags 高度重视用户隐私：

  1. 本地存储：默认情况下，所有数据都存储在您的浏览器本地
  2. 同步服务：如果使用同步功能，数据会传输到您选择的同步服务（GitHub 或 WebDAV）
  3. 无跟踪：UTags 不包含任何跟踪或分析代码
  4. 无广告：UTags 不显示广告，也不与广告网络共享数据
  5. 开源：UTags 是开源的，您可以审查代码以确认数据处理方式

Q: 如何报告 bug 或提出功能建议​

A: 您可以通过以下方式报告 bug 或提出功能建议：

  1. GitHub Issues：在 UTags GitHub 仓库 提交 issue
  2. 社区讨论：在 GitHub Discussions 或社区论坛中参与讨论

报告 bug 时，请提供以下信息：

  • UTags 版本
  • 浏览器类型和版本
  • 操作系统
  • 问题的详细描述
  • 重现问题的步骤
  • 如果可能，提供截图或录屏

Q: UTags 的开发路线图是什么​

A: UTags 的未来开发计划包括：

  1. 更多网站支持：扩展对更多网站的支持
  2. 高级数据分析：添加更强大的数据分析和可视化功能
  3. 协作功能：添加团队协作和标签共享功能
  4. AI 辅助：集成 AI 功能，帮助自动标记和组织内容
  5. 移动应用：开发原生移动应用

具体的开发计划和时间表可以在 GitHub 仓库的 Projects 部分查看。

Q: 如何支持 UTags 项目​

A: 您可以通过以下方式支持 UTags 项目：

  1. 使用并分享：使用 UTags 并向他人推荐
  2. 提交反馈：报告 bug 和提出改进建议
  3. 贡献代码：参与开发，提交 Pull Request
  4. 贡献翻译：帮助改进或添加新的语言翻译
  5. 捐赠：通过 GitHub Sponsors 或其他渠道进行捐赠
  6. 星标项目：在 GitHub 上给项目加星，提高项目可见度