TrafficMonitor是一个很受欢迎的任务栏监控工具。它还支持插件开发。然而……插件开发起来很麻烦。

本项目支持用lua开发TrafficMonitor插件，尽可能降低开发难度。

1. 安装

在release页面下载zip后，解压到TrafficMonitor的插件目录即可

压缩包自带若干lua编写的插件，可以在“显示设置”中启用。

2. lua插件开发指南

可以参考plugins目录下的例子。

简单例子

模板如下：

-- 显示在“显示设置”里的名称
name="nvidia显卡监测"
-- 样例文本，会按此文本计算插件的显示宽度。尽可能用最大可能宽度的样例文本。
sample="显卡: 100%"
-- 调用onUpdate的频率，单位秒
interval=3

-- 每隔interval秒调用一次，返回值将被绘制到任务栏
function onUpdate()
	return "显卡: "..tf.runCmdLine("nvidia-smi.exe --query-gpu=utilization.gpu --format=csv,noheader")
end

-- 用户在插件文本上点击左键时触发
function onClick()
end

请注意：如果您是中文环境，需要将lua文件的编码设置为GBK

插件的选项

直接在lua里修改和保存即可，记得为用户提供详细说明。可参考赚钱.lua

显示图像

目前仅支持绘制指定图标。

在onUpdate返回的文本中，出现[xxx]格式的文本，将从lua同级目录下加载并绘制xxx.ico。

如hello world[smile]会被渲染为hello world🙂

应将xxx.ico放在lua文件同级目录下；为方便管理，应该为有图片资源的lua插件单独创建一个目录。

运行命令行

本项目为lua插件提供了一些扩展，统一放在命名空间tf下。

要运行本地命令，可以调用tf.runCmdLine以获得标准输出和标准错误的内容。

访问监控信息

可通过tf.monitorInfo获取监控信息。具体字段见PluginInterface.h

3. Demo

在plugins目录下有我编写的几个例子

• 显卡监测：调用nvidia-smi获取并显示GPU使用率
• 赚钱：实时显示当日打工挣了多少钱（创意来自macos上的某个插件，忘记名字了……）
• 程序员格言：定时更新一条程序员才懂的格言

4. 开发计划

• [ ] 开发一个可视化的“测试”界面，方便lua脚本编写时测试（在测试界面实现）
• [ ] 继续上传更多有用/有趣的插件