setup-xhs

name	setup-xhs
description	安装部署小红书自动化环境：Python CLI 引擎 + Chrome 浏览器扩展。 当用户第一次使用小红书功能、提到安装/部署/配置小红书、环境搭建、CLI 命令报错、或 check-login 返回 connection/bridge 错误时使用。

前置条件

• macOS 或 Linux
• Python >= 3.11
• Google Chrome 浏览器

安装流程

1. 安装 Python 依赖

cd {baseDir}/../../xiaohongshu-skills && uv sync

如果没有 uv，先安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 安装 Chrome 扩展

引导用户在 Chrome 中加载开发者扩展：

1. 打开 Chrome，地址栏输入 chrome://extensions/
2. 右上角打开「开发者模式」
3. 点击「加载已解压的扩展程序」
4. 选择目录：{baseDir}/../../xiaohongshu-skills/extension/
5. 确认扩展「XHS Bridge」已启用

3. 验证安装

python3 {baseDir}/../../xiaohongshu-skills/scripts/cli.py check-login

• 返回 {"logged_in": ...} → 安装成功
• 返回 connection/bridge 错误 → 检查扩展是否启用、Chrome 是否打开

4. 登录

验证通过后，引导用户执行 /xhs-login 完成登录。

环境检查

bash {baseDir}/../../scripts/check_env.sh

故障排查

问题	解决
uv: command not found	curl -LsSf https://astral.sh/uv/install.sh | sh
python3: command not found	安装 Python 3.11+：brew install python@3.11
Bridge 连接失败	确认 Chrome 扩展已启用，Chrome 已打开
扩展报错	在 chrome://extensions/ 查看扩展错误日志
CLI 超时	确认小红书页面已加载，尝试刷新页面

不需要的东西

• 不需要 Docker
• 不需要 --remote-debugging-port
• 不需要 MCP server
• 不需要 Go 编译环境