用途:为 Kuroco Headless CMS 的服务端逻辑与外部系统集成提供参考,包括 Smarty 模板插件用法、批处理与 Webhook 的编写模式,以及外部连携方式的设计选型。可配合 kuroco-docs 技能检索官方文档。
主要能力:第一部分是 Smarty 插件参考,覆盖变量数据操作(assign、append、json_decode、rcms_json_encode)、API 数据获取(api_internal、api_method、assign_tag_list)、字符串处理(escape、truncate、date_format、translate)、数组操作、表单 UI(fileupload、inquiry_input、pager)、认证权限(rcms_auth、login、logout)、外部连携(sendmail、slack_post_message、ai_completion、github_deploy)、文件操作(write_file、put_file、read_file、read_dir)、Vue 连携(rcms_vue_component、head_include),共 151 个插件。第二部分为 Webhook、批处理与外部连携模式,含批处理频率选择与限制、内部 API 调用、外部 API 调用、触发器、外部服务连携和最佳实践。
使用方式:文档引用了 syntax.md、api-plugins.md、integration-design.md、integrations.md 等参考文件。批处理在管理界面「オペレーション → バッチ処理 → 追加」创建,用 Smarty 描述执行内容。内部 API 用 {api_internal},外部 API 用 {api},秘匿值用 {secret} 读取。
限制:批处理单次执行时长默认 4 小时(Smarty 批处理 6 小时),超时失败;{api} 每次仅能发送 1 个文件,timeout 默认 30 秒、上限 3600 秒,自定义端点 PHP 执行 30 秒截断,代理调用 {api} 需将 timeout 设为 30 以下。{path} 类动态路径需用反引号插值,无短縮代入语法,无中途终止标签。
适用场景:结构化的服务端逻辑开发、定时数据同步、表单触发器通知、外部 API 代理与数据导入设计。具体计费与更多平台细节暂未提供。