docs: README 含全量文件索引(56根+6决策+1ops+研究+归档,状态标注)——文件索引/归档状态必须同步README(老莫8-30); INDEX.md 归档(职能并入README)
This commit is contained in:
xxm
+89
-55
@@ -1,8 +1,8 @@
|
||||
# MoFin 文档中心（唯一入口）
|
||||
|
||||
> **任何 session / 任何人说"看文档"，先读本文件。**（2026-08-30 老莫立，dev-spec 红线#11）
|
||||
> 最后更新：2026-08-30（大更新：知微协作区/决策区/ops 区/系统状态刷新）
|
||||
> 考古规则：**越靠近现在的文档越接近真实情况**；`archive/` 仅供历史参考，**禁止当现状依据**。
|
||||
> **任何 session / 任何人说"看文档"，先读本文件。**（dev-spec 红线#11，2026-08-30 老莫立）
|
||||
> 本文件含**全量文件索引**——文件新增/归档/状态变化必须同步更新本索引（红线#11）。
|
||||
> 最后更新：2026-08-30 ｜ 考古规则：越靠近现在的文档越接近真相；archive/ 仅供参考，禁止当现状依据。
|
||||
|
||||
---
|
||||
|
||||
@@ -10,71 +10,105 @@
|
||||
|
||||
| 目录 | 用途 | 性质 |
|
||||
|------|------|------|
|
||||
| `docs/` 根 | 正式文档（手册/规范/状态说明/审查报告） | **正式** |
|
||||
| `docs/decisions/` | 架构决策日志（YYYY-MM-DD-标题.md，格式见 decisions/README.md） | **正式** |
|
||||
| `docs/ops/` | 运维操作单（批量操作/事件处置，含恢复检查单） | **正式** |
|
||||
| `docs/` 根 | 正式文档 | **正式** |
|
||||
| `docs/decisions/` | 架构决策日志（格式见 decisions/README.md） | **正式** |
|
||||
| `docs/ops/` | 运维操作单（批量操作/事件处置含恢复检查单） | **正式** |
|
||||
| `docs/research/` | 策略研究方法论与日志 | **正式** |
|
||||
| `docs/archive/` | 历史文档（旧设计/废弃组件/过时报告） | ⚠️ 仅供参考 |
|
||||
| `docs/archive/` | 历史文档 | ⚠️ 仅供参考 |
|
||||
| `docs/research/archive/` | 57 份单次实验过程记录 | ⚠️ 仅供参考 |
|
||||
|
||||
## 1. 🚀 新手入门（按顺序读）
|
||||
|
||||
| # | 文档 | 内容 |
|
||||
|---|------|------|
|
||||
| 1 | [portfolio-data-model.md](portfolio-data-model.md) | 核心数据模型：表结构、币种规则、常见错误 |
|
||||
| 2 | [DEVELOPMENT_STANDARDS.md](DEVELOPMENT_STANDARDS.md) + [dev-spec.md](dev-spec.md) | 开发规范（含 11 条红线） |
|
||||
| 3 | [CHANGELOG.md](../CHANGELOG.md) | 变更日志 |
|
||||
|
||||
## 2. 🤖 知微协作（position-analyst 必读）
|
||||
|
||||
| 文档 | 内容 | 状态 |
|
||||
|------|------|------|
|
||||
| [zhiwei-work-manual.md](zhiwei-work-manual.md) | **知微常驻工作手册**（守则/路径/已知问题） | 正式（知微维护） |
|
||||
| [zhiwei-ops-discipline.md](zhiwei-ops-discipline.md) | 运维纪律（git 白名单/deploy_guard/自愈边界） | 正式（8-30 已更新 cp -u 同步） |
|
||||
| [xxm-zhiwei-collaboration.md](xxm-zhiwei-collaboration.md) | 知微↔小小莫 kanban 闭环协作协议 | 正式 |
|
||||
| [zhiwei-reading-guide-20260813.md](zhiwei-reading-guide-20260813.md) | 温区自适应系统交接 | 正式（8-13 系统仍生效） |
|
||||
| [MoFin系统状态与数据链路说明.md](MoFin系统状态与数据链路说明.md) | RR/淘汰/数据源（8-17 版；v2 增量烂尾已标注） | 正式 |
|
||||
|
||||
## 3. 🔧 当前状态指针（先看这里，别看旧审查）
|
||||
## 1. 当前状态指针（先看这里）
|
||||
|
||||
| 主题 | 以哪份为准 |
|
||||
|------|-----------|
|
||||
| **Cron 任务现状** | [ops/2026-08-30-cron-disabled-审计恢复.md](ops/2026-08-30-cron-disabled-审计恢复.md)（88 enabled/22 disabled 全有 reason） |
|
||||
| Cron 架构史 | [cron-architecture-review-20260811.md](cron-architecture-review-20260811.md)（8-11 快照，顶部有指针） |
|
||||
| **进化体系归档决策** | [evolution-archive-readme.md](evolution-archive-readme.md)（8-21：人驱动闭环，AB路线废弃） |
|
||||
| 部署守卫/同步机制 | dev-spec 红线 + 8-30 操作单第八节（**deploy↔hermes 为 cp -u 跨设备同步，非硬链接**） |
|
||||
| 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) |
|
||||
|
||||
## 4. 📊 运维参考
|
||||
## 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 API（8-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 末节为准。
|
||||
|
||||
### 待处理/特殊
|
||||
| 文件 | 状态 |
|
||||
|------|------|
|
||||
| [QUICKSTART.md](QUICKSTART.md) | 快速操作手册 |
|
||||
| [DEPLOY.md](DEPLOY.md) | 部署指南（本地→Gitea→246） |
|
||||
| [DASHBOARD.md](DASHBOARD.md) | Dashboard API（**8-28 起 token 鉴权：?token=，见 .mofin_token**） |
|
||||
| [HEALTH-PIPELINE.md](HEALTH-PIPELINE.md) | 健康监控管线（8-30 新增 cron_disabled_audit 每日 08:20） |
|
||||
| INDEX.md | ⚠️ 8-22 旧索引——**已由本 README 索引取代，归档** |
|
||||
| analyst-knowledge-log.md | 空标题残留（8-25），待知微确认是否清理 |
|
||||
| operations-index.md | 运维操作索引（8-20）——与 ops/ 目录职能重叠，待收敛 |
|
||||
| strategy-review-loop.md（7-06） | 旧复盘闭环设计——部分内容被 strategy_review.py 实现取代 |
|
||||
|
||||
## 5. 📈 策略研究
|
||||
## 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）
|
||||
|
||||
[research/methodology.md](research/methodology.md)（方法论总纲）/ [research/research-log.md](research/research-log.md) / [research/research-status.md](research/research-status.md)
|
||||
## 4. ops/ 操作单
|
||||
2026-08-30-cron-disabled-审计恢复.md（cron 审计+恢复+51 脚本分叉同步+kanban dispatcher 修复）
|
||||
|
||||
## 6. 📦 归档区（仅供参考）
|
||||
|
||||
`archive/` 下所有文档（含被归档的 SYSTEM_ARCHITECTURE、cron-catalog 6/27 版等）——**读它们前必须意识到：它们不代表当前系统**。
|
||||
## 5. archive/（20 份，仅供参考）
|
||||
含旧 SYSTEM_ARCHITECTURE、cron-catalog(6/27)、REQUIREMENTS、EXPERT_SYSTEM_DESIGN 等——**禁止作为现状依据**。
|
||||
|
||||
---
|
||||
|
||||
## 文档规范（红线#11 摘要）
|
||||
|
||||
1. 任何结构变化（新增正式文档/归档/目录调整）**必须同步更新本 README**
|
||||
2. 每个 .md 顶部标注日期；过时内容追加 `> **已废弃** — 见 XXX 替代`
|
||||
3. 不删旧文档，移 `archive/`；**archive 内容禁止作为现状依据引用**
|
||||
4. 交叉引用用相对路径
|
||||
|
||||
## 当前系统状态（2026-08-30 核实）
|
||||
|
||||
- **数据**：SQLite `/home/hmo/MoFin/data/mofin.db`（61 表，含 stock_daily 1006 万行）；数据/备份在 **data 卷（/mnt/data, 913G）**，代码与 hermes 在系统盘（227G）
|
||||
- **脚本同步**：deploy/profile-scripts（git 权威）→ hermes scripts 为 **cp -u 副本**（跨设备，硬链接已失效）；改 deploy 后须验证 hermes 侧一致
|
||||
- **Cron**：hermes position-analyst profile 110 任务（88 enabled）；每日审计 cron_disabled_audit 08:20
|
||||
- **服务**：mofin-dashboard :8899（token 鉴权）/ dsa-server :8001 / guard-monitor / xmpp-mohe/zhiwei / ejabberd(docker)
|
||||
- **备份**：每日 07:50 gzip → `data/backups/compressed/`（14 天）→ 08:30 Windows M 盘异地同步
|
||||
- **Kanban**：~/.hermes/kanban.db + API :9580 + dispatcher 自动派卡（8-30 修复 spawn-crash）
|
||||
- **数据**：SQLite `data/mofin.db`（61 表）；数据/备份在 data 卷（/mnt/data 913G），代码/hermes 在系统盘（227G）
|
||||
- **同步**：deploy→hermes 为 cp -u 副本（跨设备）；改 deploy 后须验证 hermes 侧一致
|
||||
- **Cron**：110 任务（88 enabled，disabled 全有 reason）；每日审计 08:20
|
||||
- **服务**：mofin-dashboard :8899（token 鉴权）/ dsa-server :8001 / guard-monitor / xmpp×2 / ejabberd
|
||||
- **备份**：07:50 gzip→compressed/（14 天）→08:30 M 盘异地
|
||||
- **Kanban**：kanban.db + API :9580 + dispatcher 派卡（8-30 修复）
|
||||
|
||||
Reference in New Issue
Block a user