PosBrain · 仓位智能驾驶舱

一个面向个人投资者的本地化、单文件、多市场仓位管理与决策辅助系统

A股 · 港股 · 可转债 · ETF · 黄金 · 数字货币 · 国债 · 现金 — 一屏看全。

---

核心理念

投资是一场和自己的博弈，结构化的仓位比单笔交易更决定长期回报。

PosBrain 不替你下单、也不打榜、不直连券商，它做一件事：把你的全市场持仓、现金比例、估值环境、交易历史，整合在一个本地页面里，让你每次打开都能在 30 秒内回答：

• 我现在的现金/风险资产比例是否符合纪律？
• 估值（CSI 300 PB / 比特币 AHR999）现在偏贵还是便宜？
• 我的持仓集中度、行业分布、币种分布是不是失衡了？
• 月度资金净流入/流出在什么趋势？
• 历史交易里有哪些已平仓 PnL，胜率几何？

功能一览

模块	说明
多市场持仓	A 股 / 港股 / 美股 / 可转债 / ETF / 数字货币 / 黄金 / 国债 / 现金
实时报价代理	后端代理腾讯财经 / akshare，支持 A 股、港股、可转债、指数、汇率
估值环境	沪深300 PB 历史百分位、九神指数（BTC AHR999）
比例仪表板	整体现金 vs 风险资产、数字货币内 USDT 比例、法币内股票比例
月度快照	自动追加月末快照，自动算资金净流入
持仓打分	前景 1-5、分红 1-5（基于自定规则）
已平仓 PnL	累计已实现盈亏、胜率、按市场分组
行业观察	自定义板块跟踪 + 代表标的 + 关注要点
推荐池	周度更新机制、"新增"标记
资产明细核对	每月对账用的全量明细展开视图
印象笔记	任意单元格 inline 编辑备注，自动持久化

技术栈

• 后端：纯 Python 标准库 http.server + 可选 akshare（A 股财报/指数估值用）
• 前端：单个 HTML 文件，零构建、零打包，原生 JS
• 数据：单个 portfolio_data.json，人类可读、Git 友好（如果你不公开仓库）
• 依赖：Node Webpack React Docker — 都不需要

快速开始

git clone https://github.com/NeverChenX/PosBrain.git
cd PosBrain

# 复制示例数据为正式数据
cp sample_portfolio_data.json portfolio_data.json

# (可选) 安装 akshare 以启用 PB / AHR999 / 财报模块
pip install akshare

# 启动
python3 server.py

打开浏览器访问 http://localhost:8765/。

自定义你的持仓

直接编辑 portfolio_data.json，schema 见 sample_portfolio_data.json 中的所有字段。常见动作：

• 加一只 A 股：在 stocks 数组里追加 {"mkt":"A股","code":"600000","name":"XXX","sector":"银行","val":...,"shares":...,"price":...,"costPrice":...}
• 加一只港股：mkt 写 "港股"，价格字段用 price_hkd / costPrice_hkd
• 加月度快照：往 monthly 数组末尾追加一条 {"month":"YYYY-MM","stockFiat":...,"cashFiat":...,"digital":...,"digitalCash":...}
• 加一笔已平仓：往 closedPositions 追加

页面 30 秒自动刷新一次价格。手动点右上角"刷新数据"立即拉取。

推荐池配置（可选）

如果你想用 /api/recommended 接口展示自己的推荐池，可以提供一个 position_config.json，结构：

{
  "recommended_stocks": [
    {"code": "00001", "name": "示例港股", "reason": "高股息防御"}
  ]
}

默认查找路径是项目根目录下的 position_config.json，可通过环境变量覆盖：

export POSBRAIN_POSITION_CONFIG=/path/to/your/position_config.json
python3 server.py

项目结构

PosBrain/
├── server.py                    # 本地 HTTP 服务 + 行情代理 + 计算 API
├── portfolio_manager.html       # 单文件前端
├── update_monthly.py            # 每月快照辅助脚本
├── types.ts                     # TypeScript 类型（给 IDE 用）
├── sample_portfolio_data.json   # 脱敏示例数据
├── favicon.svg                  # PosBrain 字体型 logo
├── LICENSE
└── README.md

隐私 & 安全

• 所有数据全部留在本地，不会被任何第三方收集
• 不联网上报：行情代理只是从 qt.gtimg.cn / akshare / 中证指数官网拉行情，不上送任何持仓
• 建议：自己 fork 后把 portfolio_data.json 改为私有仓库提交，或干脆不入 git（默认 .gitignore 已忽略真实数据文件）

License

MIT — see LICENSE.