公开记录
软件健康报告模式 0.15.0 · 指标 2.10.0 · 2026-07-19 18:31 UTC

davidusb-geek / emhass

emhass: Energy Management for Home Assistant, is a Python module designed to optimize your home energy interfacing with Home Assistant.

PythonMIT★ 638 星标⑂ 157 复刻始于 2021年9月在 GitHub 上查看 ↗
类型库如何判定
#energy#home-automation#linear-programming#management#model-predictive-control#optimization

davidusb-geek/emhass 的健康指数为 100 分中的 92 分，处于「优秀」区间。 其得分最高的类别是Vitality（98/100），最低的是Sustainability & Governance（68/100）。 最近一次更新在今天。 近期的大部分工作由 1 位贡献者完成。

92
总分 / 100
优秀

软件健康指数

指标归入加权类别，统一采用 1–100 量表。总体分先取类别加权平均，再依据公开记录的分布进行校准，使各等级具有百分位含义；当公开证据触发高风险司法辖区政策时，评级会按政策调整，并设置 34（存在风险）的上限。

92
卓越93-100公开记录中的最高层级（约前 5%）；基本满足所有检验标准
优秀80-92各方面均表现强劲；仅有少量不足
良好65-79健康；不足之处有限且可控
中等50-64可接受，但存在明显不足；建议进行审查
薄弱35-49多个领域存在实质性薄弱环节
存在风险20-34存在重大薄弱环节；采用时应保持审慎
危急1-19问题严重（项目被弃置、仅有单一维护者、缺乏基本工程规范）
活力社区与采用可持续性与治理工程质量安全AI 就绪度

评分画像

每条轴代表一个类别。形状比平均值更重要——健康的对象会填满整个图形，而“一峰一谷”式画像意味着某一维度的优势正掩盖另一维度的风险。

加权总体分 78 经校准后在公布的指数量表上为 92（记录校准 2026-08-02）。

所有权

David个人账户
44 关注者13 个公开仓库始于 2017年10月

该仓库由个人账户拥有。相较于组织支持的项目，单一所有者项目的延续性风险更高。

软件包生态系统

注册表软件包版本月下载量版本数最近发布标签
PyPIemhass0.17.91,3251467 天前energyhassmanagementoptimization

按类别列示的指标

活力

项目是否仍有生命——是否仍在编写代码，是否仍在发布版本？

98卓越 · 占总体的 21%

开发活跃度

96卓越
评分方式
36/36推送新近度 — 最近一次推送于 0 天前
32.5/36提交节奏 — 52 周中有 47 周有提交
18/18提交量 — 最近一年 1,028 次提交
10/10OpenSSF Scorecard：Maintained — 30 commit(s) and 16 issue activity found in the last 90 days -- score normalized to 10
所用输入
commits_last_year1,028
human_commit_share—
days_since_last_push0
active_weeks_last_year47

发布纪律

100卓越
评分方式
27/27有发布版本 — 已发布 100 个发布版本
36/36发布时效 — 最近一次发布版本于 7 天前
27/27发布节奏 — 约每 14.9 天发布一次
0/10OpenSSF Scorecard：Signed-Releases — 无数据
所用输入
releases_count100
latest_release_tagv0.17.9
releases_from_tags否
days_since_latest_release7
mean_days_between_releases14.9
已排除计分（无数据或不适用）：OpenSSF Scorecard：Signed-Releases。 其余权重已重新归一化。

社区与采用

项目是否拥有用户、下载量与关注度，并具备欢迎贡献者参与的配置？

71良好 · 占总体的 17%

流行度与采用

71良好
评分方式
45.5/60星标 — 638 个星标
18.3/25复刻 — 157 个复刻
7.2/15关注者 — 21 位关注者
所用输入
forks157
stars638
watchers21
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

社区健康

85优秀
评分方式
22.5/22.5README
22.5/22.5许可证 — 可识别的许可证（MIT）
18/18CONTRIBUTING 指南
13.5/13.5行为准则
0/7.2议题模板
0/6.3PR 模板
所用输入
has_readme是
has_license是
readme_badges—
has_contributing是
has_issue_template否
has_code_of_conduct是
readme_badge_services—
has_pull_request_template否

