我来帮你搞定这个LibreOffice Calc Python UDF的问题！你现在卡在把字符串格式的单元格范围转换成实际数值上，咱们一步步来解决，不管用Uno原生接口还是ScriptForge工具都能搞定，还能优化你的调用方式更顺手～

一、先解决当前场景：处理字符串格式的范围参数 #

你现在是把范围当字符串（比如"A2:B11"）传给Python函数，核心是在Python里把这个字符串解析成实际的单元格范围，再提取数值。

1. 用Uno原生接口实现 #

Uno提供了专门的工具类解析范围字符串，我们可以用SheetCellRangeAddressHelper来解析，然后遍历范围获取所有数值：

def mode_freq(arange):
    from com.sun.star.sheet import SheetCellRangeAddressHelper
    from collections import Counter

    # 1. 获取当前文档和目标工作表（这里用索引0的工作表，你也可以指定名称）
    doc = XSCRIPTCONTEXT.getDocument()
    target_sheet = doc.getSheets().getByIndex(0)  # 对应Sheet1

    # 2. 解析字符串范围为单元格地址范围
    address_parser = doc.getAddressParser()
    # 以工作表第一个单元格为基准解析范围字符串
    base_cell_addr = target_sheet.getCellByPosition(0, 0).getAddress()
    range_addr = SheetCellRangeAddressHelper.parseRange(address_parser, arange, base_cell_addr)

    # 3. 获取指定范围的单元格对象
    cell_range = target_sheet.getCellRangeByPosition(
        range_addr.StartColumn, range_addr.StartRow,
        range_addr.EndColumn, range_addr.EndRow
    )

    # 4. 提取范围里的所有数值，转换成二维列表
    all_values = []
    rows = cell_range.getRows()
    for row_idx in range(rows.getCount()):
        row = rows.getByIndex(row_idx)
        current_row = []
        cells = row.getCells()
        for cell_idx in range(cells.getCount()):
            cell = cells.getByIndex(cell_idx)
            current_row.append(cell.getValue())  # 取数值，文本用getString()
        all_values.append(current_row)

    # 5. 计算众数频率（这里实现你的核心逻辑）
    flat_values = [num for row in all_values for num in row if isinstance(num, (int, float))]
    if not flat_values:
        return 0  # 空范围返回0

    value_counter = Counter(flat_values)
    mode_value = max(value_counter, key=value_counter.get)
    mode_frequency = value_counter[mode_value] / len(flat_values)
    return mode_frequency

2. 用ScriptForge接口实现（更简洁） #

ScriptForge是LibreOffice的官方脚本工具库，语法更友好，解析范围字符串只需要一行代码：

def mode_freq(arange):
    from scriptforge import CreateScriptService
    from collections import Counter

    # 1. 初始化Calc文档服务
    calc_doc = CreateScriptService("Calc")

    # 2. 直接解析字符串范围（默认用当前活动工作表，也可以指定工作表：calc_doc.Sheets["Sheet1"].GetRange(arange)）
    target_range = calc_doc.GetRange(arange)

    # 3. 一键获取范围的二维数值数组，不用手动遍历！
    all_values = target_range.DataArray

    # 4. 计算众数频率（逻辑同上）
    flat_values = [num for row in all_values for num in row if isinstance(num, (int, float))]
    if not flat_values:
        return 0

    value_counter = Counter(flat_values)
    mode_value = max(value_counter, key=value_counter.get)
    mode_frequency = value_counter[mode_value] / len(flat_values)
    return mode_frequency

二、优化调用体验：直接传单元格范围对象 #

你现在调用UDF时需要给范围加引号，其实可以修改Basic包装器，让它直接接收单元格范围对象，这样用户调用时不用加引号，直接写=CALL_MODE_FREQ(A2:B11)更符合Calc的使用习惯。

1. 修改Basic包装器 #

把参数类型从string改成Object，直接把范围对象传给Python：

Function Call_mode_freq(range as Object) as double
 Dim oScriptProvider, oScript
 oScriptProvider = ThisComponent.getScriptProvider()
 oScript = oScriptProvider.getScript(_
     "vnd.sun.star.script:stat_functions.py$mode_freq?language=Python&location=user")
 Call_mode_freq = oScript.invoke(array(range), array(), array() )
End Function

2. 对应修改Python函数 #

现在传入的是单元格范围对象，直接提取数值即可：

def mode_freq(cell_range):
    from collections import Counter

    # 1. 直接从范围对象提取二维数值数组
    all_values = []
    rows = cell_range.getRows()
    for row_idx in range(rows.getCount()):
        row = rows.getByIndex(row_idx)
        current_row = [cell.getValue() for cell in row.getCells()]
        all_values.append(current_row)

    # 2. 计算众数频率（逻辑同上）
    flat_values = [num for row in all_values for num in row if isinstance(num, (int, float))]
    if not flat_values:
        return 0

    value_counter = Counter(flat_values)
    mode_value = max(value_counter, key=value_counter.get)
    mode_frequency = value_counter[mode_value] / len(flat_values)
    return mode_frequency

三、关键注意事项 #

1. 脚本存放位置：确保你的stat_functions.py放在LibreOffice的用户Python脚本目录：
   • Windows：C:\Users\<你的用户名>\AppData\Roaming\LibreOffice\4\user\Scripts\python
   • Linux：~/.config/libreoffice/4/user/Scripts/python
   • Mac：~/Library/Application Support/LibreOffice/4/user/Scripts/python
2. 启用Python支持：在LibreOffice中打开「工具→选项→LibreOffice→高级」，勾选「启用Python脚本支持」
3. ScriptForge安装：如果用ScriptForge方案，需要先在LibreOffice扩展中心搜索安装「ScriptForge」扩展
4. 测试顺序：先让Python函数返回固定值（比如return 1.0），确认Basic能正确调用，再逐步添加解析范围和计算逻辑，避免一步出错难排查

备注：内容来源于stack exchange，提问作者AlanD