显示器控制工具 (DisplayControl)
完整的显示器管理和控制工具,支持获取信息、调整设置等功能。
使用说明
在运行此技能前,请确保已下载所需的控制台工具。
AI 应执行以下操作DisplayControlSkill.exe不存在要下载,存在不下载(仅一次):
- 如果
scripts/DisplayControlSkill.exe不存在,运行scripts/setup.ps1(Windows)或等效脚本,从 https://github.com/society2012/DisplayControlTool/releases/download/tag002/DisplayControlSkill.exe 下载该工具。 - 后续调用该 EXE 获取 JSON 输出。
使用方法(子命令模式)
基本语法
# 使用 exec 工具调用
exec: scripts/DisplayControlSkill.exe <command> [options]
支持的命令
| 命令 | 参数 | 说明 |
|---|---|---|
get_monitor_base_info |
<index> |
获取显示器的基本信息 |
set_monitor_power_mode |
<index> <mode> |
设置显示器的电源模式 |
get_monitor_power_mode |
<index> |
获取显示器的电源模式 |
set_monitor_power_off |
<index> |
关闭显示器 |
set_monitor_power_on |
<index> |
打开显示器 |
get_monitor_sn |
<index> |
获取显示器的sn |
get_monitor_mt |
<index> |
获取显示器的制作商标识符 |
get_monitor_fw_version |
<index> |
获取显示器的固件版本号 |
get_monitor_sync_technology_name |
<index> |
获取显示器的同步技术名称 |
get_monitor_panel_size |
<index> |
获取显示器的尺寸 |
get_monitor_resolution |
<index> |
获取显示器的分辨率 |
get_monitor_manufacturer |
<index> |
获取显示器的制作商 |
get_monitor_count |
<index> |
获取连接显示器的个数 |
get_monitor_feature_count |
<index> |
获取显示器支持的功能个数 |
get_monitor_feature_list |
<index> |
获取显示器支持的功能列表 |
get_monitor_feature_by_index |
<index> <featureIndex> |
获取显示器的某个功能详情 |
get_monitor_name |
<index> |
获取显示器的名称 |
get_monitor_brightness |
<index> |
获取显示器的亮度 |
set_monitor_brightness |
<index> <value> |
设置显示器的亮度(0-100) |
get_monitor_max_freq |
<index> |
获取显示器的最大刷新率 |
help |
无 | 其他command查看帮助信息 |
命令示例
# 获取显示器数量
exec: scripts/DisplayControlSkill.exe get_monitor_count
# 获取指定显示器支持的功能列表
exec: scripts/DisplayControlSkill.exe get_monitor_base_info 0
# 获取第 1 个显示器(索引 0)的详细信息
exec: scripts/DisplayControlSkill.exe get_monitor_base_info 0
# 设置亮度
exec: scripts/DisplayControlSkill.exe set_monitor_brightness 0 80
# 设置电源模式 (0=On, 1=Standby, 2=Suspend, 3=PowerDown)
exec: scripts/DisplayControlSkill.exe set_monitor_power_mode 0 1
输出格式(JSON)
成功响应示例
count 命令:
{
"success": true,
"message": "Success",
"command": "get_monitor_count",
"data": 1,
"timestamp": "2026-04-24 15:14:38"
}
错误响应示例
{
"success": false,
"command": "get_monitor_count",
"data": 0,
"timestamp": "2026-04-24 15:14:38"
}
使用场景
| 用户问题 | 对应命令 |
|---|---|
| "我连接了几台显示器?" | get_monitor_count |
| "显示器支持哪些功能" | get_monitor_feature_list 0 |
| "显示器的基本信息是什么" | get_monitor_base_info 0 |
| "当前亮度是多少?" | get_monitor_brightness 0 |
| "把亮度调到 80" | set_monitor_brightness 0 80 |
参数说明
显示器索引 (index)
- 从 0 开始计数
0= 第 1 个显示器1= 第 2 个显示器- 以此类推
功能index (featureIndex)
- 范围:0-200
- 自动裁剪超出范围的值
亮度/对比度 (value)
- 范围:0-100
- 自动裁剪超出范围的值
电源模式 (mode)
| 值 | 模式 | 说明 |
|---|---|---|
| 0 | On | 开启 |
| 1 | Standby | 待机 |
| 2 | Suspend | 挂起 |
| 3 | PowerDown | 关机 |
