看懂权限按钮和批准请求
权限按钮决定工具按什么范围工作。一次审批处理的是眼前那项操作。看到批准卡片时，先对照要改的文件或要执行的命令。
本篇目录 4 节
01
怎样确认当前会话的权限
在 Web 会话输入区找权限控件，或输入 /permission 调出列表。这里只切换当前会话。通用设置中的权限默认值只影响以后新建的会话。以下名称对应官方 dsh-v0.2.1-rc.5 的默认 Web 配置。
| 界面名称 | 日常读写 | 适合什么时候用 |
|---|---|---|
| 仅可查看（read-only） | 文件工具允许读，拒绝普通文件写入；受限命令也按只读规则运行。 | 让它读一份材料或了解代码时。 |
| 工作区内修改（workspace-write） | 一般可在选定项目内创建、修改文件。平台临时区域也可能可写。写入其他目录通常会受到限制。 | 在小项目里修改自己的文件。这是该版随附配置的默认值。 |
| 完全权限（danger-full-access） | 相关工具取消 Harness 这层文件沙箱限制，仍受操作系统账户权限约束。 | 它覆盖的范围远大于单个文件。本页实验无需使用。 |
02
为什么有时会问，有时直接写了？
常规项目内写入在「工作区内修改」下通常无需逐次弹窗。对受限操作，工具可以报告拒绝，模型也可能为同一操作申请仅本次扩大权限。许可请求显示理由；若是命令，还要看完整命令、工作目录、目标路径及其可能影响的文件。
选择拒绝后，本次扩大权限的请求不会获得许可。审批取消或找不到可用的审批渠道，也不会得到这次授权。拒绝一次与更换整个会话的权限模式有不同影响。
03
文件工具与系统命令分别在哪里被检查
| 执行途径 | 限制如何生效 | 跨平台差别 |
|---|---|---|
| read / write / edit | 文件工具在写入或编辑前检查实际目标路径；读取没有同样的工作区内限制。 | 需要系统账户能访问目标。文件系统权限仍可阻止读或写。 |
| Linux Bash | 默认执行器优先尝试 bubblewrap，其次尝试 Landlock。受限命令的文件写入依后端规则执行。 | bubblewrap 的 /tmp 可为该命令单独提供；旧 Linux 内核上的 Landlock 可能只覆盖部分文件操作。 |
| macOS Bash | 使用 Seatbelt（sandbox-exec）限制文件写入，保留规则允许的临时目录。 | 受限后端不可用时，命令可能在启动前失败。 |
| Windows PowerShell | 随附配置调用 PowerShell；Windows 受限令牌和访问控制规则负责限制写入。 | 官方标明是部分执行，尤其涉及硬链接和系统访问控制，不能据此断言每台电脑效果相同。 |
04
怎样阅读拒绝信息
提示 file access denied under workspace-write 时，先核对目标是否在所选工作区外。提示 file has not been read 或要求 re-read 时，先读最新版本，避免覆盖人工修改。出现 SANDBOX_UNAVAILABLE 通常表示无法启动可用的受限后端，这次命令未按请求运行。
文件沙箱关注文件影响。它没有承诺封锁网络、凭据访问或所有插件行为。对于不熟悉的代码，官方建议使用专用环境和最小权限。
来源与延伸阅读
TAKE IT WITH YOU
把手册和练习材料带走
知识库方便查阅和备课，演示素材可用于跟做站内示例。