System Control

System Control (macOS)

macOS 系统控制助手。触发后必须先询问用户确认，再执行操作。

执行流程: 触发 → 询问用户 → 用户确认 → 执行操作 → 返回结果

安全规则: 强制退出应用前必须确认 | 音量>80 需警告 | 优先使用 trash 删除

Full docs: read SKILL-REFERENCE.md

Monitor and control macOS system functions via native commands and AppleScript.

1. System Information

# Hardware overview
system_profiler SPHardwareDataType 2>/dev/null | grep -E "Model|Chip|Memory|Serial"

# CPU & memory usage (snapshot)
top -l 1 -s 0 | head -12

# Disk usage
df -h / | tail -1

# Battery status (laptops)
pmset -g batt

# Network info
ifconfig en0 | grep "inet " && networksetup -getairportnetwork en0 2>/dev/null

# Uptime
uptime

# macOS version
sw_vers

Bundled script for quick system report

python3 {baseDir}/scripts/sysinfo.py [--json]

Returns: CPU%, memory%, disk%, battery%, network status, uptime.

2. Application Management

# List running visible apps
osascript -e 'tell application "System Events" to get name of every process whose visible is true'

# Launch an app
open -a "Safari"
open -a "Visual Studio Code"

# Quit an app (graceful)
osascript -e 'tell application "Safari" to quit'

# Force-quit an app
kill -9 $(pgrep -x "AppName")

# Get frontmost app
osascript -e 'tell application "System Events" to get name of first process whose frontmost is true'

# List all windows of an app
osascript -e 'tell application "System Events" to tell process "Safari" to get name of every window'

# Bring app to front
osascript -e 'tell application "Safari" to activate'

3. Notifications

# Send a macOS notification
osascript -e 'display notification "消息内容" with title "标题" subtitle "副标题" sound name "default"'

# Notification with custom sound
osascript -e 'display notification "提醒" with title "助手提醒" sound name "Glass"'

4. Clipboard

# Read clipboard content
pbpaste

# Write to clipboard
echo "要复制的内容" | pbcopy

# Copy file content to clipboard
pbcopy < /path/to/file.txt

5. Volume & Display

# Get current volume (0-100)
osascript -e 'output volume of (get volume settings)'

# Set volume (0-100)
osascript -e 'set volume output volume 50'

# Mute/unmute
osascript -e 'set volume output muted true'
osascript -e 'set volume output muted false'

# Get brightness (requires brightness CLI or AppleScript)
# Install: brew install brightness
brightness -l 2>/dev/null || echo "brightness CLI not installed"

6. File Management Shortcuts

# Open file in default app
open /path/to/file.pdf

# Open folder in Finder
open /path/to/folder

# Reveal file in Finder
open -R /path/to/file.txt

# Move to Trash (safe delete)
trash /path/to/file  # requires: brew install trash
# Or use Finder:
osascript -e 'tell application "Finder" to delete POSIX file "/path/to/file"'

# Quick Look preview
qlmanage -p /path/to/file.png 2>/dev/null

7. Process Management

# Find process by name
pgrep -fl "process_name"

# Kill process
kill <pid>
kill -9 <pid>  # force

# List top CPU consumers
ps aux --sort=-%cpu | head -10

# List top memory consumers
ps aux --sort=-%mem | head -10

8. Network

# Current WiFi network
networksetup -getairportnetwork en0 2>/dev/null

# Public IP
curl -s ifconfig.me

# Local IP
ipconfig getifaddr en0

# DNS lookup
nslookup example.com

# Ping test
ping -c 3 8.8.8.8

# Port check
nc -z -w 3 host port

Safety Rules

• Never force-quit without asking — data loss risk
• Never change system settings (firewall, sharing, users) without explicit permission
• Prefer trash over rm — recoverable deletion
• Volume changes: warn user before setting volume > 80
• App launches: safe to do freely; app quits need confirmation

9. 统一控制脚本（syscontrol.py）

scripts/syscontrol.py 提供统一 Python 接口，无需拼接 osascript：

# 执行任意 shell 命令
python3 {baseDir}/scripts/syscontrol.py run "ls -la ~/Desktop" --timeout 10

# 列出进程（可按名称过滤）
python3 {baseDir}/scripts/syscontrol.py ps --name chrome

# 终止进程
python3 {baseDir}/scripts/syscontrol.py kill --pid 1234
python3 {baseDir}/scripts/syscontrol.py kill --name "Google Chrome"

# 打开文件/URL/应用
python3 {baseDir}/scripts/syscontrol.py open https://example.com
python3 {baseDir}/scripts/syscontrol.py open /path/to/file.pdf

# 发送系统通知
python3 {baseDir}/scripts/syscontrol.py notify "助手" "任务完成"

# 磁盘使用
python3 {baseDir}/scripts/syscontrol.py disk

# 设置环境变量（--persist 写入 ~/.zshenv）
python3 {baseDir}/scripts/syscontrol.py env-set MY_KEY myvalue --persist

# 健康检查
python3 {baseDir}/scripts/syscontrol.py --check