# 开发文档

JarkViewer 按 AI 协作方式开发。日常规则放在 [AGENTS.md](../AGENTS.md)，实现细节与操作手册按任务查阅，不必每轮通读。

| 要做的事 | 先读 |
| --- | --- |
| 首次构建、升级静态库、调整工程 | [构建与依赖](build.md) |
| 选择回归、生成语料、运行自检 | [验证指南](testing.md) |
| 查启动慢、崩溃、颜色或播放问题 | [调试与排障](debugging.md) |
| 定位模块、理解入口与窗口生命周期 | [架构导航](architecture.md) |
| 改解码、缓存、画布、SVG、ICC、EXIF | [图像链路](image-pipeline.md) |
| 改音视频、seek、硬件解码、频谱 | [媒体播放](media-playback.md) |
| 改 ImGui、输入法、设置、多语言、打印、编辑或缩略图 | [界面与交互](ui.md) |
| 了解旧审计覆盖范围与性能误判 | [2026-11 审计记录](history/2026-11-audit.md) |

## 文档维护

- [中文 README](../README.md) / [English README](../README_EN.md) 面向使用者，保留功能、操作、格式与常见问题；开发内容从本目录进入。
- AGENTS.md 只放跨任务的工作规则和阅读入口。局部实现约束写到对应主题，并尽量由代码、自检或源码不变量检查守住。
- 一个事实只在一处详细说明，其余位置用链接。格式清单是例外：两份 README 必须与代码一致，由 `tools/check_source_invariants.ps1` 交叉检查。
- 文档和相关代码同轮更新；命令参数、库版本与结构体布局以当前源码/脚本为准。不要把一次实测耗时、断言总数或某台机器的路径当成永久约束。
- 历史报告只记录当时的版本、覆盖和结论。新一轮验证保留自己的报告，不向日常规则持续追加流水账；旧全文可从 Git 历史查回。

所有命令默认在仓库根目录执行，PowerShell 使用 `pwsh`。文档中的 `<图片>`、`<视频>`、`<报告目录>` 等是待替换参数；需要语料、GUI、ffmpeg 或本机工具链的命令应按前提运行。