Imported from dotnet9/CodeWF.Avalonia (
AGENTS.md). Install upstream withnpx skills add dotnet9/CodeWF.Avalonia. Copyright stays with the author.
AGENTS.md — 仓库协作约定
面向 AI 助手与新成员的改动守则。设计决策背景见
docs/决策记录.md， 流式规格见docs/流式规则.md，性能数据见docs/基准报告.md。
构建与测试
dotnet build CodeWF.Avalonia.slnx -c Release
dotnet test tests/CodeWF.Avalonia.Content.Tests/CodeWF.Avalonia.Content.Tests.csproj --filter "FullyQualifiedName~Markdown"
dotnet run --project bench/CodeWF.Avalonia.Markdown.Benchmarks -c Release -- all- 版本跟随 Avalonia：
Directory.Build.props的Version前三位 = Avalonia 版本，第 4 位自有修订。 - 提交：中文、一个逻辑单元一个提交，随做随推。
改动同步清单（改这里就必须改那里）
流式（Streaming/）
- 改冻结规则：先改
docs/流式规则.md（规格先行），再改MarkdownStreamSegmenter，跑StreamingEquivalenceTests矩阵必须全绿。 - 改 remend 处理器：
MarkdownTailRemender加处理器 →docs/流式规则.md§4.1 优先级表同步 +Fixtures/remend/加 JSON fixture； fixture 数量基线在RemendFixtureTests.FixtureCount_MeetsBaseline。 - 改快照结构：
MarkdownStreamingSnapshot加字段 →MarkdownViewer.OnStreamingSnapshotReady与流式测试同步。 - 性能相关改动 →
bench跑对照，数字进docs/基准报告.md。
渲染（Rendering/）
- 新增块渲染器：
Rendering/Blocks/新建 →MarkdownViewer.CreateDefaultPipeline注册 →MarkdownStyleKeys加样式类 → 主题字典（Themes/）补对应排版资源。 MarkdownBlockKind加成员：分类器MarkdownBlockClassifier、MarkdownDiffService的指纹/比较分支、渲染器管道三处同步，漏一处 会出现"解析到了但永远走降级渲染"。IMarkdownRenderContext加成员：唯一实现者是MarkdownViewer； 能力包（Mermaid/Math/Images/Highlighting）是该接口的消费者，签名变更 要全量编译能力包确认。
块级状态（折叠等）
- 状态字典键 = 块源码起始偏移（
SourceSpan.Start），存MarkdownViewer不存控件；换文档清理点在RenderDocumentFull（源码变更才清， 同文档重渲染保留）。
图片（Images）
- 本地加载统一过
MarkdownImageSourceLoader.LoadLocalFile/Async—— 白名单等安全约束加在这两处，不要绕过。 - 远程读取统一过
ReadRemoteBytesWithDiskCache/Async。
测试约定
- headless 平台测试（控件构造/布局/点击）挂
[Collection("AvaloniaPlatform")]platform.Run(() => ...)；纯逻辑（切分器/remend/diff/loader）不挂， 直接跑。
- 点击模拟：
window.MouseMove/MouseDown/MouseUp+Dispatcher.UIThread.RunJobs()。 - 涉及会真的打开浏览器的路径（链接点击），测试必须置
args.Cancel = true。
已知边界（不要试图"修复"）
- 无障碍：Avalonia 无公开 TextPattern，文本级光标浏览不可用（见 D19）。
- 行内单个
_不参与 remend 补全（snake_case 误报成本高于收益，见 §4.1）。 - 解析失败保留旧快照不清空（流式规格 B2），排障先看
Failed事件。
