智能提示设计原则

dotNet.AntdUI 扩展库的智能提示目标是“高频、够用、轻量”，而不是完整复制全部 .NET API。AntdUI 公开类型很多，如果把所有继承自 WinForms 的属性、低频重载和内部辅助类型都写入提示，会让库文件膨胀，也会降低输入时的命中质量。

收录原则

• 收录常用控件构造函数与核心枚举。
• 收录最常输入的属性、方法、事件。
• 表格、选择器、树、菜单、静态弹层、聊天等高频组件优先。
• 复杂配置对象与低频高级 API 放入文档，不强行塞入提示。
• 新增上游组件时先确认当前 DLL 是否公开对应类型，再决定是否加入顶层提示。

不收录或少收录

• WinForms 继承来的大量基础属性，例如 Handle、CreateParams、无关设计器属性。
• 设计器专用属性、内部类型、编译器生成类型。
• 很少手写的重载方法。
• 过深的事件参数成员；事件参数更适合在文档中说明。

反射核对示例

import dotNet.reflection;

var data = dotNet.reflection.exportAssembly(
    "~\lib\dotNet\AntdUI\.res\AntdUI.dll",
    {
        typeNames = [
            "AntdUI.Button",
            "AntdUI.Table",
            "AntdUI.Chat.MsgList",
            "AntdUI.Chat.ChatList"
        ];
        includeMethods = true;
        includeEvents = true;
        includeFields = false;
    }
);

var md = dotNet.reflection.toMarkdown(data);

维护流程

1. 用反射脚本确认类型、构造函数、属性、事件和链式方法是否存在。
2. 查上游 wiki / 示例，判断 API 是否高频。
3. 高频成员加入 dotNet.AntdUI 智能提示；低频成员写入对应组件文档。
4. 修改后执行隔离重载与冒烟测试，避免提示块语法破坏库文件。

命名建议

• 顶层 AntdUI.Xxx 只列组件、数据项、关键枚举和静态类。
• 组件提示块使用 !AntdUIXxx 命名。
• 嵌套类型可按实际使用写为 !AntdUIModalConfig、!AntdUITextChatItem 等，尽量保持短而清晰。

Markdown 格式