docs(HEL-272): 用终版项目介绍更新仓库 README

将总工审核通过的项目介绍写入根目录 README，保留本机启动、Docker 与系统配置等必要说明，技术栈保持公开。

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: multica-agent <github@multica.ai>

README.md

@@ -1,76 +1,360 @@
-# 小白复盘 Web
+# 小白复盘
 
-一个面向 A 股盘后复盘的本地 Web 工作台。后端使用 Python 访问 Tushare Pro，前端不依赖构建工具。
+> 一个给 A 股股民自己用的**盘后复盘工作台**。
+> 收盘以后打开它，把「今天市场到底发生了什么」按情绪、梯队、轮动、竞价、龙虎榜一条条看明白，再决定明天激进还是保守。
 
-本目录是经过保真迁移、结构治理和用户人工验收的唯一正式源码，不依赖父目录旧程序或失败版本。
-目录职责见[ARCHITECTURE.md](ARCHITECTURE.md)，产品与维护文档见[docs/README.md](docs/README.md)。
+**一句话定位**：小白复盘是一套可以自己部署、自己掌控数据的 A 股盘后复盘工具。它把散落在各个行情软件里的涨停、炸板、连板梯队、板块轮动、集合竞价、龙虎榜数据，整理成一套**看得懂、能追问、可记录**的复盘界面。
 
-当前包含集合竞价、涨停池、炸板池、跌停板、昨日涨停、涨停表现、市场天梯、板块轮动、题材库、人气热榜、龙虎榜和个人复盘工作区。交易日快照与同步记录保存在本地 SQLite 数据库 `data/review.db`。
+它**不是**行情交易软件，**不接券商、不代为下单**，也不提供任何形式的个股推荐。
 
-集合竞价中心采用盘前生命周期：9:15 前显示预告，9:15–9:25 明确等待最终竞价，9:25–9:30 自动读取并重试最终竞价筛选，9:30 后停止更新并冻结为复盘归档。当前 Tushare 只提供 9:25 最终竞价快照，不将其表述为动态虚拟撮合行情。
+---
 
-第三阶段加入了机构席位、席位别名、个股复权日 K、资金流、自选股、涨停原因修订、个股笔记、每日复盘和历史数据回补。
+## 一、为什么值得试（项目亮点）
 
-股票代码在桌面端悬停后会显示分时与日 K 快速预览，默认优先展示日 K；移动端点击代码后从底部打开预览面板。股票详情以及板块、题材、指数详情均可在日 K 与最新分时之间切换。日 K 复用个股详情缓存；分时优先使用 iFinD，东方财富仅作隔离的展示兜底，并使用短时内存缓存。图表数据不写入主行情、不参与情绪、选股或问天计算；不可用时明确显示“分时不可用”，不会用日 K 模拟分时走势。
+1. **先看情绪，再看个股**
+   用一个 0–100 的「情绪温度」，把当天市场的冷热程度和它处在哪个阶段（冰点 → 修复 → 发酵 → 高潮 → 分化 → 退潮）直接摆在第一屏。先判断环境，再谈个股。
 
-智能选股包含六阶段盘后候选、29 套精选策略、自定义公式 DSL、自然语言公式编译、候选排名和滚动回测。阶段与精选策略在当日行情更新后由后台确定性计算；自定义选股由用户手动执行，LLM 只负责编译自然语言条件，不参与候选筛选。竞价、估值、财务、资金、人气和席位等字段按已登记的数据可用性进入因子库，缺失时明确显示覆盖问题。
+2. **说的就是短线玩家的话**
+   晋级、断板、连板高度、梯队完整度、封单额、炸板……这些词不用解释，界面上原样呈现，不用再自己在行情软件里一层层翻。
 
-候选只有经用户手动加入后才进入五交易日持续跟踪，展示 T+1 开盘/收盘、T+3、T+5、最大涨幅与最大回撤。提醒中心支持手工日期提醒，并在策略首日反馈和五日跟踪完成时生成账号私有的站内提醒。
+3. **不会写公式，也能按自己的想法筛股票**
+   可以直接写一句人话（比如「连续两天放量上涨且不是 ST」），系统会把它编译成受控公式再执行筛选。技术活儿交给程序，判断权始终在你手上。
 
