Публічний реєстр
Звіт про здоров'я програмного забезпеченнясхема 0.34.0 · метрики 2.10.0 · 2026-09-15 23:35 UTC

Python-roborock / python-roborock

Python library & console tool for controlling Roborock vacuum

PythonApache-2.0★ 230 зірок⑂ 104 форкиз лют. 2023 р.Переглянути на GitHub ↗
ТипБібліотекаІнструмент командного рядкаяк це визначено

Python-roborock/python-roborock має індекс здоров’я 92 зі 100, що відповідає смузі «Відмінний». Найвищий показник — Vitality (98/100), найнижчий — Security (63/100). Останнє оновлення було 2 дні тому. Більшість нещодавньої роботи виконують 2 учасники.

92
загалом / 100
Відмінний

Індекс здоров'я програмного забезпечення

Метрики згруповано у зважені категорії на шкалі 1–100. Загальна оцінка починається як їхнє зважене середнє, відкаліброване за розподілом публічного реєстру, тож діапазони мають перцентильний зміст; коли публічні дані активують Політику юрисдикцій високого ризику, рейтинг коригується й отримує верхню межу 34 («У зоні ризику»).

92
Винятковий93-100Верхній щабель реєстру (≈ топ-5%); відповідає практично всім перевіреним критеріям
Відмінний80-92Сильний за всіма напрямами; незначні прогалини
Добрий65-79Здоровий; прогалини обмежені та керовані
Помірний50-64Прийнятний, але з помітними прогалинами; рекомендовано перевірку
Слабкий35-49Суттєві недоліки в кількох сферах
У зоні ризику20-34Суттєві слабкі місця; впровадження потребує обережності
Критичний1-19Серйозні проблеми (покинутий, єдиний мейнтейнер, без базової гігієни)
ЖиттєздатністьСпільнота тавпровадженняСталість таврядуванняІнженернаякістьБезпекаГотовність доШІ

Профіль оцінок

Кожна вісь — окрема категорія. Форма важить більше, ніж середнє: здоровий об'єкт заповнює всю фігуру, тоді як профіль із піками та провалами означає, що сила в одному вимірі маскує ризик в іншому.

Зважений загальний бал 78 калібровано до 92 за шкалою опублікованого індексу (калібрування реєстру 2026-08-02).

Власність

Python-roborockОрганізація
8 підписників4 публічні репозиторіїз січ. 2025 р.

За цим репозиторієм стоїть організація — спільна, підзвітна опіка, здатна пережити будь-якого окремого мейнтейнера.

Пакетні екосистеми

РеєстрПакетВерсіяЗавантажень / місВерсіїОстання публікаціяТеги
PyPIpython-roborock7.8.081 9964522 дні томуhomeassistantroborockvacuum

Метрики за категоріями

Життєздатність

Чи живий проєкт — чи пишеться код і чи виходять релізи?

98Винятковий · 21% загального індексу

Активність розробки

96Винятковий
Як обчислюється оцінка
36/36Свіжість push — останній push 2 дн. тому
31.8/36Ритм комітів — 46/52 тижнів із комітами
18/18Обсяг комітів — 555 комітів за останній рік
10/10OpenSSF Scorecard: Maintained — 30 commit(s) and 4 issue activity found in the last 90 days -- score normalized to 10
Використані вхідні дані
commits_last_year555
human_commit_share1
days_since_last_push2
active_weeks_last_year46

Дисципліна релізів

100Винятковий
Як обчислюється оцінка
27/27Випускає релізи — опубліковано 100 релізів
36/36Свіжість релізів — останній реліз 2 дн. тому
27/27Ритм релізів — реліз кожні ~0,7 дн.
0/10OpenSSF Scorecard: Signed-Releases — немає даних
Використані вхідні дані
releases_count100
latest_release_tagv7.8.0
releases_from_tagsні
days_since_latest_release2
mean_days_between_releases0,7
Виключено з оцінювання (немає даних або не застосовно): OpenSSF Scorecard: Signed-Releases. Залишкові ваги перенормовано.

Спільнота та впровадження

Чи має проєкт користувачів, завантаження, увагу та влаштовані умови для контриб’юторів?

69Добрий · 17% загального індексу

Популярність і впровадження

59Помірний
Як обчислюється оцінка
38.3/60Зірки — 230 зірок
16.8/25Форки — 104 форків
4.3/15Спостерігачі — 7 спостерігачів
Використані вхідні дані
forks104
stars230
watchers7
growth_stateunverified
growth_factor_pct100
growth_unverified_reasonno_history