生态采用（下载量）

52中等
评分方式
41.6/80月度下载量 — pypi 合计每月 1,325 次下载
0/20注册表被依赖数 — 该生态系统不报告此项
所用输入
packagesemhass
dependents—
ecosystemspypi
total_downloads—
monthly_downloads1,325
unverified_packages_excluded—
已排除计分（无数据或不适用）：注册表被依赖数。 其余权重已重新归一化。

可持续性与治理

项目能否在其成员之外延续——巴士系数、响应能力、由谁支持，以及软件包的维护状况？

68良好 · 占总体的 23%

维护者韧性（巴士系数）

43薄弱
评分方式
9/54巴士系数 — 1 位贡献者贡献了半数提交
10.8/22.5提交分布 — 头号贡献者编写了 52% 的提交
13.5/13.5贡献者广度 — 57 位贡献者
10/10OpenSSF Scorecard：Contributors — project has 14 contributing companies or organizations
所用输入
bus_factor1
contributors_sampled57
top_contributor_share0.52

议题与 PR 响应能力

89优秀
评分方式
39/42议题解决 — 93% 的议题已关闭
26.8/30PR 接受 — 已裁定的 PR 中 454/509 已合并
0/13Newcomer PR acceptance — 30 天内没有首次贡献者的 PR 得到裁决
12/15OpenSSF Scorecard：Code-Review — Found 9/11 approved changesets -- score normalized to 8
所用输入
merged_prs454
open_issues31
closed_issues408
prs_merged_7d—
prs_decided_7d—
prs_merged_30d—
prs_decided_30d—
issue_closed_ratio0.929
closed_unmerged_prs55
first_time_authors_30d—
first_time_prs_merged_30d—
first_time_prs_decided_30d—
已排除计分（无数据或不适用）：Newcomer PR acceptance。 其余权重已重新归一化。

所有权与托管责任

53中等
评分方式
10/30所有权背书 — 个人（用户）账户
0/20已验证域名 — 不适用于个人账户
11.9/25所有者影响力 — davidusb-geek 有 44 位关注者
20.3/25既往记录 — 13 个公开仓库，账户约 8 年
所用输入
followers44
owner_typeUser
is_verified—
owner_logindavidusb-geek
public_repos13
account_age_days3,195
已排除计分（无数据或不适用）：已验证域名。 其余权重已重新归一化。

软件包维护

100卓越
评分方式
25/25已发布且可解析 — pypi 上有 1 个软件包
35/35发布时效 — 最近一次发布于 7 天前
20/20版本历史 — 146 个已发布版本
20/20未被弃用 — 活跃，未被弃用或撤回
所用输入
packagesemhass
ecosystemspypi
any_deprecated否
min_days_since_publish7

工程质量

基础的工程与文档实践是否到位？

81优秀 · 占总体的 19%

工程实践

68良好
评分方式
24/24CI 工作流 — 10 个工作流
24/24存在测试
0/16Linter 配置
0/9.6Pre-commit 钩子
0/6.4.editorconfig
20/20OpenSSF Scorecard：CI-Tests — 11 out of 11 merged PRs checked by a CI test -- score normalized to 10
所用输入
has_ci是
has_tests是
has_editorconfig否
has_linter_config否
has_precommit_config否

文档

100卓越
评分方式
30/30README
25/25文档目录
15/15文档 / 主页站点 — https://emhass.readthedocs.io
10/10仓库描述
10/10主题标签 — 6 个主题标签
10/10Wiki
所用输入
topicsenergy, home-automation, linear-programming, management, model-predictive-control, optimization
has_wiki是
homepagehttps://emhass.readthedocs.io
docs_sitehttps://emhass.readthedocs.io
has_readme是
has_docs_dir是
has_description是

安全

可见的安全与供应链实践是否稳固，且不存在未解决的高风险司法辖区暴露？

71良好 · 占总体的 16%

安全态势