-问师模块会读取当前复盘、近十日市场情绪、涨跌停、昨日反馈、板块轮动、市场阶段、龙虎榜和指定个股数据，再按选中的游资思维 Skill 进行单师对话。对话记录按账号、老师和交易日期保存在服务端；主模型不可用时自动切换辅助模型。
+4. **有问题可以「问」**
+   - **问师**：挑一位游资思维模型，系统自动把当天情绪、梯队、龙虎榜等数据喂给它，单师对话，边看数据边追问。
+   - **问天**：一个偏传统文化视角的模块，分「观势 / 观气 / 观心」三部分，看盘之外也给自己留一段安静时间。
 
-新增公开问师角色时，在 `游资skills` 下增加一个包含 `SKILL.md` 的独立目录，并在 `游资skills/mentor_catalog.json` 中登记素材等级与结构质检。管理员私有角色放在 `data/private-mentor-skills`，该目录不进入 Git 或 Docker 镜像，且只会出现在管理员的问师列表中。系统会从 Skill 的 frontmatter、一级标题、核心模型和引用语中自动生成角色信息，无需修改注册代码。
+5. **复盘能留下来，而不是第二天就忘**
+   交易日志可以记录当时的买卖逻辑和情绪标签（平静 / 笃定 / 犹豫 / 焦虑 / 冲动），配合每日复盘三问和提醒中心，帮自己看清是不是在情绪化操作。
 
-问天模块包含三个相互独立的部分：观势以市场数据生成三才六爻，用于观察“势”，行情缺失或自动取象明显偏差时可显式手动校准六爻，人工结果与自动来源严格区分；观气依据干支、精确节气、五运六气及客主加临关系观察“运”，行业五行仅作传统取象归类；观心先准备1秒，再完成5轮“吸3秒、顿2秒、呼4秒”，随后以六次三枚铜钱起卦、察念和解卦完成一次不输入问题的问心仪式。卦象、干支、节气与气机关系均由本地确定性程序计算，LLM只负责解释，不参与起卦或改动结果。
+6. **数据在自己手里**
+   所有数据存在部署机器本地的 SQLite 数据库里，账号密码用 scrypt 哈希保存，行情 Token 和模型密钥加密存放。没有云端账号，不上传个人交易记录。
 
-问天模块使用项目本地的 `lunar-python` 计算历法，并使用 `data/iching_zh.json` 中的固定六十四卦、卦辞和爻辞。第三方授权见 `THIRD_PARTY_NOTICES.md`。
+7. **一套界面，白天晚上都能看**
+   内置日间 / 夜间两套配色，股票代码上悬停就弹出日 K 与分时小图，`Ctrl + K` 可以全局搜索股票、板块和题材。
 
-“我的复盘”包含结构化手工交易日志，可记录方向、价格、数量、仓位、盈亏、逻辑、执行、情绪和标签，不接券商也不自动下单。顶部“复盘助手”以流式方式读取市场统计、策略跟踪、提醒、个人复盘和交易日志；对话按账号保存，只提供分析和条件化计划。
+---
 
-## 启动
+## 二、主要功能
 
