使用支持与故障排除

在这里您可以找到关于 Xtag 浏览器扩展安装、本地标签存储、分享导入和来源管理的解答。

🛠️ 开发者手动安装步骤

如果您是从 GitHub 下载的源代码，可以按照以下步骤手动将 Xtag 加载到您的浏览器中：

  1. 克隆或下载项目仓库：
    git clone https://github.com/junqiangguo/trust_graph.git
  2. 打开 Chrome 扩展程序页面：
    在地址栏中输入 chrome://extensions/ 并回车。
  3. 启用“开发者模式”：
    在页面右上角，找到并勾选“开发者模式” (Developer mode) 开关。
  4. 加载已解压的扩展：
    点击左上角的“加载已解压的扩展程序” (Load unpacked) 按钮，选择您刚刚克隆/解压文件夹中的 extension 子目录。
  5. 刷新 X.com：
    打开或刷新 x.com (Twitter)。您会在每个用户名字旁看到一个小贴纸，说明安装成功！

⚡ 本地高级分析工具 (可选)

Xtag 扩展无需任何本地或远程服务端即可直接使用。高级用户如果想在自己的电脑上运行关注网络分析工具，可以参考项目里的本地脚本：

# 1. 进入项目根目录并创建 Python 虚拟环境
cd trust_graph
python3 -m venv .venv

# 2. 激活虚拟环境并安装依赖项
source .venv/bin/activate
pip install -r requirements.txt

# 3. 运行本地一键启动脚本
./run_all.sh

这将在本地同时启动：
• 本地接口服务：仅在您的电脑上运行。
• 本地可视化面板：提供高级名单分析及数据库导入工具。

常见问题解答 (FAQ)

Xtag 一定需要后台或 localhost 吗？

不需要。 Chrome 商店版本会直接使用 Chrome 扩展本地存储保存标签，不依赖 localhost。可选本地工具只给高级用户做额外分析，不影响扩展基本功能。

Xtag 会收集并上传我的关注数据和标签吗？

绝对不会。 Xtag 的设计初衷就是为了保障隐私安全。

所有被标记的用户名、标记分类、备注和导入来源，都储存在您本机的 Chrome 扩展本地存储中。只有当您主动发布分享链接时，选中的标签快照才会上传到您配置的 HTTPS 分享后台。

如何与其他人共享我的“防骗/信任标签”？

Xtag 支持点对点和去中心化的快照共享：

  1. 在浏览器中点击扩展程序工具栏图标。
  2. 在“分享”面板中，输入作者名字（如：Alice），以及您的分享后台（支持一键部署到免费的 Cloudflare Worker 上）。
  3. 点击“发布我的标签短链接”即可生成一个唯一的网页快照地址（例如：https://scamvax.pages.dev/s/xxxx）。
  4. 将此链接发给好友，对方直接在其扩展中粘贴即可预览增量修改并按需导入。
导入别人的标签会污染或覆盖我自己的黑/白名单吗？

不会。 Xtag 采取增量人工合并预览模式。

当您输入别人的分享链接时，扩展不会直接写入您的数据库，而是先拉取生成一个“冲突预览视图”。您可以清晰地看到：哪些是新增账号、哪些账号的标签和您现有的标记有冲突。您需要手动勾选需要合并的行。只有当您主动勾选了“覆盖冲突标签”后，导入的标签才会覆写您原有的记录，充分保证操作自主权。

如何一键部署属于我自己的快照分享后台？

我们提供了一个极其简单的 Cloudflare Worker + KV 的免费分享后台代码（位于项目 share_worker 目录中）。

只要您的电脑安装了 Node.js，在 share_worker 目录下运行：

npm install
npx wrangler kv namespace create SHARES
# 将返回的 id 填入 wrangler.jsonc 中
npx wrangler secret put PUBLISH_TOKEN # 设置共享授权令牌
npx wrangler deploy

部署成功后，将生成的 Worker 网址输入至您扩展的分享后台配置中，即可拥有完全自主控制的共享中继站。