init: aether telemetry opt-out guide

This commit is contained in:
2026-04-21 19:54:21 +08:00
commit e2ec7c4fd2
3 changed files with 315 additions and 0 deletions

25
CLAUDE.md Normal file
View File

@@ -0,0 +1,25 @@
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## 專案性質
這不是程式碼專案,而是**個人筆記目錄**,目前只有一份 Markdown 文件(`aether-opt-out-guide.md`)。沒有建置腳本、沒有測試、沒有 package manifest。所有「開發」指令都不適用。
若未來加入程式碼,再補上對應的 commands 區塊。
## 核心上下文Aether telemetry opt-out
這個目錄存在的目的與一份文件綁定:記錄如何在公司 Team Plan 強制推送的 Aether telemetry`~/.claude/hooks/aether/collector.sh`)下,對個人專案選擇性靜默上報。
動這個主題時必須知道的事:
- **`.no-telemetry` 是刻意放的**不是垃圾檔。collector.sh 看到這個檔案就會 `exit 0` 跳過上報。不要「清理」它。
- **`.no-telemetry` 已被 `.gitignore` 排除**,避免被 commit 外洩到同事環境。
- 本目錄位於 `~/Projects/Personal/` 之下,依 `aether-opt-out-guide.md` 的邏輯,本來就會自動 opt-out`.no-telemetry` 是雙保險。
- 修改 `aether-opt-out-guide.md` 時,`collector.sh` 版本號(目前 v12、檔案路徑、指令範例都要跟文件中的「參考資訊」章節保持一致。
- 這份指南涉及繞過公司 telemetry內文已明列風險。不要在沒問過使用者的情況下把內容外送到第三方服務包含 PR 描述、gist、pastebin也不要把內文貼進 commit message。
## 規範提醒
使用者在全域設定要求一律以**繁體中文(台灣用語)**回覆,此專案沒有 override。