KswordFrame3.0 是基于 FLTK 的轻量现代 GUI 封装层，公共控件统一使用 K* 命名，例如 KButton、KInput、KTable、KDockManager。旧 Flat* 名称保留为兼容别名。

#include "KswordGUI/KswordStyle.h"
#include "KswordWinAPICore/ksword.h"

InitFlatThemeGlobal();
Fl_Window win(1060, 760, "Demo");
SetWindowStyle(&win);

• KThemeManager::instance().SetMode(KThemeMode::Light / KThemeMode::Dark)
• KThemeManager::instance().ToggleMode()
• KThemeManager::instance().SetPrimaryColor(r, g, b)
• KThemeManager::instance().ApplyTo(widget)
• KThemeManager::instance().RegisterWindow(window)

主题支持运行时切换深浅色和主题色，已注册窗口会自动刷新。

常用类和工厂：

• KButton* KCreateButton(...)
• KInput* KCreateInput(...)
• KCheckBox* KCreateCheckBox(...)
• KRadioButton* KCreateRadioButton(...)
• KToggleButton* KCreateToggleButton(...)
• KSlider* KCreateSlider(...)
• KText* KCreateText(...)
• KPanel* KCreatePanel(...)
• KChoice* KCreateChoice(...)
• KOutput* KCreateOutput(...)
• KProgressBar* KCreateProgress(...)
• KTextBox* KCreateTextBox(...)
• KTextDisplay* KCreateTextDisplay(...)
• KTable* KCreateTable(...)
• KBrowser* KCreateBrowser(...)
• KMenuButton* KCreateMenuButton(...)
• KCounter* KCreateCounter(...)
• KSpinner* KCreateSpinner(...)
• KValueInput* KCreateValueInput(...)
• KSplitter* KCreateSplitter(...)

KTextBox 额外提供：clear_current_line()、clear_previous_line()、clear_all()、append_text()。

图像框架用于把图片资源和显示控件解耦：

• KImageResource：保存或加载图片资源，便于多个视图复用同一份图片数据。
• KImageView：负责在 GUI 中显示图片，同时支持空状态文本和主题化背景/边框/文字色。
• KCreateImageView(...)：工厂函数，按 K* 控件风格创建一个主题化图像视图。

最小示例：

KImageView* view = KCreateImageView(20, 20, 240, 140, "Preview");
view->set_fit_mode(KImageFitMode::Contain);

KImageResource resource = KImageResource::Load("assets/preview.png");
if (resource.valid()) {
    view->setImagePath(resource.path().c_str());
}
else {
    view->set_empty_text("暂无图片");
}

Demo 中的“图像组件”区域会优先查找仓库内 assets/ 或 resources/ 下的常见图片文件；没有资源时显示空状态文本，避免硬编码不存在路径。

FLTK 原生 Dock API：

KDockManager* manager = KCreateDockManager(20, 20, 800, 500);
KDockWidget* dock = KCreateDockWidget("标题", contentWidget);
manager->addDockWidget(KDockAreaPosition::Center, dock);
std::string layout = manager->saveLayout();
manager->restoreLayout(layout);

支持左/右/上/下/中心区域、标签化、标题栏拖拽停靠、浮动窗口、关闭隐藏、布局保存/恢复。

KswordWinAPICore/ksword.h 聚合日志 API：

kLogEvent ev;
dbg << ev << "debug" << eol;
info << "info" << eol;
warn << "warn" << eol;
err << "error" << eol;
fatal << "fatal" << eol;

全局对象：dbg、info、warn、err、fatal。日志会输出到控制台并归档到 KswordARKEventEntry，可用 Snapshot()、Track(GUID)、Save(path) 查询或导出。

Main.cpp 展示：

• K* 基础控件、文本/列表/表格、数值控件；
• KImageView 图像组件区域，展示资源加载、空状态和 Contain fit 模式；
• 动态主题色和深浅色切换；
• KDockManager 实际 Dock 面板；
• 启动参数 --log-smoke-test 可触发日志链路验证。