安全边界

工作区文件边界

q 的内置文件操作限制在当前工作区。带锚点的编辑会拒绝过期内容，结构化路径可以在相关工具批次继续前启用嵌套的 AGENTS.md 指令。

.qignore 影响发现和根目录列表，但不是访问控制边界：工具仍可读取明确指定的工作区内路径。

Shell 执行

Shell 命令从工作区启动，但不是操作系统级沙箱。除非操作系统、容器或账户限制它，否则命令可以使用 q 进程所拥有的权限。

处理不可信的仓库或命令时，请使用隔离账户、容器或虚拟机。

凭据

提供商与 MCP 凭据优先使用环境变量引用。q 将全局配置保存在 ~/.q。Windows 文件模式不管理 ACL，因此应通过适合本机的账户和文件系统控制保护该目录。

网络服务

内部数据服务绑定在回环地址，且不要求 bearer 认证。独立 Gateway 可以单独配置。

不要在非回环地址上暴露未经认证的 Gateway 监听端口。应使用认证和可信网络，或正确配置的反向代理。