# get_rich

**Repository Path**: mayday97/get_rich

## Basic Information

- **Project Name**: get_rich
- **Description**: 股票 分析 get rich
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 投资交易策略系统

面向投资小白的 A 股 / 港股 / 场外公募基金投资交易策略系统。产品以有条件、有期限、有风险边界的操作计划为主，研究分析与证据作为解释展开。已确认的建设方向见 [产品定位与迭代原则](./docs/10-product-positioning.md)。三个现有场景：

1. **个股分析** —「比亚迪最近怎么看？」→ 自动取数、算指标、四维度综合，输出带证据链的结构化分析与操作剧本
2. **场外基金分析** —「这只基金还能拿吗？」→ 业绩 / 风险 / 持仓结构 / 管理与规模四维，输出定性的申赎建议
3. **盘中判断** —「今天到此刻的走势，有没有改变那份计划？」→ 结论由模型给出、原样展示，TS 只供事实与校验

（曾经还有「持仓诊断」与「自由对话」两条链路，均已删除，见 [决策 0012](./docs/04-decisions/0012-retired-chains.md)。）

**产品边界**：个股成本输入只使用**每股平均买入成本价**辅助理解交易纪律，不接入持股数量、账户总资金或真实仓位，不提供买卖金额或股数，不接实盘、不下单。现行运行时仍保留来源引用与免责声明；决策和执行由用户负责。

建议卡、期限、成本纪律与执行验收的建设方向见 [产品定位与迭代原则](./docs/10-product-positioning.md)；现行买卖判定与治理以 [docs/04-decisions/](./docs/04-decisions/) 为准，其中 [0002](./docs/04-decisions/0002-objective-and-strategy-governance.md) 管准入、[0013](./docs/04-decisions/0013-trading-evidence-and-shadow.md) 管交易事实与影子实验。官方正文补源、前瞻样本积累与正式新规则准入继续待办。

## 快速开始

环境要求：**Node.js ≥ 24.12**、pnpm ≥ 10。无需 Docker / Redis / 数据库服务，也不需要 C++ 编译工具链。

> 懒人方式：git clone 后直接跑 `./run.sh`，自动完成下面全部步骤并启动服务（依赖已装、配置没变时重复执行会跳过对应步骤；本机 pnpm 版本不够会自动用 corepack 拉钉住的版本）。以下为手动步骤：

```bash
pnpm install
```

```bash
cp .env.example .env
```

把 [platform.deepseek.com](https://platform.deepseek.com) 申请的 key 填进 `.env` 的 `DEEPSEEK_API_KEY`，然后：

> 有多个 key 时可用 `DEEPSEEK_API_KEYS=sk-a,sk-b,sk-c`（英文逗号分隔）配置，**每次分析随机取一个**（用于摊额度/绕限流），配置后 `DEEPSEEK_API_KEY` 被忽略。

```bash
pnpm db:generate && pnpm db:migrate
```

```bash
pnpm dev
```

- 前端 http://localhost:5173
- 后端 http://localhost:3000/api （前端通过 Vite proxy 访问，代码里一律用相对路径 `/api/*`）

> **数据不会自动更新。** 系统没有后台定时任务——看某只票时在个股页点「刷新数据」，或去数据管理页按类别批量刷新。理由与操作见 [05-runbook.md](./docs/05-runbook.md)。

## 常用命令

| 命令 | 作用 |
|---|---|
| `pnpm dev` | 并行启动前后端与共享包的 watch 构建 |
| `pnpm build` | 全量构建 |
| `pnpm test` | 单元测试 |
| `pnpm test:contract` | 契约测试（**会真实联网**打外部接口，验证字段结构未变） |
| `pnpm typecheck` | 全量类型检查 |
| `pnpm db:generate` | 由 schema 推导迁移 SQL |
| `pnpm db:migrate` | 执行迁移（server 启动时也会自动跑一次） |

## 结构

```
docs/          全部项目文档，从 docs/00-overview.md 开始读；现行规则见 docs/04-decisions/
packages/
  shared/      前后端共享的类型、代码格式转换、Envelope 契约
  datasource/  数据源适配层：providers + 限流 + 降级链 + 归一化
  indicators/  技术指标纯函数（无 IO，全单测）
  analytics/   估值回算、资金流基线、关键位与剧本锚点、期望值与成绩单口径、基金指标
apps/
  server/      NestJS 后端（三条分析链路、tools、同步任务、报告成绩单、事件雷达、REST）
  web/         Vue3 前端
extensions/
  chrome-sector-sync/  Chrome 自选板块日线批量同步扩展
data/          SQLite 库文件 + 外部接口原始响应快照（不入库）
```

## Chrome 板块日线同步扩展

服务端无法直接访问东财板块日线时，可使用 Chrome 扩展批量更新自选股票对应的行业板块。构建与加载方式见 [`extensions/chrome-sector-sync/README.md`](./extensions/chrome-sector-sync/README.md)。

## 两条贯穿全局的原则

**① LLM 不做任何数值计算。** 所有数字来自 `packages/indicators` 与 `packages/analytics` 里的确定性函数，模型负责解读、综合与提出条件化剧本。每个 tool 返回值都带 `citationId`，模型输出的每条结论必须引用它。盘中判断的特殊边界是**模型结论原样展示、TS 不覆盖裁决**，输入数字仍由 TS 计算；它不例外于数值计算原则，见 [决策 0009](./docs/04-decisions/0009-intraday-chain.md)。

**② 能从腾讯拿的，绝不打东财。** 东财是唯一会封 IP 的数据源，只用于其独占数据（龙虎榜、两融、大宗、资金流、研报、板块），限流 1s + 熔断，见 [01-datasource.md](./docs/01-datasource.md)。

## 状态

个股 / 基金 / 盘中三条链路、证据链、剧本核对、成绩单与成对对照、事件雷达（人工策展粘贴）均已可用。

- 系统怎么跑起来、数据从哪来、存了什么：[docs/00-overview.md](./docs/00-overview.md)
- 建设方向与成本价边界：[docs/10-product-positioning.md](./docs/10-product-positioning.md)
- 现在生效的规则与阈值：[docs/04-decisions/](./docs/04-decisions/README.md)
- 还没做的事与候选规则门槛：[docs/06-backlog.md](./docs/06-backlog.md)

个股建议里**有明确触发条件的相对减半**可以保留，含义是「减掉当前该股票持有数量的一半，由用户自行换算」；
配置档位（`positionCeiling`）不推导减仓比例，也不输出金额或股数。判据见
[0010 持仓纪律](./docs/04-decisions/0010-holding-discipline.md) 与
[0005 模型输出治理](./docs/04-decisions/0005-model-output-governance.md)。