portable-text-serialization 是把 Portable Text 富文本转成页面或其他文本格式的 Skill。Portable Text 保存内容块、文字片段和标记,渲染器再把这些结构映射成目标框架的组件。
粗体属于直接标记,链接等注释则引用标记定义;只取文字可能丢掉链接和层次。图片、代码或行动按钮这样的自定义块,需要相应组件,不能把没显示当成原内容为空。
主文建议处理未知类型、稳定组件配置,并在查询时展开需要的引用。展开资料还要守住权限与字段范围,关闭缺组件警告只是少显示提示,不是补好了渲染。
适合内容系统先理结构再选输出目标。不同格式支持不同,不能承诺来回转换无损;本文没有运行库,框架专属规则未展开,主文对通用接口的说法需按实际包版本核。