{"id":31044821,"url":"https://github.com/nfs-tw-developer/meshplorer","last_synced_at":"2025-09-14T16:51:57.735Z","repository":{"id":310163981,"uuid":"1038932551","full_name":"NFS-TW-Developer/MeshPlorer","owner":"NFS-TW-Developer","description":"MeshPlorer 是一款 Meshtastic 機器人服務，支援緊急守護、天氣查詢等功能。","archived":false,"fork":false,"pushed_at":"2025-08-24T03:58:06.000Z","size":90,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-24T05:08:03.156Z","etag":null,"topics":["bot","compose","docker","mesh","meshtastic","mqtt","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NFS-TW-Developer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-16T05:37:22.000Z","updated_at":"2025-08-24T03:58:09.000Z","dependencies_parsed_at":"2025-08-16T07:40:20.752Z","dependency_job_id":null,"html_url":"https://github.com/NFS-TW-Developer/MeshPlorer","commit_stats":null,"previous_names":["nfs-tw-developer/meshplorer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/NFS-TW-Developer/MeshPlorer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NFS-TW-Developer%2FMeshPlorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NFS-TW-Developer%2FMeshPlorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NFS-TW-Developer%2FMeshPlorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NFS-TW-Developer%2FMeshPlorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NFS-TW-Developer","download_url":"https://codeload.github.com/NFS-TW-Developer/MeshPlorer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NFS-TW-Developer%2FMeshPlorer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275136699,"owners_count":25411709,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-14T02:00:10.474Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","compose","docker","mesh","meshtastic","mqtt","python"],"created_at":"2025-09-14T16:51:52.460Z","updated_at":"2025-09-14T16:51:57.719Z","avatar_url":"https://github.com/NFS-TW-Developer.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MeshPlorer\n\n## 簡介\n\nMeshPlorer 是一款 Meshtastic 機器人服務，支援緊急守護、天氣查詢等功能。\n\n## 功能特色\n\n- **緊急守護服務** - 自動監控緊急頻道，提供即時通報\n- **天氣查詢服務** - 根據節點位置自動查詢天氣資訊\n- **智慧訊息處理** - 支援加密通訊和重複訊息過濾\n\n## 快速開始\n\n```bash\n# 啟動服務\ndocker compose up -d\n```\n\n## 機器人指令\n\n在 Meshtastic 網路中可以用以下指令跟機器人互動：\n\n### 基本指令\n\n機器人支援這些前綴：\n- `@nfs.tw`\n- `@nfstw`\n- `@nfs`\n\n**可以用的指令**：\n- **@nfs.tw help** - 顯示所有可用指令的詳細說明\n- **@nfs.tw weather** - 查詢你所在位置的天氣狀況（定位來源為 MeshSight，每分鐘限用一次）\n- **@nfs.tw ab [指令]** - 由機器人幫你呼叫 ARBot 機器人\n\n**使用範例**：\n```\n@nfs.tw help\n@nfs.tw weather\n@nfs.tw ab status\n```\n\n**靜默機制**：\n- 天氣查詢：1 分鐘靜默期，超過限制會回應 🤐 emoji\n- 一般指令：無靜默期限制\n\n### 測試功能\n\n發送包含以下關鍵字的訊息會讓機器人回應 👌 emoji：\n- **中文**: `測試`\n- **英文**: `test`、`testing`（需要是獨立詞彙或短句）\n\n*注意：測試功能有 20 秒靜默期，避免過度回應*\n\n### 緊急守護功能\n\n在緊急守護頻道中發送任何文字訊息會觸發緊急通報：\n\n**觸發條件**：\n- 在設定的緊急守護頻道中發送文字訊息\n- 機器人會自動忽略 emoji 訊息\n\n**回應內容**：\n- 🆘 緊急守護通報\n- 發送者節點資訊\n- 緊急地址（來源：MeshSight）\n- 訊息內容（限制 20 字）\n- 安全提醒\n\n**靜默機制**：\n- 3 分鐘靜默期，避免重複通報\n- 自動過濾重複訊息（10 分鐘內）\n\n## 設定\n\n編輯 `data/meshplorer-gateway/configs/config.json` 來設定機器人參數。\n\n**主要設定項目**：\n- 工作頻道和加密金鑰\n- 緊急守護頻道設定\n- 忽略的節點 ID 清單\n- 日誌等級設定\n\n## 參與貢獻\n\n如果您有功能請求或發現錯誤，請在 GitHub 上[開啟 issue](https://github.com/NFS-TW-Developer/MeshPlorer/issues)。\n\n## 法律聲明\n\nThis project is not affiliated with or endorsed by the Meshtastic project.\n\nThe Meshtastic logo is the trademark of Meshtastic LLC.\n\n## 倉儲狀態\n![Alt](https://repobeats.axiom.co/api/embed/8c088057ec39162a448d66f0e68e42274a7c4bfb.svg \"Repobeats analytics image\")\n\n## 相關專案\n\n- [MeshSight](https://github.com/NFS-TW-Developer/MeshSight)：節點地圖視覺化\n\n## 參考資料\n\n- https://meshtastic.org/docs/software/integrations/mqtt/mqtt-python/\n- https://github.com/meshtastic/protobufs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfs-tw-developer%2Fmeshplorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnfs-tw-developer%2Fmeshplorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfs-tw-developer%2Fmeshplorer/lists"}