# X_SSL_Net 文档索引

本文档索引对应仓库当前 `docs/` 目录。当前 active 主线是：

```text
XNet2d + VMamba-style SS2D + 2D ultrasound supervised segmentation
encoder = tri-branch local/wavelet/global
decoder = plain U-Net same-scale skip + optional frequency refine
```

## 当前必读

1. `training/当前项目详解与纯文本架构流程图.md`
2. `method/XNet_method.md`
3. `operations/Start.md`
4. `experiments/一键实验脚本使用说明.md`
5. `experiments/优化配置训练流程说明.md`
6. `experiments/实验结果汇总脚本说明.md`
7. `method/XNet_encoder_vs_MobileMamba_encoder_2026-05-31.md`

## method

方法设计、模型结构和模块来源。

1. `method/XNet_method.md`
2. `method/XNet_encoder_vs_MobileMamba_encoder_2026-05-31.md`

说明：当前仓库 `docs/method/` 下可直接阅读的 active 方法文档主要是以上两份。更早期的方法草稿、来源笔记和临时资产如果未出现在当前目录中，应视为历史资料而非 active 文档入口。

## data

数据集说明、数据加载器和 split 设计。

1. `data/data数据集说明.md`
2. `data/datasets_paper_results.md`
3. `data/数据加载器分层设计说明.md`

## training

训练框架、配置、验证、日志和性能项。

1. `training/当前项目详解与纯文本架构流程图.md`

## experiments

实验脚本、优化配置、训练流程和结果汇总。

1. `experiments/一键实验脚本使用说明.md`
2. `experiments/实验结果汇总脚本说明.md`
3. `experiments/优化配置训练流程说明.md`

## operations

运行入口和快速启动说明。

1. `operations/Start.md`

## paper

论文方向判断和数据集论文入口。

1. `paper/超声分割主流方法与分领域方向判断_2026-04-30.md`
2. `paper/数据集相关论文链接与指标入口.md`

## references

引用和外部资料。

1. `references/wx.md`
2. `references/US-43d_refs.bib`

## archive

阶段性归档和历史上下文。archive 中的内容不一定代表当前 active 代码状态。

1. `archive/20260504_220523_xnet_vmamba_cleanup_archive.md`
2. `archive/20260505_xnet_active_cleanup_archive.md`

说明：archive、handoff、report 中若出现 `X-shaped decoder`、`diagonal guide`、`guide modulation` 等表述，应优先结合文档内新增的“当前实现对照说明”理解，不要直接当作当前代码事实。