huimei 0.1.0__tar.gz

huimei-0.1.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: huimei
+Version: 0.1.0
+Summary: Multi-platform social media automation CLI — publish to Douyin, XHS, Bilibili, Weibo and 8+ platforms from your terminal
+Author: HuiMei Team
+License: MIT
+Project-URL: Homepage, https://github.com/huimei-engine/huimei-cli
+Project-URL: Repository, https://codeup.aliyun.com/6832d8ec9c32f0e37238744f/huimei-cli
+Keywords: social-media,automation,cli,douyin,bilibili,xiaohongshu,playwright,cross-posting,marketing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+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: Topic :: Internet
+Classifier: Topic :: Multimedia
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pycryptodome>=3.20.0
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# 慧媒引擎 CLI (huimei)
+
+多平台社媒自动化发布工具 — 一个命令发布到抖音/快手/B站/小红书/微博等11个平台。
+
+## 安装
+
+### 方式1: pip (推荐)
+```bash
+pip install huimei
+playwright install chromium
+```
+
+### 方式2: pipx (隔离环境)
+```bash
+pipx install huimei
+playwright install chromium
+```
+
+### 方式3: 一键脚本
+```bash
+curl -fsSL https://raw.githubusercontent.com/huimei-engine/huimei-cli/main/install.sh | bash
+```
+
+## 快速开始
+
+```bash
+# 登录
+huimei login
+
+# 查看支持的平台
+huimei platforms
+
+# 查看已绑定账号
+huimei account list
+
+# 查看状态
+huimei status
+```
+
+## AI Agent 集成 (MCP Server)
+
+huimei 内置 MCP Server，可供 Claude Code / Hermes / OpenCode 等 AI Agent 直接调用：
+
+### Claude Code 配置
+```json
+{
+  "mcpServers": {
+    "huimei": {
+      "command": "huimei-mcp-server",
+      "args": []
+    }
+  }
+}
+```
+
+### Hermes Agent 配置
+```yaml
+mcp_servers:
+  huimei:
+    command: huimei-mcp-server
+```
+
+### 可用工具
+
+| 工具 | 说明 |
+|------|------|
+| `huimei_login` | 登录账号 |
+| `huimei_status` | 查看状态 |
+| `huimei_logout` | 登出 |
+| `huimei_platforms` | 列出支持平台 |
+| `huimei_accounts` | 列出绑定账号 |
+| `huimei_publish` | 创建发布任务 |
+
+## 架构
+
+```
+CLI (本地) ──HTTP──► Java后端 (云端)
+  │                    │
+  ├─ Playwright        ├─ 账号管理
+  ├─ Cookie本地存储    ├─ 任务调度
+  └─ 住宅IP执行       └─ 订阅计费
+```
+
+CLI 是后端的远程执行器（手臂），所有业务决策由后端（大脑）做出。
+
+## 开发
+
+```bash
+git clone <repo>
+cd huimei-cli
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

huimei-0.1.0/README.md

@@ -0,0 +1,98 @@
+# 慧媒引擎 CLI (huimei)
+
+多平台社媒自动化发布工具 — 一个命令发布到抖音/快手/B站/小红书/微博等11个平台。
+
+## 安装
+
+### 方式1: pip (推荐)
+```bash
+pip install huimei
+playwright install chromium
+```
+
+### 方式2: pipx (隔离环境)
+```bash
+pipx install huimei
+playwright install chromium
+```
+
+### 方式3: 一键脚本
+```bash
+curl -fsSL https://raw.githubusercontent.com/huimei-engine/huimei-cli/main/install.sh | bash
+```
+
+## 快速开始
+
+```bash
+# 登录
+huimei login
+
+# 查看支持的平台
+huimei platforms
+
+# 查看已绑定账号
+huimei account list
+
+# 查看状态
+huimei status
+```
+
+## AI Agent 集成 (MCP Server)
+
+huimei 内置 MCP Server，可供 Claude Code / Hermes / OpenCode 等 AI Agent 直接调用：
+
+### Claude Code 配置
+```json
+{
+  "mcpServers": {
+    "huimei": {
+      "command": "huimei-mcp-server",
+      "args": []
+    }
+  }
+}
+```
+
+### Hermes Agent 配置
+```yaml
+mcp_servers:
+  huimei:
+    command: huimei-mcp-server
+```
+
+### 可用工具
+
+| 工具 | 说明 |
+|------|------|
+| `huimei_login` | 登录账号 |
+| `huimei_status` | 查看状态 |
+| `huimei_logout` | 登出 |
+| `huimei_platforms` | 列出支持平台 |
+| `huimei_accounts` | 列出绑定账号 |
+| `huimei_publish` | 创建发布任务 |
+
+## 架构
+
+```
+CLI (本地) ──HTTP──► Java后端 (云端)
+  │                    │
+  ├─ Playwright        ├─ 账号管理
+  ├─ Cookie本地存储    ├─ 任务调度
+  └─ 住宅IP执行       └─ 订阅计费
+```
+
+CLI 是后端的远程执行器（手臂），所有业务决策由后端（大脑）做出。
+
+## 开发
+
+```bash
+git clone <repo>
+cd huimei-cli
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