71良好
评分方式
7.5/7.5Binary-Artifacts — no binaries found in the repo
0/7.5Branch-Protection — 无数据
2.5/2.5CI-Tests — 11 out of 11 merged PRs checked by a CI test -- score normalized to 10
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
6/7.5Code-Review — Found 9/11 approved changesets -- score normalized to 8
2.5/2.5Contributors — project has 14 contributing companies or organizations
10/10Dangerous-Workflow — no dangerous workflow patterns detected
7.5/7.5Dependency-Update-Tool — update tool detected
0/5Fuzzing — project is not fuzzed
2.5/2.5许可证 — license file detected
7.5/7.5Maintained — 30 commit(s) and 16 issue activity found in the last 90 days -- score normalized to 10
5/5Packaging — packaging workflow detected
0/5Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
5/5SAST — SAST tool is run on all commits
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — 无数据
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
7.5/7.5Vulnerabilities — 0 existing vulnerabilities detected
所用输入
sourceopenssf_scorecard
checks_evaluated16
scorecard_versionv5.5.0
checks_inconclusive2
scorecard_aggregate7.1
已排除计分（无数据或不适用）：Branch-Protection, Signed-Releases。 其余权重已重新归一化。

AI 就绪度

该仓库在多大程度上具备与 AI 编码代理协同开发与维护的条件？权重刻意设小（4%）：代理工具链是一项真实的维护信号，但完全不具备的仓库仍可达到 100/100。

69良好 · 占总体的 4%

AI 代理上下文与指引

75良好
评分方式
45/45代理指令 — AGENTS.md
0/15机器可读文档（llms.txt）
0/40可读的提交历史 — 无数据
所用输入
has_llms_txt否
llms_txt_url—
legible_history_share—
agent_instruction_filesAGENTS.md
agent_instruction_max_bytes8,340
已排除计分（无数据或不适用）：可读的提交历史。 其余权重已重新归一化。

验证循环（构建 / 测试 / 类型检查）

61中等
评分方式
18/18一条命令的引导启动 — docs/Makefile
22/22自动化测试
0/11Lint / 格式化配置
0/11静态类型检查
10/10可复现环境 — devcontainer, Dockerfile
0/10已体现的代理实践 — 无数据
5/8自动化维护 — 已配置依赖自动化，但在抽样提交中未观察到
0/10OpenSSF Scorecard：Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
所用输入
has_nix否
has_tests是
lockfiles—
has_dockerfile是
typed_language否
bootstrap_filesdocs/Makefile
has_devcontainer是
has_linter_config否
typecheck_configs—
agent_commit_share—
toolchain_manifests—
dependency_bot_commit_share0
已排除计分（无数据或不适用）：已体现的代理实践。 其余权重已重新归一化。

面向模型的代码可读性

45薄弱
评分方式
0/45可类型检查的代码 — Python，未配置类型检查
44.6/55可控的文件大小 — 采样的 58 个源文件中有 11 个超过 60KB
所用输入
primary_languagePython
largest_source_bytes393,714
source_files_sampled58
oversized_source_files11

机器可读接口

100卓越
评分方式
40/40API 模式（OpenAPI/GraphQL/proto） — src/emhass/static/openapi.json
0/20MCP 服务器 — 不适用于此类软件
40/40可运行示例 — cookbook
所用输入
example_dirscookbook
has_mcp_signal否
api_schema_filessrc/emhass/static/openapi.json
interfaces_expected_of—
已排除计分（无数据或不适用）：MCP 服务器。 其余权重已重新归一化。

关键数据

638GitHub 星标
57贡献者
1,028最近 12 个月提交数
0距最近推送天数
100发布版本数
1巴士系数（bus factor）
31开放议题
PyPI软件包生态系统数

更多细节

OpenSSF Scorecard 7.1 / 10
7.1综合

来自开源项目 OpenSSF Scorecard 的独立、工具无关的安全评估。每项检查奖励的是安全实践本身，而非特定供应商的工具。Scorecard 无法判定的检查项标记为 不适用，并从安全评分中剔除（绝不按零分计）。Scorecard v5.5.0 · 2026-07-19 18:30 UTC

