feat: 多账号端口隔离 + 账号选择前置步骤

- account_manager: 每个命名账号自动分配独立端口（9223+），新增
  get_account_port()、公开 get_profile_dir()、update_account_description()
- cli: 新增 _resolve_account()，connect 函数按账号切换端口和 Chrome Profile；
  tab 文件按端口隔离（session_tab_<port>.txt / login_tab_<port>.txt）；
  新增 add-account / list-accounts / remove-account / set-default-account 4 个子命令；
  登录成功后自动读取平台昵称写入账号描述
- xhs/login: 新增 get_current_user_nickname()，从首页导航栏读取昵称
- 5 个 SKILL.md: 统一添加账号选择前置步骤（0/1 账号免选，多账号必选）
- CLAUDE.md: CLI 子命令表追加 4 个账号管理命令

@@ -21,7 +21,7 @@ uv run pytest              # 运行测试
 双层结构：`scripts/` 是 Python CDP 自动化引擎，`skills/` 是 Claude Code Skills 定义（SKILL.md 格式）。
 
 - `scripts/xhs/` — 核心自动化库（模块化，每个功能一个文件）
-- `scripts/cli.py` — 统一 CLI 入口，19 个子命令，JSON 结构化输出
+- `scripts/cli.py` — 统一 CLI 入口，23 个子命令，JSON 结构化输出
 - `scripts/publish_pipeline.py` — 发布编排器（含图片下载和登录检查）
 - `skills/*/SKILL.md` — 指导 Claude 如何调用 scripts/
 
@@ -74,3 +74,7 @@ python scripts/publish_pipeline.py --title-file t.txt --content-file c.txt --ima
 | `long-article` | — | 长文发布（填写+排版） |
 | `select-template` | — | 长文发布（选择模板） |
 | `next-step` | — | 长文发布（下一步+描述） |
+| `add-account` | — | 账号管理（添加，自动分配端口） |
+| `list-accounts` | — | 账号管理（列出所有） |
+| `remove-account` | — | 账号管理（删除） |
+| `set-default-account` | — | 账号管理（设置默认） |

@@ -13,6 +13,9 @@ logger = logging.getLogger(__name__)
 _CONFIG_DIR = Path.home() / ".xhs"
 _ACCOUNTS_FILE = _CONFIG_DIR / "accounts.json"
 
+# 命名账号端口起始值（默认账号使用 9222）
+_NAMED_PORT_START = 9223
+
 
 def _load_config() -> dict:
     """加载账号配置。"""
@@ -41,20 +44,25 @@ def list_accounts() -> list[dict]:
                 "name": name,
                 "description": info.get("description", ""),
                 "is_default": name == default,
-                "profile_dir": _get_profile_dir(name),
+                "profile_dir": get_profile_dir(name),
+                "port": info.get("port", _NAMED_PORT_START),
             }
         )
     return result
 
 
 def add_account(name: str, description: str = "") -> None:
-    """添加账号。"""
+    """添加账号，自动分配独立端口（从 _NAMED_PORT_START 递增）。"""
     config = _load_config()
     accounts = config.setdefault("accounts", {})
     if name in accounts:
         raise ValueError(f"账号 '{name}' 已存在")
 
-    accounts[name] = {"description": description}
+    # 自动分配端口：取已有端口的最大值（至少 _NAMED_PORT_START - 1）加 1
+    existing_ports = {info.get("port", _NAMED_PORT_START) for info in accounts.values()}
+    port = max(existing_ports | {_NAMED_PORT_START - 1}) + 1
+
+    accounts[name] = {"description": description, "port": port}
 
     # 如果是第一个账号，设为默认
     if not config.get("default"):
@@ -63,10 +71,10 @@ def add_account(name: str, description: str = "") -> None:
     _save_config(config)
 
     # 创建 Profile 目录
-    profile_dir = _get_profile_dir(name)
+    profile_dir = get_profile_dir(name)
     os.makedirs(profile_dir, exist_ok=True)
 
-    logger.info("添加账号: %s", name)
+    logger.info("添加账号: %s (port=%d)", name, port)
 
 
 def remove_account(name: str) -> None:
@@ -98,12 +106,37 @@ def set_default_account(name: str) -> None:
     logger.info("默认账号设置为: %s", name)
 
 
