docs: reorganize — README index, archive old docs, add status headers

This commit is contained in:
知微
2026-07-04 10:22:51 +08:00
parent 58786d170b
commit 574f1be3ec
26 changed files with 2118 additions and 2031 deletions
+18 -2
View File
@@ -196,5 +196,21 @@
**萃取知识:** **萃取知识:**
1. 自愈执行器对宏风险的报警是设计行为(health check标记risk=high→写TODO→升级处理),需要按"已知市场状态"处理而非"系统故障" 1. 自愈执行器对宏风险的报警是设计行为(health check标记risk=high→写TODO→升级处理),需要按"已知市场状态"处理而非"系统故障"
2. 腾讯(00700)距止损2.76%是所有持仓中最接近止损位的——本轮冲击前未被重点标记,暴露了"只关注风险最大的几个"忽略了中游风险 | 腾讯(00700)距止损2.76%是所有持仓中最接近止损位的——本轮冲击前未被重点标记,暴露了"只关注风险最大的几个"忽略了中游风险
|
## 2026-07-04 周末宏观风险评估(首次独立周末扫描)
**发现了什么:** 采集器08:00输出2条HIGH信号,但经LLM深度分析确认为误报:
1. 「单一押注有色 百亿基金栽在盛达资源」→ LOW(基金级个股新闻,误报模式4:公司/基金事件误标为宏观风险)
2. 「北约领导人宣布伊朗不得拥核」→ MEDIUM(政治声明,但整体美伊趋势为降级降级谈判/石油恢复/海峡共管推进)
**执行操作:** signal_news ID=760 修正覆盖(UPDATE) + ID=761 插入正确MEDIUM信号
**综合判定:** MEDIUM(新闻维度MEDIUM+组合高暴露MEDIUM→2个MEDIUM
**关键发现:** 周末数据采集(Curl东方财富首页+macro_raw_news 50条)确认一周来最大的系统性风险变化是——美伊冲突全面降级(OPEC产量恢复、伊朗洽售石油、多哈会谈推进),而这在signal_news历史HIGH信号中完全未体现。采集器只抓取了北约声明这个单独事件,忽略了整体趋势改善的上下文。**周末扫描的核心价值在于提供采集器无法做到的语境整合判断。**
**萃取知识:**
1. 周末扫描的第一步(检查未评级新闻)如果为空,必须主动从curl数据中提取Fetched新事件INSERT入库——不能直接输出"无未评级新闻"
2. 背离检测器在非交易日持续运行,divergence_state的level=none+bias=opportunity为本次MEDIUM判定提供了关键支撑——无市场结构风险
3. 非农数据"弱于预期"是反向逻辑(鸽派利好),采集器关键词无法区分方向性语义,LLM修正时需特别注意误报模式11
+52
View File
@@ -0,0 +1,52 @@
# MoFin 文档中心
> 文档驱动开发。每次代码变更必须同步更新对应文档。
---
## 阅读指引
### 🚀 新手入门(按顺序读)
| # | 文档 | 内容 | 时间 |
|---|------|------|------|
| 1 | **[SYSTEM_ARCHITECTURE.md](SYSTEM_ARCHITECTURE.md)** | 系统总览:架构图、数据流、模块职责 | 10 min |
| 2 | **[portfolio-data-model.md](portfolio-data-model.md)** | 核心数据模型:表结构、币种规则、常见错误 | 10 min |
| 3 | **[DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md)** | 开发规范:代码结构、DB 规范、Prompt 规范、开发流程 | 15 min |
| 4 | **[CHANGELOG.md](../CHANGELOG.md)** | 变更日志:所有改动的完整记录 | 5 min |
### 🔧 日常开发
| 文档 | 何时查阅 |
|------|---------|
| [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md) | 每次写代码前 |
| [TEST_PLAN.md](TEST_PLAN.md) | 每次改完代码后跑测试 |
| [CHANGELOG.md](../CHANGELOG.md) | 改完后追加变更记录 |
### 📊 运维参考
| 文档 | 内容 |
|------|------|
| [cron-catalog.md](cron-catalog.md) | Cron 任务清单(知微维护) |
| [decisions-db-migration.md](decisions-db-migration.md) | JSON→DB 迁移记录(✅ 已完成) |
### 📦 历史文档(archive/
旧的设计文档、需求文档、分析报告。仅供参考,不代表当前系统状态。
---
## 文档规范
- 每个 .md 文件顶部标注版本和日期
- 过时内容追加 `> **已废弃** — 见 XXX 替代`
- 不直接删除旧文档,移到 `archive/` 保留
- 交叉引用使用相对路径 `[xxx](xxx.md)`
## 当前系统状态
- **数据**:纯 SQLite`/home/hmo/web-dashboard/data/mofin.db`
- **币种**:港股存 HKD,A 股存 CNY,汇总时转换
- **JSON**:已全部移除,无残留
- **测试**`scripts/run_all_tests.py` — 33/33 通过
- **最新**`CHANGELOG.md` 查看完整变更
+2 -3
View File
@@ -1,8 +1,7 @@
# MoFin 自成长系统设计文档 # MoFin 自成长系统设计文档
> 最后更新:2026-06-23 > 状态:设计文档 | 最后更新:2026-06-23 | 维护人:知微
> 维护人:知微 > 当前架构见 [SYSTEM_ARCHITECTURE.md](SYSTEM_ARCHITECTURE.md) | 开发规范见 [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md)
> 原则:每增加一个系统机制,必须在此同步更新文档并签入 git
--- ---
+20
View File
@@ -0,0 +1,20 @@
# Archive — 历史文档
这些文档是早期设计、需求分析、诊断报告。**不代表当前系统状态**。保留供参考。
| 文件 | 内容 | 日期 |
|------|------|------|
| REQUIREMENTS.md | 初始需求文档 | 2026-06 |
| EXPERT_SYSTEM_DESIGN.md | 专家系统设计 | 2026-06 |
| data-pipeline-diagnosis.md | 数据管道诊断 | 2026-06 |
| refactor-for-xiaoxiao.md | 重构方案 | 2026-06 |
| session-handover-20260630.md | 会话交接 | 2026-06 |
| DATABASE_ARCHITECTURE.md | 旧 DB 架构(被 portfolio-data-model 取代) | 2026-06 |
| mofin-database-architecture.md | 旧 DB 架构 | 2026-06 |
| market-data-requirements.md | 旧市场数据需求 | 2026-06 |
| market-screening-system-design.md | 旧市场筛选设计 | 2026-06 |
| strategy-evaluation-requirements.md | 旧策略评估需求 | 2026-06 |
| self-healing-loop.md | 旧自愈循环 | 2026-06 |
| analyst-knowledge-log.md | 分析师知识日志 | 2026-07 |
当前系统文档见 `../README.md`