10Binary-Artifactsno binaries found in the repo
不适用Branch-Protectioninternal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md
10CI-Tests11 out of 11 merged PRs checked by a CI test -- score normalized to 10
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
8Code-ReviewFound 9/11 approved changesets -- score normalized to 8
10Contributorsproject has 14 contributing companies or organizations
10Dangerous-Workflowno dangerous workflow patterns detected
10Dependency-Update-Toolupdate tool detected
0Fuzzingproject is not fuzzed
10Licenselicense file detected
10Maintained30 commit(s) and 16 issue activity found in the last 90 days -- score normalized to 10
10Packagingpackaging workflow detected
0Pinned-Dependenciesdependency not pinned by hash detected -- score normalized to 0
10SASTSAST tool is run on all commits
0Security-Policysecurity policy file not detected
不适用Signed-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
10Vulnerabilities0 existing vulnerabilities detected
直接依赖 24
注册表软件包版本约束清单文件
PyPInumpy>=2.0.0, <2.3.0pyproject.toml
PyPIscipy>=1.15.0pyproject.toml
PyPIpandas>=2.2.0pyproject.toml
PyPIpvlib>=0.11.0pyproject.toml
PyPIprotobuf>=5.29.3pyproject.toml
PyPIpytz>=2024.2pyproject.toml
PyPIh5py>=3.12.1pyproject.toml
PyPIhighspy>=1.10.0pyproject.toml
PyPIcvxpy>=1.6.0, <1.8.0pyproject.toml
PyPIpyyaml>=6.0.2pyproject.toml
PyPItables>=3.10.0pyproject.toml
PyPIskforecast>=0.19.1,<0.23.0pyproject.toml
PyPIwaitress>=3.0.2pyproject.toml
PyPIplotly>=6.0.0pyproject.toml
PyPIgunicorn>=23.0.0pyproject.toml
PyPIquart—pyproject.toml
PyPIaiofiles—pyproject.toml
PyPIjinja2—pyproject.toml
PyPIasyncio—pyproject.toml
PyPIaiohttp—pyproject.toml
PyPIorjson—pyproject.toml
PyPIwebsockets—pyproject.toml
PyPIuvicorn==0.30.6pyproject.toml
PyPIinfluxdb>=5.3.1pyproject.toml
全部依赖 24

来自 GitHub 依赖图的完整解析依赖集合：18 个直接依赖与 6 个间接（传递）软件包。仓库提交锁文件时，传递闭包才是完整的。

注册表软件包版本关系
PyPIaiohttp—直接
PyPIcvxpy—直接
PyPIgunicorn—直接
PyPIh5py—直接
PyPIhighspy—直接
PyPIinfluxdb—直接
PyPInumpy—直接
PyPIpandas—直接
PyPIplotly—直接
PyPIprotobuf—直接
PyPIpvlib—直接
PyPIpytz—直接
PyPIpyyaml—直接
PyPIscipy—直接
PyPIskforecast—直接
PyPItables—直接
PyPIuvicorn0.30.6直接
PyPIwaitress—直接
PyPIflask—间接
PyPIkaleido—间接
PyPIpulp—间接
PyPIrequests—间接
PyPItabulate—间接
PyPItslearn—间接
原始 JSON 报告 机器可读

反馈

发现这份报告有不准确之处，或有想法要分享？错误的测量、未识别的工具、建议、疑问——都欢迎提出。每条消息都会被阅读并得到回复。

登录过程中消息不会丢失。

相关记录

与 davidusb-geek/emhass 共享目录标签或生态系统的已检测仓库。 并排阅读 →

86flixOpt/flixoptVector based Energy Optimization Framework优秀95coin-or/pulpA python Linear Programming API卓越94e2nIEE/pandapowerConvenient Power System Modelling and Analysis based on PYPOWER and pandas卓越92Pyomo/pyomoAn object-oriented algebraic modeling language in Python for structured optimization problems.优秀81sylvan-energy/gridpathA versatile simulation and optimization platform for power-system planning and operations.优秀78blue-marble/gridpathA versatile simulation and optimization platform for power-system planning and operations.良好

评分是信号，而非担保。 评分反映的是 GitHub 上公开可见的实践——不是代码审计，也不是安全保证。

缺失数据将被剔除并重新归一化权重，绝不按零分计。方法论已版本化并公开：指标 v2.10.0、模式 v0.15.0—— 完整方法论 · 指标知识库.

单项结果在整体记录中的位置： 汇总统计 — PyPI.