Здоров'я спільноти

70Добрий
Як обчислюється оцінка
22.5/22.5README
22.5/22.5Ліцензія — визнана ліцензія (Apache-2.0)
18/18Настанови CONTRIBUTING
0/13.5Кодекс поведінки
0/7.2Шаблон issue
0/6.3Шаблон PR
Використані вхідні дані
has_readmeтак
has_licenseтак
readme_badges4
has_contributingтак
has_issue_templateні
has_code_of_conductні
readme_badge_servicescodecov.io, shields.io
has_pull_request_templateні

Впровадження в екосистемі (завантаження)

82Відмінний
Як обчислюється оцінка
65.5/80Щомісячні завантаження — 81 996 завантажень/місяць у pypi
0/20Залежні пакети в реєстрі — ця екосистема цього не повідомляє
Використані вхідні дані
packagespython-roborock
dependents—
ecosystemspypi
total_downloads—
monthly_downloads81 996
unverified_packages_excluded—
Виключено з оцінювання (немає даних або не застосовно): Залежні пакети в реєстрі. Залишкові ваги перенормовано.

Сталість та врядування

Чи переживе проєкт своїх людей — бас-фактор, реактивність, хто за ним стоїть і як супроводжуються пакети?

68Добрий · 23% загального індексу

Стійкість мейнтейнерів (бас-фактор)

63Помірний
Як обчислюється оцінка
25.2/54Бас-фактор — на 2 контриб’ютор(ів) припадає половина всіх комітів
14.6/22.5Розподіл комітів — головний контриб’ютор — автор 35% комітів
13.5/13.5Широта контриб’юторів — 59 контриб’юторів
10/10OpenSSF Scorecard: Contributors — project has 4 contributing companies or organizations
Використані вхідні дані
bus_factor2
contributors_sampled59
top_contributor_share0,351

Реактивність на issue та PR

72Добрий
Як обчислюється оцінка
28.4/42Вирішення issue — закрито 68% issue
24.6/30Прийняття PR — злито 661/806 вирішених PR
11.7/13Newcomer PR acceptance — злито 9/10 PR від новачків за 30 дн.
7.5/15OpenSSF Scorecard: Code-Review — Found 17/30 approved changesets -- score normalized to 5
Використані вхідні дані
merged_prs661
open_issues43
closed_issues90
prs_merged_7d11
prs_decided_7d12
prs_merged_30d23
prs_decided_30d25
issue_closed_ratio0,677
closed_unmerged_prs145
first_time_authors_30d6
first_time_prs_merged_30d9
first_time_prs_decided_30d10

Власність та опіка

45Слабкий
Як обчислюється оцінка
30/30Підтримка власника — у власності організації
0/20Верифікований домен
6.9/25Охоплення власника — 8 підписників у Python-roborock
8.5/25Послужний список — 4 публічних репозиторіїв, вік облікового запису ~1 р.
Використані вхідні дані
followers8
owner_typeOrganization
is_verifiedні
owner_loginPython-roborock
public_repos4
account_age_days618

Супровід пакетів

100Винятковий
Як обчислюється оцінка
25/25Опубліковано й доступно — 1 пакет(ів) у pypi
35/35Свіжість публікацій — остання публікація 2 дн. тому
20/20Історія версій — 452 опублікованих версій
20/20Не застарілий — активний, не deprecated і не yanked
Використані вхідні дані
packagespython-roborock
ecosystemspypi
any_deprecatedні
min_days_since_publish2

Інженерна якість

Чи наявні базові інженерні практики та документація?

91Відмінний · 19% загального індексу

Інженерні практики

92Відмінний
Як обчислюється оцінка
24/24Процеси CI — 2 процес(ів) CI
24/24Наявні тести
16/16Конфігурація лінтера — pyproject.toml ([tool.ruff])
9.6/9.6Pre-commit-хуки
0/6.4.editorconfig
18/20OpenSSF Scorecard: CI-Tests — 16 out of 17 merged PRs checked by a CI test -- score normalized to 9
Використані вхідні дані
has_ciтак
has_testsтак
has_editorconfigні
has_linter_configтак
has_precommit_configтак

Документація

90Відмінний
Як обчислюється оцінка
30/30README
25/25Каталог документації
15/15Сайт документації / домашня сторінка — https://python-roborock.github.io/python-roborock/
10/10Опис репозиторію
0/10Теми
10/10Wiki
Використані вхідні дані
topics—
has_wikiтак
homepagehttps://python-roborock.github.io/python-roborock/
docs_sitehttps://python-roborock.github.io/python-roborock/
has_readmeтак
has_docs_dirтак
has_descriptionтак

