README.zh.md 2.2 KB
description: "代码执行能力族的包映射：程序执行能为你做什么，以及每个部分由哪个包负责。"
kind: "package-group"
code-runtime/——代码执行能力族
English | 中文
概述
code-runtime/ 组让模型编写一个程序，把宿主提供的函数当作普通异步调用，然后只返回程序的打印输出和返回值。如需在隔离的 Node Worker 中执行，请选择 TypeScript 后端；如需 CPython 进程，请选择实验性 Python 后端。每次运行都不会保留之前程序的状态。失败会作为结果返回，供调用方诊断或提供给模型。
目录
包
这三个包共同提供程序执行能力；每个 README 描述其各自部分做什么。
| 包 | 角色 | ctx 键 |
|---|---|---|
code-runtime/ |
定义代码运行时做什么：针对宿主提供的绑定运行一个程序，并报告其打印和返回的内容 | ctx.codeRuntime |
code-runtime-worker-thread/ |
在全新的 Node Worker 线程中执行 TypeScript 程序 | 注册 ctx.codeRuntime |
experimental/code-runtime-python/ |
实验性 Python 后端：持有 Node host 与 CPython 子进程之间的 fd-3 协议格式与 CPython 运行时实现 | — |
相关文档
先从子系统参考了解服务约定，再看消费此能力的 PTC mode 设计，以及它所遵循的能力 seam 模型。
- 代码运行时子系统参考——请求／结果词汇、绑定与
ctx.codeRuntime的 cordis 接口面。 - PTC mode Agent Note——工具注册表如何把
run_code呈现给模型。 - 能力 seam——本家族遵循的 Service Definition / Service Provider / Consumer 拆分。