kcode-pi 0.1.0

package/vendor/kingdee-skills/ok-cosmic/assets/ReportFormPluginTemplate.java

@@ -0,0 +1,257 @@
+package kd.cd.common;
+
+import kd.bos.context.RequestContext;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.entity.NumberFormatProvider;
+import kd.bos.entity.datamodel.events.PackageDataEvent;
+import kd.bos.entity.report.FilterInfo;
+import kd.bos.entity.report.ReportColumn;
+import kd.bos.entity.report.ReportQueryParam;
+import kd.bos.entity.report.queryds.ReportFilterFieldConfig;
+import kd.bos.form.control.events.FilterContainerInitEvent;
+import kd.bos.form.events.FilterContainerSearchClickArgs;
+import kd.bos.form.field.events.BeforeFilterF7SelectEvent;
+import kd.bos.lang.Lang;
+import kd.bos.logging.Log;
+import kd.bos.logging.LogFactory;
+import kd.bos.list.column.ListOperationColumnDesc;
+import kd.bos.report.ReportList;
+import kd.bos.report.events.CreateColumnEvent;
+import kd.bos.report.plugin.AbstractReportFormPlugin;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+
+/**
+ * 报表界面插件骨架模板（原生 AbstractReportFormPlugin）。
+ * 该类仅用于示例写法，生成后请按实际业务删除无用事件并替换占位常量。
+ */
+public class ReportFormPluginTemplate extends AbstractReportFormPlugin {
+    private static final Log LOG = LogFactory.getLog(ReportFormPluginTemplate.class);
+
+    /**
+     * 触发时机: 在需要了解当前插件可访问上下文能力时调用。
+     * 参数要点: 无入参；仅展示当前插件可通过 this. 访问的方法能力。
+     * 典型用途: 作为模板提示，指导在各事件内选择正确的上下文 API。
+     */
+    private void getContextSample() {
+        // this.getView();
+        // this.getModel();
+        // this.getPageCache();
+        // this.getControl("reportlistap");
+        // this.getQueryParam();
+    }
+
+    private static final String GRID_KEY = "reportlistap";
+    private static final String FILTER_ORG = "org";
+    private static final String FILTER_BILL_STATUS = "billstatus";
+    private static final String RES_APP_ID = "kd-cd-common-template";
+
+    // ===== 核心事件 =====
+
+    /**
+     * 触发时机: 默认查询参数初始化时。
+     * 参数要点: queryParam 可设置默认过滤、排序、方案值。
+     * 典型用途: 为报表设置默认组织、默认状态等初始查询条件。
+     */
+    @Override
+    public void initDefaultQueryParam(ReportQueryParam queryParam) {
+        super.initDefaultQueryParam(queryParam);
+        FilterInfo filter = queryParam.getFilter();
+        if (filter == null) {
+            filter = new FilterInfo();
+            queryParam.setFilter(filter);
+        }
+        filter.addFilterItem("fieldKey", RequestContext.get().getOrgId());
+    }
+
+    /**
+     * 触发时机: 过滤容器初始化时。
+     * 参数要点: contInitEvent 可访问过滤容器定义，queryParam 为当前查询参数。
+     * 典型用途: 初始化过滤项默认值、隐藏字段或补充联动字段。
+     */
+    @Override
+    protected void filterContainerInit(FilterContainerInitEvent contInitEvent, ReportQueryParam queryParam) {
+        super.filterContainerInit(contInitEvent, queryParam);
+        initDefaultQueryParam(queryParam);
+    }
+
+    /**
+     * 触发时机: 过滤项 F7（基础资料/引用数据选择控件）打开前。
+     * 参数要点: args 可追加基础资料过滤条件。
+     * 典型用途: 限定 F7（基础资料/引用数据选择控件）可选范围，如只显示启用组织或启用基础资料。
+     */
+    @Override
+    public void filterContainerBeforeF7Select(BeforeFilterF7SelectEvent args) {
+        super.filterContainerBeforeF7Select(args);
+        args.addCustomQFilter(new kd.bos.orm.query.QFilter("enable", kd.bos.orm.query.QCP.equals, true));
+    }
+
+    /**
+     * 触发时机: 点击过滤容器“查询”按钮时。
+     * 参数要点: args 含当前过滤值。
+     * 典型用途: 在查询按钮点击时读取过滤值、补充联动参数或提示信息。
+     */
+    @Override
+    public void filterContainerSearchClick(FilterContainerSearchClickArgs args) {
+        super.filterContainerSearchClick(args);
+        Object orgValue = args.getFilterValue(FILTER_ORG);
+        if (orgValue != null) {
+            this.getView().showTipNotification(String.format(
+                    ResManager.loadKDString("按组织过滤：%s", "ReportFormPluginTemplate_0", RES_APP_ID),
+                    orgValue
+            ));
+        }
+    }
+
+    /**
+     * 触发时机: 查询前校验时。
+     * 参数要点: 返回 false 会阻断查询。
+     * 典型用途: 避免空条件、超大范围或非法查询进入数据库。
+     */
+    @Override
+    public boolean verifyQuery(ReportQueryParam queryParam) {
+        super.verifyQuery(queryParam);
+        return queryParam.getFilter() != null;
+    }
+
+    /**
+     * 触发时机: 报表查询执行前。
+     * 参数要点: queryParam 含过滤、分页、排序等上下文。
+     * 典型用途: 追加查询过滤条件、设置报表控件状态或修正参数。
+     */
+    @Override
+    public void beforeQuery(ReportQueryParam queryParam) {
+        super.beforeQuery(queryParam);
+        FilterInfo filter = queryParam.getFilter();
+        if (filter == null) {
+            filter = new FilterInfo();
+            queryParam.setFilter(filter);
+        }
+        // 设置取数排序规则
+        queryParam.setSortInfo("xxx");
+        // 设置自定义参数到取数插件
+        queryParam.setCustomParam(new HashMap<>());
+        // 设置是否树形报表
+        queryParam.setTreeReportList(false);
+        // 设置报表过滤条件配置
+        queryParam.setReportFilterFieldConfig(new ReportFilterFieldConfig());
+        // 设置多语言
+        queryParam.setMulLang(Lang.zh_CN);
+        // 设置报表自定义过滤条件
+        queryParam.setCustomFilter(new ArrayList<>());
+        // 设置提示信息
+        queryParam.setMessage(ResManager.loadKDString("查询完成", "ReportFormPluginTemplate_1", RES_APP_ID));
+    }
+
+    /**
+     * 触发时机: 报表查询执行后。
+     * 参数要点: queryParam 保留本次查询上下文。
+     * 典型用途: 查询完成后输出提示、记录日志或刷新附属区域。
+     */
+    @Override
+    public void afterQuery(ReportQueryParam queryParam) {
+        super.afterQuery(queryParam);
+        this.getView().showTipNotification(ResManager.loadKDString("报表查询完成", "ReportFormPluginTemplate_2", RES_APP_ID));
+    }
+
+    /**
+     * 触发时机: 报表列创建后。
+     * 参数要点: event 可调整列标题、宽度、隐藏状态等。
+     * 典型用途: 动态调整列显示方式或列元数据。
+     */
+    @Override
+    public void afterCreateColumn(CreateColumnEvent event) {
+        super.afterCreateColumn(event);
+        this.getView().showTipNotification(ResManager.loadKDString("报表列初始化完成", "ReportFormPluginTemplate_3", RES_APP_ID));
+    }
+
+    /**
+     * 触发时机: 打包单元格数据时。
+     * 参数要点: packageDataEvent 含当前行列数据上下文。
+     * 典型用途: 对界面展示值做格式化；该事件通常不用于导出逻辑。
+     */
+    @Override
+    public void packageData(PackageDataEvent packageDataEvent) {
+        super.packageData(packageDataEvent);
+        if (packageDataEvent.getSource() instanceof ReportColumn) {
+            DynamicObject dObject = packageDataEvent.getRowData();
+            String applyType = dObject.getString("kdec_applytype");
+            if ("A".equals(applyType)) {
+                ReportColumn column = (ReportColumn) packageDataEvent.getSource();
+                if (LOG.isDebugEnabled()) {
+                    LOG.debug(String.format(
+                            ResManager.loadKDString("当前报表列：%s", "ReportFormPluginTemplate_4", RES_APP_ID),
+                            column.getFieldKey()
+                    ));
+                }
+                if ("kdec_totalday".equals(column.getFieldKey())) {
+                    packageDataEvent.setFormatValue(100);
+                }
+            }
+        }
+    }
+
+    /**
+     * 触发时机: 行数据返回后、渲染前。
+     * 参数要点:
+     * - gridPK: 当前报表 grid 标识。
+     * - rowData: 查询结果行集合。
+     * - queryParam: 查询参数。
+     * 典型用途: 对查询结果行做补值、格式修正和显示增强。
+     */
+    @Override
+    public void processRowData(String gridPK, DynamicObjectCollection rowData, ReportQueryParam queryParam) {
+        super.processRowData(gridPK, rowData, queryParam);
+        if (!GRID_KEY.equals(gridPK)) {
+            return;
+        }
+        for (DynamicObject row : rowData) {
+            if (row.get("name") == null) {
+                row.set("name", ResManager.loadKDString("未命名", "ReportFormPluginTemplate_5", RES_APP_ID));
+            }
+        }
+    }
+
+    /**
+     * 触发时机: 导出分批数据预处理时。
+     * 参数要点: data 为当前待导出的数据集合。
+     * 典型用途: 导出前补值、替换导出文本或标准化数值格式。
+     */
+    @Override
+    public void preProcessExportData(List exportColumns,
+                                     DynamicObjectCollection data,
+                                     NumberFormatProvider numberFormatProvider) {
+        super.preProcessExportData(exportColumns, data, numberFormatProvider);
+        for (DynamicObject row : data) {
+            if (row.get("name") == null) {
+                row.set("name", ResManager.loadKDString("导出默认名称", "ReportFormPluginTemplate_6", RES_APP_ID));
+            }
+        }
+    }
+
+    /**
+     * 触发时机: 设置导出 Excel 文件名时。
+     * 参数要点: list 为导出文件名片段集合。
+     * 典型用途: 自定义导出文件名，便于区分组织、期间或报表类型。
+     */
+    @Override
+    public void setExcelName(List list) {
+        super.setExcelName(list);
+        list.add("report_export");
+    }
+
+    /**
+     * 触发时机: 初始化列排序和过滤能力时。
+     * 参数要点: allColumns 为全部列定义。
+     * 典型用途: 控制列是否支持排序、列头过滤等交互行为。
+     */
+    @Override
+    public void setSortAndFilter(List allColumns) {
+        super.setSortAndFilter(allColumns);
+        this.getView().showTipNotification(ResManager.loadKDString("初始化排序与过滤能力", "ReportFormPluginTemplate_7", RES_APP_ID));
+    }
+}

