Files
MoFin/docs/README.md
T

115 lines
6.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# MoFin 文档中心(唯一入口)
> **任何 session / 任何人说"看文档",先读本文件。**dev-spec 红线#112026-08-30 老莫立)
> 本文件含**全量文件索引**——文件新增/归档/状态变化必须同步更新本索引(红线#11)。
> 最后更新:2026-08-30 | 考古规则:越靠近现在的文档越接近真相;archive/ 仅供参考,禁止当现状依据。
---
## 0. 文件夹地图
| 目录 | 用途 | 性质 |
|------|------|------|
| `docs/` 根 | 正式文档 | **正式** |
| `docs/decisions/` | 架构决策日志(格式见 decisions/README.md | **正式** |
| `docs/ops/` | 运维操作单(批量操作/事件处置含恢复检查单) | **正式** |
| `docs/research/` | 策略研究方法论与日志 | **正式** |
| `docs/archive/` | 历史文档 | ⚠️ 仅供参考 |
| `docs/research/archive/` | 57 份单次实验过程记录 | ⚠️ 仅供参考 |
## 1. 当前状态指针(先看这里)
| 主题 | 以哪份为准 |
|------|-----------|
| Cron 任务现状 | [ops/2026-08-30-cron-disabled-审计恢复.md](ops/2026-08-30-cron-disabled-审计恢复.md)88/110 enabled,全有 reason |
| 进化体系 | [evolution-archive-readme.md](evolution-archive-readme.md)(8-21:人驱动闭环,自动调参废弃) |
| 脚本同步机制 | 8-30 操作单第八节(deploy↔hermes = **cp -u 跨设备**,硬链接已失效) |
| 知微工作入口 | [zhiwei-work-manual.md](zhiwei-work-manual.md) |
## 2. 全量文件索引(docs/ 根,56 份)
### 规范类(每次动手前读)
| 文件 | 内容 | 状态 |
|------|------|------|
| README.md | 本文件(唯一入口+索引) | 正式 |
| dev-spec.md | 开发规范(11 条红线) | 正式(8-30 红线#11 |
| DEVELOPMENT_STANDARDS.md | 代码结构/DB/Prompt 规范 | 正式 |
| llm-execution-protocol.md | LLM 执行协议 | 正式(8-21 |
| lifecycle-management.md | 对象生命周期管理规范 | 正式 |
| learned.md | 经验教训(8-03 起) | 正式(持续追加) |
| strategy-recommendation-spec.md | 推送规范(8-17 老莫定稿) | 正式 |
### 知微协作类
| 文件 | 内容 | 状态 |
|------|------|------|
| zhiwei-work-manual.md | 知微常驻手册(守则/路径/已知问题) | 正式(知微维护,8-30 修正) |
| zhiwei-ops-discipline.md | 运维纪律(git 白名单/guard/自愈边界) | 正式(8-30 修正 cp -u |
| xxm-zhiwei-collaboration.md | kanban 闭环协作协议 | 正式(8-25) |
| zhiwei-reading-guide-20260813.md | 温区自适应交接 | 正式(系统仍生效) |
| MoFin系统状态与数据链路说明.md | RR/淘汰/数据源 | 正式(8-17;v2 烂尾已标注) |
### 系统机制类
| 文件 | 内容 | 状态 |
|------|------|------|
| SYSTEM_ARCHITECTURE.md | 系统架构(3+1 层次/环节,8-14) | 正式 |
| portfolio-data-model.md | 数据模型 | 正式 |
| scheduler-mechanism.md | 定时任务调度机制(8-20) | 正式 |
| message-architecture-20260821.md | 消息架构重构(8-21 | 正式 |
| SELF_GROWTH_SYSTEM.md | 自成长系统设计 | ⚠️ 部分失效(meta_growth/meta_watchdog 8-21 已归档废弃;分支自成长/剪枝 8-30 恢复运行) |
| morning-health-check.md | 盘前体检机制 | 正式 |
| HEALTH-PIPELINE.md | 健康监控管线 | 正式 |
| DASHBOARD.md | Dashboard API8-28 起 token 鉴权) | 正式 |
| QUICKSTART.md / DEPLOY.md / TEST_PLAN.md | 操作/部署/测试 | 正式 |
| VERSIONS.md | 版本变更记录 | 正式 |
| fx_rate_proposal.md | 汇率单一权威源方案 | 正式(已落地:fx_rate 表+hk_rate DB 优先 7fc6116a |
### 策略研究类
| 文件 | 内容 | 状态 |
|------|------|------|
| strategy_research_methodology.md / predictive_oversold_strategy.md | 方法论/超跌策略 | 正式 |
| v_mr_strategy.md / s2_panic_v2_research_20260816.md | 策略文档 | 正式 |
| RR分析结论.md / 淘汰逻辑验证.md / max_hold分析结论.md | 数据结论(8-17) | 正式 |
| research/methodology/research-log/research-status/research-scripts + 2 专题) | 研究总纲与日志 | 正式 |
### 历史事件记录(时点快照,有效但不代表当前状态)
| 文件 | 内容 | 状态 |
|------|------|------|
| cron-architecture-review-20260811.md | 8-11 cron 审查 | 快照(顶部已加指针) |
| cron-review-poversold-20260811.md / cron-to-xmpp-restore-20260811.md | 8-11 cron 梳理/恢复 | 快照 |
| cleansweep-20260819/20260820.md | 大扫除记录 | 快照 |
| architecture-fix-20260819.md / data-flow-map-20260819.md | 多写方修复/数据流地图 | 快照 |
| system-audit-20260810.md / doc-audit-20260811.md / system-architecture-review-20260812.md | 彻查/治理报告 | 快照 |
| strategy-current-state-20260811.md | 策略现状(8-11 | 快照(现状见 strategy_weights.json |
| 统一触发逻辑改造方案-20260812.md | 盘中重评触发改造 | 快照(已落地) |
| holding-strategies-multewriter-analysis.md | 多写方分析(8-20 | 快照 |
### 数据层重构专题(8-25~26,已收官)
meeting-mofin-restructure-20260825 / migration-restructure-20260825 / migration-summary / phase0_probe_results / restructure_progress_report(+final) / restructure-report-20260826 / portfolio-sync-issue-20260825 ——重构过程记录,**正式留档**,当前状态以本 README 末节为准。
### 待处理/特殊
| 文件 | 状态 |
|------|------|
| INDEX.md | ⚠️ 8-22 旧索引——**已由本 README 索引取代,归档** |
| analyst-knowledge-log.md | 空标题残留(8-25),待知微确认是否清理 |
| operations-index.md | 运维操作索引(8-20)——与 ops/ 目录职能重叠,待收敛 |
| strategy-review-loop.md7-06 | 旧复盘闭环设计——部分内容被 strategy_review.py 实现取代 |
## 3. decisions/ 决策日志(6 份)
2026-07-19 spec+Dashboard 2026-08-12 p_oversold 部署 **2026-08-13 温区动态切换(温区体系总决策)** 2026-08-14 港股 cron 挂载 2026-08-15 进化闭环重构(→8-21 归档:见 evolution-archive-readme.md
## 4. ops/ 操作单
2026-08-30-cron-disabled-审计恢复.mdcron 审计+恢复+51 脚本分叉同步+kanban dispatcher 修复)
## 5. archive/20 份,仅供参考)
含旧 SYSTEM_ARCHITECTURE、cron-catalog(6/27)、REQUIREMENTS、EXPERT_SYSTEM_DESIGN 等——**禁止作为现状依据**。
---
## 当前系统状态(2026-08-30 核实)
- **数据**SQLite `data/mofin.db`(61 表);数据/备份在 data 卷(/mnt/data 913G),代码/hermes 在系统盘(227G
- **同步**deploy→hermes 为 cp -u 副本(跨设备);改 deploy 后须验证 hermes 侧一致
- **Cron**110 任务(88 enableddisabled 全有 reason);每日审计 08:20
- **服务**mofin-dashboard :8899token 鉴权)/ dsa-server :8001 / guard-monitor / xmpp×2 / ejabberd
- **备份**07:50 gzip→compressed/14 天)→08:30 M 盘异地
- **Kanban**kanban.db + API :9580 + dispatcher 派卡(8-30 修复)