Back to Details

x07-os-run

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

x07-os-run

x07-os-run

Prefer 
x07 run --profile os
/ 
x07 run --profile sandbox
for normal execution. 
x07-os-runner
is an internal component behind the 
x07
facade; its CLI is not part of the supported end-user surface.
Use this skill when you need real OS I/O (fs/net/process/time) via 
run-os
or policy-enforced execution via 
run-os-sandboxed
.
推荐使用
x07 run --profile os
或
x07 run --profile sandbox
进行常规执行。
x07-os-runner
是
x07
外观层背后的内部组件；其CLI不属于受支持的终端用户使用界面。
当你需要通过
run-os
实现真实OS I/O（文件系统/网络/进程/时间），或通过
run-os-sandboxed
实现策略强制的执行时，请使用此技能。

Canonical commands (recommended: 
x07 run
)

标准命令（推荐：
x07 run
）

  • Run the current project (unsandboxed):
    • x07 run
    • x07 run --profile os
  • Run a project explicitly (unsandboxed):
    • x07 run --project x07.json --profile os
  • Run sandboxed (requires an explicit policy):
    • x07 run --project x07.json --profile sandbox --policy run-os-policy.json
  • If your program expects CLI args via 
    argv_v1
    , pass them after 
    --
    and 
    x07 run
    will encode them into input bytes:
    • x07 run --profile os -- tool --help
  • Generate a schema-valid base policy:
    • x07 policy init --template cli
    • x07 policy init --template http-client
    • x07 policy init --template web-service
    • x07 policy init --template fs-tool
    • x07 policy init --template sqlite-app
    • x07 policy init --template postgres-client
    • x07 policy init --template worker
    • x07 policy init --template worker-parallel
  • Materialize a derived policy with explicit destinations (only in run-os-sandboxed):
    • x07 run --profile sandbox --policy .x07/policies/base/http-client.sandbox.base.policy.json --allow-host example.com:443
    • x07 run --profile sandbox --policy .x07/policies/base/http-client.sandbox.base.policy.json --deny-host example.com:*
  • Run a single program (when not using a project manifest):
    • x07 run --program src/main.x07.json --module-root src
  • 运行当前项目（非沙箱模式）：
    • x07 run
    • x07 run --profile os
  • 显式运行某个项目（非沙箱模式）：
    • x07 run --project x07.json --profile os
  • 沙箱模式运行（需要显式策略）：
    • x07 run --project x07.json --profile sandbox --policy run-os-policy.json
  • 如果你的程序期望通过
    argv_v1
    接收CLI参数，请在
    --
    后传入，
    x07 run
    会将它们编码为输入字节：
    • x07 run --profile os -- tool --help
  • 生成符合Schema的基础策略：
    • x07 policy init --template cli
    • x07 policy init --template http-client
    • x07 policy init --template web-service
    • x07 policy init --template fs-tool
    • x07 policy init --template sqlite-app
    • x07 policy init --template postgres-client
    • x07 policy init --template worker
    • x07 policy init --template worker-parallel
  • 生成带有显式目标的派生策略（仅适用于run-os-sandboxed）：
    • x07 run --profile sandbox --policy .x07/policies/base/http-client.sandbox.base.policy.json --allow-host example.com:443
    • x07 run --profile sandbox --policy .x07/policies/base/http-client.sandbox.base.policy.json --deny-host example.com:*
  • 运行单个程序（不使用项目清单时）：
    • x07 run --program src/main.x07.json --module-root src

Expert backend (
x07-os-runner
)

专业后端组件（
x07-os-runner
）

x07-os-runner
implements OS execution for 
x07 run
/ 
x07 bundle
. Treat it as internal and prefer 
x07
commands above.
x07-os-runner
为
x07 run
/
x07 bundle
实现OS执行功能。请将其视为内部组件，优先使用上述
x07
命令。

Policy

策略说明

Policies are a starting point. Generate one from a template, then extend it deliberately for your app (roots, env, subprocess allowlists, limits). For net-enabled templates, keep 
net.allow_hosts
empty in the base policy and use 
x07 run --allow-host
to materialize auditable derived policies for specific destinations.
策略是配置的起点。从模板生成策略，然后根据你的应用需求（根目录、环境变量、子进程白名单、限制条件）进行针对性扩展。 对于支持网络的模板，请在基础策略中保持
net.allow_hosts
为空，使用
x07 run --allow-host
为特定目标生成可审计的派生策略。

Output contract

输出约定

  • x07 run
    in 
    run-os*
    worlds prints an 
    x07-os-runner.report@...
    JSON report to stdout (pass-through).
  • The underlying OS runner emits the same report shape.
In both cases:
  • Use the process exit code for pass/fail.
  • Parse the JSON for 
    schema_version
    , 
    mode
    , 
    world
    , and base64-encoded output bytes.
  • 在
    run-os*
    环境中执行
    x07 run
    时，会将
    x07-os-runner.report@...
    格式的JSON报告输出到标准输出（透传）。
  • 底层的OS执行器会输出相同格式的报告。
在两种情况下：
  • 使用进程退出码判断执行成功/失败。
  • 解析JSON以获取
    schema_version
    、
    mode
    、
    world
    以及base64编码的输出字节。