+def update_account_description(name: str, description: str) -> None:
+    """更新账号描述（通常用于存储平台昵称）。"""
+    config = _load_config()
+    accounts = config.get("accounts", {})
+    if name not in accounts:
+        raise ValueError(f"账号 '{name}' 不存在")
+    accounts[name]["description"] = description
+    _save_config(config)
+    logger.info("账号 %s 描述已更新: %s", name, description)
+
+
 def get_default_account() -> str:
     """获取默认账号名称。"""
     config = _load_config()
     return config.get("default", "")
 
 
-def _get_profile_dir(account: str) -> str:
+def get_profile_dir(account: str) -> str:
     """获取账号的 Chrome Profile 目录。"""
     return str(_CONFIG_DIR / "accounts" / account / "chrome-profile")
+
+
+def _get_profile_dir(account: str) -> str:
+    """获取账号的 Chrome Profile 目录（别名，向后兼容）。"""
+    return get_profile_dir(account)
+
+
+def get_account_port(name: str) -> int:
+    """获取指定账号的 Chrome 调试端口。"""
+    config = _load_config()
+    accounts = config.get("accounts", {})
+    if name not in accounts:
+        raise ValueError(f"账号 '{name}' 不存在")
+    return accounts[name].get("port", _NAMED_PORT_START)

@@ -15,47 +15,52 @@ import os
 import sys
 import tempfile
 
-# 记录登录用 tab 的 target_id，确保 verify-code / wait-login 连回精确的那个 tab
-_LOGIN_TAB_FILE = os.path.join(tempfile.gettempdir(), "xhs", "login_tab_id.txt")
+def _session_tab_file(port: int) -> str:
+    """返回指定端口的 session tab 文件路径（每账号独立隔离）。"""
+    return os.path.join(tempfile.gettempdir(), "xhs", f"session_tab_{port}.txt")
 
-# 记录上次命令使用的 tab，供下次命令复用，避免重复开新 tab
-_SESSION_TAB_FILE = os.path.join(tempfile.gettempdir(), "xhs", "session_tab_id.txt")
 
+def _login_tab_file(port: int) -> str:
+    """返回指定端口的 login tab 文件路径（每账号独立隔离）。"""
+    return os.path.join(tempfile.gettempdir(), "xhs", f"login_tab_{port}.txt")
 
-def _save_login_tab(target_id: str) -> None:
-    os.makedirs(os.path.dirname(_LOGIN_TAB_FILE), exist_ok=True)
-    with open(_LOGIN_TAB_FILE, "w") as f:
+
+def _save_login_tab(target_id: str, port: int) -> None:
+    path = _login_tab_file(port)
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    with open(path, "w") as f:
         f.write(target_id)
 
 
-def _load_login_tab() -> str | None:
+def _load_login_tab(port: int) -> str | None:
     with contextlib.suppress(FileNotFoundError):
-        data = open(_LOGIN_TAB_FILE).read().strip()
+        data = open(_login_tab_file(port)).read().strip()
         return data or None
     return None
 
 
-def _clear_login_tab() -> None:
+def _clear_login_tab(port: int) -> None:
     with contextlib.suppress(FileNotFoundError):
-        os.remove(_LOGIN_TAB_FILE)
+        os.remove(_login_tab_file(port))
 
 
-def _save_session_tab(target_id: str) -> None:
-    os.makedirs(os.path.dirname(_SESSION_TAB_FILE), exist_ok=True)
-    with open(_SESSION_TAB_FILE, "w") as f:
+def _save_session_tab(target_id: str, port: int) -> None:
+    path = _session_tab_file(port)
+    os.makedirs(os.path.dirname(path), exist_ok=True)
+    with open(path, "w") as f:
         f.write(target_id)
 
 
-def _load_session_tab() -> str | None:
+def _load_session_tab(port: int) -> str | None:
     with contextlib.suppress(FileNotFoundError):
-        data = open(_SESSION_TAB_FILE).read().strip()
+        data = open(_session_tab_file(port)).read().strip()
         return data or None
     return None
 
 
-def _clear_session_tab() -> None:
+def _clear_session_tab(port: int) -> None:
     with contextlib.suppress(FileNotFoundError):
