Store.Management/.agents/rules/handycontrol-usage.md

HandyControl 使用规则

当前依赖

Framework 项目当前引用官方 HandyControl 3.6.2.1 与 MAX.Common.WPF。准确版本以 Source/Store.Management.Framework/Store.Management.Framework.csproj 为准。

• 保持官方 HandyControl 包选择，不套用内部 fork 包名禁令，不因规则迁移替换包。
• XAML 命名空间为 https://handyorg.github.io/handycontrol；程序集与 pack URI 使用 HandyControl。
• 不将当前机器的 NuGet 缓存绝对路径推广为其他机器的固定路径。

主题与窗口

Source/Store.Management/App.xaml 当前按顺序合并：

1. /Store.Management.Framework;component/Resources/HandyControlBasic.xaml
2. /HandyControl;component/Themes/SkinDefault.xaml
3. /HandyControl;component/Themes/Theme.xaml

应用定义 PrimaryBrush、TextIconBrush、BackgroundBrush 和 DialogWindowStyle。WindowBase 构造读取窗口画刷，DialogWindow 读取对话框样式，调整时保持资源契约。

• 默认尺寸、内边距、字号集中在 HandyControlBasic.xaml；修改前检查覆盖顺序与使用范围。
• 不引用未创建的 FrameworkTheme.xaml、CustomColors.xaml 或语义颜色清单。
• 优先复用已有控件与样式，核实当前包版本的属性和资源键。
• 消息提示沿用当前 WPF / HandyControl 用法；业务弹窗复用 Prism 链路，不假设存在 IMessageBoxServiceEx。
• 组件参考见 controls-reference.md，绑定与输入约定见 wpf-xaml.md。