hipowork-cli 0.2.0__tar.gz → 0.3.2__tar.gz

hipowork_cli-0.3.2/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: hipowork-cli
+Version: 0.3.2
+Summary: HiPo Work CLI — Agent 友好的招聘平台命令行工具集（OAuth 授权 / 岗位发布 / 候选人匹配 / 简历导入）
+Author-email: Lin Tong <sexylin2010@gmail.com>
+License: MIT
+Project-URL: Homepage, https://hipowork.com
+Project-URL: Repository, https://github.com/sexylin/hipowork-cli
+Project-URL: Documentation, https://hipowork.com
+Keywords: hipo,hipowork,recruitment,hiring,candidate-matching,cli,ai-agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.10
+Requires-Dist: httpx>=0.27
+Provides-Extra: resume
+Requires-Dist: pymupdf>=1.24; extra == "resume"
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+
+# hipowork-cli
+
+<div align="center">
+
+# 让你的简历，被 AI 看到
+### 让机会与人才自然相遇
+
+[![PyPI](https://img.shields.io/pypi/v/hipowork-cli?color=blue)](https://pypi.org/project/hipowork-cli/)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![OAuth 2.0](https://img.shields.io/badge/Auth-OAuth2.0-green)](https://oauth.net/2/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+[中文文档](README.md) · [English](README_EN.md)
+
+**官网：** [https://hipowork.com](https://hipowork.com) · [https://www.hipowork.com](https://www.hipowork.com)  
+**远程 MCP 服务：** `https://mcp.hipowork.com/mcp`  
+**API 服务端点：** `https://api.hipowork.com`
+
+</div>
+
+---
+
+## 🌟 平台理念
+
+在传统的招聘求职中，优秀的简历常常沉睡在静态文档或封闭的简历库中，被动等待死板的关键词匹配。
+
+**HiPo Work** 致力于改变这一现状：
+- **把简历沉淀为高精度语义资产**：通过 Agent 或客户端工具，求职者的专业技能、独立项目经验、工作职责与落地成果被全量结构化沉淀并生成向量。
+- **让你的简历被 AI 工具随时检索**：不管是 Claude Code、Cursor、OpenAI CodeX、Hermes Agent 还是企业招聘 Agent，都能在秒级通过工具精准检索、评估与连接候选人。
+- **让机会与人才自然相遇**：不再需要海投或盲目筛选，基于真实项目深度与核心能力，实现招聘方与求职者的双向精准触达。
+
+---
+
+## 🔗 相关生态与公开仓库
+
+HiPo Work 提供了完整的 Agent 原生招聘生态，涵盖命令行工具、MCP 服务与 Web 控制台：
+
+| 项目 / 平台 | 链接 | 说明 |
+|------------|------|------|
+| **官方网站** | [hipowork.com](https://hipowork.com) | 包含求职者中心、招聘方控制台、岗位发布与语义匹配演示 |
+| **hipowork-cli**（本项目） | [github.com/sexylin/hipowork-cli](https://github.com/sexylin/hipowork-cli) | 客户端命令行工具集（PyPI: `pip install hipowork-cli`），提供 `hipo` 与 `hipowork-cli` 终端命令 |
+| **hipo-mcp** | [github.com/sexylin/hipo-mcp](https://github.com/sexylin/hipo-mcp) | 远程 MCP 服务端，遵循 Model Context Protocol 标准，支持 OAuth 2.0 (PKCE) |
+| **MCP Registry** | `io.github.sexylin/hipo-work` | MCP 官方 Registry 认证注册服务坐标 |
+
+---
+
+## 📦 安装
+
+```bash
+# 从 PyPI 安装（推荐，要求 Python 3.10+）
+pip install hipowork-cli
+
+# 可选：支持本地简历 PDF 文本提取依赖
+pip install hipowork-cli[resume]
+```
+
+安装完成后系统提供两个完全等价的命令行入口：`hipo` 与 `hipowork-cli`。
+
+---
+
+## 🚀 快速开始
+
+### 1. 登录与授权
+
+```bash
+# 求职者登录（终端将打印标准引导并在浏览器完成邮箱验证）
+hipowork-cli login --role candidate     # 或: hipo login --role candidate
+
+# 招聘方登录
+hipowork-cli login --role employer
+```
+
+> **提示**：
+> - 首次授权需要在浏览器完成邮箱验证码登录；如果你已经在 HiPo Work Web 端（[hipowork.com](https://hipowork.com)）登录过，授权页将直接显示**「确认授权」**，一键放行免重复输入验证码。
+> - 授权完成后 Token 自动刷新与持久化，存放在本机 `~/.hipo_mcp_tokens.json`（0600 权限），无需手动维护。
+> - CLI 授权成功还会自动打开 Web Handoff 页面直接进入对应的 Profile 档案页。
+
+### 2. 状态检查与账户管理
+
+```bash
+hipo status          # 查看当前登录身份、Token 有效期与 Scope 权限
+hipo refresh         # 强制轮换 Access Token
+hipo accounts list   # 查看已登录的多账户（支持多邮箱、多角色随时切换）
+```
+
+### 3. 日常使用
+
+```bash
+# 求职者：根据简历智能匹配在招岗位
+hipo match-jobs
+
+# 求职者：导入结构化简历并上传本地附件
+hipo resume-import --json my_resume.json --attachment my_resume.pdf
+
+# 招聘方：发布招聘岗位
+hipo publish-job --json examples/job.example.json
+
+# 招聘方：自然语言搜索候选人
+hipo search "成都 5年经验 熟悉Solidity和Go的全栈"
+```
+
+---
+
+## 📋 命令速查表
+
+### 认证与凭据
+| 命令 | 说明 |
+|---|---|
+| `hipowork-cli login --role candidate/employer` | 统一登录入口（打印格式化引导并打开浏览器授权） |
+| `hipo authorize --role candidate/employer` | OAuth 授权（login 别名，PKCE + 邮箱验证码） |
+| `hipo status` | 查看当前 Token 状态、角色、权限与过期时间 |
+| `hipo refresh` | 强制刷新 Access Token |
+| `hipo token-sync [--refresh]` | 导出 Token 供浏览器前端调试使用（Base64 格式） |
+| `hipo accounts list/current/switch/delete` | 多账户管理（支持多个角色与邮箱多凭据隔离存储） |
+
+### 求职者（Candidate）
+| 命令 | 说明 |
+|---|---|
+| `hipo match-jobs [--json]` | 根据我的简历匹配全平台岗位，输出按匹配度排序的列表及多维度评分 |
+| `hipo resume-extract <file.pdf> [--out x.txt]` | 本地提取简历文本（支持 PDF、DOCX、TXT） |
+| `hipo resume-validate <resume.json>` | 导入前校验 JSON 结构（包括 duration_months、projects 完整性等） |
+| `hipo resume-import --json <resume.json> [--attachment file.pdf]` | **核心推荐**：直接导入本地结构化简历，支持携带原件附件存档 |
+| `hipo resume-import --text <resume.txt>` | 传入简历纯文本，走平台后端 AI 服务解析后导入 |
+
+### 招聘方（Employer）
+| 命令 | 说明 |
+|---|---|
+| `hipo publish-job --title x --text "..." [--json file]` | 发布招聘需求（支持结构化条件与面议设置） |
+| `hipo close-job <job_id>` | 关闭已发布的职位（关闭后不再被候选人检索或参与匹配） |
+| `hipo search "自然语言描述" [--max n]` | 自然语言直接检索候选人人格与经历 |
+| `hipo match-candidates --text "..." / --json cond.json / --job <id>` | 结构化多维度候选人匹配（支持技能硬过滤与向量语义检索） |
+| `hipo market --keyword python [--industry tech]` | 技能与行业人才市场供需热度分析 |
+| `hipo stats` | 平台统计概览（在招职位、人才分布等） |
+
+### 运维与端到端诊断
+| 命令 | 说明 |
+|---|---|
+| `hipo healthcheck` | 一键体检：检查 API / MCP / OAuth metadata / Embedding 全链路连通性 |
+| `hipo e2e` | 完整端到端冒烟测试：Token 校验 → REST /auth/me → MCP 会话 → 受保护工具调用 |
+
+> 任意命令均可添加 `--help` 查看完整参数；大部分命令支持 `--json` 输出结构化数据，方便与自动化脚本结合。
+
+---
+
+## 📄 简历导入的最佳实践
+
+### 1. 推荐方式：`--json`（带独立项目经历与原始附件）
+使用你本地的 LLM 或 Agent 将简历提炼为结构化 JSON（参考 `examples/resume.example.json`），重点保留：
+- **`projects`**：独立作品、开源项目、商业落地专项等（作为一等公民数据独立呈现）；
+- **`work_experiences`**：职责、成果、技术栈及精确的 `duration_months`（用于累计工作年限）；
+- **`--attachment`**：携带本地原始 PDF/Word 附件，自动上传加密存储并供招聘方预览。
+
+```bash
+hipo resume-import --json my_resume.json --attachment my_resume.pdf
+```
+
+### 2. 文本解析方式：`--text`
+如果你不想手动组织 JSON，也可以直接提取文本由后端 AI 统一解析：
+```bash
+hipo resume-extract my_resume.pdf --out resume.txt
+hipo resume-import --text resume.txt
+```
+
+---
+
+## 🛠️ 本地开发与源码运行
+
+```bash
+git clone git@github.com:sexylin/hipowork-cli.git
+cd hipowork-cli
+
+python3 -m venv .venv
+.venv/bin/pip install -e .[resume]
+
+# 运行完整单元测试套件
+.venv/bin/python -m unittest discover -s tests
+```
+
+---
+
+## 📄 License
+
+本项目基于 [MIT License](LICENSE) 开源。

hipowork_cli-0.3.2/README.md

@@ -0,0 +1,183 @@
+# hipowork-cli
+
+<div align="center">
+
+# 让你的简历，被 AI 看到
+### 让机会与人才自然相遇
+
+[![PyPI](https://img.shields.io/pypi/v/hipowork-cli?color=blue)](https://pypi.org/project/hipowork-cli/)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![OAuth 2.0](https://img.shields.io/badge/Auth-OAuth2.0-green)](https://oauth.net/2/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+[中文文档](README.md) · [English](README_EN.md)
+
+**官网：** [https://hipowork.com](https://hipowork.com) · [https://www.hipowork.com](https://www.hipowork.com)  
+**远程 MCP 服务：** `https://mcp.hipowork.com/mcp`  
+**API 服务端点：** `https://api.hipowork.com`
+
+</div>
+
+---
+
+## 🌟 平台理念
+
+在传统的招聘求职中，优秀的简历常常沉睡在静态文档或封闭的简历库中，被动等待死板的关键词匹配。
+
+**HiPo Work** 致力于改变这一现状：
+- **把简历沉淀为高精度语义资产**：通过 Agent 或客户端工具，求职者的专业技能、独立项目经验、工作职责与落地成果被全量结构化沉淀并生成向量。
+- **让你的简历被 AI 工具随时检索**：不管是 Claude Code、Cursor、OpenAI CodeX、Hermes Agent 还是企业招聘 Agent，都能在秒级通过工具精准检索、评估与连接候选人。
+- **让机会与人才自然相遇**：不再需要海投或盲目筛选，基于真实项目深度与核心能力，实现招聘方与求职者的双向精准触达。
+
+---
+
+## 🔗 相关生态与公开仓库
+
+HiPo Work 提供了完整的 Agent 原生招聘生态，涵盖命令行工具、MCP 服务与 Web 控制台：
+
+| 项目 / 平台 | 链接 | 说明 |
+|------------|------|------|
+| **官方网站** | [hipowork.com](https://hipowork.com) | 包含求职者中心、招聘方控制台、岗位发布与语义匹配演示 |
+| **hipowork-cli**（本项目） | [github.com/sexylin/hipowork-cli](https://github.com/sexylin/hipowork-cli) | 客户端命令行工具集（PyPI: `pip install hipowork-cli`），提供 `hipo` 与 `hipowork-cli` 终端命令 |
+| **hipo-mcp** | [github.com/sexylin/hipo-mcp](https://github.com/sexylin/hipo-mcp) | 远程 MCP 服务端，遵循 Model Context Protocol 标准，支持 OAuth 2.0 (PKCE) |
+| **MCP Registry** | `io.github.sexylin/hipo-work` | MCP 官方 Registry 认证注册服务坐标 |
+
+---
+
+## 📦 安装
+
+```bash
+# 从 PyPI 安装（推荐，要求 Python 3.10+）
+pip install hipowork-cli
+
+# 可选：支持本地简历 PDF 文本提取依赖
+pip install hipowork-cli[resume]
+```
+
+安装完成后系统提供两个完全等价的命令行入口：`hipo` 与 `hipowork-cli`。
+
+---
+
+## 🚀 快速开始
+
+### 1. 登录与授权
+
+```bash
+# 求职者登录（终端将打印标准引导并在浏览器完成邮箱验证）
+hipowork-cli login --role candidate     # 或: hipo login --role candidate
+
+# 招聘方登录
+hipowork-cli login --role employer
+```
+
+> **提示**：
+> - 首次授权需要在浏览器完成邮箱验证码登录；如果你已经在 HiPo Work Web 端（[hipowork.com](https://hipowork.com)）登录过，授权页将直接显示**「确认授权」**，一键放行免重复输入验证码。
+> - 授权完成后 Token 自动刷新与持久化，存放在本机 `~/.hipo_mcp_tokens.json`（0600 权限），无需手动维护。
+> - CLI 授权成功还会自动打开 Web Handoff 页面直接进入对应的 Profile 档案页。
+
+### 2. 状态检查与账户管理
+
+```bash
+hipo status          # 查看当前登录身份、Token 有效期与 Scope 权限
+hipo refresh         # 强制轮换 Access Token
+hipo accounts list   # 查看已登录的多账户（支持多邮箱、多角色随时切换）
+```
+
+### 3. 日常使用
+
+```bash
+# 求职者：根据简历智能匹配在招岗位
+hipo match-jobs
+
+# 求职者：导入结构化简历并上传本地附件
+hipo resume-import --json my_resume.json --attachment my_resume.pdf
+
+# 招聘方：发布招聘岗位
+hipo publish-job --json examples/job.example.json
+
+# 招聘方：自然语言搜索候选人
+hipo search "成都 5年经验 熟悉Solidity和Go的全栈"
+```
+
+---
+
+## 📋 命令速查表
+
+### 认证与凭据
+| 命令 | 说明 |
+|---|---|
+| `hipowork-cli login --role candidate/employer` | 统一登录入口（打印格式化引导并打开浏览器授权） |
+| `hipo authorize --role candidate/employer` | OAuth 授权（login 别名，PKCE + 邮箱验证码） |
+| `hipo status` | 查看当前 Token 状态、角色、权限与过期时间 |
+| `hipo refresh` | 强制刷新 Access Token |
+| `hipo token-sync [--refresh]` | 导出 Token 供浏览器前端调试使用（Base64 格式） |
+| `hipo accounts list/current/switch/delete` | 多账户管理（支持多个角色与邮箱多凭据隔离存储） |
+
+### 求职者（Candidate）
+| 命令 | 说明 |
+|---|---|
+| `hipo match-jobs [--json]` | 根据我的简历匹配全平台岗位，输出按匹配度排序的列表及多维度评分 |
+| `hipo resume-extract <file.pdf> [--out x.txt]` | 本地提取简历文本（支持 PDF、DOCX、TXT） |
+| `hipo resume-validate <resume.json>` | 导入前校验 JSON 结构（包括 duration_months、projects 完整性等） |
+| `hipo resume-import --json <resume.json> [--attachment file.pdf]` | **核心推荐**：直接导入本地结构化简历，支持携带原件附件存档 |
+| `hipo resume-import --text <resume.txt>` | 传入简历纯文本，走平台后端 AI 服务解析后导入 |
+
+### 招聘方（Employer）
+| 命令 | 说明 |
+|---|---|
+| `hipo publish-job --title x --text "..." [--json file]` | 发布招聘需求（支持结构化条件与面议设置） |
+| `hipo close-job <job_id>` | 关闭已发布的职位（关闭后不再被候选人检索或参与匹配） |
+| `hipo search "自然语言描述" [--max n]` | 自然语言直接检索候选人人格与经历 |
+| `hipo match-candidates --text "..." / --json cond.json / --job <id>` | 结构化多维度候选人匹配（支持技能硬过滤与向量语义检索） |
+| `hipo market --keyword python [--industry tech]` | 技能与行业人才市场供需热度分析 |
+| `hipo stats` | 平台统计概览（在招职位、人才分布等） |
+
+### 运维与端到端诊断
+| 命令 | 说明 |
+|---|---|
+| `hipo healthcheck` | 一键体检：检查 API / MCP / OAuth metadata / Embedding 全链路连通性 |
+| `hipo e2e` | 完整端到端冒烟测试：Token 校验 → REST /auth/me → MCP 会话 → 受保护工具调用 |
+
+> 任意命令均可添加 `--help` 查看完整参数；大部分命令支持 `--json` 输出结构化数据，方便与自动化脚本结合。
+
+---
+
+## 📄 简历导入的最佳实践
+
+### 1. 推荐方式：`--json`（带独立项目经历与原始附件）
+使用你本地的 LLM 或 Agent 将简历提炼为结构化 JSON（参考 `examples/resume.example.json`），重点保留：
+- **`projects`**：独立作品、开源项目、商业落地专项等（作为一等公民数据独立呈现）；
+- **`work_experiences`**：职责、成果、技术栈及精确的 `duration_months`（用于累计工作年限）；
+- **`--attachment`**：携带本地原始 PDF/Word 附件，自动上传加密存储并供招聘方预览。
+
+```bash
+hipo resume-import --json my_resume.json --attachment my_resume.pdf
+```
+
+### 2. 文本解析方式：`--text`
+如果你不想手动组织 JSON，也可以直接提取文本由后端 AI 统一解析：
+```bash
+hipo resume-extract my_resume.pdf --out resume.txt
+hipo resume-import --text resume.txt
+```
+
+---
+
+## 🛠️ 本地开发与源码运行
+
+```bash
+git clone git@github.com:sexylin/hipowork-cli.git
+cd hipowork-cli
+
+python3 -m venv .venv
+.venv/bin/pip install -e .[resume]
+
+# 运行完整单元测试套件
+.venv/bin/python -m unittest discover -s tests
+```
+
+---
+
+## 📄 License
+
+本项目基于 [MIT License](LICENSE) 开源。

{hipowork_cli-0.2.0 → hipowork_cli-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hipowork-cli"
-version = "0.2.0"
+version = "0.3.2"
 description = "HiPo Work CLI — Agent 友好的招聘平台命令行工具集（OAuth 授权 / 岗位发布 / 候选人匹配 / 简历导入）"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -41,6 +41,7 @@ Documentation = "https://hipowork.com"
 
 [project.scripts]
 hipo = "hipowork_cli:main"
+hipowork-cli = "hipowork_cli:main"
 
 [tool.setuptools]
 package-dir = { "" = "src" }

{hipowork_cli-0.2.0 → hipowork_cli-0.3.2}/src/hipowork_cli/__init__.py

@@ -15,12 +15,13 @@ import subprocess
 import sys
 from pathlib import Path
 
-__version__ = "0.2.0"
+__version__ = "0.3.2"
 
 SCRIPTS_DIR = Path(__file__).resolve().parent / "scripts"
 
 # 命令名 → 对应脚本文件（不含 .py）
 COMMANDS = {
+    "login": "hipo_authorize",
     "authorize": "hipo_authorize",
     "status": "hipo_token_status",
     "refresh": "hipo_token_refresh",
@@ -42,7 +43,8 @@ COMMANDS = {
 
 # 各命令的一句话说明（help 输出用）
 HELP = {
-    "authorize": "OAuth 授权（打开浏览器完成邮箱验证码登录）",
+    "login": "登录/授权（在终端提供链接并在浏览器完成邮箱验证）",
+    "authorize": "OAuth 授权（login 的别名）",
     "status": "查看 token 状态（角色/scope/过期）",
     "refresh": "强制刷新 token",
     "token-sync": "导出 token 到浏览器 localStorage（4 个 base64）",
@@ -72,7 +74,7 @@ def _print_help() -> None:
     print("HiPo Work CLI — 统一入口")
     print("用法: hipo <command> [args...]\n")
     print("认证与令牌:")
-    for k in ("authorize", "status", "refresh", "token-sync", "accounts"):
+    for k in ("login", "authorize", "status", "refresh", "token-sync", "accounts"):
         print(f"  {k:<16} {HELP[k]}")
     print("\n招聘方:")
     for k in ("publish-job", "close-job", "search", "match-candidates", "market", "stats"):

hipowork_cli-0.3.2/src/hipowork_cli/__main__.py

@@ -0,0 +1,5 @@
+from hipowork_cli import main
+import sys
+
+if __name__ == "__main__":
+    sys.exit(main())

{hipowork_cli-0.2.0 → hipowork_cli-0.3.2}/src/hipowork_cli/scripts/hipo_authorize.py

@@ -117,34 +117,35 @@ class CallbackServer:
 
 
 async def redirect_handler(url: str) -> None:
-    print("\n=== 请在浏览器完成授权（邮箱验证码登录）===")
-    print("授权 URL:")
-    print(url)
-    print()
+    print("\nTo authenticate, please:")
+    print(f"1. Go to: {url}")
+    print("\n2. Complete email verification and authorize in the browser.")
+    print("3. Waiting for authentication callback...\n")
     try:
         webbrowser.open(url)
-        print("(已尝试自动打开浏览器；若未打开请手动复制上面的 URL)")
+        print("(Attempting to automatically open the browser; if it doesn't open, copy and paste the URL above.)")
     except Exception:
         pass
 
 
 async def run(port: int, role: str, email: str) -> int:
+    import httpx2
     from mcp import ClientSession
     from mcp.client.auth import OAuthClientProvider
-    from mcp.client.streamable_http import streamablehttp_client
-    from mcp.shared.auth import OAuthClientMetadata
+    from mcp.client.streamable_http import streamable_http_client, create_mcp_http_client
+    from mcp.shared.auth import OAuthClientMetadata, AuthorizationCodeResult
 
     cb = CallbackServer(port, role)
     cb.start()
 
-    async def callback_handler() -> tuple[str, str | None]:
+    async def callback_handler() -> AuthorizationCodeResult:
         print("\n等待浏览器授权回调...")
         await asyncio.to_thread(cb.received.wait, 600)
         code, state = cb.code, cb.state
         if not code:
             raise RuntimeError("回调未收到授权码（可能超时或用户取消）")
         print(f"收到回调 code={code[:12]}... state={state[:12]}...")
-        return code, state
+        return AuthorizationCodeResult(code=code, state=state)
 
     metadata = OAuthClientMetadata(
         client_name="hipowork-cli",
@@ -162,32 +163,71 @@ async def run(port: int, role: str, email: str) -> int:
         storage=_StorageAdapter(store),
         redirect_handler=redirect_handler,
         callback_handler=callback_handler,
-        timeout=600,
     )
 
     print(f"连接 {DEFAULT_MCP_URL} ...")
     try:
-        async with streamablehttp_client(DEFAULT_MCP_URL, timeout=30, auth=oauth) as (read, write, _sid):
-            async with ClientSession(read, write) as session:
-                init = await session.initialize()
-                print("\nMCP INIT OK")
-                print("  server:", init.serverInfo.name, init.serverInfo.version)
-                tools = await session.list_tools()
-                print(f"\nTOOLS ({len(tools.tools)}):")
-                for t in tools.tools:
-                    first = (t.description or "").splitlines()[0]
-                    print(f"  - {t.name}: {first}")
-
-                # token 已在 storage 落盘；补记 email/role 到账户信息
-                acc = store.get_account()
-                if acc is not None:
-                    if email:
-                        acc["email"] = email
-                    acc["role"] = role
-                    store.set_account(store.default_account(), acc)
-                print("\n✅ 授权完成，token 已保存到本地仓库。")
-                print("   后续可用 hipo_token_status.py / hipo_token_sync.py / hipo_mcp_client.py 复用。")
-                return 0
+        http_client = create_mcp_http_client(auth=oauth, timeout=httpx2.Timeout(30.0, read=600.0))
+        async with http_client:
+            async with streamable_http_client(DEFAULT_MCP_URL, http_client=http_client) as (read, write):
+                async with ClientSession(read, write) as session:
+                    init = await session.initialize()
+                    print("\nMCP INIT OK")
+                    print("  server:", init.server_info.name, init.server_info.version)
+                    tools = await session.list_tools()
+                    print(f"\nTOOLS ({len(tools.tools)}):")
+                    for t in tools.tools:
+                        first = (t.description or "").splitlines()[0]
+                        print(f"  - {t.name}: {first}")
+
+                    # token 已在 storage 落盘；补记 email/role 到账户信息。
+                    # P1-12: 角色以服务端 /auth/me 返回的真实角色为准（本地 --role
+                    # 只是授权页初选，服务端可能因角色选择页/已有档案而不同）。
+                    acc = store.get_account()
+                    if acc is not None:
+                        if email:
+                            acc["email"] = email
+                        try:
+                            from hipo_auth import api_request, DEFAULT_API_BASE
+                            me = api_request("GET", "/auth/me", token=store.tokens().get("access_token"), api_base=DEFAULT_API_BASE)
+                            server_role = str(me.get("role") or "").strip()
+                            if server_role:
+                                acc["role"] = server_role
+                            if me.get("email"):
+                                acc["email"] = me["email"]
+                        except Exception as exc:  # noqa: BLE001
+                            # /auth/me 不可用时回退到本地角色（降级但不阻塞授权完成）
+                            print(f"  ⚠️ 读取服务端角色失败，回退本地角色: {type(exc).__name__}: {str(exc)[:200]}")
+                            acc["role"] = role
+                        store.set_account(store.default_account(), acc)
+
+                    # CLI/MCP 授权成功 → 桥接 Web 登录态：自动打开 /oauth/handoff。
+                    # 方案A：payload 只传 access_token + client_id，不传 refresh_token。
+                    # CLI 的 refresh 是旋转式一次性凭证（任一端刷新都会作废旧值），
+                    # 与浏览器共享同一根 refresh 会在下一次刷新时互相作废（does not
+                    # exist）。因此这里给浏览器的是"限时浏览会话"：access 过期后前端
+                    # 不再自动刷新，引导走标准 PKCE 拿 Web 自己的链。
+                    try:
+                        import base64 as _b64
+                        toks = store.tokens()
+                        cinfo = store.client_info()
+                        if toks.get("access_token") and cinfo.get("client_id"):
+                            payload_json = json.dumps({
+                                "access_token": toks["access_token"],
+                                "client_id": cinfo["client_id"],
+                                "expires_in": toks.get("expires_in") or 900,
+                            }).encode()
+                            # base64url（无填充，与前端 atob 前补 '=' 的逻辑匹配）
+                            payload_b64 = _b64.urlsafe_b64encode(payload_json).rstrip(b"=").decode()
+                            handoff_url = f"https://www.hipowork.com/oauth/handoff#payload={payload_b64}"
+                            webbrowser.open(handoff_url)
+                            print("\n🌐 已在浏览器打开 HiPo Work Web 登录态并跳转到个人中心（限时会话，access 过期后引导重新登录）。")
+                    except Exception as exc:  # noqa: BLE001
+                        print(f"  ⚠️ 打开 Web 登录态失败（不影响 CLI 授权）：{type(exc).__name__}: {str(exc)[:200]}")
+
+                    print("\n✅ 授权完成，token 已保存到本地仓库。")
+                    print("   后续可用 hipo_token_status.py / hipo_token_sync.py / hipo_mcp_client.py 复用。")
+                    return 0
     except Exception as exc:
         print(f"授权失败: {type(exc).__name__}: {str(exc)[:800]}")
         return 1