-        os.remove(_SESSION_TAB_FILE)
+        os.remove(_session_tab_file(port))
 
 # Windows 控制台默认编码（如 cp1252）不支持中文，强制 UTF-8
 if sys.stdout and hasattr(sys.stdout, "reconfigure"):
@@ -76,16 +81,51 @@ def _output(data: dict, exit_code: int = 0) -> None:
     sys.exit(exit_code)
 
 
+def _update_account_nickname(args: argparse.Namespace, page) -> None:
+    """登录成功后，将平台昵称写入账号描述（best-effort，失败不影响登录结果）。"""
+    if not getattr(args, "account", ""):
+        return
+    import sys as _sys
+
+    _sys.path.insert(0, os.path.join(os.path.dirname(__file__)))
+    import account_manager
+    from xhs.login import get_current_user_nickname
+
+    try:
+        nickname = get_current_user_nickname(page)
+        if nickname:
+            account_manager.update_account_description(args.account, nickname)
+            logger.info("账号 %s 昵称已更新: %s", args.account, nickname)
+    except Exception as e:
+        logger.warning("更新账号昵称失败: %s", e)
+
+
+def _resolve_account(args: argparse.Namespace) -> str | None:
+    """解析 --account 参数，更新 args.port，返回 user_data_dir（无账号时返回 None）。"""
+    if not getattr(args, "account", ""):
+        return None
+    import sys as _sys
+
+    _sys.path.insert(0, os.path.join(os.path.dirname(__file__)))
+    import account_manager
+
+    name = args.account
+    args.port = account_manager.get_account_port(name)
+    return account_manager.get_profile_dir(name)
+
+
 def _connect(args: argparse.Namespace):
     """连接到 Chrome 并返回 (browser, page)。
 
-    优先复用上次命令留下的 tab（通过 _SESSION_TAB_FILE 记录），
+    优先复用上次命令留下的 tab（通过端口隔离的 session tab 文件记录），
     避免每次命令都新建 tab 导致 Chrome 中 tab 堆积。
     """
     from chrome_launcher import ensure_chrome, has_display
     from xhs.cdp import Browser
 
-    if not ensure_chrome(port=args.port, headless=not has_display()):
+    user_data_dir = _resolve_account(args)
+
+    if not ensure_chrome(port=args.port, headless=not has_display(), user_data_dir=user_data_dir):
         _output(
             {"success": False, "error": "无法启动 Chrome，请检查 Chrome 是否已安装"},
             exit_code=2,
@@ -95,32 +135,34 @@ def _connect(args: argparse.Namespace):
     browser.connect()
 
     # 优先复用上次命令留下的 tab
-    saved_id = _load_session_tab()
+    saved_id = _load_session_tab(args.port)
     if saved_id:
         page = browser.get_page_by_target_id(saved_id)
         if page:
             logger.debug("复用会话 tab: %s", saved_id)
-            _save_session_tab(page.target_id)
+            _save_session_tab(page.target_id, args.port)
             return browser, page
         logger.warning("会话 tab (target_id=%s) 已失效，重新获取", saved_id)
 
     page = browser.get_or_create_page()
-    _save_session_tab(page.target_id)
+    _save_session_tab(page.target_id, args.port)
     return browser, page
 
 
 def _connect_saved_tab(args: argparse.Namespace):
-    """连接到登录流程中记录的精确 tab（via _LOGIN_TAB_FILE），回退到第一个非空白 tab。"""
+    """连接到登录流程中记录的精确 tab，回退到第一个非空白 tab。"""
     from chrome_launcher import ensure_chrome, has_display
     from xhs.cdp import Browser
 
-    if not ensure_chrome(port=args.port, headless=not has_display()):
+    user_data_dir = _resolve_account(args)
+
+    if not ensure_chrome(port=args.port, headless=not has_display(), user_data_dir=user_data_dir):
         _output({"success": False, "error": "无法连接到 Chrome"}, exit_code=2)
 
     browser = Browser(host=args.host, port=args.port)
     browser.connect()
 
-    target_id = _load_login_tab()
+    target_id = _load_login_tab(args.port)
     if target_id:
         page = browser.get_page_by_target_id(target_id)
         if page:
@@ -141,7 +183,9 @@ def _connect_existing(args: argparse.Namespace):
     from chrome_launcher import ensure_chrome, has_display
     from xhs.cdp import Browser
 
-    if not ensure_chrome(port=args.port, headless=not has_display()):
+    user_data_dir = _resolve_account(args)
+
+    if not ensure_chrome(port=args.port, headless=not has_display(), user_data_dir=user_data_dir):
         _output(
             {"success": False, "error": "无法连接到 Chrome"},
             exit_code=2,
@@ -244,6 +288,8 @@ def cmd_login(args: argparse.Namespace) -> None:
             )
         )
         success = wait_for_login(page, timeout=120)
