# 资产看板小程序

**Repository Path**: ibst/personal-assets-mini-program

## Basic Information

- **Project Name**: 资产看板小程序
- **Description**: 基于JavaScript的个人资产看板小程序
- **Primary Language**: Unknown
- **License**: MIT-0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: HTML, 金融

## README

# 个人资产

一个**本地运行**的个人资产记账与配置分析工具：单文件网页 + 零依赖 Node 服务 + 本地 `data.json`。数据只存在你自己的电脑上，不上传任何地方。

## 快速开始

Windows 下直接**双击 `启动个人资产.bat`**：

- 首次会自动 `npm install` 装好 PDF 解析依赖（之后跳过，不重复联网）
- 启动本地服务，自动打开浏览器 → `http://127.0.0.1:8123/个人资产.html`

也可以手动：

```bash
npm install        # 只有 PDF 导入用到 pdfjs-dist，其余零依赖
node server.js
```

不想开服务也行：直接双击 `个人资产.html`（`file://` 模式），退回「浏览器缓存 + 手动选一次 data.json」的旧方式，数据同样落在该文件里。

## 功能

- **资产录入**：基金 / 股票 / 现金 / 黄金，记录份额、成本价、现价、币种（人民币 / 港币 / 美元）。
- **自动分类**：每笔资产自动归入「**大类**（现金 / 固定收益 / 黄金 / 权益）→ **区域**（A股 / 港股 / 美股 / 欧洲 / 新兴市场 / 全球）→ **策略**（宽基 / 行业主题 / 主动 / 个股）」，也支持在编辑里手动改。
- **资产配置**：可下钻的配置卡（大类 → 区域 → 策略），横向占比条 + 逐行明细。
- **资产走势**：自动记录总资产历史，可手动补录历史点位。
- **资产配置评价**：基于当前持仓自动生成几百字的配置评估与建议（大类 / 区域 / 策略 / 集中度 / 币种）。
- **汇率**：联网更新人民币 / 港币 / 美元汇率。
- **数据新鲜度**：顶部提示数据最后一次手动更新是多久前。
- **导出 / 导入**：
  - JSON 备份：整份数据无损导出 / 导入。
  - PDF：导出成完整表格；导入认两种——本程序自产 PDF（数据内嵌、无损还原）和腾讯理财通「持有明细证明」（按基金代码更新市值）。

## 目录结构

```
个人资产/
├─ 个人资产.html       前端全部（原生 HTML/CSS/JS，单文件）
├─ server.js           Node 服务：静态托管 + data.json 读写 + PDF 解析
├─ 启动个人资产.bat      Windows 一键启动
├─ package.json        仅 PDF 导入依赖 pdfjs-dist
├─ package-lock.json
└─ .npmrc              npm install 跳过 optional 依赖
```

`data.json`（运行后自动生成）是全部数据，**已加入 .gitignore，不会随代码上传**。

## 数据与隐私

- 服务只绑 `127.0.0.1`，局域网里的其他机器访问不到。
- 数据读写本地 `data.json`，改动即保存，不联网上传。
- 只有「汇率更新」会联网请求公开汇率接口，除此之外不发起任何网络请求。

## 技术栈

- 前端：原生 HTML / CSS / JS，无框架、无构建。
- 后端：Node 标准库（http / fs / path），PDF 文本解析用 `pdfjs-dist`。
- 存储：单个 `data.json`（GET / PUT），原子写入。

## 许可

个人自用，未指定开源协议。