Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
node_modules
dist
dist-ssr
*.local
.DS_Store
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
# RUN:面向隐蔽目标分割的可逆展开网络 交互式教程

基于论文 *RUN: Reversible Unfolding Network for Concealed Object Segmentation*,由 **paper-skill** 生成的完整 React + TypeScript + Vite 网页项目。

## 论文与素材

- 原文:https://arxiv.org/abs/2501.18783v2 ,ICML 2025,PMLR 267:22853–22864。
- 教程共 10 页(含封面)。实验数值引用原文 Table 1,适用条件与出处保留在页面和讲稿中。
- 图形为本教程代码绘制的教学示意,不含第三方摄影或论文原图。合成雾化实验不是 RUN/RUN+ 推理,其强度 MAE 不代表论文分割指标。

## 本地运行

本项目由 paper-skill 的论文专属章节和交互组件生成。

```bash
npm install
npm run dev # 开发预览 http://localhost:5173
npm run build # 产出 dist/ 静态站点
npm run preview # 预览构建结果
```

最终提交应保留整个项目目录,不要只复制 `index.html` 或 `dist/`。

## PPT 演示模式

每章包含多张独立幻灯片,每页固定为 1600×900。顶部翻页,左侧预览选页,
“讲稿”打开演讲者备注,“放映”进入全屏。方向键翻页时不会抢占输入控件。
手机保持原有排版,支持双指缩放、放大后拖动以及缩放复位。

首页的两种方法通过 `useCoverPlayback()` 同步播放同一生活场景,并用一句话引出
核心方法。正文可以直接点击或拖动画布里的物体,也可以用少量关联滑块组成
一个完整实验;不同页面应选择主题内不同的生活动作,而不是重复同一动画。
不同页面按教学问题安排生活场景、交互、论文公式或实验结果;同页并置的画面与
形式化表示由同一状态驱动,其他依据可放在独立页面或讲稿中。
不需要为动画添加播放、暂停、单步、重置或标签切换控件。

通过 `chapters[].scenes` 指定每页目标、讲稿和专属 `componentId`;正文通过统一组件注册表注册,版面按内容自由设计。
正文在固定画布内自由构图;生成器应按教学问题安排视觉重点,不能让每页都成为左图右卡。
新项目不再提供固定的“左图右文”引入页或“三列文字”总结页。结论应融入大幅动画、
交互结果或充分可读的论文证据图。
正文使用 `--ppt-body-text`、`--ppt-body-heading`、`--ppt-body-emphasis` 三种字号;删掉重复的小标签,给公式、机制和结果留足可读空间。生活动画用于引入和解释合适的概念,其他页面可以直接操作论文变量、结构或证据。详细出处与类比边界放入讲稿,密集内容拆成新页。
`outlines.json` 由章节组装器生成。页面截图存入 `public/thumbnails/`;
`?capture=1&slide=页面ID` 可在 1600×900 窗口中单独捕获页面。

## 目录结构

| 路径 | 说明 | 是否生成器(Agent)修改 |
| --------------------------------------------------- | ---------------------------------------------- | ----------------------- |
| `src/data/tutorial.ts` | 论文专属内容(章节、模块、公式、B 站、元信息) | ✅ 唯一数据文件 |
| `src/styles/paper.css` | 论文专属 `:root` 配色覆盖 | ✅ 仅此 CSS |
| `src/modules/*.tsx` + `registry.tsx` | 论文专属 Canvas 交互组件 | ✅ 在 registry 注册 |
| `public/images/*` | 论文原图(可选) | ✅ 仅放图 |
| `public/thumbnails/*` | 幻灯片截图 | ✅ 生成后截图 |
| `outlines.json` | 每页目标、交互与讲稿 | 由组装器派生 |
| `src/components/*` | 演示框架与场景展示组件 | ❌ 模板框架默认 |
| `src/lib/*` | 静态工具(canvasKit / B 站) | ❌ 模板框架默认 |
| `src/styles/{tokens,components,presentation}.css` | 设计令牌、组件与演示样式 | ❌ 模板框架默认 |

## 配色语义(contract.md §5,保持稳定)