-```powershell
-cd app
+界面左侧一共有 **16 个页面**，另有一个内嵌页面（策略持续跟踪）。下面按分组说明。
+
+### 2.1 市场数据（登录即可用）
+
+| 页面 | 解决什么问题 | 打开后能看到什么 |
+| --- | --- | --- |
+| **情绪周期** | 收盘后说不清市场整体冷热、处在什么阶段 | 0–100 情绪温度、升温 / 降温方向、六阶段判定、由五个维度（市场宽度 20、涨停生态 25、赚钱效应 30、连板结构 15、成交活跃度 10）加权算出 |
+| **涨停池** | 当天封板的票散在各处，看不出封板结构 | 按首板 / 2 板 / 3 板+ 筛选，含首封时间、开板次数、封单额、涨停原因 |
+| **炸板池** | 触板没封住容易被误当成涨停 | 距涨停还差多少、开了几次板、炸板原因 |
+| **跌停板** | 亏钱效应集中在哪不直观 | 连续跌停天数、风险线索、风险行业聚集提示 |
+| **昨日涨停** | 昨天追板的人今天怎么样 | 晋级 / 炸板 / 跌停 / 断板四类结果，加一条「兑现率」（收红口径）摘要 |
+| **涨停表现** | 梯队到底健不健康 | 按连板高度看晋级率、收红率、平均涨幅，并给出当日结论 |
+| **市场天梯** | 连板梯队靠手翻拼不出来 | 从首板逐层排到当天最高板（至少展示 5 层），配市场高度与梯队完整度指标 |
+| **板块轮动** | 热点是延续还是一日游 | 最近 9 个交易日、Top 12 板块的热力矩阵，点板块可跨日高亮看连续性，并可下钻到申万二级成分股 |
+| **集合竞价** | 9:25 的竞价信息太散 | 四个页签：重点异动 / 我的自选 / 全部候选 / 竞价一字；关注分满分 100，可按「超预期 / 符合预期 / 低于预期」筛选；9:30 后停止更新，冻结归档供复盘 |
+| **题材库** | 题材排行和成分股要开好几个网站 | 左边题材排行、右边成分股，题材上悬停直接出日 K / 分时预览 |
+| **人气热榜** | 各家榜单各看各的 | 同花顺 + 东方财富双榜汇总，可切单榜或看「双榜共识」 |
+| **龙虎榜** | 上榜明细和游资动向查起来费劲 | 每日明细、净买入 / 净卖出筛选、活跃游资，点游资可看当日操作，游资档案带席位归类 |
+
+### 2.2 智能功能（会员可用）
+
+| 页面 | 解决什么问题 | 打开后能看到什么 |
+| --- | --- | --- |
+| **智能选股** | 自己写条件门槛高，盘中手翻太累 | 三种模式：① 六阶段策略，当日行情更新后（15:10 之后）自动计算；② **29 套精选策略库**，每套都标注适用环境、失效风险与准入条件；③ 自定义选股，自然语言写条件 → 编译成受控公式 → 确定性筛选执行 → 滚动回测 |
+| **策略持续跟踪** | 选出来的票加完自选就忘了为什么选 | 只有手动加入的候选才进入跟踪，展示 T+1 开盘 / 收盘、T+3、T+5、最大涨幅与最大回撤，到期自动提醒 |
+| **问师** | 复盘时没人讨论、视角单一 | 选一位游资思维模型单师对话，系统按模型流派自动喂情绪、梯队、龙虎榜等对应数据，回答为流式输出并带动态追问 |
+| **问天** | 想换个视角看市场，也想让自己静下来 | **观势**：用市场数据生成三才六爻，用来观察「势」；**观气**：依干支、精确节气、五运六气观察「运」；**观心**：不看盘、不输问题，先准备 1 秒，接着做 5 轮「吸气 3 秒、停顿 2 秒、呼气 4 秒」，再以六次三枚铜钱起卦完成一次问心仪式 |
+| **我的复盘** | 交易散养、不复盘、情绪化操作 | 结构化交易日志（方向、价格、仓位、盈亏、逻辑、执行、情绪、标签）、每日复盘三问、提醒中心、复盘助手（读取你的日志与市场数据，给出分析和条件化计划） |
+
+> 说明：卦象、干支、节气与气机关系全部由本地程序确定性计算，大模型只负责文字解释，不参与起卦，也不会改动结果。
+
+### 2.3 全局能力
+
+- 股票 / 板块 / 题材上悬停，弹出日 K 与分时快速预览
+- `Ctrl + K` 全局搜索
+- 日间 / 夜间双主题一键切换
+- 提醒中心集中查看策略跟踪与手工提醒
+- 登录页有一组会动的小 K 线小人（红涨绿跌）
+
+---
+
+## 三、特色页面展示
+
+> 下面每个占位都写清了「这张图要展示什么」。补图时，把图片文件放进仓库的 `docs/images/` 目录、按占位里写好的文件名命名，然后将该占位块（引文整段）替换为「补图后替换本块」后面那行图片语法（去掉反引号）即可；图未补上之前，方框内的文字就是给补图人的说明，不影响阅读。
+
+### 3.1 情绪周期
+
+> **【图 1｜情绪周期主界面（截图）】**
+> 展示：日间主题下情绪周期页整屏，需清楚露出 0–100 情绪温度大数字、当前阶段卡（如「发酵」）、以及温度变化曲线。
+> 补图后替换本块：`![情绪周期主界面](docs/images/sentiment-overview.png)`
+
+> **【图 2｜阶段与五维构成（截图）】**
+> 展示：阶段卡与五个维度的评分构成（市场宽度、涨停生态、赚钱效应、连板结构、成交活跃度），体现「温度不是拍脑袋来的」。
+> 补图后替换本块：`![情绪阶段与五维构成](docs/images/sentiment-dimensions.png)`
+
+> **【图 3｜日距切换（动图，约 4 秒）】**
+> 展示：在 10 / 20 / 60 日之间切换查看温度走势，动作要慢一点，让人看清曲线在动。
+> 补图后替换本块：`![情绪周期日距切换](docs/images/sentiment-range.gif)`
+
+### 3.2 市场天梯
+
+> **【图 4｜连板梯队全景（截图）】**
+> 展示：从首板一路排到当天最高板的分层结构，右侧「市场高度」与「梯队完整度」两个指标要同时入镜。
+> 补图后替换本块：`![市场天梯](docs/images/ladder-overview.png)`
+
+> **【图 5｜展开 / 收起交互（动图，约 4 秒）】**
+> 展示：点击展开某高度的成分股再收起，说明每一层都能点开看细节。
+> 补图后替换本块：`![市场天梯展开交互](docs/images/ladder-expand.gif)`
+
+### 3.3 涨停相关股池
+
+> **【图 6｜涨停池与炸板池（截图，两张并排）】**
+> 展示：左为涨停池（含首封时间、开板次数、封单额、涨停原因），右为炸板池（含距涨停、开板次数、炸板原因）。
+> 补图后替换本块：`![涨停池与炸板池](docs/images/pools-limit-broken.png)`
+
+> **【图 7｜昨日涨停与涨停表现（截图，两张并排）】**
+> 展示：左为昨日涨停的四类结果与兑现率摘要，右为涨停表现按连板高度列出的晋级率、收红率、平均涨幅与当日结论。
+> 补图后替换本块：`![昨日涨停与涨停表现](docs/images/pools-yesterday-performance.png)`
+
+### 3.4 板块轮动
+
+> **【图 8｜9 日热力矩阵（截图）】**
+> 展示：最近 9 个交易日、Top 12 板块的强度色阶矩阵，含强度图例。
+> 补图后替换本块：`![板块轮动热力矩阵](docs/images/rotation-heatmap.png)`
+
+> **【图 9｜点板块跨日高亮（动图，约 6 秒）】**
+> 展示：点选某个板块后，该板块在 9 天里的位置被高亮，直观看出「延续」还是「一日游」；再点开看下钻的申万二级成分股。
+> 补图后替换本块：`![板块轮动跨日高亮](docs/images/rotation-highlight.gif)`
+
+### 3.5 集合竞价
+
+> **【图 10｜竞价中心与关注分（截图）】**
+> 展示：重点异动页签下的候选列表，关注分列（满分 100）与「超预期 / 符合预期 / 低于预期」筛选条要看得见，右侧的题材承接卡片一并入镜。
+> 补图后替换本块：`![集合竞价中心](docs/images/auction-overview.png)`
+
+> **【图 11｜竞价生命周期（截图或示意静态图）】**
+> 展示：9:15 前预告 → 9:15–9:25 等待最终竞价 → 9:25–9:30 读取最终竞价 → 9:30 后冻结归档这四个节点。**建议用静态图表达，不做盘中动态录屏，避免被误解为实时撮合行情。**
+> 补图后替换本块：`![竞价生命周期](docs/images/auction-lifecycle.png)`
+
+### 3.6 龙虎榜
+
+> **【图 12｜龙虎榜明细与净买卖（截图）】**
+> 展示：每日上榜明细表，净买入 / 净卖出筛选条，以及活跃游资区域。
+> 补图后替换本块：`![龙虎榜明细](docs/images/dragon-detail.png)`
+
+> **【图 13｜游资档案（截图）】**
+> 展示：游资档案详情，含席位归类与当日操作列表。
+> 补图后替换本块：`![游资档案](docs/images/dragon-profile.png)`
+
+> **【图 14｜点游资看当日操作（动图，约 5 秒）】**
+> 展示：在明细里点某个游资，弹出它当天的全部操作，说明「席位 ↔ 个股」是打通的。
+> 补图后替换本块：`![龙虎榜游资点选](docs/images/dragon-click.gif)`
+
+### 3.7 智能选股
+
+> **【图 15｜29 套精选策略库（截图）】**
+> 展示：策略库列表，画面里要能数出策略卡片，并露出其中一张的「适用环境 / 失效风险 / 准入条件」。
+> 补图后替换本块：`![精选策略库](docs/images/screener-library.png)`
+
+> **【图 16｜自然语言写公式全流程（动图，约 15 秒，可加速）】**
+> 展示：输入一句人话 → 编译成受控公式 → 执行筛选 → 返回候选表 → 加入持续跟踪，完整走一遍。**本图是全篇技术含量最高的一张，务必配「不构成投资建议」角标。**
+> 补图后替换本块：`![自然语言写公式](docs/images/screener-natural-language.gif)`
+
+> **【图 17｜策略持续跟踪（截图）】**
+> 展示：某个候选的 T+1 开盘 / 收盘、T+3、T+5、最大涨幅与最大回撤。
+> 补图后替换本块：`![策略持续跟踪](docs/images/screener-tracking.png)`
+
+### 3.8 问师
+
+> **【图 18｜问师对话（截图）】**
+> 展示：模型选择区与一段已完成的对话，回答中引用了情绪、梯队、龙虎榜等真实市场数据。
+> 补图后替换本块：`![问师对话](docs/images/mentor-chat.png)`
+
+### 3.9 问天
+
+> **【图 19｜观势（截图）】**
+> 展示：由市场数据生成的三才六爻卦象图，以及六爻与市场数据的对应关系。
+> 补图后替换本块：`![问天观势](docs/images/heaven-shi.png)`
+
+> **【图 20｜观气（截图）】**
+> 展示：干支、精确节气、五运六气与客主加临关系的呈现。
+> 补图后替换本块：`![问天观气](docs/images/heaven-qi.png)`
+
+> **【图 21｜观心（截图）】**
+> 展示：观心呼吸引导界面（准备 1 秒 + 「吸 3 秒、顿 2 秒、呼 4 秒」共 5 轮），以及六次三枚铜钱起卦的界面。
+> 补图后替换本块：`![问天观心](docs/images/heaven-xin.png)`
+
+> **【图 22｜起卦动效（动图，约 10 秒）】**
+> 展示：铜钱起卦与六爻推演的现有效果。**只录现有动画，不做任何页面改动；全片挂「传统文化娱乐化观察，非预测」角标。**
+> 补图后替换本块：`![问天起卦动效](docs/images/heaven-coin.gif)`
+
+### 3.10 我的复盘
+
+> **【图 23｜交易日志与情绪标签（截图）】**
+> 展示：一条交易记录的完整字段，并把情绪五标签（平静 / 笃定 / 犹豫 / 焦虑 / 冲动）放大到看得清。
+> 补图后替换本块：`![交易日志情绪标签](docs/images/review-journal.png)`
+
+> **【图 24｜复盘助手（动图，约 8 秒）】**
+> 展示：复盘助手读取个人日志与市场数据后，流式输出一段分析与条件化计划。
+> 补图后替换本块：`![复盘助手](docs/images/review-assistant.gif)`
+
+### 3.11 全局细节
+
+> **【图 25｜四个小细节（截图，四宫格拼图）】**
+> 展示：① 代码悬停弹出的日 K / 分时预览；② `Ctrl + K` 全局搜索；③ 日间 / 夜间双主题对比；④ 登录页会动的小 K 线小人。
+> 补图后替换本块：`![全局细节四宫格](docs/images/global-details.png)`
+
+---
+
+## 四、适合谁用
+
+- **每天收盘后不知道从哪看起的散户**：先给一个情绪温度和阶段，再往下拆。
+- **做短线、看连板梯队的人**：晋级、断板、高度、完整度都在一个页面里。
+- **想按自己的条件筛股票、但不会写公式的人**：说人话就行。
+- **知道自己「管不住手」的人**：交易日志 + 情绪标签 + 每日复盘三问，把情绪化操作摆到自己面前。
+- **在意数据隐私、想把工具放在自己机器上的人**：私有部署，数据不出本机。
+- **对传统文化视角感兴趣的玩家**：问天的观势 / 观气 / 观心提供了另一种看市场的方式。
+
+**不太适合**：想要一键自动下单的人（本项目不接券商）；想要「跟着买就能赚」的人（本项目不提供任何形式的投资建议）。
+
+---
+
+## 五、一天怎么用（典型流程）
+
+1. **收盘后 10 分钟：定环境**
+   打开「情绪周期」，看温度多少、在哪个阶段、是升温还是降温。先定下明天的基调是激进还是保守。
+
+2. **看结构：谁在涨、涨到几板**
+   进「市场天梯」看连板梯队和市场高度，再到「涨停池 / 炸板池 / 跌停板」看当天的封板结构与亏钱效应。
+
+3. **看延续：热点有没有搬家**
+   进「板块轮动」，点几个强势板块，看它们在最近 9 天是连续走强还是只有一天行情。
+
+4. **看结果：昨天追板的人今天怎么样**
+   进「昨日涨停」和「涨停表现」，对照梯队健康度，检验自己的判断。
+
+5. **查人气与席位**
+   「人气热榜」看双榜共识，「龙虎榜」看活跃游资当天做了什么。
+
+6. **按自己的条件选一批候选**
+   进「智能选股」，要么用六阶段策略或 29 套精选策略，要么直接写一句人话让它编译成公式。选出来的候选**手动**加入「策略持续跟踪」，后面 T+1 / T+3 / T+5 会自动提醒你回看。
+
+7. **有疑问就问**
+   「问师」按游资思维模型边看数据边追问；想静一静就去「问天」做一次观心。
+
+8. **记下来**
+   在「我的复盘」里写当天交易日志（含情绪标签）和复盘三问。第二天开盘前，先回看昨天的记录。
+
+---
+
+## 六、部署与访问
+
+> 本项目为**私有部署的个人工具**，没有官方在线版，也不提供公共账号。
+
+- **部署方式**：仓库内提供 `Dockerfile` 与 `compose.yaml`，在已有 Docker 环境的机器上即可启动；也可直接用 Python 运行 `server.py` 在本机启动。
+- **访问方式**：部署完成后通过浏览器访问该机器上的服务端口（默认 8765），**具体地址由部署者自己决定**。出于安全考虑，本文档不写任何内网 IP、账号、密码或密钥。
+- **数据存放**：所有行情快照、复盘记录与账号数据都存在部署机器本地的 SQLite 数据库文件中（`data/review.db`），随 `data/` 目录一起备份即可。
+- **账号**：首次使用先注册，第一个注册的账号自动成为管理员，之后注册的默认为普通用户。
+- **数据来源**：行情数据来自 Tushare Pro 等第三方数据接口（部分分时数据优先使用同花顺 iFinD），**需要部署者自己申请并配置 Token**；部分接口的可用性取决于数据源方的授权与积分权限，个别数据缺失时页面会明确提示，不会用估算值顶替。
+- **大模型功能**：问师、问天解释、复盘助手、自然语言编译公式等需要配置一个 OpenAI 兼容的接口，由部署者自行配置与管理额度；未配置时这些对话与解释功能不可用，市场数据部分不受影响。
+
+### 本机启动
+
+仓库根目录即为运行目录（`server.py`、`requirements.txt` 都在根目录）。
+
+```bash
 python -m pip install -r requirements.txt
 python server.py
 ```
 
-浏览器打开 `http://127.0.0.1:8765`，首次使用先注册账号。首个账号自动成为管理员，后续账号默认为普通用户。主行情不再回退演示数据：盘前、非交易日或临时取数失败时沿用最近真实收盘快照；没有任何真实快照时提示等待管理员完成首次同步。
+默认监听本机回环地址、端口 `8765`（仅本机浏览器可访问）。首次使用先注册账号。主行情不再回退演示数据：盘前、非交易日或临时取数失败时沿用最近真实收盘快照；没有任何真实快照时，页面会提示等待管理员完成首次同步。
 