package/vendor/kingdee-skills/ok-cosmic/assets/ReportListDataPluginTemplate.java

@@ -0,0 +1,70 @@
+package kd.cd.common;
+
+import kd.bos.algo.DataSet;
+import kd.bos.entity.report.*;
+import kd.bos.orm.query.QFilter;
+import kd.bos.servicehelper.QueryServiceHelper;
+
+import java.util.List;
+
+/**
+ * 报表取数插件骨架模板（原生 AbstractReportListDataPlugin）。
+ * 该类仅用于示例写法，生成后请按实际业务删除无用事件并替换占位常量。
+ */
+public class ReportListDataPluginTemplate extends AbstractReportListDataPlugin {
+
+    /**
+     * 触发时机: 在需要了解当前插件可访问上下文能力时调用。
+     * 参数要点: 无入参；仅展示当前插件可通过 this. 访问的方法能力。
+     * 典型用途: 作为模板提示，指导在各事件内选择正确的上下文 API。
+     */
+    private void getContextSample() {
+        // this.getQueryParam();
+        // this.getSelectedObj();
+        // this.setProgress(30);
+    }
+
+    private static final String QUERY_KEY = "report-query";
+    private static final String ENTITY_NAME = "entity_name";
+    private static final String SELECT_FIELDS = "id,billno,name";
+    private static final String ORDER_BY = "id desc";
+    private static final String FIELD_BILL_NO = "billno";
+
+    // ===== 核心事件 =====
+
+    /**
+     * 触发时机: 报表发起查询时。
+     * 参数要点:
+     * - queryParam.getFilter() 为过滤面板条件。
+     * - selectedObj 为左侧树或左表选中对象。
+     * 典型用途: 按查询条件与左侧选中对象组装 DataSet。
+     */
+    @Override
+    public DataSet query(ReportQueryParam queryParam, Object selectedObj) {
+        super.query(queryParam, selectedObj);
+        FilterInfo filter = queryParam.getFilter();
+        int top = 1000;
+        QFilter[] filters = filter == null ? null : filter.getQFilters().toArray(new QFilter[0]);
+        this.setProgress(20);
+        return QueryServiceHelper.queryDataSet(QUERY_KEY, ENTITY_NAME, SELECT_FIELDS, filters, ORDER_BY, top);
+    }
+
+    /**
+     * 触发时机: 报表初始化列定义后。
+     * 参数要点: columns 为系统生成的列集合，可调整显示列属性。
+     * 典型用途: 动态隐藏列、修改列宽、冻结列或调整显示顺序。
+     */
+    @Override
+    public List<AbstractReportColumn> getColumns(List<AbstractReportColumn> columns) {
+        super.getColumns(columns);
+        for (int i = 0; i < columns.size(); i++) {
+            ReportColumn rColumn = (ReportColumn) columns.get(i);
+            String key = rColumn.getFieldKey();
+            if (key.equals("textfield")) {
+                rColumn.setFreeze(true);
+                columns.set(i, rColumn);
+            }
+        }
+        return columns;
+    }
+}

