docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
// Package codex 在核心 API 与受限 CLI worker 间通过 Unix socket 通信,隔离公开凭据与本地执行环境。
|
||||
package codex
|
||||
|
||||
import (
|
||||
@@ -15,16 +16,19 @@ import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// executable 指向部署容器预装 CLI,不从请求或 PATH 选择可执行文件。
|
||||
const executable = "/opt/codex/node_modules/.bin/codex"
|
||||
|
||||
var errOutputLimit = errors.New("Codex output limit exceeded")
|
||||
|
||||
// outputBuffer 对 CLI stdout 累计限额;超限标记用于进程结束后选择稳定错误响应。
|
||||
type outputBuffer struct {
|
||||
buffer bytes.Buffer
|
||||
exceeded bool
|
||||
limit int
|
||||
}
|
||||
|
||||
// Write 实现 io.Writer,默认使用公共输出限制,画布事件流可另设更大内部预算。
|
||||
func (b *outputBuffer) Write(p []byte) (int, error) {
|
||||
limit := b.limit
|
||||
if limit == 0 {
|
||||
@@ -37,6 +41,7 @@ func (b *outputBuffer) Write(p []byte) (int, error) {
|
||||
return b.buffer.Write(p)
|
||||
}
|
||||
|
||||
// ServeWorker 由 main 的 codex-worker 模式调用,重建 0600 socket,只允许一个生成任务同时执行。
|
||||
func ServeWorker(socket string) error {
|
||||
syscall.Umask(0077)
|
||||
if err := os.Remove(socket); err != nil && !errors.Is(err, os.ErrNotExist) {
|
||||
@@ -50,6 +55,7 @@ func ServeWorker(socket string) error {
|
||||
if err := os.Chmod(socket, 0600); err != nil {
|
||||
return err
|
||||
}
|
||||
// 文本 /exec 与 /canvas/exec 共享一个槽位;忙时立即 429,目录读取不占执行槽。
|
||||
slot := make(chan struct{}, 1)
|
||||
mux := http.NewServeMux()
|
||||
mux.HandleFunc("POST /exec", func(w http.ResponseWriter, r *http.Request) {
|
||||
@@ -87,6 +93,7 @@ func ServeWorker(socket string) error {
|
||||
fail(w, 503, "codex_unavailable")
|
||||
return
|
||||
}
|
||||
// 仅按公开 ID 匹配当前目录,再在 worker 内取 Backend,调用方不能任意指定 CLI 模型名。
|
||||
var selected *CanvasModel
|
||||
for _, model := range models {
|
||||
if model.ID == input.ModelID {
|
||||
@@ -112,7 +119,10 @@ func ServeWorker(socket string) error {
|
||||
return server.Serve(listener)
|
||||
}
|
||||
|
||||
// execute 为旧文本入口保留默认模型选择,实际进程生命周期集中在 executeModel。
|
||||
func execute(w http.ResponseWriter, r *http.Request, prompt string) { executeModel(w, r, prompt, "") }
|
||||
|
||||
// executeModel 用请求期限约束 CLI,禁用外部工具能力;失败仅公开错误码,不转发 stderr。
|
||||
func executeModel(w http.ResponseWriter, r *http.Request, prompt, model string) {
|
||||
ctx, cancel := context.WithTimeout(r.Context(), timeout)
|
||||
defer cancel()
|
||||
@@ -126,6 +136,7 @@ func executeModel(w http.ResponseWriter, r *http.Request, prompt, model string)
|
||||
cmd.Dir = "/work"
|
||||
cmd.Env = []string{"PATH=/usr/local/bin:/usr/bin:/bin", "HOME=/home/node", "CODEX_HOME=/home/node/.codex", "SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt"}
|
||||
cmd.Stdin = strings.NewReader(prompt)
|
||||
// Setpgid 配合负 PID kill 终止整个进程组;WaitDelay 约束取消后的输出管道等待。
|
||||
cmd.SysProcAttr = &syscall.SysProcAttr{Setpgid: true}
|
||||
cmd.Cancel = func() error {
|
||||
err := syscall.Kill(-cmd.Process.Pid, syscall.SIGKILL)
|
||||
@@ -146,6 +157,7 @@ func executeModel(w http.ResponseWriter, r *http.Request, prompt, model string)
|
||||
case err != nil:
|
||||
fail(w, 502, "codex_failed")
|
||||
default:
|
||||
// 只有合法事件流、成功结束事件及非空最终文本才能作为公开生成结果返回。
|
||||
var result string
|
||||
var completed bool
|
||||
for _, line := range bytes.Split(bytes.TrimSpace(output.buffer.Bytes()), []byte("\n")) {
|
||||
|
||||
Reference in New Issue
Block a user