-需要后台启动本地验收端口时，使用`tools/start_local.ps1`。该工具把日志、进程号和Python缓存
-统一写入`runtime/`，不在源码根目录产生运行文件：
+Windows 下若需要后台启动，并把日志、进程号和 Python 缓存统一写入 `runtime/`（不在源码根目录产生运行文件），可使用：
 
 ```powershell
-powershell -ExecutionPolicy Bypass -File tools/start_local.ps1 -Port 8797
+powershell -ExecutionPolicy Bypass -File tools/start_local.ps1
 ```
 
-局域网 Docker 部署使用 `Dockerfile` 与 `compose.yaml`，完整的迁移、持久化、
-防火墙、备份和恢复步骤见 [DOCKER_DEPLOY.md](DOCKER_DEPLOY.md)。
+### Docker 部署
 
-账号密码使用 scrypt 哈希；公共 Tushare Token、平台模型密钥以及原始生辰资料均使用 `APP_ENCRYPTION_KEY` 加密后保存在 SQLite。公共数据和平台模型归系统所有，生辰资料仍按账号隔离。普通用户不配置 LLM，只有管理员授权的有效会员可以使用平台模型。请将 `.env` 与数据库一起备份，丢失加密密钥后无法恢复这些资料。
+局域网或服务器部署使用仓库根目录的 `Dockerfile` 与 `compose.yaml`。完整的迁移、持久化、防火墙、备份和恢复步骤见 [DOCKER_DEPLOY.md](DOCKER_DEPLOY.md)。
 