package/vendor/kingdee-skills/ok-cosmic/assets/StandardTreeListPluginTemplate.java

@@ -0,0 +1,130 @@
+package kd.cd.common;
+
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.form.control.Search;
+import kd.bos.form.control.events.BeforeItemClickEvent;
+import kd.bos.form.control.events.SearchEnterEvent;
+import kd.bos.form.events.BeforeDoOperationEventArgs;
+import kd.bos.form.events.ClosedCallBackEvent;
+import kd.bos.form.events.MessageBoxClosedEvent;
+import kd.bos.form.operate.AbstractOperate;
+import kd.bos.list.plugin.StandardTreeListPlugin;
+
+import java.util.EventObject;
+
+/**
+ * 标准树列表插件骨架模板（原生 StandardTreeListPlugin）。
+ * 该类仅用于示例写法，生成后请按实际业务删除无用事件并替换占位常量。
+ */
+public class StandardTreeListPluginTemplate extends StandardTreeListPlugin {
+
+    /**
+     * 触发时机: 在需要了解当前插件可访问上下文能力时调用。
+     * 参数要点: 无入参；仅展示当前插件可通过 this. 访问的方法能力。
+     * 典型用途: 作为模板提示，指导在各事件内选择正确的上下文 API。
+     */
+    private void getContextSample() {
+        // this.getTreeListView();
+        // this.getTreeModel();
+        // this.getView();
+        // this.getModel();
+    }
+
+    private static final String OP_DELETE = "delete";
+    private static final String OP_DISABLE = "disable";
+    private static final String RES_APP_ID = "kd-cd-common-template";
+
+    /**
+     * 触发时机: 插件注册监听阶段。
+     * 参数要点: e 为通用事件对象。
+     * 典型用途: 注册树工具栏、搜索框等监听器。
+     */
+    @Override
+    public void registerListener(EventObject e) {
+        super.registerListener(e);
+        this.addItemClickListeners("tree_toolbar");
+    }
+
+
+    /**
+     * 触发时机: 工具栏项点击前。
+     * 参数要点: evt.getItemKey() 标识当前按钮，可取消默认处理。
+     * 典型用途: 在删除、停用前做前置校验或弹框确认。
+     */
+    @Override
+    public void beforeItemClick(BeforeItemClickEvent evt) {
+        super.beforeItemClick(evt);
+        if (OP_DELETE.equals(evt.getItemKey()) && this.getSelectedRows().isEmpty()) {
+            evt.setCancel(true);
+            this.getView().showErrorNotification(ResManager.loadKDString("请先选择数据", "StandardTreeListPluginTemplate_0", RES_APP_ID));
+        }
+    }
+
+    /**
+     * 触发时机: 标准操作执行前。
+     * 参数要点:
+     * - (AbstractOperate) args.getSource(): 获取操作对象。
+     * - operate.getOperateKey(): 获取操作标识。
+     * - args.setCancel(true): 取消操作。
+     * 典型用途: 在停用、删除等操作前校验选择数据是否合法。
+     */
+    @Override
+    public void beforeDoOperation(BeforeDoOperationEventArgs args) {
+        super.beforeDoOperation(args);
+        AbstractOperate operate = (AbstractOperate) args.getSource();
+        if (OP_DISABLE.equals(operate.getOperateKey()) && this.getSelectedRows().isEmpty()) {
+            args.setCancel(true);
+            this.getView().showErrorNotification(ResManager.loadKDString("请先选择数据", "StandardTreeListPluginTemplate_1", RES_APP_ID));
+        }
+    }
+
+    /**
+     * 触发时机: 左树搜索回车时。
+     * 参数要点: evt 携带搜索关键字。
+     * 典型用途: 过滤树节点或联动刷新右侧数据。
+     */
+    @Override
+    public void search(SearchEnterEvent evt) {
+        super.search(evt);
+        Search search = (Search) evt.getSource();
+        //搜索控件标识，可以根据该标识，判断是哪个控件，然后做逻辑处理
+        String key = search.getKey();
+        //搜索的文本内容
+        this.getView().showTipNotification(String.format(
+                ResManager.loadKDString("树搜索关键字：%s", "StandardTreeListPluginTemplate_2", RES_APP_ID),
+                evt.getText()
+        ));
+    }
+
+    /**
+     * 触发时机: 左树工具栏按钮点击时。
+     * 参数要点: e 可识别当前点击来源。
+     * 典型用途: 处理新增分组、刷新分组、展开节点等动作。
+     */
+    @Override
+    public void treeToolbarClick(EventObject e) {
+        super.treeToolbarClick(e);
+        this.getView().showTipNotification(ResManager.loadKDString("已触发标准树列表工具栏动作", "StandardTreeListPluginTemplate_3", RES_APP_ID));
+    }
+
+    /**
+     * 触发时机: 确认框关闭后。
+     * 参数要点: event.getResult() 可判断用户确认结果。
+     * 典型用途: 处理删除、停用等二次确认后的后续逻辑。
+     */
+    @Override
+    public void confirmCallBack(MessageBoxClosedEvent event) {
+        super.confirmCallBack(event);
+    }
+
+    /**
+     * 触发时机: 子页面关闭回调时。
+     * 参数要点: closedCallBackEvent 可读取返回动作与回参。
+     * 典型用途: 子页面关闭后刷新当前树列表。
+     */
+    @Override
+    public void closedCallBack(ClosedCallBackEvent closedCallBackEvent) {
+        super.closedCallBack(closedCallBackEvent);
+        this.reload();
+    }
+}

