1"""

2 System Operations Layer — 系统底层操作模块 (v1.7.1)

3 让 Agent 拥有真正的"手"，像用户一样操作系统资源。

4

5 核心设计:

6- 分层授权: 每层操作需要对应权限级别，不越权

7- 可视化审批: Agent 主动申请授权 → 用户点击同意/拒绝（P0 增强）

8- 可审计: 所有操作记录到 AuditLogger

9- 可沙箱: 高风险操作默认在沙箱内执行

10

11 权限层级 (由低到高):

12 READ — 只读（文件读取/目录列表/进程查看）

13 WRITE_SANDBOX — 沙箱写入（仅限指定目录）

14 WRITE_ALL — 全盘写入（危险，需明确授权）

15 SHELL_READONLY — 只读 Shell 命令

16 SHELL_STANDARD — 标准 Shell（超时/目录限制）

17 SHELL_FULL — 全权限 Shell（需二次确认）

18 BROWSER — 浏览器自动化

19 ADMIN — 系统管理（安装/卸载/配置）

20"""

21

22 from agentos.system.permissions import (

23 SystemPermission,

24 PermissionTier,

25 PermissionContext,

26 PermissionDenied,

27 SystemPermissionManager,

28)

29 from agentos.system.file_ops import (

30 FileOperator,

31 FileOpResult,

32 FileListing,

33)

34 from agentos.system.shell_exec import (

35 ShellExecutor,

36 ShellResult,

37 ShellSandbox,

38 ShellPolicy,

39)

40 from agentos.system.browser import (

41 BrowserSession,

42 BrowserAction,

43 BrowserResult,

44 CDPBrowser,

45)

46 from agentos.system.approval import (

47 ApprovalEngine,

48 ApprovalTicket,

49 ApprovalStatus,

50)

51

52__all__ = [

53 # Permissions

54 "SystemPermission",

55 "PermissionTier",

56 "PermissionContext",

57 "PermissionDenied",

58 "SystemPermissionManager",

59 # File Ops

60 "FileOperator",

61 "FileOpResult",

62 "FileListing",

63 # Shell

64 "ShellExecutor",

65 "ShellResult",

66 "ShellSandbox",

67 "ShellPolicy",

68 # Browser

69 "BrowserSession",

70 "BrowserAction",

71 "BrowserResult",

72 "CDPBrowser",

73 # Approval

74 "ApprovalEngine",

75 "ApprovalTicket",

76 "ApprovalStatus",

77]