-## 系统与账号配置
+### 系统与账号配置
 
-管理员通过页面右上角“系统管理”保存公共 Tushare Token、平台主/辅助模型、会员每日额度和后台刷新开关。所有用户读取同一份 SQLite 行情快照，不再分别配置行情 Token。已有个人凭据中的 Tushare Token 会在升级时迁移到系统配置并从个人凭据移除。
+管理员通过页面右上角「系统管理」保存公共 Tushare Token、平台主/辅助模型、会员每日额度和后台刷新开关。所有用户读取同一份 SQLite 行情快照，不再分别配置行情 Token。
 
-```text
-TUSHARE_TOKEN=你的Token
-```
+`.env` 中的 Tushare 和平台 LLM 配置只用于初始化系统配置，密钥不会返回到浏览器。请将 `.env` 与数据库一起备份，丢失 `APP_ENCRYPTION_KEY` 后无法恢复加密资料。
 
-`.env` 中的 Tushare 和平台 LLM 配置只用于初始化系统配置，密钥不会返回到浏览器。后台刷新只在交易时段更新 SQLite 快照，不会主动刷新或重绘用户页面；用户点击页面“刷新”时读取最新快照。管理员也可点“后台刷新”立即启动一次后台同步，当前页面仍保持不变。
+普通用户在「账号设置」中维护个人资料、查看会员状态和修改密码，不配置个人 LLM。有效会员自动使用平台模型；管理员可在「系统管理」中手动开通、续期、停用会员。平台模型受管理员设置的每日调用次数限制，管理员账号始终可用。
 
