
30秒速读
同样一盏灯,白天照和晚上照,对睡眠的影响完全不同——决定因素不只是照度,还有光谱里的黑视素成分。做智能家居或健康照明的人经常要算这个,但 CIE S 026/E:2018 的公式手算很繁琐。本文介绍一个面向 MCP 个人代理的 Python 照明计算技能:输入照度和光源参数,直接算出等效黑视素勒克斯,还能做 WELL L03 昼间工作区的合规审计。本文讲清它算什么、怎么接、边界在哪。关键词:circadian-skill。
项目信息表
| 项目名 | Circadian Skill(昼夜节律照明计算技能) |
| 仓库地址 | Alpha-Park / genpark-personal-agent-circadian-melanopic-lux-ratio-skill |
| 主要语言 | Python(标准库实现,零外部依赖) |
| 运行平台 | 支持 MCP 的个人代理 / 工具宿主 |
| 许可证 | 仓库元数据未声明,采用前请核实 |
核心功能
- 等效黑视素勒克斯计算:根据光源的黑视素日光比(M/P 比)与明视觉照度,算出 melanopic EDI,这是评估光照对昼夜节律影响的核心指标。
- CIE S 026/E:2018 指标处理:覆盖青视素、黑视素、明视觉照度比相关的标准指标,把标准公式变成可调用的工具。
- MCP 工具暴露:通过 MCP 以 JSON-RPC 2.0 形式暴露工具,个人代理可以直接调用,不用自己写公式解析。
- WELL L03 昼间工作区审计:针对 WELL Building Standard v2 的 L03 条款(昼间工作区的黑视素照度要求),提供专门的审计工具,输入实测数据即可判断是否达标。
- 零依赖部署:按仓库说明仅用 Python 标准库实现,不用装 numpy、scipy 之类的科学计算包,集成成本低。
上手指南
- 准备 MCP 宿主(关键前置):你得先有一个支持 MCP 的个人代理或工具宿主,这个技能本身不带界面、不带 Agent,只是一组可被调用的计算工具。
- 按仓库 README 配置调用:MCP 的工具注册方式、参数格式以仓库文档为准,公开资料没有给出完整示例,动手前通读 README。
- 准备输入数据:核心输入是明视觉照度(lux)和光源的 M/P 比。数据从哪来——照度计实测、灯具厂商光谱报告,都可以,关键是数据要靠谱,算得再准也救不了错的输入。
- 先跑 WELL L03 审计验证:拿一组已知数据跑一遍审计工具,对照 WELL v2 L03 的条款看输出是否合理,确认计算链路没问题再接入业务流程。
- 锁定运行环境:Python 版本变化可能影响标准库行为,长期使用建议固定 Python 版本,并给关键指标做回归检查。
独家整理:适用边界(它是什么,不是什么)
| 问题 | 答案 |
| 能直接控制灯具调光调色温吗? | 不能。它只做计算,不含设备控制、传感器驱动,闭环控制要另配系统。 |
| 能替代专业照明检测机构的报告吗? | 不能。它是计算和初步审计工具,正式合规认证以权威机构为准。 |
| WELL 审计覆盖全部条款吗? | 不。只针对 v2 的 L03 昼间工作区指标,其他 WELL 条款不在范围内。 |
| 没有 MCP 环境能用吗? | 能看源码借公式,但它的交付形态就是 MCP 工具,没有 MCP 宿主就失去了最方便的调用方式。 |
| 适合谁? | 在个人代理、照明分析流程里需要算黑视素指标的开发者,以及做昼间工作区节律照明初步评估的研究和工程人员。 |
常见问题
Q1:M/P 比是什么?从哪拿到?
A:黑视素照度与明视觉照度的比值,反映光源光谱对昼夜节律刺激的强弱。灯具厂商的光谱测试报告里通常有,实在没有就只能按同类光源估算,但估算会引入误差。
Q2:许可证是什么?能商用吗?
A:仓库元数据标记为未声明。采用前务必找到许可证文本并核实再分发条件,未声明不等于可随意商用。
Q3:计算结果的精度如何验证?
A:建议用 CIE S 026/E:2018 标准里的示例数据做对照测试,看工具输出与标准示例是否一致,这是验证这类计算工具最直接的办法。
Q4:和买一台照度计有什么区别?
A:照度计测的是明视觉照度(lux),这个工具算的是黑视素等效照度(melanopic EDI),两者回答的是不同问题:前者管”够不够亮”,后者管”对节律刺激够不够”。
Q5:README 里提到的日光瞳孔缩小控制器是什么?
A:仓库摘要把它列在功能范围内,但没有给出接口细节。具体实现和可用状态要看源码,别按”已实现”来做选型。
适用人群
适合在 MCP 工具链里需要计算黑视素照度指标的开发者,以及要做 WELL L03 昼间工作区初步审计的照明研究和工程人员,一句话:算节律光,不控灯。
开源地址
GitHub 国内访问较慢,如打不开可多刷新几次

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