- `--blue` 指导/当前状态,`--green` 成功/本文方法,`--red` 失败/传统方法
- `--orange` 用户强调,`--purple` 辅助机制

切勿把 `--accent` 重新定义成别的语义角色。
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<!-- 固定幻灯片画布由 SlideStage 等比缩放至可用视口 -->
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=yes" />
<title>RUN:面向隐蔽目标分割的可逆展开网络 · 交互式教程</title>
</head>
<body>
<div id="root"></div>
<script type="module" src="/src/main.tsx"></script>
</body>
</html>
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
{
"title": "RUN:面向隐蔽目标分割的可逆展开网络",
"pages": [
{
"id": "domain-conflict",
"chapterId": "chap-1",
"title": "掩码歧义如何变成 RGB 重建冲突",
"goal": "比较同一像素的前景掩码判断与 RGB 背景解释。",
"summary": "用前景、背景和残差把问题动机与分离模型连起来。",
"interaction": "选取 5×5 区域中的像素并改变掩码值,观察前景、背景与重建残差。",
"next": "稀疏规则进一步降低不确定像素对分离的干扰。",
"snippet": "问题动机见 PDF p. 2 Sec. 1;Fig. 2, PDF p. 3。分离模型见 PDF p. 3 Sec. 3.1 Eqs. (1)-(4)。面板使用归一化合成数值,不复现论文图像。"
},
{
"id": "separation-model",
"chapterId": "chap-2",
"title": "分离模型与不确定像素的稀疏权重",
"goal": "读懂前景、背景和残差,并理解不确定掩码为何不受稀疏惩罚。",
"summary": "观察单像素重组残差;讲稿补充论文对 M̃ 与 w 的阈值规则。",
"interaction": "调节 M 和 B,数值、分解条与残差即时更新;按讲稿判断阈值映射和权重。",
"next": "把交替优化更新展开为有限阶段网络。",
"snippet": "分离模型见 PDF p. 3 Sec. 3.1 Eqs. (1)-(4),使用归一化灰度单像素例 C=0.8。稀疏规则见 PDF p. 4 Sec. 3.1 Eq. (5):[0.1,0.4) 映射到 0.1,(0.6,0.9] 映射到 0.9;[0.4,0.6] 时 w=0,其余 w=1。边界包含关系严格按论文;交互不是论文数据。"
},
{
"id": "unfolding-structure",
"chapterId": "chap-3",
"title": "从 M/B 交替更新到 K 阶展开网络",
"goal": "理解 M 与 B 的交替优化如何映射到 RUN 阶段结构。",
"summary": "讲稿说明交替更新关系;画面逐阶段查看 SOFS 与 ROBE 的职责。",
"interaction": "选择阶段 K 并点选 SOFS/ROBE,显示该阶段输入、输出与更新职责。",
"next": "进入 SOFS 的双感受野掩码细化。",
"snippet": "交替更新见 PDF pp. 4-5 Sec. 3.2.1 Eqs. (6)-(17):先更新 M,再以新 M 和旧 B 更新背景;背景子问题可闭式求解,掩码侧不伪造完整网络结果。展开结构见 Sec. 3.2.2 Fig. 3 Eqs. (18)-(21)。论文实验默认 K=4,见 PDF p. 6 implementation details;不宣称 K=4 对所有场景最优。"
},
{
"id": "sofs-rss",
"chapterId": "chap-4",
"title": "SOFS 如何兼顾边缘和漏分区域",
"goal": "区分局部感受野与大感受野在 RSS 中的职责。",
"summary": "操作输入特征和局部/广域分支权重,检查输出掩码与边缘响应。",
"interaction": "选择 5×5 特征位置并调节两分支贡献,输出格图实时更新。",
"next": "查看 ROBE 如何在 RGB 域更新背景并重建图像。",
"snippet": "PDF p. 5 Sec. 3.2.2 Eqs. (18)-(19), Fig. 3。小感受野用于边缘附近局部细化,大感受野用于补足漏分区域;玩具网格不等价于真实 VSS/RSS 网络。"
},
{
"id": "reconstruction-loss",
"chapterId": "chap-5",
"title": "ROBE 背景更新与联合重建监督",
"goal": "理解背景闭式更新,并区分掩码、边缘与重建损失。",
"summary": "讲稿给出 ROBE 更新关系;交互切换各损失项的监督对象。",
"interaction": "开关 BCE、IoU、Dice、重建 MSE,观察对应掩码、边缘和重建约束。",
"next": "检查这些机制在 COD 协议下的实验结果。",
"snippet": "ROBE 更新见 PDF p. 5 Sec. 3.2.1 Eq. (17):B̂ₖ=(λBₖ₋₁+C−C·M)/(1+λ),真实 RUN 还用学习网络细化背景。联合损失见 Sec. 3.2.2 Eq. (22)。交互说明监督对象,不模拟训练精度或伪造消融数值。"
},
{
"id": "cod-results",
"chapterId": "chap-6",
"title": "RUN 在 COD10K 同设置下的结果",
"goal": "在统一骨干和评测设置内比较主要指标,不跨协议拼接结论。",
"summary": "聚焦 Table 1 的 ResNet50 common setting,比较 COD10K 的 Fβ、MAE、Eφ、Sα。",
"interaction": "选择指标和 FEDER/FocusDiff 基线,联动查看四指标矩阵、局部数轴和绝对/相对差值;不改变论文测量结果。",
"next": "不同 COS 子任务采用不同数据与指标协议。",
"snippet": "PDF p. 6 Table 1,ResNet50 common setting, single input scale/single stage:COD10K RUN Fβ=0.747, MAE=0.030, Eφ=0.903, Sα=0.827;FocusDiff Fβ=0.730, MAE=0.031, Eφ=0.897, Sα=0.820。Fβ/Eφ/Sα 越高越好,MAE 越低越好。"
},
{
"id": "transfer-protocols",
"chapterId": "chap-7",
"title": "PIS、MTOS 与 TOD 不能合并排行",
"goal": "按任务核对数据集、指标方向和训练划分。",
"summary": "逐个查看跨任务评测协议,区分可以比较与不应合并的指标。",
"interaction": "选择 PIS、MTOS 或 TOD,匹配数据集与指标组合并核对答案,反馈解释协议错配的原因。",
"next": "最后核对 RUN+ 扩展和论文明确的适用边界。",
"snippet": "PDF pp. 7-8 Tables 2-4,Appendix A.1 p. 12。PIS: mDice/mIoU/Sα;MTOS: mDice/AUC/SEN;TOD: mIoU/Fβmax/MAE。数据划分与骨干不同,不跨任务比数值。"
},
{
"id": "run-plus",
"chapterId": "chap-8",
"title": "RUN+ 的雾化鲁棒性来自额外重建器",
"goal": "分清 RUN 主方法与加入预训练去雾模型的扩展。",
"summary": "对照论文报告的 RUN/RUN+ 结构差别及雾化实验范围。",
"interaction": "调节真实透射率、空气光与估计透射率,联动观察合成参考图、雾化输入、解析恢复和强度 MAE。",
"next": "回顾双域联合建模解决的问题与仍未解决的边界。",
"snippet": "PDF p. 8 Fig. 5 Sec. 4.3;Appendix B p. 13。雾化在 COD10K 模拟,RUN 仍退化,RUN+ 使用额外预训练去雾模型。页面另用教学合成模型 I=tJ+(1−t)A 与解析逆变换说明估计误差;非 RUN/RUN+ 推理,强度 MAE 不等于论文分割 MAE。"
},
{
"id": "limitations",
"chapterId": "chap-8",
"title": "复杂退化、资源开销与分辨率仍有限制",
"goal": "识别论文作者明确列出的未来工作方向。",
"summary": "检查低层视觉模型整合成本和 352×352 输入设置对应的限制。",
"interaction": "逐项判断同协议结果、混合退化、高分辨率和资源开销四个结论,查看证据解释并汇总判断结果。",
"next": "结束教程。",
"snippet": "Appendix B p. 13;训练测试缩放到 352×352 见 Sec. 4 p. 5。低照度、模糊、噪声仅作为作者提及的方向,不写成已经测得的结果。"
}
]
}
Loading
Loading