用途:通过 jinko-sdk 进行 Jinkō 计算模型(QSP/PK-PD)的技术性构建与编辑,关注 SDK 机制与模型有效性,而非生物学合理性。
主要能力:创建空模型、检索已有模型、批量增改组件(参数、分类参数、房室、物种、ODE、反应、给药等)、设置求解选项、检查诊断与可解性。支持代数规则(残差方程形式)、分段与 case 公式语法、事件时间触发表达式、单位检查模式。
使用方式:优先编辑已有模型而非重建;新建时用 client.create_empty_model()。用 model.components.batch(version_name=...) 提交组件变更。用 model.get_diagnostics().errors() 检查诊断,用 model.simple_solve(timeseries_ids=[...]) 检查可解性,默认候选来自 model.time_dependent_ids(),超过 10 个时先取前 10 并请用户确认。模型应无错误级诊断且 simple_solve() 成功。建议在专用 Jinkō 文件夹内建模型,如 YYYY-MM-DD-<experiment-name>,可用 client.folders.get_by_name(name, exact_match_only=True) 复用。脚本示例:python skills/jk-model/scripts/create_minimal_model.py --name sdk-minimal-model --apply;python skills/jk-model/scripts/edit_existing_model_batch.py --model-sid cm-... --apply;python skills/jk-model/scripts/validate_model_readiness.py --model-sid cm-...。
限制:求解时间点须在 10..1000 之间,点数为 (tMax - tMin) / tStep + 1,超限需增大步长。单位检查模式包括 NoUnitCheck、UnitCheckWithNoUnitConversion、UnitCheckAndConvertAllSpeciesToExtentUnits、UnitCheckAndConvertOnlyReactantsAndProductsToExtentUnits,新建模型默认推荐 UnitCheckAndConvertAllSpeciesToExtentUnits。代数规则为残差方程,方程值按 0 = equation 解释;若出现 TOO_FEW_ALGEBRAIC_RULES、TOO_MANY_ALGEBRAIC_RULES 或 MISSING_UNKNOWN,需核对方程数与未知量数一致。非平凡单位或换算行为应先读 references/unit_docs.md,默认允许单位注册表为 references/units_static_info.json。