兩種模式
模式 1:檔案參照
指向一個檔案,行號範圍可選:
/note-snippet src/auth.swift:10-25
這會讀取檔案、擷取第 10-25 行、從副檔名辨識語言,並在筆記裡加上來源出處。
模式 2:行內程式碼
直接貼上程式碼:
/note-snippet const token = jwt.sign(payload, secret, { expiresIn: '1h' })
語言會從語法格式辨識 — import、括號、關鍵字、運算子。
註解
在 -- 分隔符後面加上上下文:
/note-snippet src/auth.ts:5-20 -- middleware 重構用的 JWT 驗證邏輯
註解會出現在筆記裡程式碼區塊的下方,說明你為什麼儲存這段片段。
語言辨識
| 來源 | 辨識方式 |
|---|---|
| 檔案參照 | 副檔名(.ts、.py、.swift 等) |
| 行內程式碼 | 語法分析(import、關鍵字、運算子) |
智慧標題
AI 會分析程式碼,產生具描述性的標題(最多 6 個字):
- auth 程式碼會是
JWT Token 驗證 - 自訂 hook 會是
React Auth Hook - 基礎設施會是
Docker Compose 設定
上限
- 每段片段最多 約 50 行
- 較長的片段會被截斷,並標註完整長度
- 較大的程式碼區段,建議改存成檔案