安装与使用教程

推荐从 Chrome 网上应用店一键安装；或下载 zip 用开发者模式手动加载（约 2 分钟）。

备选：下载 zip 手动安装

适用于 Edge、Brave、Arc 等其他 Chromium 浏览器，或需要使用最新本地构建时。压缩包内含构建好的扩展文件，下载后解压加载即可。

当前版本 …

下载 .zip 跳到安装步骤 AI 帮装

可选：让 Codex / Claude 帮你装

已经在用编程助手？把下面提示词发给 Codex、Claude、Cursor 等，让它优先推荐 Chrome 网上应用店安装；或帮你下载 zip、解压并逐步带你用开发者模式加载。浏览器里开关和选文件夹仍需你自己确认。

请帮我安装 XReply Chrome 扩展（推荐优先使用 Chrome 网上应用店；如需用 zip 手动安装，请按以下步骤）。

1. （如果用户选择商店安装）引导用户访问 https://chromewebstore.google.com/detail/pimnhmgdpdmoifmmhbepejglbbbchghh?utm_source=x.asiones.com 一键添加扩展。
2. 如需手动安装：从 https://x.asiones.com/downloads/xreply-latest.zip 下载安装包。
3. 解压到固定目录（例如 ~/Documents/xreply 或 %USERPROFILE%\Documents\xreply），不要删/移动该文件夹。
4. 确认解压目录下能直接看到 manifest.json、background.js、content.js、options.html、icons/。
5. 指导我：打开 chrome://extensions（Edge 用 edge://extensions）→ 打开「开发者模式」→「加载已解压的扩展程序」→ 选中含 manifest.json 的那一层文件夹。
6. 提醒：若提示「请停用开发者模式扩展」选保留；不要加载 zip 本身或外层空目录。
7. 加载成功后，引导我打开设置页：云托管用 𝕏 登录，或自带 API 填 Base URL / Key / 模型。

全程用中文分步说明；需要我手动点的步骤请明确标出。优先推荐商店安装。

不会用 AI 助手？忽略本块，按下方手动步骤约 2 分钟即可完成。

一、解压安装包

  1. 解压 zip

    macOS：双击 xreply-latest.zip，得到一个文件夹（内含 manifest.json、background.js 等）。

    Windows：右键 →「全部提取…」→ 解压到任意固定位置（建议放在不会轻易被删的目录，例如 Documents/xreply）。

    请记住这个文件夹的位置。扩展依赖该路径持续存在；删掉或移动后需重新加载。

  2. 确认文件夹内容

    打开解压后的文件夹，应能直接看到：

    • manifest.json
    • background.js、content.js、options.html
    • icons/ 目录

    加载时要选这一层文件夹（能直接看到 manifest.json 的那一层），不要选它的上一级，也不要只选某个子文件。

二、在浏览器中加载扩展

  1. 打开扩展管理页

    在地址栏输入并回车：

    Chrome / Brave / Arcchrome://extensions
    Edgeedge://extensions

    也可以：浏览器菜单 →「扩展程序」→「管理扩展程序」。

  2. 打开开发者模式

    页面右上角打开 「开发者模式」（Developer mode）开关。打开后会出现「加载已解压的扩展程序」等按钮。

  3. 加载已解压的扩展程序

    点击 「加载已解压的扩展程序」（Load unpacked）→ 选择上一步解压出的文件夹 → 确定。

    成功后列表中会出现 XReply — X 回复助手，并显示版本号。

  4. 固定到工具栏（推荐）

    点地址栏右侧拼图图标 → 找到 XReply → 点图钉固定。之后可点图标进入设置。

启动时的提示是正常的
  • 浏览器可能提示「请停用开发者模式扩展程序」——点取消 / 保留即可，不要点停用。
  • 使用 zip 手动加载时，扩展卡片上会显示「未打包」或「开发者模式」标记（商店版不会）。请勿同时启用商店版和本地开发者模式版本。
  • 请勿删除或移动解压后的文件夹；否则扩展会失效，需重新「加载已解压的扩展程序」。