-普通用户在“账号设置”中维护个人资料、查看会员状态和修改密码，不配置个人 LLM。有效会员自动使用平台模型；管理员可在“系统管理”中手动开通、续期、停用会员。平台模型受管理员设置的每日调用次数限制，管理员账号始终可用。
+新增公开问师角色时，在 `游资skills` 下增加一个包含 `SKILL.md` 的独立目录，并在 `游资skills/mentor_catalog.json` 中登记。管理员私有角色放在 `data/private-mentor-skills`，该目录不进入 Git 或 Docker 镜像，且只会出现在管理员的问师列表中。
 
-Tushare 各接口有独立积分权限。程序优先使用 `limit_list_d` 获取涨跌停明细；该接口不可用时，会尝试通过日线和每日涨跌停价格推算。
+### 相关文档
 
-## 隔离实时聚合验证
+- [ARCHITECTURE.md](ARCHITECTURE.md) — 模块边界与源码职责
+- [docs/README.md](docs/README.md) — 交接手册入口
+- [DOCKER_DEPLOY.md](DOCKER_DEPLOY.md) — Docker 部署、备份与恢复
+- [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) — 第三方授权（含问天历法库）
 
-`backend/data/realtime.py`用于验证东方财富、同花顺和选股宝网页数据源。它不写入 SQLite 主行情快照，也不参与情绪评分或智能选股；当 Tushare 实时指数权限不可用时，观势会使用东方财富三大指数和板块外显，并继续使用 Tushare 的板块成分内核与个股数据。
+**技术组成（简要）**
 
