# httg-bridge

**Repository Path**: xledoo/httg-bridge

## Basic Information

- **Project Name**: httg-bridge
- **Description**: httg-bridge
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-22
- **Last Updated**: 2026-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# httg-bridge

**edge↔HTTG 通信中间件**（基线 v1.4 D35）：部署于内网 market 机（HTTG 仅内网可达）。

- 多账户会话保活（Playwright+OCR 登录 / httpx 轻量刷新，全局串行）
- HTTG 账户服务：user↔组合 粒度绑定验证 / 投顾产品发现 / 按用户聚合资金持仓摘要 / 按账户解绑
- 绑定模型 v2（D37）：注册表 `registry.json`（Fernet 独立加密，与凭证共用密钥材料）；
  `POST /bindings` 支持 `product_ids` 选择性绑定；`/users/*` 端点组
- 一键创建（公共账号）端点 501 占位（红塔「新建组合」API 待抓包）；密码经 env `HTTG_BRIDGE_SHARED_PASS` 注入
- v1 端点（`/bindings/{username}/products|summary`、`DELETE /bindings/{username}`）已移除，升级需重新 bind
- 凭证唯一宿主：Fernet 加密本地存储，唯一入口=bind API（D33）
- 对外仅 :8901 私密端点组（CF Tunnel + Access + WAF + X-Internal-Token，D23）

架构基线：`trader-app-ui/docs/paper-trading-architecture.md` §8
HTTP 契约：`docs/api.md`
组合数据同步设计：`docs/portfolio-data-sync-design.md`

## 初始化

    uv venv && uv sync
    uv run python -m playwright install chromium
    cp bridge.toml.example bridge.toml   # 填 [server].internal_token

## 运行

    uv run httg-bridge --config bridge.toml

## 测试

    uv run pytest -q