三、选择模式并登录

  1. 打开设置页

    任选一种方式：

    • 扩展管理页 → XReply →「详情」→「扩展程序选项」
    • 点工具栏上的 XReply 图标（若已固定）

    首次安装成功后通常会自动打开设置页。

  2. 选择模式

    ☁️ 云托管（默认）

    在设置页点「使用 𝕏 登录」完成授权即可，无需填 Key 或模型。也可在个人中心登录、查看额度与套餐。

    🔑 自带 API

    填 Base URL + API Key + 模型（需为 OpenAI 兼容端点，含本地服务）。首次填非默认域名会弹一次主机权限授权，请允许。

四、在 X 上开始回复

  1. 打开任意帖子的回复弹窗

    访问 x.com 或 pro.x.com，点某条帖子的「回复」。XReply 只在回复弹窗（modal）里工作，不会在详情页底部的内联输入框自动请求。

  2. 等待灰色建议出现

    弹窗打开后会自动生成建议，以灰色文字显示在输入框中（此时还没真正写入）。每次会准备 3 条。

  3. 三个快捷键

    ↑ / ↓上下切换不同建议。切到底会再生成，始终留 1 条备选。
    Tab接受当前建议，写入输入框。
    Option/Alt + Tab改写你已输入的内容（如「赞同」）。仅 macOS；Windows 上 Alt+Tab 被系统占用。

五、自定义 Prompt（可选）

可在设置页（自带 API）或个人中心（云托管）修改 System Prompt。可用变量：

${post}帖子内容（生成、改写都可用）。
${draft}当前草稿（仅改写可用）。

回复必须包裹在 <reply></reply> 之间——标签内的内容会被直接使用。改 Prompt 时请保留这条要求。

云托管 Prompt 存云端；自带 API 的 Prompt 只存本地，两者互不覆盖。

六、更新扩展

  1. 重新下载

    回到本页，再次下载最新 zip。

  2. 覆盖解压

    解压并覆盖原来的文件夹内容（或解压到新文件夹）。

  3. 重新加载

    打开 chrome://extensions：

    • 若覆盖了同一路径：点 XReply 卡片上的「重新加载」圆形箭头即可。
    • 若换了新文件夹：先移除旧扩展，再「加载已解压的扩展程序」选新文件夹。

常见问题

为什么推荐从 Chrome 网上应用店安装？

商店版安装最简单、更新自动。推荐优先使用商店链接。开发者模式（zip）主要用于其他 Chromium 浏览器、测试最新构建，或不想通过商店的情况。

可以用 Codex / Claude 帮我安装吗？

可以。见本页「可选：让 Codex / Claude 帮你装」，复制提示词发给编程助手即可。它能帮你下载、解压并逐步指导；浏览器里的开发者模式开关和「加载已解压的扩展程序」仍需你手动确认。

加载时报错「清单文件缺失」或「无法加载」？

多半选错了文件夹层级。请选中能直接看到 manifest.json 的那一层，而不是外层空目录或 zip 本身。

扩展突然灰掉或无法使用？

检查解压目录是否被删除、移动或清空。路径变了需要重新「加载已解压的扩展程序」。云托管用户可到设置页确认是否仍已登录。

打开回复弹窗没有灰色建议？

确认：1）在回复弹窗而非详情页内联框；2）云托管已登录且额度未用完，或自带 API 已填对 Base URL / Key / 模型；3）扩展管理页里 XReply 已启用。可打开扩展「详情 → 检查视图 / Service Worker」查看是否有报错。

Windows 上 Option+Tab 改写无效？

Windows 的 Alt+Tab 被系统占用，扩展拦不到。请用 ↑↓ 切换建议、Tab 接受；改写请在 macOS 上用，或自己改完再发。

开发者模式安全吗？

开发者模式只是浏览器允许加载未上架扩展的开关。请只从本官网（x.asiones.com）下载安装包。不要加载来路不明的文件夹。

几点说明
  • 只在回复弹窗（modal）里自动生成，不会在帖子详情页的内联输入框上乱发请求。
  • Option+Tab 改写在 macOS 可用；Windows 的 Alt+Tab 被系统占用，改写在 Windows 上不可用。
  • 可继续用 zip 手动加载本地包（用于测试最新构建）；商店版与本地开发者模式版请勿同时启用，以免冲突。

从 Chrome 网上应用店安装 下载 zip 登录个人中心