项目工程
权限与资源
以最小能力声明宿主访问,并理解应用申请与宿主授权的交集。
权限是应用申请,不是自行获得的授权。运行 YXB 时,有效权限始终是“应用清单申请”与“宿主授权上限”的逐项交集。
[权限]
文件 = ["data"]
网络 = ["api.example.com"]
本地网络 = false
TCP监听 = ["127.0.0.1"]
UDP绑定 = []
环境 = ["YANXU_PROFILE"]
进程 = false
原生扩展 = false文件范围相对包根目录;网络列出允许外连的主机、地址或最窄 CIDR;TCP 与 UDP 绑定能力单独声明;环境只暴露列出的变量。进程和原生扩展是布尔能力。桌面相关能力也彼此独立,不会隐式授予文件、网络或进程。
网络 = ["*"]只放行普通公网目标,不会隐式放行回环、私网、链路本地、CGNAT 或其他敏感地址。访问用户配置的本地服务应显式声明本地网络 = true;VPN fake-IP 等不属于该集合的网段应添加最窄 CIDR,例如198.18.0.0/15。URL 预检、DNS 解析后的真实 IP 和宿主/应用权限交集使用同一规则,宿主仍可进一步收窄范围。
使用yanxu 包 运行或yanbao run按清单运行项目。直接执行单一文卷为兼容旧脚本保留不受限行为,因此不适合运行不可信来源。嵌入宿主默认应使用沙箱配置,并设置执行步数、调用深度与集合大小预算;命令行可通过--max-steps或YANXU_MAX_STEPS收紧单次执行步数。