-登录后可调用：
+| 层面 | 说明 |
+| --- | --- |
+| 后端 | Python 3.12，仅用标准库自带的 HTTP 服务与自研路由，第三方依赖极少 |
+| 数据库 | SQLite（WAL 模式），单文件，易备份 |
+| 前端 | 原生 JavaScript + HTML，无构建工具、无打包步骤，改完刷新即可 |
+| 部署 | Docker / Docker Compose，或本机直接运行 |
+| 安全 | 账号密码 scrypt 哈希存储；行情 Token 与模型密钥使用 `APP_ENCRYPTION_KEY` 加密后存库，密钥与数据库需一起备份 |
 
-```text
-GET /api/realtime-aggregate/health?sector=元器件
-```
+---
 
-返回内容包括东方财富三大指数及板块快照、指数时间差、同花顺和选股宝可用性、每个来源的耗时与错误。盘中指数时间差不超过15秒，收盘后不超过120秒。`ready=true` 仅表示本次验证满足聚合层约束，不代表这些网页内部接口具有长期稳定性或商业使用授权。
+## 七、免责声明
+
+- 本项目是一个**个人研究与复盘工具**，所提供的全部数据、指标、候选与文字分析，**均不构成投资建议、证券推荐或买卖要约**。
+- 本项目**不接券商、不代为下单**，交易日志只做手工记录与统计，不代表任何实际成交。
+- 情绪温度、阶段判定、连板梯队、策略筛选等均为**基于公开数据的统计与规则计算结果**，不预测未来走势，不保证任何收益。历史统计与回测结果不代表未来表现。
+- 「问天」模块属于**传统文化视角的娱乐化观察**，卦象、干支、节气与气机关系由本地程序确定性生成，用于换个角度看市场和自我觉察，**不具备预测功能，不得作为投资依据**。
+- 行情数据来自第三方接口，可能存在延迟、缺失或口径调整；页面会在数据不可用时明确提示，请以交易所与券商正式披露的数据为准。
+- 股市有风险，入市需谨慎。投资决策及其后果由使用者本人承担。
+
+---
+
+## 附：精简版项目推荐语
+
+> 下面三段可以单独整段复制转发，不需要带图也能看懂。
+
+### 一句话版（约 60 字，适合评论区、群聊快速安利）
+
+> 小白复盘：一个自己部署的 A 股盘后复盘工作台——情绪、梯队、轮动、龙虎榜一页页看明白；说人话就能选股，不荐股、不下单，数据只存自己机器。
+
+### 短版（约 320 字，适合社交平台、群聊、朋友圈）
+
+> 发现一个挺特别的 A 股盘后复盘工具，叫「小白复盘」。
+>
+> 它不荐股、也不下单，就专心做一件事：把收盘后散落在各个软件里的信息整理成人看得懂的样子。打开先给你一个 0–100 的情绪温度和「冰点→修复→发酵→高潮→分化→退潮」六个阶段，让你先知道今天是什么环境；然后连板梯队、涨停炸板、板块轮动的 9 天热力图、集合竞价、龙虎榜游资动向，一页一页往下看。
+>
+> 最惊喜的是不会写公式也能选股——直接写一句人话，它帮你编译成条件去筛。还有「问师」可以按游资思维跟你对话，「问天」用卦象换个角度看市场、也让你静一静。
+>
+> 数据存在自己机器上的本地数据库里，私有部署，不上传。
+>
+> 提醒一句：它只是个把信息摆清楚的工具，不荐股也不下单，不构成投资建议。
+
+### 稍长版（约 580 字，适合发论坛、公众号、仓库简介）
+
+> **小白复盘 —— 给 A 股股民自己的盘后复盘工作台**
+>
+> 收盘以后，你是怎么复盘的？在好几个软件之间来回切，还是干脆不复盘？
+>
+> 小白复盘是一套可以自己部署的 A 股盘后复盘工具。它把涨停、炸板、跌停、连板梯队、板块轮动、集合竞价、龙虎榜这些散落各处的数据，整理成 16 个看得懂的页面：
+>
+> - **情绪周期**：0–100 情绪温度 + 六阶段判定，由市场宽度、涨停生态、赚钱效应、连板结构、成交活跃度五个维度加权算出，先看环境再看个股。
+> - **市场天梯**：从首板一路排到当天最高板，配市场高度与梯队完整度。
+> - **板块轮动**：近 9 个交易日 Top 12 板块热力矩阵，点一下就能看出热点是延续还是一日游。
+> - **集合竞价**：关注分满分 100，9:30 后自动冻结归档，专门留给复盘看。
+> - **龙虎榜**：席位明细、活跃游资、游资档案打通，点游资就能看它当天做了什么。
+> - **智能选股**：29 套精选策略（每套都写了适用环境和失效风险），也可以直接写一句人话，让它编译成公式去筛选。
+> - **问师 / 问天 / 我的复盘**：一个陪你按游资思维聊数据，一个用传统卦象换个角度看市场，一个帮你记下每笔交易的逻辑和情绪。
+>
+> 它不接券商、不代为下单，也不给出任何个股推荐——只负责把信息摆清楚，判断始终在你自己手里。所有数据存在你自己机器的本地 SQLite 里，私有部署，不上传。
+>
+> 项目私有部署、无公共在线版；文中所有功能描述均对应现有实现，不构成投资建议，市场有风险。