更新日志 (Change Log)
本页面记录了 GdiSDK 的版本更新历史和重要变更信息。
版本历史
v0.3.2
新功能
新增WaterSoilCorrosion模块，支持根据岩土勘察规范计算水土腐蚀性。
Pipeline增加save_data_to_db方法，支持pipeline在GDIM上运行时将指定的出端口数据、Pipeline属性值或模块属性值存储GDIM数据库，从而实现跨Pipeline访问数据。
新增GdimAppDataReader模块，用于从GDIM中读取其他Pipeline应用通过save_data_to_db方法存储的数据。
新增GdimAppDataSelector模块，用于从GdimAppDataReader模块的输出结果中选择需要的数据。
新增SphericalKMeans模块，用于对方向向量或高维特征做球面 K 均值（Spherical K-Means）聚类分析，按余弦相似度划分簇，例如岩石节理聚类分析。
新增TableDescribe模块，使用DataFrame的describe方法对表格数据进行描述性统计分析，并支持选择需要统计的列和统计指标。
功能优化
TextWriter模块支持直接接入ResultModel数据结构并打印数据。
TableToMarkdown和TablesToMarkdown模块增加支持设置数字字段输出精度的参数precision。
TablesToMarkdown支持主子表合并时，对合并以后的表表标题，支持选择 “combined”, “main”, “sub” 三种模式，分别对应合并后的表标题为 “主表标题 - 子表标题”，”主表标题”，”子表标题”。
TableToMarkdown和TablesToMarkdown模块增加用于支持LaTex公式前端渲染的参数latex_math。
CsvReader模块增加check_units参数，允许读取表结构时不检查单位表示合法性。
DocxToMarkdown模块新增参数images_dir_relative_to_input和relative_image_link，用于控制提取图片的位置和markdown中图片链接是绝对路径还是相对路径。
bug修复
GdimTableWriter模块写入数据时，只自动匹配了name能否和GDIM字段的name或title吻合，但是没有在匹配不成功时匹配title能否和GDIM字段title是否吻合。
修复PromptTemplate模块在某些情况下会重复执行的bug。
兼容性变更
MarkdownSectionFilter模块删除用于输出markdown文件的端口，输出文件必须链接到TextWriter模块。
模块MarkdownSectionFilter的OutputSingleResult端口改为OutputResultModel端口。
v0.3.1
新功能
丰富Pipeline调试功能，增加verbose和run_trace_file参数，支持输出丰富的运行时报告。
新增TableToResultModel模块，支持将TableData的某一行转为ResultModel。
新增ReadGtbFile模块，用于读取通过模块ExportGdimTables导出的xlsx或gtb文件。
新增TableToMarkdown模块，支持将TableData转为markdown。
新增TablesToMarkdown模块，支持将TableCollection转为markdown。
新增TextWriter模块，支持将任意Text或JsonObject数据类型写出到纯文本文件中。
AddTableColumns模块新增diff模板语法，支持计算行间差值，或分组计算插值，适合表格层厚计算。
功能优化
模块ExportGdimTables增加帮助文档，该模块用于批量导出GDIM中的表格数据为xlsx或gtb（csv zip压缩包）格式。
RestulModel增加from_dict方法，简化了其动态定义的方式。
优化了GdimTableReader模块，当empty_error_type设置为create_empty_table时，输出带字段的空表，而不是没有任何字段的空表。
兼容性变更
GdimAppProjectInfoReader模块的OutputProjectInfo端口类型从SingleResult改为ResultModel
DocxToMarkdown、TableToString和TableToJson模块的OutpuSingleResult端口改为OutputResultModel，同时修改了输出端口的数据类型。
DocxToMarkdown模块不再支持直接输出markdown文件，输出文件需要配合TextWriter模块使用。
v0.3.0
新功能
新增Pipeline的gdim_state属性，用于管理GDIM平台连接状态，包括token、proj_id、tpl_id、host、template、proj_list等。
新增Pipeline的update_gdim_state方法，用于更新GDIM平台连接状态。
新增 AgentRunResult 接口类型，用于存储大模型运行结果及其元数据信息。
新增基于Pydantic BaseModel的ResultModel接口类型，用于存储结构化计算结果及其元数据信息，将来将逐步替换并淘汰SingleResult接口类型。
新增模块MergeResultModels，用于合并多个ResultModel和SingleResult结果。
新增ConditionalLink，用于在模块间进行条件流转。
模块CsvReader新增output_mode参数，用于控制输出模式，支持table、schema、both三种模式。增加OutputSchema端口，用于输出CSV文件的数据结构schema。
增加语音转录文字相关功能，暂未封装为Module。
功能优化
重构pipeline模块文件结构。
重构LLM Provider，采用ModelClientFactory作为LLM Provider的工厂类，支持多种LLM Provider的注册和使用，增加对OpenRouter和VolcEngine的支持。
新增Pipeline开发相关的技能，包括pipeline-creator、local-function-coder、pipeline-gdim-review。
兼容性变更
使用Pipelined的update_gdim_state方法更新GDIM平台连接状态，不再使用Pipeline的gdim_token、gdim_proj_id、gdim_host、gdim_template、gdim_proj_list属性。
PipeLine的add_link方法改为内部方法，无法再直接调用，请使用PipeLine的add_links方法代替。
所有读取GDIM数据相关模块中的proj_id参数类型提示均不再支持int，因此建议proj_id均以str类型传入。
v0.2.8
新功能
filters包中新增MarkdownSectionFilter模块，支持根据章节编号或标题模式过滤Markdown文档。
AddTableColumns模块新增特殊模板变量_row_number，用于获取每行的行号。
更新获取地震设计参数的接口，适配GDIM。
适配geoSurvey包中SeismicDesignParameters模块至新的module_decorator装饰器。
适配gisOperators包中ConvexHullCenter模块至新的module_decorator装饰器。
mergers包中新增MergeSingleResult模块，用于合并多个SingleResult结果
功能优化
AddTableColumns模块模板语法优化为更友好的Python表达式形式。
v0.2.7
新功能
converters包中新增DocxToMarkdown模块，支持将Word文档(.docx)或RTF文档(.rtf)转换为Markdown格式。
SingleResult支持直接传入字典数据进行初始化，对于不需要元数据的字典数据，简化了初始化SingleResult的流程。
简化 Pipeline 的 add_multi_binding_attribute 方法中的参数 bindings，删除对 list[dict]` 类型属性的支持。
更新说明
版本命名规范
GdiSDK 采用语义化版本控制 (Semantic Versioning)：
主版本号 (Major): 重大功能更新和升级，不向下兼容。
次版本号 (Minor): 较大的功能更新和改进，但可能包含不向下兼容的变更。
修订版本号 (Patch): 小的功能更新和改进，向下兼容。
升级指南
从旧版本升级
当前为初始版本，暂无升级指南。后续版本发布时，将在此处提供详细的升级说明。
注意事项
升级前请备份您的数据和配置
查看版本间的兼容性说明
测试您的应用程序以确保正常运行
贡献指南
如何报告问题
如果您发现了bug或有功能建议，请：
检查是否已有相关的issue（仓库地址：https://gitee.com/jimmy_kl/gdisdk/issues ）
提供详细的问题描述和复现步骤
包含您的环境信息（Python版本、操作系统等）
联系我们
邮件联系: support@kulunsoft.com
—
最后更新: 2026年5月5日