Coverage for agentos/system/__init__.py: 100%

1""" 

2System 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 

22from agentos.system.permissions import ( 

23 SystemPermission, 

24 PermissionTier, 

25 PermissionContext, 

26 PermissionDenied, 

27 SystemPermissionManager, 

28) 

29from agentos.system.file_ops import ( 

30 FileOperator, 

31 FileOpResult, 

32 FileListing, 

33) 

34from agentos.system.shell_exec import ( 

35 ShellExecutor, 

36 ShellResult, 

37 ShellSandbox, 

38 ShellPolicy, 

39) 

40from agentos.system.browser import ( 

41 BrowserSession, 

42 BrowserAction, 

43 BrowserResult, 

44 CDPBrowser, 

45) 

46from 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]