2026-03-23 22:43:54 +08:00
|
|
|
|
# Documentation Sources
|
|
|
|
|
|
|
|
|
|
|
|
## 目标
|
|
|
|
|
|
|
|
|
|
|
|
当多个文档都提到同一主题时，AI 必须知道“到底信哪一份”。本文件定义权威来源，避免引用旧文档或重复维护的文本。
|
|
|
|
|
|
|
|
|
|
|
|
## 权威来源表
|
|
|
|
|
|
|
|
|
|
|
|
| 主题 | 权威文档 | 备注 |
|
|
|
|
|
|
| --- | --- | --- |
|
|
|
|
|
|
| 项目总入口 | `README.md` | 面向人类，提供索引而不展开细节 |
|
|
|
|
|
|
| AI 协作入口 | `AGENTS.md` | 面向 AI 的首读文件 |
|
|
|
|
|
|
| 产品定位与阶段 | `docs/PRODUCT.md` | 不再使用旧根目录产品文档 |
|
|
|
|
|
|
| 架构与模块职责 | `docs/ARCHITECTURE.md` | 包含仓库结构和运行时主线 |
|
|
|
|
|
|
| 构建、运行、测试、打包 | `docs/DEVELOPMENT.md` | 命令以这里为准 |
|
|
|
|
|
|
| 贡献和文档更新规则 | `docs/CONTRIBUTING.md` | PR、spec、文档协作规则 |
|
|
|
|
|
|
| feature 级规格 | `.trae/specs/<feature>/spec.md` | 行为意图和需求场景 |
|
|
|
|
|
|
| feature 任务拆解 | `.trae/specs/<feature>/tasks.md` | 实施步骤与依赖 |
|
|
|
|
|
|
| feature 验收 | `.trae/specs/<feature>/checklist.md` | 回归与验收项 |
|
|
|
|
|
|
| 视觉规范 | `docs/VISUAL_SPEC.md` | 颜色、语义资源、玻璃层级 |
|
|
|
|
|
|
| 圆角规范 | `docs/CORNER_RADIUS_SPEC.md` | 圆角层级与动态规则 |
|
|
|
|
|
|
| 插件生态边界 | `docs/ECOSYSTEM_BOUNDARIES.md` | 仓库边界和 market 所属 |
|
Avalonia12 (#7)
* ava12升级
* Enable centralized package versioning
Add <Project> and <PropertyGroup> with <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally> to Directory.Packages.props to enable centralized package version management across the repository. This allows package versions to be controlled from this single file instead of individual project files.
* Migrate codebase to Avalonia 12 APIs
Apply Avalonia 12 migration changes: replace SystemDecorations with WindowDecorations and remove ExtendClientAreaChromeHints/ExtendClientAreaTitleBarHeightHint usages; update BindingPlugins removal logic (no-op); switch clipboard usage to ClipboardExtensions.SetTextAsync; update Bitmap.CopyPixels calls to the new signature. Replace TextBox.Watermark with PlaceholderText, convert NumberBox styles to FANumberBox and adjust templates, change Checked/Unchecked handlers to IsCheckedChanged, and adapt FluentIcons usages (SymbolIconSource -> FASymbol/FAFont/FluentIcon equivalents). Fix MainWindow partial classes to inherit Window and correct missing variables/fields/usings. Add migration docs/specs/tasks under .trae and include a small TestFluentIcons project for icon testing.
* Migrate to Avalonia 12 and Plugin SDK v5
Upgrade project to the Avalonia 12 baseline and Plugin SDK v5: centralize Avalonia packages, remove legacy WebView.Avalonia usage (use NativeWebView/WebView2 EnvironmentRequested), and update Fluent/Material icon/package usages. Bump multiple package/project versions to 5.0.0 and Avalonia 12.0.1, update plugin template and README/docs to SDK v5, and add PLUGIN_SDK_V5_MIGRATION.md.
Also fix runtime/behavior bugs: make DataLocationResolver use a fixed bootstrap launcher data path and avoid recursive ResolveDataRoot; add legacy-state handling and extraction in OobeStateService; and update component settings tests to reflect migrated storage (DB/backup) and reset cache for test reloads. Various csproj, tests, and docs updated to reflect the migration and ensure build/test compatibility.
* Update icon glyphs and symbol mappings
Replace and refine icon sources across settings pages and controls: many FAFontIconSource glyphs were updated to specific Seagull Fluent Icons codepoints, some FASymbolIconSource usages were replaced with FAFontIconSource, and a number of symbol-to-Symbol enum mappings were adjusted (e.g. "Bell" -> AlertOn, "Shield" -> ShieldLock). Also clarified a comment in SettingsWindow and fixed a trailing newline in StudySettingsPage. Changes standardize icon visuals and bridge FluentIcons glyphs into FluentAvalonia icon sources.
* fix.修复合并产生的问题。
2026-04-29 12:14:29 +08:00
|
|
|
|
| SDK v5 迁移 | `docs/PLUGIN_SDK_V5_MIGRATION.md` | Plugin SDK breaking changes |
|
2026-03-23 22:43:54 +08:00
|
|
|
|
|
|
|
|
|
|
## 已废弃来源
|
|
|
|
|
|
|
|
|
|
|
|
以下文件内容已迁移，不应继续作为权威来源引用：
|
|
|
|
|
|
|
|
|
|
|
|
- `PRODUCT_BRIEF.md`
|
|
|
|
|
|
- `PRODUCT_DOCUMENT.md`
|
|
|
|
|
|
- `run.md`
|
|
|
|
|
|
|
|
|
|
|
|
## 冲突处理规则
|
|
|
|
|
|
|
|
|
|
|
|
如果发现多个文档内容冲突，按以下优先级处理：
|
|
|
|
|
|
|
|
|
|
|
|
1. 先看本表中的权威来源
|
|
|
|
|
|
2. 再看相关项目内源码、`csproj`、目录 README
|
|
|
|
|
|
3. 如果仍有冲突，以当前仓库源码和项目配置为准，并回写文档
|