[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-92716":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":9,"pushedAt":9,"updatedAt":23,"readmeContent":24,"aiSummary":25,"trendingCount":15,"starSnapshotCount":15,"syncStatus":16,"lastSyncTime":26,"discoverSource":27},92716,"HADocs","SirBlondieDK\u002FHADocs","SirBlondieDK","HADocs automatically documents, analyzes, and visualizes your Home Assistant installation. Generate comprehensive documentation, calculate a meaningful Health Score, discover configuration issues, detect unused entities, and gain deep insights into your smart home architecture.",null,"HTML",105,5,6,11,0,2,42.53,"Other",false,"main",true,[],"2026-07-22 04:02:06","\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fbanner\u002Fhero.svg\" alt=\"HADocs - Smart Home Intelligence for Home Assistant\" width=\"100%\">\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">🏠 HADocs\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>Smart Home Intelligence for Home Assistant\u003C\u002Fstrong>\u003Cbr>\n  \u003Cem>Find root causes. Improve health. Generate documentation.\u003C\u002Fem>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg alt=\"Release\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002FSirBlondieDK\u002FHADocs\">\n  \u003Cimg alt=\"Downloads\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002FSirBlondieDK\u002FHADocs\u002Ftotal\">\n  \u003Cimg alt=\"Stars\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FSirBlondieDK\u002FHADocs\">\n  \u003Cimg alt=\"License\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002FSirBlondieDK\u002FHADocs\">\n  \u003Cimg alt=\"Python\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.11+-blue\">\n  \u003Cimg alt=\"Home Assistant\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FHome%20Assistant-Compatible-41BDF5\">\n  \u003Cimg alt=\"Privacy\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCloud-No-success\">\n\u003C\u002Fp>\n\n---\n\n## 🚀 What is HADocs?\n\n**HADocs** is a local-first Smart Home Intelligence tool for Home Assistant.\n\nInstead of overwhelming you with hundreds or thousands of entities, HADocs analyzes your installation, groups symptoms into **Root Causes**, calculates a transparent **Health Score**, and generates a modern intelligence dashboard.\n\nHADocs runs locally. No cloud. No telemetry. No external AI calls.\n\n---\n\n## ✨ Why HADocs?\n\nTraditional diagnostics tell you **what** is broken.\n\nHADocs helps you understand **what to fix first**.\n\n| Traditional tools | HADocs |\n|---|---|\n| Hundreds of unavailable entities | ✅ Groups symptoms into root causes |\n| Raw technical data | ✅ Executive summary |\n| Manual troubleshooting | ✅ Prioritized repair plan |\n| Unknown impact | ✅ Health Score prediction |\n| Scattered information | ✅ Dashboard, Explorer and Markdown docs |\n| Hard to share safely | ✅ Local, redacted Knowledge Pack |\n\n---\n\n## ❤️ Dashboard Engine v2\n\n![Dashboard Overview](assets\u002Fscreenshots\u002F01-dashboard-overview.png)\n\nThe new Dashboard Engine gives you a product-like view of your Home Assistant installation:\n\n- Executive Summary\n- Health Score\n- Potential Health Score\n- Estimated repair time\n- Installation Overview\n- Root Cause cards\n- Recommended Actions\n- History\n- Explorer and Knowledge Pack shortcuts\n\n---\n\n## ❤️ Health Score v2\n\n![Installation Overview](assets\u002Fscreenshots\u002F02-installation-overview.png)\n\nHealth Score v2 is designed to be explainable and fair for both small and large installations.\n\nIt considers active affected entities, critical issues, warnings, maintenance issues, root cause complexity, installation size, disabled entities and potential improvement.\n\nDisabled entities are ignored as active problems, and penalties are normalized so large installations are not punished unfairly.\n\n---\n\n## ⚡ Smart Recommendations\n\n![Top Recommendations](assets\u002Fscreenshots\u002F03-top-recommendations.png)\n\nHADocs prioritizes what matters most.\n\nFor each recommendation, HADocs can show likely root cause, affected entities, affected devices, estimated repair time, expected Health Score gain and child incidents.\n\nDon't fix everything. Fix what matters first.\n\n---\n\n## 🔥 Root Cause Intelligence\n\n![Root Cause Analysis](assets\u002Fscreenshots\u002F04-root-cause-analysis.png)\n\nHADocs focuses on causes, not symptoms.\n\nInstead of showing 176 unavailable entities as 176 separate problems, HADocs can group them into a single Root Cause.\n\n```text\nMobile App devices\n3 devices offline\n176 affected entities\nEstimated repair time: 2 minutes\nPotential Health Score gain: +8\n```\n\n---\n\n## 📈 Transparent Scoring\n\n![Score Explanation](assets\u002Fscreenshots\u002F05-health-score-history.png)\n\nNo black box.\n\nHealth Score v2 explains why points were lost and what can improve them.\n\n---\n\n## 📚 Generated Output\n\n![Generated Output](assets\u002Fscreenshots\u002F06-generated-output.png)\n\nEvery scan generates a complete local intelligence package:\n\n```text\noutput\u002F\n├── index.html\n├── index.md\n├── 00_executive_dashboard.md\n├── 01_root_causes.md\n├── 02_incidents.md\n├── explorer\u002F\n├── knowledge\u002F\n├── history\u002F\n└── csv\u002F\n```\n\nGenerated formats include interactive HTML Dashboard, HTML Explorer, Markdown documentation, Knowledge Pack, redacted Knowledge Pack, CSV exports and history snapshots.\n\n---\n\n## 🔍 Explorer\n\nThe Explorer lets you browse generated data by areas, devices, entities, integrations and relationships.\n\n---\n\n## 🧠 Knowledge Pack\n\nHADocs exports structured local knowledge that can be used with AI assistants manually.\n\nHADocs does **not** upload it automatically.\n\nYou choose what to share.\n\n```text\noutput\u002Fknowledge\u002F\noutput\u002Fknowledge\u002Fredacted\u002F\n```\n\n---\n\n## 🔒 Privacy first\n\nHADocs is built for local analysis.\n\n- ✅ Runs locally\n- ✅ No telemetry\n- ✅ No cloud upload\n- ✅ No external AI calls\n- ✅ Home Assistant token stored in Windows Credential Manager\n- ✅ `config.json` does not store tokens\n- ✅ Redacted Knowledge Pack available\n\n---\n\n## 🖥️ Installation\n\n### Windows\n\n1. Download the latest release from GitHub Releases.\n2. Extract `HADocs-v0.13.0-win64.zip`.\n3. Run `HADocs.exe`.\n4. Enter your Home Assistant URL and Long-Lived Access Token.\n5. Click **Scan Home Assistant**.\n\nPython is not required for the Windows release.\n\n### From source\n\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002FSirBlondieDK\u002FHADocs.git\ncd HADocs\npy -3.14 -m pip install -e .\npy -3.14 main.py\n```\n\n---\n\n## 🧪 Development\n\nRun tests:\n\n```powershell\npy -3.14 -m pytest\n```\n\nBuild Windows package:\n\n```powershell\npowershell -ExecutionPolicy Bypass -File installer\u002Fbuild_windows.ps1\nCompress-Archive -Path dist\\HADocs\\* -DestinationPath HADocs-v0.13.0-win64.zip -Force\n```\n\n---\n\n## 🗺️ Roadmap\n\nSee [ROADMAP.md](ROADMAP.md).\n\nNext milestones:\n\n- v0.14: Explain This, deeper repair guidance, dependency graph\n- v0.15: Automation Intelligence, Lovelace review, Zigbee health\n- v1.0: stable public release, localization, installer and automatic updates\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n---\n\n## ❤️ Built for the Home Assistant community\n\nHADocs was created by a Home Assistant user to make troubleshooting faster, clearer and more enjoyable.\n\nIf HADocs saves you time, consider giving the project a ⭐ on GitHub.\n","HADocs 是一款面向 Home Assistant 用户的本地化智能诊断与文档生成工具。它自动分析配置文件、识别未使用实体、检测配置问题，计算可解释的健康评分（Health Score），并生成结构化 Markdown 文档与交互式仪表盘。核心特点包括根因归类（Root Cause）、本地运行（无云服务\u002F无遥测）、健康状态预测及修复优先级推荐。适用于 Home Assistant 中高级用户进行系统健康评估、配置优化、故障排查和团队知识沉淀。","2026-07-10 02:30:15","CREATED_QUERY"]