配置文件
O&O DeskInfo 将所有设置保存在一个 XML 文件中。通知区域图标菜单提供日常使用的选项。通过配置文件还可以指定边距、精确颜色、图表尺寸、历史记录长度、技术支持联系信息和受管理工作站的使用限制。
下文逐项说明配置文件中的设置。
配置文件的位置
文件名始终为 OODeskInfo.cfg。O&O DeskInfo 按以下顺序查找文件:
- 命令行指定的位置。 如果提供了
/cfg参数,程序使用该参数指向的文件。 - 程序所在目录。 如果
OODeskInfo.exe所在文件夹有OODeskInfo.cfg,程序使用该文件。因此,从 U 盘运行时,您可以将程序和设置一起携带。 - 用户配置文件。 如果前两处都未指定文件,程序使用
%LocalAppData%\OO Software\OO DeskInfo\OODeskInfo.cfg。如果文件不存在,程序会创建它。
要获得可以直接编辑的有效文件,请先启动 O&O DeskInfo,再退出,然后打开 %LocalAppData%\OO Software\OO DeskInfo\ 下生成的文件。它包含各项设置的当前值。
结构和规则
<?xml version="1.0"?>
<Settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<Language>en</Language>
<PanelPosition>RightTop</PanelPosition>
<TextSize>12</TextSize>
</Settings>
编辑时请遵循以下规则:
- 根元素必须是
<Settings>,不得声明默认 XML 命名空间。 - 元素名称区分大小写,拼写必须与本参考中的名称完全一致。
- 布尔值写作小写的
true或false。 - 颜色可以写作英文名称(
White、Black、Red、Green、Orange),也可以写作#RRGGBB或#AARRGGBB格式的十六进制值。 - 每个元素都是可选的。省略某个元素将使用其默认值,因此只包含两项设置的文件同样有效。
- 元素可以按任意顺序排列。保留程序写入时采用的顺序,便于比较不同文件。
自动应用更改
O&O DeskInfo 会监视配置文件。保存更改约一秒后,程序会自动应用新值,无需重启。您可以将编辑器放在桌面一侧,一边修改设置,一边观察效果。
部分编辑器会分几步写入文件。O&O DeskInfo 会等到写入暂停约一秒后再读取,以免应用尚未写完的配置。
大多数设置通过就地重建显示面板生效,已收集的图表历史记录会保留。以下四项依赖于仅在进程启动时初始化的资源,因此修改后程序会重新启动:
在通知区域菜单中所做的更改会立即生效,并立即写入文件。
运行中的程序也会保存自己的设置,例如缓存的分栏布局。您可以在运行时直接编辑当前文件。请避免修改较早的副本后再覆盖当前文件,以免恢复过时的值。
如果文件因缺少结束标记、包含无效值或多余字符而无法解析,O&O DeskInfo 会在同一目录保存一份带时间戳的备份,扩展名为 .invalid,然后使用默认设置重新开始。您可以在保留的文件中找到错误,修正后复制回需要的值。
常规
Language
类型:文本 · 默认值:空(系统语言)
用户界面的语言。将元素留空或设为 system,即可跟随 Windows 显示语言。
| 值 | 语言 |
|---|---|
留空或 system | Windows 显示语言 |
en | 英语 |
de | 德语 |
fr | 法语 |
也可以在通知区域菜单中选择语言,或使用命令行参数 /lang。
<Language>en</Language>
LogEnabled
类型:布尔值 · 默认值:false
将详细日志写入 %LocalAppData%\OO Software\OO DeskInfo\Logs\OODeskInfo.log。仅在排查故障时启用,联系技术支持时可附上该日志。
ShowWelcome
类型:布尔值 · 默认值:true
控制启动时是否显示欢迎向导。完成向导一次后,此值自动设为 false。重新设为 true 可在下次启动时再次显示向导。为受管理计算机准备配置文件时,可设为 false 以跳过向导。
UpdateSpeed
类型:数值(秒) · 默认值:5
控制显示值的刷新间隔。通知区域菜单提供 1(快)、5(正常)和 10(慢)。在文件中可指定其他值,菜单会显示为“自定义”。驱动器活动及 CPU、内存计数器的采样间隔由该值推算。请参阅更新速度。
UseEfficiencyMode
类型:布尔值 · 默认值:true
请求 Windows 以较低优先级在后台运行 O&O DeskInfo,并在硬件支持时使用能效核心。在不支持效率模式的 Windows 版本中,此设置不起作用。
LaunchTaskManager
类型:布尔值 · 默认值:true
控制双击通知区域图标时是否打开 Windows 任务管理器。
位置和显示器
PanelPosition
类型:LeftTop | RightTop | LeftBottom | RightBottom · 默认值:RightTop
信息面板在屏幕上所处的角落。
Monitor
类型:数值 · 默认值:0
显示面板所在显示器的编号,从零开始。0 表示第一台显示器。ShowOnAllMonitors 为 true 时,此设置不起作用。
ShowOnAllMonitors
类型:布尔值 · 默认值:false
设为 true 时,所有连接的显示器会同时显示信息,使用相同的显示配置、位置和外观。
TopMargin, RightMargin, BottomMargin, LeftMargin
类型:数值(像素) · 默认值:0
在桌面集成模式下,指定面板与屏幕边缘之间的距离。可借此避开任务栏、程序坞或壁纸图案。
<TopMargin>40</TopMargin>
<RightMargin>24</RightMargin>
<BottomMargin>0</BottomMargin>
<LeftMargin>0</LeftMargin>
IsIntegratedWithDesktop
类型:布尔值 · 默认值:true
true 将面板绘制在桌面背景上,位于桌面图标下方。false 切换到滑动窗口。
DisplayAlwaysOnTop
类型:布尔值 · 默认值:false
仅适用于滑动窗口模式。使窗口始终位于其他窗口上方。
ShowButtonOnDesktop
类型:布尔值 · 默认值:true
仅适用于滑动窗口模式。控制是否在屏幕边缘显示拉出按钮。设为 false 时,可通过通知区域图标显示或隐藏窗口。
ButtonYPosition
类型:数值 · 默认值:175
拉出按钮的垂直位置,以像素为单位。通常可以直接用鼠标拖动按钮来设置。
外观
AutoAdjustTextColor
类型:布尔值 · 默认值:true
true 根据壁纸亮度自动选择文字颜色,在浅色背景上使用黑字,在深色背景上使用白字,并忽略 TextColor。若要指定固定颜色,请设为 false。
TextColor
类型:颜色 · 默认值:White
固定文字颜色。仅当 AutoAdjustTextColor 为 false 时生效。您可以指定任意颜色。菜单会将列表以外的颜色标记为“自定义”。
菜单提供以下颜色:
| 菜单项 | 值 |
|---|---|
| 白色 | White |
| 浅灰色 | #F2F2F2 |
| 灰色 | #D9D9D9 |
| 深灰色 | #838383 |
| 黑色 | Black |
| 红色 | Red |
| 绿色 | Green |
| 蓝色 | #3082CF |
TextSize
类型:数值(磅) · 默认值:12
面板的字号。菜单中可选择 10、12 或 14。文件也接受其他值,在菜单中显示为“自定义”。
DisplayOpacity
类型:数值(百分比) · 默认值:80
整个信息面板的不透明度。菜单提供 100、80 和 40。
Opacity
类型:数值(百分比) · 默认值:80
仅适用于滑动窗口模式。指定面板背景的不透明度。菜单提供 100、80 和 40。
PanelColor
类型:颜色 · 默认值:#3082CF (蓝色)
仅适用于滑动窗口模式。指定拉出按钮的颜色。菜单提供蓝色(#3082CF)、White、Black、Red、Green 和橙色(#FF6A00)。
FillColorNormal
类型:颜色 · 默认值:#FF82BC1D (绿色)
驱动器空间使用率低于 90% 时,容量条使用的颜色。
FillColorWarning
类型:颜色 · 默认值:#FFFFBC00 (黄色)
驱动器空间使用率达到 90% 但低于 95% 时,容量条使用的颜色。
FillColorCritical
类型:颜色 · 默认值:#FFDD4A17 (红色)
驱动器空间使用率达到或超过 95% 时,容量条使用的颜色。
FillColorBackground
类型:颜色 · 默认值:#FF838383 (灰色)
驱动器容量条的背景颜色。
分栏布局
UseBalancedColumnDistribution
类型:布尔值 · 默认值:true
true 按权重将信息分配到各列:每个标签行或驱动器条目计为 1,性能图表按高度计算,信息组不会被拆分。false 按顺序分配。
BalancedColumnAlignment
类型:RightBound | LeftBound · 默认值:RightBound
当各列无法完全等高时,决定哪一列可以较短。RightBound 允许最左列较短,适用于靠右显示;LeftBound 允许最右列较短,适用于靠左显示。
图表和性能监视
ShowCPUGraph
类型:布尔值 · 默认值:true
当前显示配置包含 CPU 历史图表时,控制是否显示该图表。
ShowRAMGraph
类型:布尔值 · 默认值:true
当前显示配置包含内存历史图表时,控制是否显示该图表。
ShowGPUGraph
类型:布尔值 · 默认值:true
当前显示配置包含 GPU 历史图表时,控制是否显示该图表。如果系统没有提供 GPU 数据,程序会自动隐藏 GPU 行。
ShowNetworkGraph
类型:布尔值 · 默认值:true
当前显示配置包含网络流量图表时,控制是否显示发送和接收图表。
ShowNetworkTrafficInBitsPerSecond
类型:布尔值 · 默认值:true
true 以比特/秒显示网络流量,使用十进制前缀(b/s、Kb/s、Mb/s、Gb/s)。false 以字节/秒显示,使用二进制换算(B/s、KB/s、MB/s、GB/s)。
PerformanceGraphHeight
类型:数值(像素) · 默认值:48
每个性能图表的高度。较高的图表更容易看出细微波动,但在计算分栏布局时所占权重也较大。
PerformanceGraphMinWidth
类型:数值(像素) · 默认值:200
性能图表的最小宽度。图表可扩展到该值以上,以填满列宽。
MaxHistoryItems
类型:数值 · 默认值:1024
每项指标保留的样本数。在典型更新间隔下,1024 个样本约涵盖 17 至 34 分钟。增大此值可以查看更长时间范围内的最小值和最大值,减小此值可节省内存。
PerformanceAverageMinSampleCount
类型:数值 · 默认值:32
达到指定样本数后才显示平均值,避免启动后显示不稳定的平均值。实际采用的数值不超过 MaxHistoryItems。
驱动器和 USB 设备
ShowDriveActivity
类型:布尔值 · 默认值:true
显示每个驱动器的读写活动指示灯。
ShowUnknownUSBDeviceNotification
类型:布尔值 · 默认值:false
连接此前未标记为受信任的 USB 存储设备时显示通知。
TrustedUSBDevices
类型:文本列表 · 默认值:空
永久信任的 USB 设备列表。移除某个条目可在下次连接该设备时再次显示警告。移除整个元素可重置所有信任决定。
<TrustedUSBDevices>
<string>USBSTOR\DISK&VEN_SANDISK&PROD_ULTRA&REV_1.00\4C530001…</string>
</TrustedUSBDevices>
网络
NetworkAdapter
类型:文本 · 默认值:空(自动选择)
指定要显示哪一块网络适配器的数据。省略此元素时自动选择。字符串必须与 Windows 报告的适配器描述完全一致。最可靠的方法是先在通知区域菜单中选定适配器,然后从配置文件中读取其值。
显示配置
SelectedProfile
类型:文本 · 默认值:Default
指定当前使用的显示配置。
| 值 | 显示配置 |
|---|---|
Default | 默认配置 |
Full | 完整配置 |
Minimum | 精简配置 |
DriveLED | 仅显示驱动器 |
| 其他值 | 使用 CustomProfile 中定义的配置 |
CustomProfile
类型:元素 · 默认值:无
定义自定义显示配置。有关其结构和所有可用键,请参阅显示配置。
<CustomProfile>
<Name>Custom</Name>
<DisplayName>IT Support Profile</DisplayName>
<ShowLabels>true</ShowLabels>
<Keys>
<Item>InfoMessage</Item>
<Item>-</Item>
<Item>UserAndMachine</Item>
<Item>-</Item>
<Item>OS</Item>
</Keys>
<ColumnAssignments>InfoMessage:0;UserAndMachine:0;OS:0</ColumnAssignments>
</CustomProfile>
部署和限制
以下四项用于受管理环境。有关组合使用的方法,请参阅企业部署。
InfoMessage
类型:文本 · 默认值:空
在系统信息上方显示一行自定义文字,例如技术支持的联系方式。只有当前配置包含 InfoMessage 键时才会显示。所有预设配置均包含此键。
<InfoMessage>IT Help Desk: helpdesk@example.com | Phone: +49 30 1234-5678</InfoMessage>
SetAutoRun
类型:布尔值 · 默认值:未设置
无需询问用户即可设置自动启动项。true 创建该项,false 移除该项。省略此元素时,保留用户设置的自动启动状态。
IsRestricted
类型:布尔值 · 默认值:未设置
true 将 O&O DeskInfo 切换为只读模式。程序不再写入配置文件,也不显示通知区域菜单,用户无法更改或意外破坏已部署的配置。
TrayMenu
类型:Full | ExitOnly | HideMenu | HideAll · 默认值:Full
指定是否显示通知区域图标,以及用户可以使用哪些菜单项。
| 值 | 通知区域图标 | 菜单 |
|---|---|---|
Full | 显示 | 完整菜单 |
ExitOnly | 显示 | 仅“退出” |
HideMenu | 显示 | 无 |
HideAll | 隐藏 | 无 |
程序自行管理的值
以下元素会出现在文件中,由 O&O DeskInfo 自行维护。无需手动编辑,准备部署用的配置文件时应省略它们。
| 元素 | 含义 |
|---|---|
NewsletterSubscribed | 是否已通过产品概览订阅电子简报。 |
ScrollViewerPosition | 显示面板的滚动位置。 |
SavedColumnLayout | 缓存上次计算的分栏布局,以加快启动。 |
LayoutEnvironmentFingerprint | 记录显示环境(显示器、分辨率、字号、DPI 和显示配置)的特征,用于判断何时需要重新计算布局。 |
WindowPosition、AppViewMode | 从 O&O 通用设置继承,O&O DeskInfo 不使用这两个元素。 |
完整示例
以下示例为技术支持工作站配置德语界面,在左下角显示较大的文字和支持人员联系方式,启用强制自动启动,并限制用户更改界面。
<?xml version="1.0"?>
<Settings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- General -->
<Language>de</Language>
<LogEnabled>false</LogEnabled>
<ShowWelcome>false</ShowWelcome>
<UpdateSpeed>5</UpdateSpeed>
<!-- Position -->
<PanelPosition>LeftBottom</PanelPosition>
<Monitor>0</Monitor>
<ShowOnAllMonitors>false</ShowOnAllMonitors>
<IsIntegratedWithDesktop>true</IsIntegratedWithDesktop>
<TopMargin>0</TopMargin>
<BottomMargin>48</BottomMargin>
<LeftMargin>24</LeftMargin>
<!-- Appearance -->
<AutoAdjustTextColor>true</AutoAdjustTextColor>
<TextSize>14</TextSize>
<DisplayOpacity>100</DisplayOpacity>
<UseBalancedColumnDistribution>true</UseBalancedColumnDistribution>
<BalancedColumnAlignment>LeftBound</BalancedColumnAlignment>
<!-- Graphs -->
<ShowCPUGraph>true</ShowCPUGraph>
<ShowRAMGraph>true</ShowRAMGraph>
<ShowGPUGraph>false</ShowGPUGraph>
<ShowNetworkGraph>true</ShowNetworkGraph>
<ShowNetworkTrafficInBitsPerSecond>true</ShowNetworkTrafficInBitsPerSecond>
<PerformanceGraphHeight>64</PerformanceGraphHeight>
<!-- Drives and USB -->
<ShowDriveActivity>true</ShowDriveActivity>
<ShowUnknownUSBDeviceNotification>true</ShowUnknownUSBDeviceNotification>
<!-- Profile -->
<SelectedProfile>Custom</SelectedProfile>
<CustomProfile>
<Name>Custom</Name>
<DisplayName>Support</DisplayName>
<ShowLabels>true</ShowLabels>
<Keys>
<Item>InfoMessage</Item>
<Item>-</Item>
<Item>UserAndMachine</Item>
<Item>-</Item>
<Item>OS</Item>
<Item>-</Item>
<Item>CPU</Item>
<Item>-</Item>
<Item>NetworkBasic</Item>
<Item>-</Item>
<Item>LocalDrives</Item>
<Item>-</Item>
<Item>Performance</Item>
</Keys>
<ColumnAssignments>InfoMessage:0;UserAndMachine:0;OS:0;CPU:0;NetworkBasic:1;LocalDrives:1;Performance:2</ColumnAssignments>
</CustomProfile>
<!-- Deployment -->
<InfoMessage>IT Help Desk: helpdesk@example.com | Phone: +49 30 1234-5678</InfoMessage>
<SetAutoRun>true</SetAutoRun>
<IsRestricted>true</IsRestricted>
<TrayMenu>ExitOnly</TrayMenu>
</Settings>
编辑时可以添加 XML 注释(<!-- … -->)。O&O DeskInfo 自行写入文件时会移除注释。请将带注释的原始副本保存在部署共享目录中,另行分发客户端使用的副本。