newcitylisted

# Newcity 社區查詢 透過 Newcity 物業 app 的後端 API（`https://www.itlife.com.tw/NewcityWebApi/api`）查詢使用者的 信件與社區點數。底層是一支以 `uv` 執行的子指令 CLI `scripts/newcity.py`，共用的登入/身分解析邏輯 放在 `scripts/newcity_client.py`。本 skill 負責在正確的前提下執行它並回報結果。 ## 何時用 - **信件**：查社區/大樓管理室代收的信件、包裹是否到了、要不要去領。 關鍵詞：未領信件、待領信件、已領信件、有沒有我的包裹。 - **點數**：查社區剩餘點數餘額、點數有效期。 關鍵詞：剩餘點數、社區點數、公設點數、點數過期。 - **公告**：查社區最新公告（預設未讀），讀取單則內文與附件。 關鍵詞：最新公告、未讀公告、管委會公告、公告內容、公告附件。 - 通用關鍵詞：newcity、itlife、社區 app。 ## 執行方式 腳本在本 skill 的 `scripts/` 下，直接用 `uv run` 執行（依賴由 PEP 723 inline metadata 自動安裝）： ```bash # 查未領信件（預設） uv run ~/.claude/skills/newcity/scripts/newcity.py mail # 查已領信件 uv run ~/.claude/skills/newcity/scripts/newcity.py mail --status 2 # 查社區剩餘點數（總和 + 每筆明細與有效期） uv run ~/.claude/skills/newcity/scripts/newcity.py points # 查未讀公告（預設） uv run ~/.claude/skills/newcity/scripts/newcity.py announcements # 查全部公告、只看前 20 則 uv run ~/.claude/skills/newcity/scripts/newcity.py announcements --status all --limit 20 # 讀取單則公告內文與附件（NO_PU 來自清單），並把附件存到指定目錄 uv run ~/.claude/skills/newcity/scripts/newcity.py announcement PU2026010100001 --save ~/Downloads # 讀取單則公告並順便標記為已讀（badge 會 -1） uv run ~/.claude/skills/newcity/scripts/newcity.py announcement PU2026010100001 --mark-read ``` 子指令與參數： - `mail`：查信件。 - `--status`：`1`=未領（預設），`2`=已領。 - `--page-size`：每頁筆數（預設 50，腳本會自動翻頁取完）。 - `points`：查剩餘點數。印出剩餘點數總和與每筆贈點明細（類別、單筆/剩餘點數、有效起迄日、單號）。 - `--page-size`：每頁筆數（預設 50）。 - `announcements`：查公告清單。 - `--status`：`unread`=未讀（預設），`all`=全部，`read`=已讀。 - `--limit`：只顯示前 N 則