huimei-0.1.0/huimei.egg-info/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: huimei
+Version: 0.1.0
+Summary: Multi-platform social media automation CLI — publish to Douyin, XHS, Bilibili, Weibo and 8+ platforms from your terminal
+Author: HuiMei Team
+License: MIT
+Project-URL: Homepage, https://github.com/huimei-engine/huimei-cli
+Project-URL: Repository, https://codeup.aliyun.com/6832d8ec9c32f0e37238744f/huimei-cli
+Keywords: social-media,automation,cli,douyin,bilibili,xiaohongshu,playwright,cross-posting,marketing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+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: Topic :: Internet
+Classifier: Topic :: Multimedia
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.12.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pycryptodome>=3.20.0
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+
+# 慧媒引擎 CLI (huimei)
+
+多平台社媒自动化发布工具 — 一个命令发布到抖音/快手/B站/小红书/微博等11个平台。
+
+## 安装
+
+### 方式1: pip (推荐)
+```bash
+pip install huimei
+playwright install chromium
+```
+
+### 方式2: pipx (隔离环境)
+```bash
+pipx install huimei
+playwright install chromium
+```
+
+### 方式3: 一键脚本
+```bash
+curl -fsSL https://raw.githubusercontent.com/huimei-engine/huimei-cli/main/install.sh | bash
+```
+
+## 快速开始
+
+```bash
+# 登录
+huimei login
+
+# 查看支持的平台
+huimei platforms
+
+# 查看已绑定账号
+huimei account list
+
+# 查看状态
+huimei status
+```
+
+## AI Agent 集成 (MCP Server)
+
+huimei 内置 MCP Server，可供 Claude Code / Hermes / OpenCode 等 AI Agent 直接调用：
+
+### Claude Code 配置
+```json
+{
+  "mcpServers": {
+    "huimei": {
+      "command": "huimei-mcp-server",
+      "args": []
+    }
+  }
+}
+```
+
+### Hermes Agent 配置
+```yaml
+mcp_servers:
+  huimei:
+    command: huimei-mcp-server
+```
+
+### 可用工具
+
+| 工具 | 说明 |
+|------|------|
+| `huimei_login` | 登录账号 |
+| `huimei_status` | 查看状态 |
+| `huimei_logout` | 登出 |
+| `huimei_platforms` | 列出支持平台 |
+| `huimei_accounts` | 列出绑定账号 |
+| `huimei_publish` | 创建发布任务 |
+
+## 架构
+
+```
+CLI (本地) ──HTTP──► Java后端 (云端)
+  │                    │
+  ├─ Playwright        ├─ 账号管理
+  ├─ Cookie本地存储    ├─ 任务调度
+  └─ 住宅IP执行       └─ 订阅计费
+```
+
+CLI 是后端的远程执行器（手臂），所有业务决策由后端（大脑）做出。
+
+## 开发
+
+```bash
+git clone <repo>
+cd huimei-cli
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

huimei-0.1.0/huimei.egg-info/SOURCES.txt

@@ -0,0 +1,41 @@
+README.md
+pyproject.toml
+huimei.egg-info/PKG-INFO
+huimei.egg-info/SOURCES.txt
+huimei.egg-info/dependency_links.txt
+huimei.egg-info/entry_points.txt
+huimei.egg-info/requires.txt
+huimei.egg-info/top_level.txt
+huimei_cli/__init__.py
+huimei_cli/api_client.py
+huimei_cli/auth.py
+huimei_cli/config.py
+huimei_cli/main.py
+huimei_cli/mcp_server.py
+huimei_cli/commands/__init__.py
+huimei_cli/commands/account_cmd.py
+huimei_cli/commands/auth_cmd.py
+huimei_cli/commands/publish_cmd.py
+huimei_cli/engine/__init__.py
+huimei_cli/engine/browser.py
+huimei_cli/engine/output.py
+huimei_cli/engine/router.py
+huimei_cli/engine/session.py
+huimei_cli/platforms/__init__.py
+huimei_cli/platforms/registry/__init__.py
+huimei_cli/platforms/registry/_template.py
+huimei_cli/platforms/registry/baijiahao.py
+huimei_cli/platforms/registry/bilibili.py
+huimei_cli/platforms/registry/douyin.py
+huimei_cli/platforms/registry/ks.py
+huimei_cli/platforms/registry/sample.py
+huimei_cli/platforms/registry/tencent.py
+huimei_cli/platforms/registry/tk.py
+huimei_cli/platforms/registry/toutiao.py
+huimei_cli/platforms/registry/weibo.py
+huimei_cli/platforms/registry/weixingongzhonghao.py
+huimei_cli/platforms/registry/xhs.py
+huimei_cli/platforms/registry/zhihu.py
+tests/test_cli.py
+tests/test_core.py
+tests/test_mcp.py

huimei-0.1.0/huimei.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

huimei-0.1.0/huimei.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+huimei = huimei_cli.main:app
+huimei-mcp-server = huimei_cli.mcp_server:main

huimei-0.1.0/huimei.egg-info/requires.txt

@@ -0,0 +1,14 @@
+typer>=0.12.0
+httpx>=0.27.0
+rich>=13.0.0
+playwright>=1.40.0
+pydantic>=2.0.0
+pycryptodome>=3.20.0
+keyring>=25.0.0
+mcp>=1.0.0
+
+[dev]
+pytest>=8.0.0
+pytest-asyncio>=0.23.0
+build
+twine

huimei-0.1.0/huimei.egg-info/top_level.txt

@@ -0,0 +1 @@
+huimei_cli

huimei-0.1.0/huimei_cli/__init__.py

@@ -0,0 +1,2 @@
+"""慧媒引擎CLI客户端"""
+__version__ = "0.1.0"

huimei-0.1.0/huimei_cli/api_client.py

@@ -0,0 +1,105 @@
+"""慧媒引擎 Backend API Client"""
+import httpx
+
+
+class ApiError(Exception):
+    """API request error with status code and message."""
+    def __init__(self, code: int, message: str):
+        self.code = code
+        self.message = message
+        super().__init__(f"[{code}] {message}")
+
+
+class ApiClient:
+    """Synchronous HTTP client for huimei-engine backend API."""
+
+    def __init__(self, server_url: str, token: str | None = None, timeout: float = 30.0):
+        self.base_url = server_url.rstrip("/")
+        self.token = token
+        self.timeout = timeout
+
+    def _headers(self) -> dict:
+        headers = {"Content-Type": "application/json"}
+        if self.token:
+            headers["Authorization"] = f"Bearer {self.token}"
+        return headers
+
+    def _request(self, method: str, path: str, **kwargs) -> dict:
+        url = f"{self.base_url}{path}"
+        try:
+            resp = httpx.request(
+                method, url,
+                headers=self._headers(),
+                timeout=self.timeout,
+                **kwargs,
+            )
+        except httpx.HTTPError as e:
+            raise ApiError(0, f"Request failed: {e}") from e
+
+        if resp.status_code != 200:
+            raise ApiError(resp.status_code, f"HTTP {resp.status_code}: {resp.text[:200]}")
+
+        body = resp.json()
+        code = body.get("code", -1)
+        if code != 200:
+            raise ApiError(code, body.get("message", "Unknown error"))
+        return body.get("data")
+
+    def _get(self, path: str, **params) -> dict:
+        return self._request("GET", path, params=params or None)
+
+    def _post(self, path: str, data: dict = None) -> dict:
+        return self._request("POST", path, json=data)
+
+    def _put(self, path: str, data: dict = None) -> dict:
+        return self._request("PUT", path, json=data)
+
+    # ── Auth ──────────────────────────────────────────────
+
+    def login(self, username: str, password: str) -> dict:
+        """Login and store JWT token. Returns user/token data."""
+        result = self._post("/api/v1/auth/login", {
+            "username": username,
+            "password": password,
+        })
+        if result and "token" in result:
+            self.token = result["token"]
+        return result
+
+    # ── Subscription ──────────────────────────────────────
+
+    def get_subscription_info(self) -> dict:
+        """Get current subscription/plan info."""
+        return self._get("/api/v1/subscription/current")
+
+    # ── Accounts & Platforms ──────────────────────────────
+
+    def get_accounts(self) -> list:
+        """List all bound social media accounts."""
+        return self._get("/api/v1/accounts")
+
+    def get_platforms(self) -> list:
+        """List all supported platforms."""
+        return self._get("/api/v1/platforms")
+
+    def get_publish_params_config(self, platform_id: str) -> dict:
+        """Get publish parameter config for a specific platform."""
+        return self._get(f"/api/v1/platforms/{platform_id}/publish-params-config")
+
+    # ── Publish Tasks ─────────────────────────────────────
+
+    def create_task(self, task_data: dict) -> dict:
+        """Create a new publish task."""
+        return self._post("/api/v1/publish", task_data)
+
+    def report_task_result(self, task_uuid: str, result: dict) -> dict:
+        """Report the result of a CLI-executed task."""
+        return self._put(f"/api/v1/cli/tasks/{task_uuid}/report", result)
+
+    def register_device(self, device_id: str, device_name: str, os_type: str) -> dict:
+        """Register CLI device with backend."""
+        return self._post("/api/v1/cli/device/register", {
+            "device_id": device_id,
+            "device_name": device_name,
+            "os_type": os_type,
+        })

huimei-0.1.0/huimei_cli/auth.py

@@ -0,0 +1,72 @@
+"""Authentication management for huimei-cli."""
+
+import json
+import base64
+
+from huimei_cli.config import get_config, save_config, get_server_url, save_token
+from huimei_cli.api_client import ApiClient, ApiError
+
+
+def do_login(username: str, password: str, server_url: str = None) -> bool:
+    """Login to the huimei server and save token to config.
+
+    Args:
+        username: User's username.
+        password: User's password.
+        server_url: Optional server URL override.
+
+    Returns:
+        True if login succeeded, False otherwise.
+    """
+    url = server_url or get_server_url()
+    client = ApiClient(server_url=url)
+    try:
+        data = client.login(username, password)
+        token = data.get("token") if isinstance(data, dict) else None
+        if not token:
+            return False
+        save_token(token)
+        # Also persist server_url if overridden
+        if server_url:
+            cfg = get_config()
+            cfg["server_url"] = server_url
+            save_config(cfg)
+        return True
+    except (ApiError, Exception):
+        return False
+
+
+def is_logged_in() -> bool:
+    """Check whether a valid token exists in config."""
+    cfg = get_config()
+    return bool(cfg.get("token"))
+
+
+def get_current_user() -> dict | None:
+    """Decode the JWT token payload to get current user info.
+
+    Decodes without verification — only reads the payload claims.
+
+    Returns:
+        Dict of user claims from token, or None if not logged in.
+    """
+    cfg = get_config()
+    token = cfg.get("token")
+    if not token:
+        return None
+    try:
+        payload_b64 = token.split(".")[1]
+        padding = 4 - len(payload_b64) % 4
+        if padding != 4:
+            payload_b64 += "=" * padding
+        payload_bytes = base64.urlsafe_b64decode(payload_b64)
+        return json.loads(payload_bytes)
+    except (IndexError, ValueError, json.JSONDecodeError):
+        return None
+
+
+def logout() -> None:
+    """Clear authentication token from config."""
+    cfg = get_config()
+    cfg.pop("token", None)
+    save_config(cfg)

huimei-0.1.0/huimei_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI commands package."""