Безпека

Чи міцні видимі практики безпеки й ланцюга постачання, без непослабленої пов’язаності з юрисдикціями високого ризику?

63Помірний · 16% загального індексу

Стан безпеки

54Помірний
Як обчислюється оцінка
7.5/7.5Binary-Artifacts — no binaries found in the repo
4.5/7.5Branch-Protection — branch protection is not maximal on development and all release branches
2.2/2.5CI-Tests — 16 out of 17 merged PRs checked by a CI test -- score normalized to 9
0/2.5CII-Best-Practices — no effort to earn an OpenSSF best practices badge detected
3.8/7.5Code-Review — Found 17/30 approved changesets -- score normalized to 5
2.5/2.5Contributors — project has 4 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 4 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
0/5SAST — SAST tool is not run on all commits -- score normalized to 0
0/5Security-Policy — security policy file not detected
0/7.5Signed-Releases — немає даних
0/7.5Token-Permissions — detected GitHub workflow tokens with excessive permissions
0/7.5Vulnerabilities — 50 existing vulnerabilities detected
Використані вхідні дані
sourceopenssf_scorecard
checks_evaluated17
scorecard_versionv5.5.0
checks_inconclusive1
scorecard_aggregate5,4
Виключено з оцінювання (немає даних або не застосовно): Signed-Releases. Залишкові ваги перенормовано.

Сповіщення про залежності

100Винятковий
Як обчислюється оцінка
35/35Прямі залежності без відомих сповіщень — жодна пряма залежність не має відомих сповіщень
25/25Непрямі залежності без відомих сповіщень — жодна непряма залежність не має відомих сповіщень
0/40Немає задавнених сповіщень — жодне сповіщення не має дати публікації
Використані вхідні дані
sourceosv
advisories0
affected_packages0
assessed_packages18
unassessed_packages0
affected_by_severitynone
direct_affected_packages0
Виключено з оцінювання (немає даних або не застосовно): Немає задавнених сповіщень. Залишкові ваги перенормовано. Звірено з runtime-замиканням залежностей pypi:python-roborock@7.8.0 — тим, що тягне за собою встановлення опублікованого пакета, — 18 пакетів. Досяжність не аналізується.

Готовність до ШІ

Наскільки репозиторій оснащений для розробки та супроводу за участі ШІ-агентів? Має свідомо малу вагу (4%): агентний інструментарій — реальний сигнал супроводу, але репозиторій без нього все одно може отримати 100/100.

77Добрий · 4% загального індексу

Контекст і настанови для агентів

76Добрий
Як обчислюється оцінка
45/45Інструкції для агентів — AGENTS.md, CLAUDE.md
0/15Машиночитана документація (llms.txt)
31.5/40Читабельна історія комітів — намір зазначено у 59 з 100 людських комітів (структурований заголовок або пояснювальний текст)
Використані вхідні дані
has_llms_txtні
llms_txt_url—
legible_history_share0,59
agent_instruction_filesAGENTS.md, CLAUDE.md
agent_instruction_max_bytes8 985

Цикл верифікації (збірка / тести / перевірка типів)

67Добрий
Як обчислюється оцінка
0/18Розгортання однією командою
22/22Автоматизовані тести
11/11Конфігурація лінтера / форматера — pyproject.toml ([tool.ruff])
11/11Статична перевірка типів — mypy.ini, roborock/py.typed
10/10Відтворюване середовище — lockfile
8/10Підтверджена практика роботи з агентами — 4 з останніх 100 комітів створено агентом або з його зазначенням
5/8Автоматизоване супроводження — автоматизацію залежностей налаштовано, але у вибірці комітів її не видно
0/10OpenSSF Scorecard: Pinned-Dependencies — dependency not pinned by hash detected -- score normalized to 0
Використані вхідні дані
has_nixні
has_testsтак
lockfilesuv.lock
has_dockerfileні
typed_languageні
bootstrap_files—
has_devcontainerні
has_linter_configтак
typecheck_configsmypy.ini, roborock/py.typed
agent_commit_share0,04
toolchain_manifests—
dependency_bot_commit_share0

Читабельність коду для моделей

82Відмінний
Як обчислюється оцінка
27/45Типізований код — Python з конфігурацією перевірки типів (mypy.ini, roborock/py.typed)
54.8/55Керовані розміри файлів — 1/230 файлів вихідного коду понад 60 КБ
Використані вхідні дані
primary_languagePython
largest_source_bytes63 321
source_files_sampled230
oversized_source_files1

