fix: add docs

2025-09-13 07:23:32 -06:00 · 2024-11-17 11:07:34 +09:00
parent 8dbd0dc2e0
commit 8752cb0923
11 changed files with 740 additions and 2 deletions
--- a/docs/zh/get-started.md
+++ b/docs/zh/get-started.md
@@ -0,0 +1,84 @@
+# 入门
+
+Sky Follower Bridge 帮助您在 Bluesky 上找到并关注您的 𝕏 (Twitter) 连接。
+
+<iframe width="100%" height="315" src="https://www.youtube.com/embed/pVqoDv-1uac?si=jKDFFcKQXh61jBdL" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
+<p style="color: gray; font-size: 0.8em; line-height: 1.4;">此视频演示了 Edge 版本。最新的 Chrome 版本和最近的 Firefox 版本可能会有所不同。Chrome 的视频教程即将推出。</p>
+
+## 安装
+
+Sky Follower Bridge 可在以下平台获取：
+
+- [Chrome 网上应用店](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko) (推荐)
+- [Firefox 附加组件](https://addons.mozilla.org/en-US/firefox/addon/sky-follower-bridge/)
+- [Microsoft Edge 附加组件](https://microsoftedge.microsoft.com/addons/detail/sky-follower-bridge/dpeolmdblhfolkhlhbhlofkkpaojnnbb)
+
+::: tip
+我们推荐使用 Chrome 网上应用店版本，因为它<E4B8BA><E5AE83><EFBFBD>是最新的。其他商店版本可能会延迟更新。
+:::
+
+## 使用方法
+
+### 1. 访问 𝕏 (Twitter)
+
+访问 X 上的以下页面之一：
+- 您的关注页面: [x.com/following](https://x.com/following)
+- 您的已屏蔽用户页面: [x.com/settings/blocked/all](https://x.com/settings/blocked/all)
+- 公共列表的成员页面: `x.com/i/lists/<list_id>/members`
+
+![following-page](/images/following-page.png)
+
+### 2. 启动 Sky Follower Bridge
+
+按 `Alt + B` 或点击浏览器工具栏中的扩展图标。
+
+::: tip
+对于 Firefox 用户，按 `Alt + B` 可能不起作用。在这种情况下，请点击浏览器工具栏中的扩展图标。
+
+https://support.mozilla.org/en-US/kb/extensions-button
+:::
+
+![Open Extension](/images/open-extension.png)
+
+### 3. 登录 Bluesky
+
+输入您的 Bluesky 句柄（或电子邮件）和 [App password](https://bsky.app/settings/app-passwords)。
+
+::: tip
+如果遇到登录错误，请参阅 [故障排除指南](/troubleshooting)。
+:::
+
+![enter-credentials](/images/enter-credentials.png)
+
+### 4. 开始搜索
+
+点击 "Find Bluesky Users" 开始扫描。扩展将通过检查 Bluesky API 来搜索匹配的 Bluesky 配置文件。
+
+![find-bluesky-users](/images/scan-users.png)
+
+### 5. 查看结果
+
+点击 "View Results" 查看在 Bluesky 上找到的潜在匹配。
+
+![view-results-button](/images/click-results.png)
+
+这将打开选项页面，显示所有检测到的 Bluesky 用户。
+
+![options](/images/options.png)
+
+### 6. 关注用户
+
+点击任何您想连接的用户旁边的 "Follow" 按钮。
+
+![follow](/images/click-follow-btn.png)
+
+或使用 "Follow All" 按钮一次性关注所有检测到的用户。
+
+![follow-all](/images/follow-all-btn.png)
+
+::: warning
+请注意，匹配过程并不完美，可能偶尔会建议错误的匹配。在关注之前请始终验证配置文件。
+:::
+
+就是这样！享受在 Bluesky 上与您的社区连接 🎉 
--- a/docs/zh/index.md
+++ b/docs/zh/index.md
@@ -0,0 +1,32 @@
+---
+layout: home
+
+hero:
+  name: "Sky Follower Bridge"
+  text: "连接您的社交网络"
+  tagline: 无缝迁移您的社交连接从 𝕏 到 Bluesky
+  actions:
+    - theme: brand
+      text: Get Started
+      link: /zh/get-started
+    - theme: alt
+      text: Troubleshooting
+      link: /zh/troubleshooting
+  image:
+    src: /images/logo.png
+    alt: Sky Follower Bridge 封面图片
+
+features:
+  - icon: 🔍
+    title: 自动配置文件匹配
+    details: 自动检测与您在 𝕏 上关注的用户相似的 Bluesky 用户。
+  - icon: 🚀
+    title: 批量关注功能
+    details: 使用我们的 "Follow All" 按钮一次性关注多个用户，节省时间。
+  - icon: 📋
+    title: 多列表支持
+    details: 支持关注、粉丝、已屏蔽用户列表，甚至是公共 𝕏 列表。
+  - icon: 🌐
+    title: 跨浏览器支持
+    details: 可在 Chrome、Firefox 和 Microsoft Edge 上使用，方便您的使用。
+--- 
--- a/docs/zh/troubleshooting.md
+++ b/docs/zh/troubleshooting.md
@@ -0,0 +1,118 @@
+# 故障排除指南
+
+## 身份验证错误
+
+### 登录问题
+
+**错误信息:**  
+<span class="error-message">Error: Invalid identifier or password</span>
+
+**检查清单:**
+1. 用户名和密码输入
+   - 检查是否有意外的空格
+   - 如果复制和粘贴，请确保没有包含多余的字符
+
+2. 用户名格式
+   - 正确格式: `your-username.bsky.social`
+   - 常见错误: `your-username` (缺少 .bsky.social)
+
+3. 密码信息
+   - 我们强烈建议使用 [App Password](https://bsky.app/settings/app-passwords) 而不是您的常规密码
+   - App Password 格式: `xxxx-xxxx-xxxx-xxxx` (19 个字符)
+
+::: tip 有用的提示
+不要将 App Password 与设置中显示的 "password name" 混淆。
+如何创建新的 App Password:
+2. [导航到 App Passwords 部分](https://bsky.app/settings/app-passwords)
+3. 点击 "Add App Password"
+4. 点击 "Create App Password"
+4. 复制生成的 19 个字符的密码
+:::
+
+---
+
+### 需要双因素身份验证
+
+**错误信息:**  
+<span class="error-message">Error: Two-factor authentication required</span>
+
+**解决方案:**
+1. 检查您的电子邮件<E982AE><E4BBB6><EFBFBD>获取身份验证代码
+2. 在 2FA 输入字段中输入代码
+3. 尝试重新登录
+
+## 速率限制错误
+
+**错误信息:**  
+<span class="error-message">Error: Rate limit error</span>
+
+**解决方案:**
+1. Bluesky API 有以下限制 ([官方文档](https://docs.bsky.app/docs/advanced-guides/rate-limits)):
+   - 每小时最多 5,000 点（大约 1,666 个新操作）
+   - 每天最多 35,000 点
+   - 每个操作的点数:
+     - 创建: 3 点
+     - 更新: 2 点
+     - 删除: 1 点
+2. 如果达到限制，请等待限制重置
+3. 点击 "Restart" 按钮重试
+
+::: warning
+在 Firefox 上发布的版本经常遇到速率限制错误。如果遇到错误，请在 Chrome 上尝试。
+:::
+
+::: tip
+大多数用户在正常使用期间不会达到这些限制。然而，在短时间内执行批量操作（如关注许多用户或点赞许多帖子）时请注意。
+:::
+
+## 页面错误
+
+### 页面无效
+
+**错误信息:**  
+<span class="error-message">Error: Invalid page. please open the 𝕏 following or blocking or list page.</span>
+
+**解决方案:**
+仅在以下 𝕏 (Twitter) 页面上使用扩展：
+- 关注页面 ([x.com/following](https://x.com/following))
+- 屏蔽页面 ([x.com/settings/blocked/all](https://x.com/settings/blocked/all))
+- 列表成员页面 (`x.com/i/lists/<list_id>/members`)
+
+或在扩展页面上检查您的扩展权限。
+站点权限应如下所示：
+
+<img src="/images/site_permissions.png" alt="site permissions" width="500"/>
+
+## 扫描问题
+
+### 扫描过早停止
+
+扫描在到达页面底部之前停止
+
+**解决方案:**
+1. 点击 "Resume Scanning" 继续
+2. 扫描将在到达页面底部时自动停止
+3. 您可以随时点击 "Stop Scanning and View Results"
+
+### 未找到用户
+
+扫描后未检测到 Bluesky 用户
+
+**解决方案:**
+1. 确保您已正确登录
+2. 尝试再次扫描 - 某些用户可能在第一次扫描时未被检测到
+3. 检查 𝕏 用户是否在其个人资料中链接了他们的 Bluesky 帐户
+
+## 其他问题
+
+如果遇到任何意外错误：
+
+1. 重新加载页面
+2. 再次尝试操作
+3. 如果问题仍然存在，您可以：
+   - [创建一个问题](https://github.com/kawamataryo/sky-follower-bridge/issues)，包括：
+     - 精确的错误信息
+     - 您尝试执行的操作
+     - 您的浏览器类型和版本
+     - 任何相关的截图
+   - 或在 Bluesky 上提及 [@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social)