+        if success:
+            _update_account_nickname(args, page)
         _output(
             {"logged_in": success, "message": "登录成功" if success else "登录超时"},
             exit_code=0 if success else 2,
@@ -319,7 +365,7 @@ def cmd_get_qrcode(args: argparse.Namespace) -> None:
     qrcode_path = save_qrcode_to_file(png_bytes)
 
     # 记录 tab，供 wait-login 精确reconnect
-    _save_login_tab(page.target_id)
+    _save_login_tab(page.target_id, args.port)
 
     # 只断开 CDP 连接，不关闭 tab——QR 会话保持，用户可继续扫码
     browser.close()
@@ -340,7 +386,8 @@ def cmd_wait_login(args: argparse.Namespace) -> None:
     try:
         success = wait_for_login(page, timeout=args.timeout)
         if success:
-            _clear_login_tab()
+            _clear_login_tab(args.port)
+            _update_account_nickname(args, page)
         _output(
             {
                 "logged_in": success,
@@ -367,7 +414,7 @@ def cmd_send_code(args: argparse.Namespace) -> None:
                 return
 
             # 记录 tab，供 verify-code 精确 reconnect
-            _save_login_tab(page.target_id)
+            _save_login_tab(page.target_id, args.port)
             _output({
                 "status": "code_sent",
                 "message": f"验证码已发送至 {args.phone[:3]}****{args.phone[-4:]}，请运行 verify-code --code <验证码>",
@@ -393,7 +440,8 @@ def cmd_verify_code(args: argparse.Namespace) -> None:
     try:
         success = submit_phone_code(page, args.code)
         if success:
-            _clear_login_tab()
+            _clear_login_tab(args.port)
+            _update_account_nickname(args, page)
         _output(
             {"logged_in": success, "message": "登录成功" if success else "验证码错误或超时"},
             exit_code=0 if success else 2,
@@ -420,7 +468,7 @@ def cmd_delete_cookies(args: argparse.Namespace) -> None:
     path = get_cookies_file_path(args.account)
     delete_cookies(path)
 
-    _clear_session_tab()  # 退出登录后清除会话 tab 记录
+    _clear_session_tab(args.port)  # 退出登录后清除会话 tab 记录
     msg = "已退出登录并删除 cookies" if logged_out else "未登录，已删除 cookies 文件"
     _output({"success": True, "message": msg, "cookies_path": path})
 
@@ -817,6 +865,55 @@ def cmd_publish_video(args: argparse.Namespace) -> None:
         browser.close()
 
 
+# ========== 账号管理子命令 ==========
+
+
+def cmd_add_account(args: argparse.Namespace) -> None:
+    """添加命名账号，自动分配独立端口和 Chrome Profile。"""
+    import sys as _sys
+
+    _sys.path.insert(0, os.path.join(os.path.dirname(__file__)))
+    import account_manager
+
+    account_manager.add_account(args.name, description=args.description or "")
+    port = account_manager.get_account_port(args.name)
+    profile = account_manager.get_profile_dir(args.name)
+    _output({"success": True, "name": args.name, "port": port, "profile_dir": profile})
+
+
+def cmd_list_accounts(args: argparse.Namespace) -> None:
+    """列出所有命名账号。"""
+    import sys as _sys
+
+    _sys.path.insert(0, os.path.join(os.path.dirname(__file__)))
+    import account_manager
+
+    accounts = account_manager.list_accounts()
+    _output({"accounts": accounts, "count": len(accounts)})
+
+
+def cmd_remove_account(args: argparse.Namespace) -> None:
+    """删除命名账号。"""
+    import sys as _sys
+
+    _sys.path.insert(0, os.path.join(os.path.dirname(__file__)))
+    import account_manager
+
+    account_manager.remove_account(args.name)
+    _output({"success": True, "name": args.name})
+
+
+def cmd_set_default_account(args: argparse.Namespace) -> None:
+    """设置默认账号。"""
+    import sys as _sys
+
+    _sys.path.insert(0, os.path.join(os.path.dirname(__file__)))
+    import account_manager
+
+    account_manager.set_default_account(args.name)
+    _output({"success": True, "default": args.name})
+
+
 # ========== 参数解析 ==========
 
 
@@ -1001,6 +1098,26 @@ def build_parser() -> argparse.ArgumentParser:
     sub = subparsers.add_parser("save-draft", help="保存为草稿（取消发布时使用）")
     sub.set_defaults(func=cmd_save_draft)
 
+    # add-account（添加命名账号）
+    sub = subparsers.add_parser("add-account", help="添加命名账号，自动分配独立端口")
+    sub.add_argument("--name", required=True, help="账号名称")
+    sub.add_argument("--description", default="", help="账号描述（可选）")
+    sub.set_defaults(func=cmd_add_account)
+
+    # list-accounts（列出所有账号）
+    sub = subparsers.add_parser("list-accounts", help="列出所有命名账号")
+    sub.set_defaults(func=cmd_list_accounts)
+
+    # remove-account（删除账号）
+    sub = subparsers.add_parser("remove-account", help="删除命名账号")
+    sub.add_argument("--name", required=True, help="账号名称")
+    sub.set_defaults(func=cmd_remove_account)
+
+    # set-default-account（设置默认账号）
+    sub = subparsers.add_parser("set-default-account", help="设置默认账号")
+    sub.add_argument("--name", required=True, help="账号名称")
+    sub.set_defaults(func=cmd_set_default_account)
+
     return parser
 
 

@@ -47,6 +47,23 @@ def _wait_for_auth_ui(page: Page, timeout: float = 8.0) -> None:
         time.sleep(0.2)
 
 
+def get_current_user_nickname(page: Page) -> str:
+    """获取当前登录用户的昵称，失败时返回空字符串（best-effort）。"""
+    try:
+        page.navigate(EXPLORE_URL)
+        page.wait_for_load()
+        _wait_for_auth_ui(page)
+        if not page.has_element(LOGIN_STATUS):
+            return ""
+        nickname = page.evaluate(
+            f"document.querySelector({json.dumps(LOGIN_STATUS)})?.innerText?.trim() || ''"
+        )
+        return nickname or ""
+    except Exception:
+        logger.warning("获取用户昵称失败")
+        return ""
+
+
 def check_login_status(page: Page) -> bool:
     """检查登录状态。
 

@@ -39,6 +39,29 @@ metadata:
 | `send-code --phone` | 发送手机验证码 |
 | `verify-code --code` | 提交验证码完成登录 |
 | `delete-cookies` | 退出登录并清除 cookies |
+| `add-account --name` | 添加命名账号（自动分配端口） |
+| `list-accounts` | 列出所有命名账号及端口 |
+| `remove-account --name` | 删除命名账号 |
+| `set-default-account --name` | 设置默认账号 |
+
+---
+
+## 账号选择（前置步骤）
+
+> **例外**：用户要求"添加账号 / 列出账号 / 删除账号 / 设置默认账号"时，**跳过此步骤**，直接执行对应管理命令。
+
+其余操作（检查登录、登录、退出登录）先运行：
+
+```bash
+python scripts/cli.py list-accounts
+```
+
+根据返回的 `count`：
+- **0 个命名账号**：直接使用默认账号（后续命令不加 `--account`）。
+- **1 个命名账号**：告知用户"将对账号 X 执行操作"，直接加 `--account <名称>` 执行。
+- **多个命名账号**：向用户展示列表，询问操作哪个账号，用 `--account <选择的名称>` 执行后续命令。
+
+账号选定后，本次操作全程固定该账号，**不重复询问**。
 
 ---
 
@@ -132,6 +155,41 @@ python scripts/cli.py delete-cookies
 python scripts/cli.py --account work delete-cookies  # 指定账号
 ```
 
+## 多账号工作流
+
+每个命名账号拥有独立端口（从 9223 起递增）和独立 Chrome Profile，账号之间完全隔离。
+
+### 添加账号
+
+```bash
+python scripts/cli.py add-account --name work --description "工作号"
+# 输出: {"success": true, "name": "work", "port": 9223, "profile_dir": "..."}
+
+python scripts/cli.py add-account --name personal
+# 输出: {"success": true, "name": "personal", "port": 9224, "profile_dir": "..."}
+```
+
+### 使用指定账号执行操作
+
+通过全局 `--account` 参数指定账号，CLI 自动切换到对应端口和 Chrome Profile：
+
+```bash
+python scripts/cli.py --account work check-login
+python scripts/cli.py --account work get-qrcode
+python scripts/cli.py --account personal check-login
+python scripts/cli.py check-login  # 不指定账号，使用默认端口 9222
+```
+
+### 管理账号
+
+```bash
+python scripts/cli.py list-accounts                      # 列出所有账号及端口
+python scripts/cli.py set-default-account --name work    # 设置默认账号
+python scripts/cli.py remove-account --name personal     # 删除账号
+```
+
+---
+
 ## 失败处理
 
 - **Chrome 未找到**：提示用户安装 Google Chrome 或设置 `CHROME_BIN` 环境变量。

@@ -46,6 +46,23 @@ metadata:
 
 ---
 
+## 账号选择（前置步骤）
+
+每次 skill 触发后，先运行：
+
+```bash
+python scripts/cli.py list-accounts
+```
+
+根据返回的 `count`：
+- **0 个命名账号**：直接使用默认账号（后续命令不加 `--account`）。
+- **1 个命名账号**：告知用户"将使用账号 X"，直接加 `--account <名称>` 执行。
+- **多个命名账号**：向用户展示列表，询问选择哪个，再用 `--account <选择的名称>` 执行所有后续命令。
+
+账号选定后，本次操作全程固定该账号，**不重复询问**。
+
+---
+
 ## 输入判断
 
 按优先级判断：

@@ -40,6 +40,23 @@ metadata:
 
 ---
 
+## 账号选择（前置步骤）
+
+每次 skill 触发后，先运行：
+
+```bash
+python scripts/cli.py list-accounts
+```
+
+根据返回的 `count`：
+- **0 个命名账号**：直接使用默认账号（后续命令不加 `--account`）。
+- **1 个命名账号**：告知用户"将使用账号 X"，直接加 `--account <名称>` 执行。
+- **多个命名账号**：向用户展示列表，询问选择哪个，再用 `--account <选择的名称>` 执行所有后续命令。
+
+账号选定后，本次操作全程固定该账号，**不重复询问**。
+
+---
+
 ## 输入判断
 
 按优先级判断：

@@ -40,6 +40,23 @@ metadata:
 
 ---
 
+## 账号选择（前置步骤）
+
+每次 skill 触发后，先运行：
+
+```bash
+python scripts/cli.py list-accounts
+```
+
+根据返回的 `count`：
+- **0 个命名账号**：直接使用默认账号（后续命令不加 `--account`）。
+- **1 个命名账号**：告知用户"将使用账号 X"，直接加 `--account <名称>` 执行。
+- **多个命名账号**：向用户展示列表，询问选择哪个，再用 `--account <选择的名称>` 执行所有后续命令。
+
+账号选定后，本次操作全程固定该账号，**不重复询问**。
+
+---
+
 ## 输入判断
 
 按优先级判断：

@@ -45,6 +45,23 @@ metadata:
 
 ---
 
+## 账号选择（前置步骤）
+
+每次 skill 触发后，先运行：
+
+```bash
+python scripts/cli.py list-accounts
+```
+
+根据返回的 `count`：
+- **0 个命名账号**：直接使用默认账号（后续命令不加 `--account`）。
+- **1 个命名账号**：告知用户"将使用账号 X 发布"，直接加 `--account <名称>` 执行。
+- **多个命名账号**：向用户展示列表，**明确询问发布到哪个账号**，用 `--account <选择的名称>` 执行所有后续命令。
+
+账号选定后，本次发布全程固定该账号，**不重复询问**。
+
+---
+
 ## 输入判断
 
 按优先级判断：