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,67 @@
# 无伪装标注的零样本伪装目标分割 交互式教程

基于论文 *Towards Real Zero-Shot Camouflaged Object Segmentation without Camouflaged Annotations*,由 **paper-skill** 生成的完整 React + TypeScript + Vite 网页项目。

## 本地运行

本教程共10页(含封面),涵盖零样本训练协议、并联Adapter、多尺度空间、训练描述、Token Match、码本对齐、同主干结果、消融与迁移边界。

## 来源与验证

- 论文:https://arxiv.org/abs/2410.16953v2;DOI:https://doi.org/10.1109/TPAMI.2025.3600461。
- 插图为本教程代码绘制的教学示意,未复制论文图片;缩略图来自本教程截图。
- 合成向量和矩阵只解释公式,不是CaMF模型推理;论文实测分数与合成参数独立。
- 同一源码已通过TypeScript、Vite构建及目标目录结构检查。十页固定画布审计通过,使用者确认预览及主要交互正常。
- 移动端全流程未完成:窄屏导航曾出现共享播放器零缩放;不将此状态下的空审计视为通过。
- 未运行全仓库校验、catalog或preflight,检查范围仅为本教程。

```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>无伪装标注的零样本伪装目标分割 · 交互式教程</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": "无伪装标注的零样本伪装目标分割",
"pages": [
{
"id": "protocol",
"chapterId": "chap-1",
"title": "零样本的边界是训练数据",
"goal": "核对标注从哪里来,而不是只看零样本这个名字。",
"summary": "用DUTS显著性监督迁移,不使用COS标注。",
"interaction": "切换训练来源,判断是否符合论文协议。",
"next": "冻结主干,学习并联修正",
"snippet": "Fig.3;IV-A。DUTS训练20 epochs,预训练模型并未消失。"
},
{
"id": "adapter",
"chapterId": "chap-2",
"title": "冻结主干,学习并联修正",
"goal": "改变修正强度,观察冻结输出与可训练分支。",
"summary": "并联低秩分支修改特征,不替换冻结主干。",
"interaction": "调节分支缩放,计算向量相加。",
"next": "多尺度改变空间粒度",
"snippet": "III-B Eq.3-4;Fig.4。合成二维向量不等于真实网络推理;Adapter无额外LN、带偏置。"
},
{
"id": "scales",
"chapterId": "chap-3",
"title": "多尺度改变空间粒度",
"goal": "同一幅图像,如何产生不同尺度的视觉token?",
"summary": "不同空间粒度进入共享投影器。",
"interaction": "选择下采样尺度,核对位置数与共享投影。",
"next": "训练描述扩大语义提示",
"snippet": "III-B Multi-scale Transform;III-D Eq.6-9。最后特征经SFP生成四尺度。图示网格简化。"
},
{
"id": "captions",
"chapterId": "chap-4",
"title": "训练描述扩大语义提示",
"goal": "区分训练提示消融与推理时问答。",
"summary": "描述在训练期提供语义,推理时不需要prompt。",
"interaction": "选择训练提示,比较固定的实测分数。",
"next": "置零分数,不等于删除概率",
"snippet": "Table IV SOS部分,DUTS零样本,CAMO/COD10K Fw越大越好;BLIP2-opt离线。"
},
{
"id": "token-match",
"chapterId": "chap-5",
"title": "置零分数,不等于删除概率",
"goal": "从原始分数走到权重,检查每一步。",
"summary": "稀疏化分数之后,零值仍贡献exp(0)。",
"interaction": "改变一项分数和视觉位置数,重算softmax。",
"next": "码本学习方向,推理移除 M-LLM",
"snippet": "III-D Eq.10-12。按行min-max,低于1/Lv置零,之后softmax。非负无穷硬mask。"
},
{
"id": "codebook",
"chapterId": "chap-6",
"title": "码本学习方向,推理移除 M-LLM",
"goal": "把描述方向与query对齐,观察余弦损失。",
"summary": "训练对齐I与Q,推理使用学习到的query。",
"interaction": "改变查询角度,切换训练与推理路径。",
"next": "同主干比较:完整方法的增益",
"snippet": "III-F;III-G Eq.17-19。论文四尺度平均。零样本不含UAL。图为非零单位向量单尺度示意。"
},
{
"id": "results",
"chapterId": "chap-7",
"title": "同主干比较:完整方法的增益",
"goal": "控制backbone与训练协议,再解释指标差值。",
"summary": "同主干DUTS协议下有增益,不外推所有指标全面领先。",
"interaction": "选择指标和数据集,计算绝对与相对变化。",
"next": "更大不一定更好",
"snippet": "Table II;IV-B。EVP-EVA02-L与CaMF同主干及相同超参数。Fw↑,MAE↓。无显著性结论。"
},
{
"id": "ablations",
"chapterId": "chap-8",
"title": "更大不一定更好",
"goal": "检查MFA通道、码本与推理开销的真实条件。",
"summary": "更大通道并不保证更好,速度依赖设备和测量协议。",
"interaction": "选择通道数和推理语义来源。",
"next": "迁移结论必须带上模型来源",
"snippet": "Table III零样本CAMO Fw;Table I 4060Ti .055s。IV-E18.1FPS、332M与监督CAMO .887不混入零样本比较。"
},
{
"id": "boundaries",
"chapterId": "chap-9",
"title": "迁移结论必须带上模型来源",
"goal": "修正错配的训练来源,再回看码本对齐。",
"summary": "零样本是相对于任务定义的,不是没有任何监督。",
"interaction": "为目标选择来源,调整独立合成query角度。",
"next": "回到机制,检查证据边界。",
"snippet": "V Tables V-VII;polyp来自COS预训练,水下来自DUTS;OVCamo仅二值mask。角度不控制benchmark。"
}
]
}
Loading
Loading