FAQ

Feed 密钥在哪里复制？

登录 Mp2RSS 控制台后，进入「账户设置」，Feed 密钥 一栏点击复制按钮即可。

如果你只想看 CLI 当前用的密钥前缀，可执行：

mp2rss auth status

输出只会展示前 6 个字符 + *** 的掩码形式，不会泄露完整密钥。

默认登录时浏览器没有自动打开怎么办？

CLI 在终端会同时打印完整的授权 URL，复制到浏览器手动打开即可。常见原因：

• 系统没有默认浏览器，或当前 shell 环境变量缺少 BROWSER。
• 在远程 SSH / 容器内执行，没有桌面环境——这种情形请改用 --no-browser 路径。

loopback 端口被占用怎么办？

CLI 每次随机选空闲端口，重新执行 mp2rss auth login 即可。

若本地防火墙拦截监听本地端口，请改用 mp2rss auth login -k <feed-key> 或 mp2rss auth login --no-browser。

SSH 远程环境如何登录？

参见 登录 → 路径三。简而言之：

mp2rss auth login --no-browser

CLI 会打印授权 URL，在本地有浏览器的设备打开 URL 完成授权，把页面显示的 Feed 密钥粘贴回远端终端即可。整个过程不需要从远端到本地的网络回连。

JSON 模式下错误为什么走 stdout？

为了让 jq 等管道工具能直接消费错误。如果错误走 stderr：

mp2rss mp list -o json | jq '.error // .items'

在 stderr 与 stdout 没合并的环境里，jq 看不到错误体，只能拿到空输入而失败。把错误也写到 stdout 后，上面这条命令既能在成功时拿到 items，也能在失败时拿到 error。

错误退出码仍然非零，所以脚本里依然可以用 $? 或 set -e 控制流程：

if ! mp2rss mp list -o json > out.json; then
  jq '.error' out.json
fi

我能把 Feed 密钥放进环境变量吗？

可以。优先级是：

--api-key  >  MP2RSS_FEED_KEY  >  ~/.mp2rss/config.json 中的 feed_key

例如在 CI 里：

export MP2RSS_FEED_KEY=$FEED_KEY_SECRET
mp2rss mp list -o json

这样不需要先 auth login 写盘，也不会留下任何本地状态。

我能同时连接到多个 Mp2RSS 实例吗？

可以通过 --api-url 和 --api-key（或环境变量 MP2RSS_API_URL / MP2RSS_FEED_KEY）在单次调用中切换。配置文件 ~/.mp2rss/config.json 只保留一组默认值。

配置文件权限是怎么设的？

• 目录 ~/.mp2rss/ 权限 0700（仅当前用户可访问）。
• 文件 ~/.mp2rss/config.json 权限 0600（仅当前用户可读写）。

CLI 在写入时会强制设置上述权限。如果权限被外部修改成更宽松的值，下次写入会自动恢复。

如何更新到最新版本？

按安装方式选择对应的更新路径：

推荐：mp2rss update（任何安装方式通用）

mp2rss update              # 检查并升级到最新 release
mp2rss update --check      # 只检查，不下载
mp2rss update --force      # 即使版本相同也强制重装

行为细节：

• 查询 https://api.github.com/.../releases/latest，与本地版本比对（语义版本，预发布版本视为更老）。
• 下载平台归档 + checksums.txt，校验 SHA-256。
• 暂存为 <selfpath>.new 后 os.Rename 原子替换；Windows 会先把旧二进制改名 .old 再换入，避免「文件正在使用」。
• macOS 会自动 xattr -d com.apple.quarantine 去掉 Gatekeeper 隔离属性。

通过包管理器装的，仍可用 mp2rss update 吗？

可以，但推荐改用对应包管理器，避免覆盖被包管理器接管的文件——下次包管理器升级时可能出现哈希校验冲突。

npm / pnpm 安装的场景

pnpm up -g @mp2rss/cli
# 或
npm update -g @mp2rss/cli

postinstall 会重新拉对应版本的二进制并校验 SHA-256。

install.sh 安装的场景

直接重跑安装命令即可：

curl -fsSL https://raw.githubusercontent.com/areyoubugcoder/mp2rss-cli/main/scripts/install.sh | sh

脚本会发现已存在的二进制并覆盖到同一位置。可用 VERSION=v0.2.0 锁定具体版本。

源码构建的场景

cd /path/to/mp2rss-cli
git pull
make build
sudo install -m 0755 mp2rss /usr/local/bin/mp2rss

怎么完全卸载并清理本地痕迹？

# 1. 退出登录（清掉 feed_key）
mp2rss auth logout

# 2. 删除配置目录
rm -rf ~/.mp2rss

# 3. 从 PATH 中删掉二进制（按你的安装方式选一种）
sudo rm /usr/local/bin/mp2rss          # install.sh / 源码构建 / 直接下载
rm "$HOME/.local/bin/mp2rss"           # install.sh 默认目录
pnpm rm -g @mp2rss/cli                 # npm / pnpm / yarn 安装

CLI 能用 x search / x subscribe / x remove 吗？

不能。X 账号搜索与 X 订阅 / 取消订阅仅在 Web 控制台提供，CLI 与 Open API 都不暴露这些写类端点。脚本场景的标准做法是：

1. 在 Web 控制台「订阅管理 → X」完成 X 账号搜索 + 订阅；
2. 再用 mp2rss x list 列出已订阅 X 账号、mp2rss x posts / x articles <xUserId> 拉取内容。

为什么 x posts / x articles 要 xUserId 而不是 @handle？

CLI 与 Open API 都只接受 X 账号的唯一数字 ID（xUserId），不接受 @handle：

• handle 可改：用户随时改昵称会让订阅指向变化；xUserId 是不可变的全局 ID。

• 来源唯一：在 Web 控制台完成订阅后，用 mp2rss x list 即可拿到 xUserId：

  $ mp2rss x list -o json | jq '.items[] | {xUserId, xUsername, xDisplayName}'
  {
    "xUserId": "44196397",
    "xUsername": "elonmusk",
    "xDisplayName": "Elon Musk"
  }

  然后 mp2rss x posts 44196397 即可。

怎么报 Bug / 提需求？

• 命令行问题：mp2rss-cli Issues
• 服务端 / Web 控制台问题：Mp2RSS Issues
• 想交流功能：讨论区