feat: 新增文档Tab(📚文档)——开源项目式文档体系(VERSIONS.md运营者版本变更+INDEX.md目录树+docs.json spec),让知微通过文档理解系统变化
This commit is contained in:
@@ -0,0 +1,83 @@
|
||||
# MoFin 文档完整目录（INDEX）
|
||||
|
||||
> 文档总导航树。按主题分类，每个文档标注用途和阅读对象。
|
||||
> 维护原则：新增/归档文档时同步更新本目录。
|
||||
|
||||
---
|
||||
|
||||
## 📖 入门必读（新接入者按顺序读）
|
||||
|
||||
| # | 文档 | 内容 | 阅读对象 |
|
||||
|---|------|------|---------|
|
||||
| 1 | [README.md](README.md) | 文档中心封面（导航入口）| 所有人 |
|
||||
| 2 | [VERSIONS.md](VERSIONS.md) | **版本变更记录**（给运营者的详细变更说明）| 知微/老莫 |
|
||||
| 3 | [portfolio-data-model.md](portfolio-data-model.md) | 核心数据模型：表结构/币种/公式 | 研发 |
|
||||
| 4 | [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md) | 开发规范（代码结构/DB/流程）| 研发 |
|
||||
| 5 | [QUICKSTART.md](QUICKSTART.md) | 快速操作手册 | 运维 |
|
||||
|
||||
---
|
||||
|
||||
## 📊 运维参考（日常操作）
|
||||
|
||||
| 文档 | 内容 |
|
||||
|------|------|
|
||||
| [QUICKSTART.md](QUICKSTART.md) | 快速操作手册 |
|
||||
| [DEPLOY.md](DEPLOY.md) | 部署指南（本地→Gitea→246 工作流）|
|
||||
| [DASHBOARD.md](DASHBOARD.md) | Dashboard API 参考 |
|
||||
| [HEALTH-PIPELINE.md](HEALTH-PIPELINE.md) | 健康监控管线 |
|
||||
| [doc-audit-20260811.md](doc-audit-20260811.md) | 文档治理核实报告（15 份文档对照系统）|
|
||||
| [system-audit-20260810.md](system-audit-20260810.md) | 系统彻查报告（含处理状态追踪）|
|
||||
|
||||
---
|
||||
|
||||
## 📈 策略研究（2026-08 起）
|
||||
|
||||
| 文档 | 内容 |
|
||||
|------|------|
|
||||
| [strategy_research_methodology.md](strategy_research_methodology.md) | **研究方法论**：由果及因/12维/铁律/支撑压力 |
|
||||
| [predictive_oversold_strategy.md](predictive_oversold_strategy.md) | **预测超跌反弹策略 v5**（年化 18.57%）|
|
||||
| [deployment-plan-predictive-oversold.md](deployment-plan-predictive-oversold.md) | **部署计划**（整合 MoFin 全流程）|
|
||||
| [cron-architecture-review-20260811.md](cron-architecture-review-20260811.md) | **Cron 架构审查与重构设计**（385 行）|
|
||||
| [cron-review-poversold-20260811.md](cron-review-poversold-20260811.md) | Cron 梳理（对照 p_oversold 部署）|
|
||||
| [research/methodology.md](research/methodology.md) | 方法论总纲（铁律 0-5）|
|
||||
| [research/research-log.md](research/research-log.md) | 研究日志 |
|
||||
| [research/research-scripts.md](research/research-scripts.md) | 研究脚本清单 |
|
||||
| [research/research-status.md](research/research-status.md) | 策略现状与待办 |
|
||||
| [research/2026-08-06-low-drawdown-study.md](research/2026-08-06-low-drawdown-study.md) | 低回撤组合研究（3/6/12 定义）|
|
||||
| [research/2026-08-08-experience-lessons.md](research/2026-08-08-experience-lessons.md) | 研究经验教训 |
|
||||
|
||||
---
|
||||
|
||||
## ⚙️ 系统机制（核心设计文档）
|
||||
|
||||
| 文档 | 内容 |
|
||||
|------|------|
|
||||
| [dev-spec.md](dev-spec.md) | **开发规范总纲**（十条红线/双轨同源/自检体系）|
|
||||
| [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md) | 开发规范（代码/DB/流程 v1.1）|
|
||||
| [SELF_GROWTH_SYSTEM.md](SELF_GROWTH_SYSTEM.md) | 自成长系统设计（四层循环）|
|
||||
| [lifecycle-management.md](lifecycle-management.md) | 对象生命周期管理（信号→候选→自选→持仓）|
|
||||
| [strategy-review-loop.md](strategy-review-loop.md) | 策略复盘闭环（三层评估）|
|
||||
| [morning-health-check.md](morning-health-check.md) | 体检机制（8类40项）|
|
||||
| [zhiwei-ops-discipline.md](zhiwei-ops-discipline.md) | 知微运维纪律（deploy_guard 机制）|
|
||||
|
||||
---
|
||||
|
||||
## 🗃 历史文档（archive/）
|
||||
|
||||
旧的设计文档、需求文档、已废弃组件文档。仅供参考。
|
||||
- 含 SYSTEM_ARCHITECTURE（旧版）、TDX relay、xiaoguo、cron-catalog 等
|
||||
|
||||
---
|
||||
|
||||
## 📋 一次性文档（decisions/）
|
||||
|
||||
决策记录（spec/dashboard 引入等）。
|
||||
|
||||
---
|
||||
|
||||
## 目录维护
|
||||
|
||||
- 新增文档 → 按主题加入对应分类
|
||||
- 归档文档 → 从本目录移除，移 archive/
|
||||
- 大版本变更 → 同时更新 CHANGELOG-VERSIONS.md
|
||||
- 本文档与 Dashboard「📚 文档」Tab 联动（Tab 读取本目录树）
|
||||
@@ -0,0 +1,138 @@
|
||||
# MoFin 版本变更记录（VERSIONS）
|
||||
|
||||
> **给运营者（知微）的版本变更说明**。每次系统有改动，都记录在这里，
|
||||
> 用**你能理解的语言**说明：系统变了什么、为什么变、你需要注意什么。
|
||||
> 按时间倒序（最新在前）。
|
||||
|
||||
---
|
||||
|
||||
## 阅读指南
|
||||
|
||||
- **每条变更 = 一个完整的改动**（不分大小，统一记录）
|
||||
- 每条包含：**改了什么**（通俗）+ **为什么改** + **对你的影响**
|
||||
- 技术细节见 `CHANGELOG.md`（开发者参考）
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-11 — Cron 架构统一重构
|
||||
|
||||
### 改了什么
|
||||
MoFin 的定时任务系统做了全面梳理：
|
||||
1. **策略扫描器独立了**——以前"超跌扫描""恐慌买扫描"是被塞进"市场数据采集"里一起跑的，现在它们各自独立调度（9:35 交易日自动运行）
|
||||
2. **新建了公共代码库**——把各个策略共用的计算逻辑（技术指标、行情数据获取）抽出来，放到公共模块，避免每个策略重复写一遍
|
||||
3. **清理了冗余任务**——停掉了几个重复/过时的定时任务（如午间重复采集、死掉的旧调度）
|
||||
4. **新策略扫描器已就绪**——"预测超跌反弹"新策略的扫描代码已写好并验证（有大盘弱势判断，当前大盘不弱所以不会误报）
|
||||
|
||||
### 为什么改
|
||||
之前 cron 系统混乱：策略扫描器嵌在数据采集器里、代码多处重复、死配置残留——这阻碍了"预测超跌反弹"新策略的引入。这次重构让架构清晰，新策略可以顺畅接入。
|
||||
|
||||
### 对你的影响
|
||||
- ✅ **定时任务更清晰**：每个任务职责明确，不再有嵌套调用
|
||||
- ✅ **新策略即将上线**：超跌反弹扫描器已就绪，等你批准后即可启用
|
||||
- ✅ **假告警减少**：修了价格监控在集合竞价时段（9:15-9:25）误报暴跌的问题
|
||||
- ⚠️ **无需你操作**：本次是后台架构调整，不影响你的日常操作
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-11 — 价格监控竞价期假告警修复
|
||||
|
||||
### 改了什么
|
||||
价格监控原本在**集合竞价时段**（9:15-9:25）也会触发暴跌告警，导致误报（今天 9:17 误报睿创微纳暴跌-20%，实际正常）。
|
||||
|
||||
### 为什么改
|
||||
集合竞价时段的价格是虚拟撮合价，不是真实成交，不该触发告警。
|
||||
|
||||
### 对你的影响
|
||||
- ✅ 集合竞价时段（9:15-9:25）不会再收到暴跌告警
|
||||
- ✅ 只有连续竞价时段（9:30-11:30、13:00-15:00）才触发告警
|
||||
- ✅ 之前的假告警（睿创微纳）已确认是误报，实际价格正常
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-11 — LLM 通道切换
|
||||
|
||||
### 改了什么
|
||||
MoFin 的 AI 调用（知微分析、简报生成等）的 API 通道从 opencode.ai 直连 key6 切换为 key1。
|
||||
|
||||
### 为什么改
|
||||
key6 失效导致 LLM 调用 401 错误，简报/评估停摆。切换 key1 后恢复。
|
||||
|
||||
### 对你的影响
|
||||
- ✅ 知微的日报、简报、策略评估恢复正常
|
||||
- ✅ 无需操作
|
||||
|
||||
---
|
||||
|
||||
## 2026-08-10 — Cron 系统审视整理
|
||||
|
||||
### 改了什么
|
||||
暂停了 5 个过时/冗余的定时任务（系统健康检查旧版、自选买入区提醒、300308 盯盘、小果市场筛选），并修复了"gateway 看门狗反噬死循环"（8/3 起导致所有 AI 任务停摆的根因）。
|
||||
|
||||
### 对你的影响
|
||||
- ✅ 所有 AI 驱动的定时任务（简报、评估、复盘）恢复正常
|
||||
- ✅ 消除了无意义的任务空转
|
||||
|
||||
---
|
||||
|
||||
## 2026-07-19 — XMPP Bot 断线重连修复
|
||||
|
||||
### 改了什么
|
||||
知微的 XMPP Bot 断线后会无限重连导致崩溃，现已修复（重连失败后最多试一次，不会爆栈）。
|
||||
|
||||
### 对你的影响
|
||||
- ✅ 知微 Bot 断线后会自动恢复，不会彻底挂掉
|
||||
|
||||
---
|
||||
|
||||
## 2026-07-14 — 价格监控数据库死锁根治
|
||||
|
||||
### 改了什么
|
||||
价格监控写数据库时偶发死锁导致卡死，现已根治（加重试 + 超时保护）。
|
||||
|
||||
### 对你的影响
|
||||
- ✅ 价格监控不再卡死，持仓价格更新更稳定
|
||||
|
||||
---
|
||||
|
||||
## 2026-07-03 — 数据存储架构升级
|
||||
|
||||
### 改了什么
|
||||
系统数据从 JSON 文件迁移到 SQLite 数据库，统一了数据存储；同时修正了港股/A股的币种处理（港股存港币，汇总时自动转人民币）。
|
||||
|
||||
### 对你的影响
|
||||
- ✅ 数据不再出现 JSON/数据库不一致
|
||||
- ✅ 港股持仓显示正确（港币计价，汇总自动转人民币）
|
||||
|
||||
---
|
||||
|
||||
## 2026-07-01 — 统一数据读取
|
||||
|
||||
### 改了什么
|
||||
所有脚本统一通过 mo_data 读取数据，不再各自直接读文件。
|
||||
|
||||
### 对你的影响
|
||||
- ✅ 数据口径一致，不会出现"这个报表对不上那个报表"
|
||||
|
||||
---
|
||||
|
||||
## 历史版本（详见 CHANGELOG.md）
|
||||
|
||||
| 日期 | 概要 |
|
||||
|------|------|
|
||||
| 2026-07-13 | XMPP Bot 非阻塞 + 深套规则重构 |
|
||||
| 2026-07-10 | 知微 XMPP Bot 离线修复 |
|
||||
| 2026-07-09 | 信号堆积修复 + 监控盲区修复 |
|
||||
| 2026-07-06 | 全面系统修复（知微）|
|
||||
| 2026-06-30 | 初始架构重构（mo_models 统一数据模型）|
|
||||
|
||||
---
|
||||
|
||||
## 维护说明
|
||||
|
||||
- **每次系统改动，必须更新本文档**（在顶部新增条目）
|
||||
- **格式**：改了什么 + 为什么改 + 对你的影响
|
||||
- **面向运营者**：避免技术术语，用知微能理解的语言
|
||||
- **技术细节**：见 CHANGELOG.md（开发者参考）
|
||||
|
||||
> 维护人：Sisyphus（小小莫）
|
||||
> 原则：让运营者不用看代码，就能完全理解系统每次变化。
|
||||
Reference in New Issue
Block a user