package/vendor/kingdee-skills/ok-cosmic/assets/TaskTemplate.java

@@ -0,0 +1,80 @@
+package kd.cd.common;
+
+import kd.bos.context.RequestContext;
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.exception.KDException;
+import kd.bos.schedule.executor.AbstractTask;
+
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * 后台任务骨架模板（原生 AbstractTask）。
+ * 该类仅用于示例写法，生成后请按实际业务删除无用逻辑并替换占位常量。
+ */
+public class TaskTemplate extends AbstractTask {
+    private static final String RES_APP_ID = "kd-cd-common-template";
+
+    /**
+     * 触发时机: 在需要了解当前插件可访问上下文能力时调用。
+     * 参数要点: 无入参；仅展示当前插件可通过 this. 访问的方法能力。
+     * 典型用途: 作为模板提示，指导在各事件内选择正确的上下文 API。
+     */
+    private void getContextSample() {
+        // this.getTaskId();
+        // this.checkIsStop();
+        // this.isStop();
+        // this.feedbackProgress(10);
+        // this.feedbackProgress(30, "处理中", null);
+        // this.feedbackCustomdata(new java.util.HashMap<>());
+        // this.getMessageHandler();
+        // this.setTaskId("task-id");
+        // this.isSupportReSchedule();
+    }
+
+    // ===== 核心事件 =====
+
+    /**
+     * 触发时机: 调度中心触发任务执行时。
+     * 参数要点:
+     * - context: 请求上下文，包含用户、组织、租户等信息。
+     * - params: 调度参数 map，通常承载任务业务入参。
+     * 典型用途: 编排任务主流程、分阶段回传进度、按需检查中止标记。
+     */
+    @Override
+    public void execute(RequestContext context, Map<String, Object> params) throws KDException {
+        super.execute(context, params);
+        this.feedbackProgress(0, ResManager.loadKDString("任务开始", "TaskTemplate_0", RES_APP_ID), null);
+
+        Object taskParam = params == null ? null : params.get("taskParam");
+        doStep(taskParam);
+
+        this.checkIsStop();
+
+        Map<String, Object> customData = new HashMap<>();
+        customData.put("result", "ok");
+        customData.put("taskParam", taskParam);
+        this.feedbackProgress(100, ResManager.loadKDString("任务完成", "TaskTemplate_1", RES_APP_ID), customData);
+    }
+
+    /**
+     * 触发时机: 调度中心主动停止任务时。
+     * 参数要点: 可在停止前做资源释放、状态补偿、最后一次进度反馈。
+     * 典型用途: 安全退出长任务，避免中途停止导致资源未释放。
+     */
+    @Override
+    public void stop() throws KDException {
+        super.stop();
+        this.feedbackProgress(95, ResManager.loadKDString("收到停止指令，准备安全退出", "TaskTemplate_2", RES_APP_ID), null);
+    }
+
+    private void doStep(Object taskParam) {
+        if (taskParam == null) {
+            this.feedbackProgress(30, ResManager.loadKDString("未传入 taskParam，按默认逻辑执行", "TaskTemplate_3", RES_APP_ID), null);
+            return;
+        }
+        Map<String, Object> customData = new HashMap<>();
+        customData.put("taskParam", taskParam);
+        this.feedbackProgress(60, ResManager.loadKDString("正在处理 taskParam", "TaskTemplate_4", RES_APP_ID), customData);
+    }
+}

