docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
// 画布 AI 的私有 IPC 客户端与模型目录:平台侧只看到稳定模型 ID,执行后端保留在 worker 内。
|
||||
package codex
|
||||
|
||||
import (
|
||||
@@ -15,8 +16,10 @@ import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// CanvasInputLimit 限制提示词字节数;图片另按解码后的总字节限制。
|
||||
const CanvasInputLimit = 1 << 20
|
||||
|
||||
// CanvasModel 是过滤后的模型能力快照;Backend 不序列化,仅供 worker 启动 CLI。
|
||||
type CanvasModel struct {
|
||||
ID string `json:"id"`
|
||||
Label string `json:"label"`
|
||||
@@ -32,6 +35,7 @@ type CanvasModel struct {
|
||||
|
||||
// Only curated catalog fields leave the worker. Raw CLI cache metadata,
|
||||
// local paths, authentication files and backend configuration stay private.
|
||||
// workerCanvasModels 读取 worker 本地缓存,只公布 list 可见且支持文本/图像输入的条目。
|
||||
func workerCanvasModels() ([]CanvasModel, error) {
|
||||
raw, err := os.ReadFile("/home/node/.codex/models_cache.json")
|
||||
if err != nil {
|
||||
@@ -53,6 +57,7 @@ func workerCanvasModels() ([]CanvasModel, error) {
|
||||
if entry.Visibility != "list" || entry.Slug == "" || strings.HasPrefix(entry.Slug, "-") || len(entry.Slug) > 128 {
|
||||
continue
|
||||
}
|
||||
// 稳定散列生成公开 ID;标签可展示,实际 slug 不作为公开 Backend 字段输出。
|
||||
sum := sha256.Sum256([]byte("codex-cli/" + entry.Slug))
|
||||
inputs := []string{}
|
||||
for _, value := range entry.Inputs {
|
||||
@@ -72,6 +77,7 @@ func workerCanvasModels() ([]CanvasModel, error) {
|
||||
}
|
||||
result = append(result, CanvasModel{ID: "codex-" + hex.EncodeToString(sum[:16]), Label: label, Provider: "codex-cli", InputModalities: inputs, OutputModalities: []string{"text"}, Available: true, MaxExecutionMS: 90000, MaxInputBytes: CanvasInputLimit, ParametersSchema: map[string]any{"type": "object", "properties": map[string]any{}, "additionalProperties": false}, Backend: entry.Slug})
|
||||
}
|
||||
// 图片输出能力必须显式列入已验证后端名单,不能根据支持图片输入推断支持图片生成。
|
||||
verified := map[string]bool{}
|
||||
for _, id := range strings.Split(os.Getenv("FOUNDRY_CANVAS_IMAGE_MODELS"), ",") {
|
||||
id = strings.TrimSpace(id)
|
||||
@@ -95,8 +101,10 @@ func workerCanvasModels() ([]CanvasModel, error) {
|
||||
return result, nil
|
||||
}
|
||||
|
||||
// CanvasClient 通过固定 Unix socket 发送 HTTP;URL 主机名只是协议占位符,不进行 DNS 连接。
|
||||
type CanvasClient struct{ client *http.Client }
|
||||
|
||||
// NewCanvasClient 在未配置 socket 时返回 nil,调用方法会转换为明确的不可用错误。
|
||||
func NewCanvasClient(socket string) *CanvasClient {
|
||||
if socket == "" {
|
||||
return nil
|
||||
@@ -106,6 +114,8 @@ func NewCanvasClient(socket string) *CanvasClient {
|
||||
}}
|
||||
return &CanvasClient{client: &http.Client{Transport: transport, Timeout: 182 * time.Second, CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}}
|
||||
}
|
||||
|
||||
// Models 限制目录响应为 256 KiB,只接受成功状态和完整 JSON,隐藏 worker 内部失败原因。
|
||||
func (c *CanvasClient) Models(ctx context.Context) ([]CanvasModel, error) {
|
||||
if c == nil {
|
||||
return nil, errors.New("codex_unavailable")
|
||||
@@ -135,6 +145,7 @@ func (c *CanvasClient) Models(ctx context.Context) ([]CanvasModel, error) {
|
||||
return result.Models, nil
|
||||
}
|
||||
|
||||
// CanvasTask 在 platform 调度器与 worker 之间传递提示、模型及可选图片;当前参数对象必须为空。
|
||||
type CanvasTask struct {
|
||||
OutputModality string `json:"output_modality,omitempty"`
|
||||
Images []CanvasImage `json:"images,omitempty"`
|
||||
@@ -143,6 +154,7 @@ type CanvasTask struct {
|
||||
Parameters map[string]any `json:"parameters"`
|
||||
}
|
||||
|
||||
// Generate 是只需文本的兼容入口;复用结构化输出校验,并拒绝图片结果。
|
||||
func (c *CanvasClient) Generate(ctx context.Context, input CanvasTask) (string, error) {
|
||||
output, err := c.GenerateOutput(ctx, input)
|
||||
if err != nil {
|
||||
|
||||
Reference in New Issue
Block a user