tswn_capi 提供基于 tswn_core 的 DLL C-API。
- 头文件：
include/tswn_capi.h - 输出形式：
cdylib+staticlib - 字符串输入统一为 UTF-8
const char* - 动态输出统一使用
tswn_str_t/tswn_bytes_t，并由库侧*_free释放 - Windows 下通常会同时产出：
tswn_capi.dlltswn_capi.dll.lib（导入库，供动态链接使用）tswn_capi.lib（staticlib，供静态链接使用）
- Linux/macOS 下仍以
libtswn_capi.so/libtswn_capi.dylib等动态库产物为主
当前版本已覆盖：
Runner/PreparedRunner生命周期RunUpdates基本读取win_rate/group_win_rate/prepared_win_ratetswn-cli对齐的高层 helper（*_json/tswn_to_diy）- icon RGBA / PNG / Base64
- 版本查询：
tswn_capi_version()：返回tswn_capi包装层版本tswn_core_version()：返回tswn_core版本
tswn_capi_abi_version()：0.6.0 返回 ABI4；从 ABI 3 升级的调用方需要重新编译并重新链接。tswn_player_snapshot_t的蓝量字段统一使用magic_point；不再提供mp别名。
tswn_capi 的高层胜率接口现在都带有 thread 参数：
0：自动线程数1：单线程n：指定多线程数量
覆盖接口：
tswn_win_rate(...)tswn_win_rate_with_eval_rq(...)tswn_group_win_rate(...)tswn_group_win_rate_with_eval_rq(...)tswn_prepared_win_rate(...)tswn_prepared_win_rate_with_eval_rq(...)
自动线程数策略与 tswn_cli 保持一致：优先使用 available_parallelism()，再按当前总局数上限收敛。
为避免在 C ABI 上暴露大量变长结构体，tswn_capi 对 tswn-cli / tswn_py 的高层 helper 统一补了一层字符串/JSON 导出：
- 详细胜率：
tswn_win_rate_summary_json(...)/tswn_team_win_rate_summary_json(...)/tswn_group_win_rate_summary_json(...) - 评分与命配：
tswn_score_json(...)/tswn_namer_pf_json(...) - 批量对抗与配对：
tswn_batch_rate_json(...)/tswn_pair_rate_json(...) - 导出与解析：
tswn_to_diy(...)/tswn_to_diy_batch_json(...)/tswn_icon_info_json(...)/tswn_parse_group_lines_json(...)
这些接口返回的 tswn_str_t 都需要由调用方使用 tswn_str_free() 释放。