Машиночитні інтерфейси

100Винятковий
Як обчислюється оцінка
40/40Схема API (OpenAPI/GraphQL/proto) — roborock/map/proto/b01_scmap.proto
0/20Сервер MCP — не застосовно до цього типу програмного забезпечення
40/40Придатні до запуску приклади — examples
Використані вхідні дані
example_dirsexamples
has_mcp_signalні
api_schema_filesroborock/map/proto/b01_scmap.proto
interfaces_expected_of—
Виключено з оцінювання (немає даних або не застосовно): Сервер MCP. Залишкові ваги перенормовано.

Ключові факти

230зірок GitHub
59контриб'юторів
555комітів за останні 12 місяців
2днів від останнього пушу
100релізів
2бас-фактор
43відкритих issue
PyPIпакетних екосистем

Попередження щодо збору даних

  • Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token

Докладніше

Історія зірок і форків 0 ★ / 104 ⇿
0Зірки
104Форки
94Релізи

Коли додано кожну зірку й форк — зібрано з GitHub і згруповано за днями. Кумулятивне зростання розміщено просто над денними додаваннями, з яких воно складається, тож їх видно одне проти одного: рівномірне органічне накопичення виглядає зовсім інакше, ніж різкий короткочасний сплеск. Там, де цю різницю можна виміряти, її подано як автентичність росту.

02040608010012010442023-022024-122026-09
Мажорні 3Мінорні 61Патчі 30

Кожна точка охоплює 4 днів.

OpenSSF Scorecard 5.4 / 10
5.4сукупно

Незалежна, не прив'язана до інструментів оцінка безпеки від відкритого проєкту OpenSSF Scorecard. Кожна перевірка винагороджує практику безпеки, а не інструмент конкретного постачальника. Перевірки, які Scorecard не зміг визначити, позначено н/д і виключено з оцінки безпеки (вони ніколи не зараховуються як нуль).Scorecard v5.5.0 · 2026-09-15 23:34 UTC

10Binary-Artifactsno binaries found in the repo
6Branch-Protectionbranch protection is not maximal on development and all release branches
9CI-Tests16 out of 17 merged PRs checked by a CI test -- score normalized to 9
0CII-Best-Practicesno effort to earn an OpenSSF best practices badge detected
5Code-ReviewFound 17/30 approved changesets -- score normalized to 5
10Contributorsproject has 4 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 4 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
0SASTSAST tool is not run on all commits -- score normalized to 0
0Security-Policysecurity policy file not detected
н/дSigned-Releasesno releases found
0Token-Permissionsdetected GitHub workflow tokens with excessive permissions
0Vulnerabilities50 existing vulnerabilities detected
Прямі залежності 9
РеєстрПакетОбмеження версіїМаніфест
PyPIaiohttp>=3.8.2,<4pyproject.toml
PyPIpycryptodome~=3.18pyproject.toml
PyPIpycryptodomex~=3.18pyproject.toml
PyPIpaho-mqtt>=1.6.1,<3.0.0pyproject.toml
PyPIconstruct>=2.10.57,<3pyproject.toml
PyPIprotobuf>=6.31.1,<8pyproject.toml
PyPIvacuum-map-parser-roborock—pyproject.toml
PyPIpyrate-limiter>=4.0.0,<5pyproject.toml
PyPIaiomqtt>=2.5.0,<3pyproject.toml
Усі залежності 61

Повний розв'язаний набір залежностей із графа залежностей GitHub: 9 прямих і 52 непрямих (транзитивних) пакетів. Транзитивне замикання є повним, коли в репозиторії закомічено lockfile.

