Initial commit.

README.md

@@ -0,0 +1,60 @@
+# 維基國際短訊 自動化
+
+每週自動產生維基媒體運動「國際短訊」，用本機 `mail` 寄給秘書長過目、篩選後採用至月訊。
+台灣維基媒體協會用。
+
+短訊的**產生規則**（來源、挑選、翻譯、格式、收件人、寄送方式）全部寫在 `wmtw-briefs.md`，
+本文件不重複，只談簡介、部署與維護。
+
+運作方式：cron 每週觸發一次 Claude Code headless（`claude -p`），把 `wmtw-briefs.md` 當提示
+餵進去，它讀 wikimedia-l 過去七天內容、產繁中純文字短訊、用本機 `mail` 寄出，全程無人工介入。
+用訂閱登入憑證執行，不另計付費 API。
+
+## 部署
+
+### 前置需求
+
+執行 cron 的主機需具備：
+
+- **Claude Code CLI**，且已用會員帳號 `/login` 過（headless 才有訂閱憑證、不另計費）；
+  cron 須掛在這個已登入的使用者底下。
+- **本機 mail**（如 exim4／sendmail，免 SMTP 認證即可送出）。
+- **locale `zh_TW.UTF-8`**（中文主旨與內文才正常）。
+
+### 步驟
+
+部署位置（系統路徑、crontab）為固定處所，以下用絕對路徑；其餘指涉本專案檔案處皆用相對路徑。
+
+1. 把指示檔放到系統位置：
+
+   ```
+   sudo cp wmtw-briefs.md /etc/wmtw-briefs.md
+   ```
+
+2. 找出 claude 執行檔的完整路徑（cron 的 PATH 很精簡，必須寫完整路徑）：
+
+   ```
+   command -v claude
+   ```
+
+3. 在**已登入會員帳號的使用者**底下 `crontab -e`，加入下列一行
+   （把 `<claude完整路徑>` 換成上一步結果）：
+
+   ```
+   0 18 * * 1 <claude完整路徑> -p "$(cat /etc/wmtw-briefs.md)" --allowedTools WebFetch Bash >> /tmp/wmtw-briefs.log 2>&1
+   ```
+
+   - `0 18 * * 1`：每週一 18:00，可自行調整時段。
+   - headless 放行的工具：`WebFetch`、`Bash`。
+   - 收件人寫在 `/etc/wmtw-briefs.md` 裡，不在 crontab。
+
+## 維護
+
+- **改產生規則或收件人**：編輯部署後的 `/etc/wmtw-briefs.md`，不必動 crontab。
+- **沒收到信**：查 crontab 導向的 log；確認郵件佇列沒卡（`mailq`）；
+  確認 claude 訂閱憑證未過期（在該使用者底下重跑互動式 `claude`，若要求重新登入即為過期）。
+- **中文亂碼**：檢查 crontab 那行有沒有帶 `LANG=zh_TW.UTF-8`。
+- **內容偏少**：wikimedia-l 某些週本來就稀疏，指示檔已交代據實產短、不硬湊，屬正常。
+- **上線前測試**：複製一份指示檔、把收件人改成自己（勿寄秘書長），手動跑
+  `<claude完整路徑> -p "$(cat <測試指示檔>)" --allowedTools WebFetch Bash`，
+  確認中文、純文字排版與內容無誤後再正式啟用。