NOTE123

跟著目前檔案切換的 Markdown 筆記側欄，支援檔案／資料夾共享、LaTeX、程式碼、圖片、內嵌畫布與 YouTube 影片。

開始使用

開啟一個已儲存的檔案，點選左側 NOTE123 圖示，再按 ＋ 新增筆記。頂部顯示的是目前檔名；切換檔案，只會看到連結或共享到該檔案的筆記。筆記自動儲存，不會修改你的原始程式檔。筆記條只顯示修改時間，建立時間仍保留在內部紀錄與備份中。

滑鼠移到筆記條上，可展開／收合、下載備份或刪除。筆記條右側的齒輪會在這篇筆記內開啟設定，不遮住其他筆記；未展開時會自動展開，再按同一個齒輪即可關閉設定，關閉時不會收合筆記。可以修改名稱、選擇六種固定筆記條顏色，以及調整連結與共享。

外層留白、筆記內距、欄位、按鈕與圖示沿用「快速評測系統」的設計。一般側欄縮放只調整可用寬度，不縮小檔名字級；超長檔名會截斷顯示。

編輯與畫布

工具列依序提供粗體、斜體、底線、刪除線、圖片、YouTube、畫布、返回、前進及重新整理。「編輯／預覽」可切換 Markdown 原文與渲染結果。內容高度隨行數立即增加或縮減，輸入時不套用高度動畫；使用筆記清單捲動，不另外限制文字區塊的垂直高度。滾動條軌道不顯示。

支援 $...$ 行內 LaTeX、$$...$$ 區塊公式、程式碼區塊、表格與清單。LaTeX 使用隨套件提供的 MathJax SVG 引擎，可離線運作。手寫公式辨識已移除；沒有辨識工具列、輸入視窗、API 設定或辨識請求。升級時只會非阻塞地清理舊版留下的辨識服務金鑰。

圖片可從本機選取，或從 HTTPS 連結下載後嵌入筆記；可以指定寬高及維持比例。圖片的尺寸設定不影響畫布。

畫布直接放在筆記預覽內書寫：靠近畫布左側時，紅、黃、藍、黑四色、橡皮擦及左下粗細拉桿會一起顯示；移開後一起隱藏。畫布上的游標是依畫筆大小顯示的中空圓框。高度固定 178 CSS px，寬度隨筆記內容區調整；沒有調整畫布尺寸或另開畫布編輯視窗的按鈕。靠近右下角才顯示垃圾桶，刪除的是這張畫布附件，不是整篇筆記。工具列返回／前進可復原筆跡及附件刪除。

新版筆跡使用 CSS 像素座標；側欄變窄只裁切可見範圍，不縮放筆跡與粗細，重新拉寬可看到原本被遮住的部分。一般側欄縮放不改寫畫布點陣尺寸；需要增加背後繪圖範圍時，先在離屏緩衝完成重繪再一次顯示，避免空白閃爍。舊版筆跡依最後保存圖片的比例進行一次座標轉換，之後不再跟著側欄縮放。自動儲存不重建正在操作的畫布。滑鼠滾輪位於畫布、留白或工具列時，捲動的是筆記清單，不會被畫布攔截。

YouTube

插入功能只接受 YouTube 影片連結，包含一般 watch、youtu.be 短連結、Shorts、live 與 embed；支援連結內的開始時間。一般網站不能再嵌入。舊筆記中的 YouTube 附件會轉成影片；其他舊網站保留為外部連結，不會因升級而丟失 URL。

影片先顯示佔位卡片，按 載入影片 才建立播放器。最多同時載入兩個；載入第三個會卸載最早的一個。收合筆記、進入筆記設定、切換檔案、隱藏側欄或離開可視區域也會卸載。重新載入不保留先前播放位置。播放器至少需要 200 px 可用寬度；側欄過窄時請加寬，或使用 在瀏覽器播放。播放器內的互動由 YouTube 管理，其他區域仍捲動筆記清單。

