人生 IPO 是什么
人生 IPO 是一套本地优先的个人数据操作系统。它不只记录收支，还将财务、健康、知识、人脉、AI 决策和团队执行放入同一套可度量、可规划、可复盘的数据闭环。
系统使用 users.id 与 JWT 中的 sub 作为统一身份主键。各专业子系统共享主账号上下文，服务端根据 JWT 判断数据归属，客户端不能自行修改所属用户。这种设计可以减少不同工具之间的数据孤岛，并为 AI 问策提供统一的事实基础。
项目目前处于 Alpha 阶段，适合个人信息管理与决策辅助，不构成医疗、投资、保险、税务或法律意见。关键决策仍应由用户及相应专业人士复核。
核心模块与主要能力
财务资产
财务模块覆盖收支、预算信封、账户、资产、负债、投资组合和跨市场行情，可生成资产负债、现金流、净资产趋势及资产配置结构等视图。
健康资产
健康模块支持科室卡片、检查大项与小项、连续指标、影像元数据、诊疗路径和医保保障，并通过趋势、医疗时间轴与 3D 图谱帮助用户整理健康资料。
知识与人脉资产
知识资产库用于整理学历、证书、知识产权、技能和作品，形成能力雷达与成果证据链。人脉模块则管理人物档案、关系温度、互动时间线、资料上传及识人分析。
AI 问策与执行闭环
问策系统可以主动读取当前用户的五域数据，通过 19 个决策维度、多轮质询、红队分析和综合裁决，产出事实简报、分歧网络、行动计划、RACI、指标与复盘安排。个人与团队模块进一步提供看板、甘特图、OKR、投票、审批和协作驾驶舱。
运行前准备
README 提供的一键启动器当前面向 Windows。开始前请准备以下环境：
- Windows 10 或 Windows 11。
- Node.js
24或更高版本；如果只运行主站，最低为22.13.0。 - Python
3.11或更高版本。 npm；团队模块建议通过 Corepack 使用pnpm。
项目包含多个独立服务，因此建议先确认 Node.js、Python、npm 和 Corepack 均能在 PowerShell 中正常调用。
node --version
python --version
npm --version
corepack --version安装与配置
第一步：安装各模块依赖
在仓库根目录打开 PowerShell，依次安装主站、人脉管理和知识资产模块的依赖：
npm install
npm --prefix ".\人脉管理\app" install
npm --prefix ".\知识资产\app" install然后启用 Corepack，安装并构建团队协作工具台：
corepack enable
pnpm --dir ".\团队协作工具台\app" install
pnpm --dir ".\团队协作工具台\app" build第二步：创建本地部署配置
复制项目提供的示例配置：
Copy-Item ".\.openai\hosting.example.json" ".\.openai\hosting.json"本地开发时可以暂时保留示例 project_id。如果准备部署，需要将它替换为自己的 Sites 项目 ID，并配置名为 DB 的 Cloudflare D1 绑定。
第三步：一键启动全部服务
执行仓库根目录中的 PowerShell 启动脚本：
powershell -ExecutionPolicy Bypass -File ".\start_life_ipo.ps1"也可以双击 一键打开人生IPO.vbs。启动器会检查各项服务的指纹，等待所有服务就绪后再打开主站。运行日志写入已经被 Git 忽略的 launcher-logs/ 目录。
第四步：只运行主站
如果暂时不需要专业子系统，可以仅启动人生 IPO 主站：
npm run dev -- --port 3010启动后访问 http://localhost:3010。
认识本地服务地址
完整启动后，各模块默认使用以下地址：
- 人生 IPO 主站：
http://localhost:3010 - 人脉管理“温故”：
http://127.0.0.1:3002 - 知识资产库：
http://127.0.0.1:3020 - 医疗健康图谱：
http://127.0.0.1:8767 - 问策 AI 大师规划：
http://127.0.0.1:7341 - 星轨团队协作工具台：
http://localhost:7351/work
专业工作台默认监听本机回环地址，这是项目“本地优先、最小暴露”原则的一部分。需要开放到公网时，不应直接照搬本地配置。
基础使用流程
1. 先建立五域事实数据
登录主站后，可以根据实际需要逐步整理以下数据：
- 在财务模块维护账户、收支、预算、资产、负债和投资组合。
- 在健康模块整理检查项目、连续结果、影像元数据和诊疗时间线。
- 在知识资产库录入学历、证书、技能、知识产权与作品证据。
- 在人脉模块维护人物档案、互动记录、关系温度和后续待办。
- 在规划模块基于当前用户数据发起 AI 问策。
项目强调“事实先于 AI 结论”。数据越完整，问策系统越容易区分已知事实与真正需要追问的未知信息。
2. 查看财务与人生资产视图
财务模块不仅用于查看钱去了哪里，还可以观察净资产、结余、负债压力、现金流和配置结构。资产负债视图还会统一呈现财务与非财务人生资产，便于从整体角度理解当前状态。
3. 使用 AI 问策
问策系统会自动读取当前登录用户的五域数据字典。手动上传主要用于导入同一用户的历史快照或兼容数据，而不是替代当前数据读取。
使用时应重点检查 AI 输出中的事实依据、分歧、反证条件、负责人、期限、领先指标、停止条件和复盘节奏。即使系统提供红队分析与综合裁决，也不应把模型输出视为专业结论。
4. 将计划转入个人或团队执行
需要继续推进时，可以使用个人或团队入口，通过看板、甘特图、OKR、RACI、投票、审批与复盘机制，把判断转化为可跟踪的行动。
导出用户数据
系统提供统一的数据字典接口，可以按财务、健康、知识、人脉、规划或全部范围导出数据：
GET /api/data-library?scope=finance|health|knowledge|contacts|planning|all
Authorization: Bearer <JWT>例如，导出财务数据时将 scope 设置为 finance；导出全部数据时设置为 all。返回内容采用 life-ipo-json-dictionary 格式，README 中的版本为 4.0：
{
"format": "life-ipo-json-dictionary",
"version": "4.0",
"scope": "finance",
"exportedAt": "ISO-8601",
"owner": {
"userId": 1,
"username": "example"
},
"datasets": {}
}财务、健康、知识、人脉和规划导出会移除行级 user_id，并排除密码、JWT、API Key 与图片二进制。不过，导出文件仍可能包含敏感个人信息，应存放在受控位置并做好备份保护。
安全配置要点
人生 IPO 会处理财务、医疗和关系数据，正式使用或部署前至少应完成以下配置：
- 为主站设置高强度
JWT_SECRET与独立的AI_CREDENTIALS_SECRET。 - 为健康服务配置
SESSION_SECRET和HEALTH_DATA_KEY。 - 为知识与团队服务分别设置独立的
APP_SECRET和数据库地址。 - 通过页面或进程环境变量提供 DeepSeek Key，不要写入源码、截图、日志或 JSON 导出。
- 不要提交
.env、数据库文件、用户附件、构建目录或启动日志。 - 公网部署时增加 HTTPS、速率限制、加密备份、审计日志和最小权限策略。
DeepSeek Key 在主站中会以 AES-GCM 密文按 users.id + provider 保存，运行时明文只会在同一 Bearer 授权下短暂读取。
如果密钥曾经出现在聊天记录、日志或历史构建产物中，应先到服务商控制台撤销并重新生成，再继续部署。
质量检查与开发验证
修改主站代码或准备提交贡献前，可以在仓库根目录执行代码检查和测试：
npm run lint
npm test
python -m unittest discover ".\问策大师规划系统\tests"各子项目还可以在自己的 app 目录中运行 README 所列的 npm run build、npm run check 或 npm test。涉及数据库的改动应同时说明迁移与回滚策略。
进阶使用建议
按阶段建立数据，而不是一次填满
可以先从账户、资产负债和近期收支开始，再逐步补充健康连续指标、知识成果证据和关键关系互动。这样更容易验证数据口径，也能减少首次配置的负担。
把趋势和证据放在单条记录之前
项目的设计原则是“记录不等于洞察”。对于健康、财务和能力变化，应该同时关注连续指标、趋势图、证据来源与反证条件，避免根据单次记录做出过度判断。
让建议具备停止条件
使用问策与团队模块时，不要只记录目标。尽量为行动补充负责人、截止时间、领先指标、停止条件和固定复盘节奏，使计划能够被验证、调整或及时终止。
理解当前部署边界
当前一键启动器主要支持 Windows，跨平台启动器和容器化本地部署仍在路线图中。统一迁移系统、版本化数据库 schema、可选端到端加密备份、公开 Demo 和插件化认知工具也尚未全部完成。
谨慎处理许可与专业内容
README 明确说明仓库目前尚未指定开源许可证。代码公开可见并不表示自动允许复制、修改或再分发。若参与健康、保险或投资相关功能开发，还应标明证据来源与适用边界。
结语
人生 IPO 的价值在于把分散的个人信息组织成统一、可追踪的数据资产，并让 AI 判断进一步连接到个人或团队执行。完成依赖安装、部署配置和一键启动后，可以先建立基础五域数据，再逐步使用导出、问策、RACI 与复盘功能。由于项目仍处于 Alpha 阶段，使用过程中应始终优先保护隐私、核验 AI 结论并保留必要的数据备份。