零后端股票管理系统 · 源码与使用说明

一个不用自己搭服务器、不用自建数据库的个人股票管理系统：前端用 React 跑在浏览器里，数据直接存在飞书多维表格（云端），通过一层极薄的代理绕开跨域。代码已开源，本文给你源码入口 + 完整接入与使用指引。

一、这是什么

一句话：把你每天的买卖记录、持仓、盈亏，全部存进飞书多维表格，前端用网页随时看、随时记。

你可以把它理解成：飞书多维表格当”云数据库”，网页当”操作台”，中间一根很细的管子负责鉴权。没有服务器、没有数据库、没有备案。

二、源码获取

下载后请先解压，按下方「接入方式」配置好你的飞书凭证即可本地运行。

三、功能说明

系统围绕”记录—查看—统计“三个核心动作设计，所有数据都落在你自己的飞书表格里。

1. 交易录入 / 编辑

每笔买卖都是一条记录，典型字段包括（具体以随源码的 .base 模板为准，约 15 个字段）：

支持新增、修改、删除；表单带基础校验（如价格/数量非空、方向必选）。

2. 持仓看板

首页以卡片/列表形式展示当前持仓，关键指标包括：

• 持仓成本、最新价、持仓数量
• 浮动盈亏与盈亏比例（红色=盈利，绿色=亏损，遵循 A 股习惯）
• 按账户 / 标签分组筛选

3. 盈亏统计

基于你录入的全部成交，自动汇总：

• 单只股票累计盈亏
• 账户维度总盈亏
• 时间段筛选（如本月、本季）

4. 数据全部在飞书

所有增删改查最终都读写你的飞书多维表格。好处是：

• 数据不落任何第三方服务器，归你自己所有；
• 飞书自带版本历史、权限、多人协作、手机端查看；
• 换电脑、重装系统都不丢数据。

四、接入方式（核心）

接入分四步：建表 → 取凭证 → 本地跑 → 上线。

4.1 创建飞书多维表格

1. 打开飞书，新建一个多维表格（Bitable）；
2. 用随源码提供的 .base 模板导入（已脱敏，只含字段结构，不含真实股票名）；
3. 记下这个多维表格的 App / Base ID。

模板只定义结构，不包含你的任何真实持仓，导入后自行录入即可。

4.2 获取飞书凭证

在飞书开放平台创建一个自建应用，拿到四类凭证：

• app_id、app_secret（应用凭证）
• 多维表格的 access / 授权信息（用于读写该表）
• 给应用开通「多维表格」相关权限，并把你的账号加入可用范围

这四项是敏感信息，只在本机代理的内存里使用，不写进前端代码、不落盘。

4.3 本地运行

# 1. 安装依赖
npm install

# 2. 配置飞书凭证（通过代理的凭证入口，base64 JSON 形式传入，
#    由代理在内存中解码，不持久化到磁盘）

# 3. 启动开发服务（Vite 自带中间件代理，本地直接可跑）
npm run dev

浏览器打开本地地址即可使用。凭证通过 X-Feishu-Credentials 请求头传递，代理解码后转发飞书。

4.4 上线部署（免端口 / 免备案）

生产环境用三层极薄通道：

五、日常使用指引

1. 记一笔：打开网页 → 新增交易 → 填日期 / 代码 / 方向 / 价格 / 数量 → 保存，数据实时写入飞书。
2. 看持仓：首页看板自动汇总成本、现价、浮动盈亏，红涨绿跌一眼可见。
3. 查历史 / 统计：按日期、账户、标签筛选；查看单股与总盈亏。
4. 手机看：飞书 App 里直接打开多维表格，随时随地查数据（前端网页也可手机浏览器访问）。
5. 备份 / 协作：飞书表格自带版本历史；如需家人/朋友一起看，飞书内授权即可，无需额外搭建。

六、常见问题

• Q：我的股票数据会泄露吗？
  A：不会。数据只存在你自己的飞书多维表格，不经由任何第三方服务器；代理只在内存里用凭证，不落盘。
• Q：一定要部署上线吗？
  A：不用。本地 npm run dev 即可使用；上线只是为了方便手机/外网访问。
• Q：换电脑了数据还在吗？
  A：在。数据在飞书云端，跟电脑无关，新电脑装好前端、配好凭证就能连回原表。
• Q：飞书要收费吗？
  A：个人多维表格免费额度足够个人记账使用；具体以飞书当前政策为准。