為處理 Webview 缺少來源資訊導致的 153 錯誤，外掛會按需啟動僅監聽 127.0.0.1 的本機播放器頁面，透過真正的 HTTP 文件、strict-origin-when-cross-origin 及匹配的 origin 建立 YouTube iframe。隨機路徑權杖限制頁面存取；服務不提供筆記內容、不代理影片、不偽造第三方來源、不對區域網路開放，隨擴充功能停用或 VS Code 結束關閉。影片及播放器資源直接向 YouTube 取得。

這不會繞過影片擁有者的禁止嵌入、私人／已刪除影片、登入要求、網路或組織政策。播放器封面或介面出現只代表載入，不代表影片能播放。這版分開追蹤 ready、播放時間進展、緩衝與實際錯誤碼；長時間緩衝沒有開始播放會明確提示。當 VS Code 內嵌播放器失敗時，不會把失敗畫面冒充成播放成功。在瀏覽器播放 會在使用者按下後，透過系統預設瀏覽器開啟同一個本機播放頁；若影片禁止嵌入，改提供 在 YouTube 開啟。

VS Code Webview 的媒體編解碼支援與一般瀏覽器並不完全相同，也不能繞過 YouTube 的來源驗證、影片禁止嵌入或登入限制。此版修正 iframe 與 IFrame API 的 host 一致性、播放狀態及失敗處理，但沒有保證所有 YouTube 影片都能在側欄內播放。開發環境驗證了 HTTP 頁面、API 事件模擬、來源／nonce 驗證及瀏覽器啟動指令；尚未完成 Windows VS Code 內的真實影片播放測試。

YouTube 官方參考：

• IFrame API 錯誤代碼
• 嵌入播放器的來源資訊要求

共享、重新連結與刪除提醒

頂部齒輪分成 基本設定 與 筆記概覽。

基本設定可指定目前檔案往後新增的筆記：只在自己顯示、共享至同層資料夾、或共享至指定檔案／資料夾。資料夾預設不包含子資料夾，可個別開啟遞迴共享。這些預設不會重設現有筆記的共享規則。

筆記概覽列出此儲存區的筆記與連結，可直接按 共享至目前檔案，或使用紅色 刪除 按鈕移除筆記；此處也遵循全域刪除提醒選項。全域設定檔案列的括號筆記數持續顯示並同步更新。失去原檔案時，使用基本設定的重新連結功能指定新目標。透過 VS Code 重新命名或搬移檔案會更新連結；在 VS Code 外移動檔案，需手動重新連結。

共享的是同一份筆記，不是複製品。同一使用者儲存區的多個 VS Code 視窗透過檔案監聽同步；同時修改遇到版本衝突，會保留本機草稿並提示處理，不靜默覆寫。

開啟刪除筆記提醒 預設開啟。關閉後刪除不再彈出確認；刪除仍會移除這篇筆記在所有共享位置的顯示。確認視窗包含「(若不想看到此視窗可至設定關閉)」。刪除不會改動連結的原檔案，亦不會刪掉你已下載的筆記備份。

備份與相容性

單篇下載為 .vnote.json，包含 Markdown、名稱、顏色、檔案連結、共享規則、時間、圖片、筆跡與影片設定。匯入會建立新筆記 ID，避免覆寫既有內容。換電腦後原路徑不一定存在，請視需要重新連結；分享備份前，請確認內文及路徑沒有敏感資料。

本版維持 mikehung.file-notes-system 與既有筆記資料格式／位置，不另外安裝第二套插件。舊自訂筆記條顏色會對應至最接近的固定色。資料位於擴充功能的 globalStorageUri/notes，不寫入工作區原始檔案；不會自動跨電腦或使用者設定檔同步。

單張圖片上限 8 MB，單篇筆記上限 32 MB，每篇最多 300 個附件。一般本機筆記不會自動上傳。下載網路圖片、開啟 YouTube 時才會發生相應的網路連線。

支援桌面版 VS Code 1.90 以上。未儲存的 Untitled 文件需要先儲存。NOTE123 在本機 UI 擴充功能程序運作，可連結透過 VS Code Remote 開啟的檔案。受限制工作區可讀寫本機筆記；載入 YouTube 或下載網路圖片需要受信任的工作區。