РеєстрПакетВерсіяЗв'язок
PyPIaiohttp3.13.3пряма
PyPIaiomqtt2.5.0пряма
PyPIconstruct2.10.70пряма
PyPIpaho-mqtt2.1.0пряма
PyPIprotobuf6.33.6пряма
PyPIpycryptodome3.23.0пряма
PyPIpycryptodomex3.23.0пряма
PyPIpyrate-limiter4.0.2пряма
PyPIvacuum-map-parser-roborock0.1.5пряма
PyPIaiohappyeyeballs2.6.1непряма
PyPIaioresponses0.7.8непряма
PyPIaiosignal1.4.0непряма
PyPIappdirs1.4.4непряма
PyPIattrs25.4.0непряма
PyPIcfgv3.4.0непряма
PyPIclick8.3.1непряма
PyPIclick-shell2.1непряма
PyPIcodespell2.4.1непряма
PyPIcolorama0.4.6непряма
PyPIcoverage7.12.0непряма
PyPIdistlib0.4.0непряма
PyPIfilelock3.20.0непряма
PyPIfreezegun1.5.5непряма
PyPIfrozenlist1.8.0непряма
PyPIidentify2.6.15непряма
PyPIidna3.10непряма
PyPIiniconfig2.3.0непряма
PyPIjinja23.1.6непряма
PyPIlibrt0.7.3непряма
PyPIlxml6.0.2непряма
PyPImarkdown22.5.4непряма
PyPImarkupsafe3.0.3непряма
PyPImultidict6.7.0непряма
PyPImypy1.19.1непряма
PyPImypy-extensions1.1.0непряма
PyPInodeenv1.9.1непряма
PyPIpackaging25.0непряма
PyPIpathspec0.12.1непряма
PyPIpdoc16.0.0непряма
PyPIpillow11.3.0непряма
PyPIplatformdirs4.5.0непряма
PyPIpluggy1.6.0непряма
PyPIpre-commit4.5.1непряма
PyPIpropcache0.4.1непряма
PyPIpygments2.19.2непряма
PyPIpyshark0.6непряма
PyPIpytest9.0.2непряма
PyPIpytest-asyncio1.3.0непряма
PyPIpytest-cov7.0.0непряма
PyPIpytest-timeout2.4.0непряма
PyPIpython-dateutil2.9.0.post0непряма
PyPIpyyaml6.0.3непряма
PyPIruff0.14.11непряма
PyPIsix1.17.0непряма
PyPIsyrupy5.0.0непряма
PyPItermcolor3.1.0непряма
PyPItomli2.3.0непряма
PyPItyping-extensions4.15.0непряма
PyPIvacuum-map-parser-base0.1.5непряма
PyPIvirtualenv20.35.3непряма
PyPIyarl1.22.0непряма
Сповіщення про залежності 0

Встановлення pypi:python-roborock@7.8.0 тягне 18 пакетів, прямих і транзитивних: 0 мають відомі сповіщення, з них 0 — прямі залежності.

Жодне відоме сповіщення не стосується оцінених залежностей.

Сповіщення означає, що версія, записана в графі залежностей, потрапляє в уражений діапазон. Досяжність не аналізується, а граф містить піниї розробки й тестування — знахідка може стосуватися інструментів, а не поставленого коду.

Звіт у форматі JSON машиночитний

Зворотний зв’язок

Помітили щось хибне у цьому звіті або маєте чим поділитися? Неправильні вимірювання, непомічені інструменти, ідеї, запитання — усе доречно. Кожне повідомлення читається й отримує відповідь.

Повідомлення збережеться під час входу.

Пов’язані записи

Перевірені репозиторії, що мають спільні каталожні теги або екосистеми з Python-roborock/python-roborock. Читати поруч →

62mathiashornbek/homebridge-roborock-matterMatter-only Homebridge plugin publishing Roborock robot vacuums, including the 2025 B01/Q7-series, as native Matter accessories for Apple Home. Fork of homebridge-roborock-vacuum2.Помірний48merdok/homebridge-miotHomebridge plugin for devices supporting the Xiaomi miot protocolСлабкий94Hyundai-Kia-Connect/hyundai_kia_connect_apiThis is a Kia UVO and Hyundai Bluelink written in python. It is primary consumed by home assistant. If you are looking for a home assistant Kia / Hyundai implementation please look here: https://github.com/Hyundai-Kia-Connect/kia_uvo. Much of this base code came from reading bluelinky and contributions to the kia_uvo home assistant project.Винятковий94bramstroker/homeassistant-powercalcHome Assistant Custom component to calculate estimated power consumption of lights and other appliancesВинятковий93mampfes/hacs_waste_collection_scheduleHome Assistant integration framework for (garbage collection) schedulesВинятковий88JeffSteinbok/hass-dreoDreo Smart Device Integration for Home Assistant. This is not the official integration; this one is community built and supported and has very frequent updates.Відмінний

Оцінки — це сигнали, а не гарантії. Вони відображають публічно видимі практики на GitHub — це не аудит коду й не гарантія безпеки.

Відсутні дані виключаються, а ваги перенормовуються — нуль за відсутність ніколи не ставиться. Методологія версіонована й відкрита: метрики v2.10.0, схема v0.34.0 — повна методологія · вікі метрик.

Як окремий результат виглядає на тлі всього реєстру: сукупна статистика — PyPI.