package/vendor/kingdee-skills/ok-cosmic/assets/TreeListPluginTemplate.java

@@ -0,0 +1,152 @@
+package kd.cd.common;
+
+import kd.bos.dataentity.resource.ResManager;
+import kd.bos.form.ShowType;
+import kd.bos.form.control.Search;
+import kd.bos.form.control.events.RefreshNodeEvent;
+import kd.bos.form.control.events.SearchEnterEvent;
+import kd.bos.form.control.events.TreeNodeEvent;
+import kd.bos.list.events.BeforeShowBillFormEvent;
+import kd.bos.list.events.BuildTreeListFilterEvent;
+import kd.bos.list.plugin.AbstractTreeListPlugin;
+import kd.bos.orm.query.QCP;
+import kd.bos.orm.query.QFilter;
+
+import java.util.EventObject;
+
+/**
+ * 左树右表列表插件骨架模板（原生 AbstractTreeListPlugin）。
+ * 该类仅用于示例写法，生成后请按实际业务删除无用事件并替换占位常量。
+ */
+public class TreeListPluginTemplate extends AbstractTreeListPlugin {
+
+    /**
+     * 触发时机: 在需要了解当前插件可访问上下文能力时调用。
+     * 参数要点: 无入参；仅展示当前插件可通过 this. 访问的方法能力。
+     * 典型用途: 作为模板提示，指导在各事件内选择正确的上下文 API。
+     */
+    private void getContextSample() {
+        // this.getTreeListView();
+        // this.getTreeModel();
+        // this.getView();
+        // this.getModel();
+    }
+
+    private static final String FIELD_GROUP = "group.id";
+    private static final String TREE_NODE_ALL = "0";
+    private static final String RES_APP_ID = "kd-cd-common-template";
+
+    // ===== 核心事件 =====
+
+    /**
+     * 触发时机: 视图初始化后、事件注册阶段。
+     * 参数要点: e 为通用事件对象，通常用于注册监听。
+     * 典型用途: 注册树搜索框、工具栏等监听。
+     */
+    @Override
+    public void registerListener(EventObject e) {
+        super.registerListener(e);
+    }
+
+    /**
+     * 触发时机: 左树首次构建时，以及树模型重新创建时。
+     * 参数要点: 此时已可通过 this.getTreeModel() 访问树模型。
+     * 典型用途: 设置根节点、默认展开层级、默认筛选条件。
+     */
+    @Override
+    public void initializeTree(EventObject e) {
+        super.initializeTree(e);
+        if (this.getTreeModel() != null) {
+            this.getTreeModel().setRootVisable(true);
+        }
+    }
+
+    /**
+     * 触发时机: 树节点点击后。
+     * 参数要点: e 可读取当前节点信息。
+     * 典型用途: 切换右侧列表数据范围、刷新按钮状态或页面提示。
+     */
+    @Override
+    public void treeNodeClick(TreeNodeEvent e) {
+        super.treeNodeClick(e);
+        this.reload();
+    }
+
+    /**
+     * 触发时机: 树节点刷新时。
+     * 参数要点: e 指向当前待刷新的节点。
+     * 典型用途: 懒加载子节点、刷新节点状态或补充树结构。
+     */
+    @Override
+    public void refreshNode(RefreshNodeEvent e) {
+        super.refreshNode(e);
+        this.getView().showTipNotification(String.format(
+                ResManager.loadKDString("刷新树节点：%s", "TreeListPluginTemplate_0", RES_APP_ID),
+                e.getNodeId()
+        ));
+    }
+
+    /**
+     * 触发时机: 节点选中后构建右侧列表过滤时。
+     * 参数要点: e 可追加 QFilter 到右侧列表。
+     * 典型用途: 按当前节点 ID 生成右表过滤条件。
+     */
+    @Override
+    public void buildTreeListFilter(BuildTreeListFilterEvent e) {
+        super.buildTreeListFilter(e);
+        // 生成过滤条件
+        QFilter filter = new QFilter("fieldKey", QCP.equals, "value");
+        e.addQFilter(filter);
+        e.setCancel(true);   // 略过系统内置的分组过滤条件
+    }
+
+    /**
+     * 触发时机: 左树工具栏初始化时。
+     * 参数要点: 可调整工具栏按钮可见性与可用状态。
+     * 典型用途: 初始化新增、删除、刷新等树工具栏按钮。
+     */
+    @Override
+    public void initTreeToolbar(EventObject e) {
+        super.initTreeToolbar(e);
+    }
+
+    /**
+     * 触发时机: 左树工具栏按钮点击时。
+     * 参数要点: e 可识别按钮来源。
+     * 典型用途: 处理树节点新增、删除、刷新等动作。
+     */
+    @Override
+    public void treeToolbarClick(EventObject e) {
+        super.treeToolbarClick(e);
+        this.getView().showTipNotification(ResManager.loadKDString("已触发左树工具栏动作", "TreeListPluginTemplate_1", RES_APP_ID));
+    }
+
+    /**
+     * 触发时机: 左树搜索框回车时。
+     * 参数要点: evt 包含搜索关键字。
+     * 典型用途: 按关键字过滤左树节点或触发远程搜索。
+     */
+    @Override
+    public void search(SearchEnterEvent evt) {
+        super.search(evt);
+        Search search = (Search) evt.getSource();
+        //搜索控件标识，可以根据该标识，判断是哪个控件，然后做逻辑处理
+        String key = search.getKey();
+        //搜索的文本内容
+        this.getView().showTipNotification(String.format(
+                ResManager.loadKDString("树搜索关键字：%s", "TreeListPluginTemplate_2", RES_APP_ID),
+                evt.getText()
+        ));
+    }
+
+    /**
+     * 触发时机: 打开右侧单据详情前。
+     * 参数要点: e 可获取单据打开参数并追加自定义参数。
+     * 典型用途: 标记当前打开动作来源于左树右表场景。
+     */
+    @Override
+    public void beforeShowBill(BeforeShowBillFormEvent e) {
+        super.beforeShowBill(e);
+        e.getParameter().getOpenStyle().setShowType(ShowType.Modal);
+    }
+}