#17 可以連接本機目錄嗎？

可以——而且很強大。 連結一個專案目錄，PenPage 就變成整棵目錄樹的即時編輯器。子目錄、巢狀檔案、AI agent 設定檔——全部雙向同步，自動完成。

兩種連結方式

• 任一資料夾 — 在資料夾上右鍵 → Link Directory，把它連到磁碟上的目錄。
• Directory workspace（🗂️） — 專門用來放本機與網路目錄的獨立工作區，跟你其他筆記分開。（#6 什麼是 Workspace）

兩者都用下面說明的同一套雙向同步機制。

連結整棵目錄樹

File Link 不是連結單一檔案——它連結整個目錄，包含最多 4 層的子目錄。每個 .md 檔變成一個 PenPage 頁面，每個子目錄變成一個巢狀資料夾。

1. 點資料夾上的連結圖示（或右鍵 → Link Directory）
2. 選擇你電腦上的目錄
3. PenPage 掃描整棵樹，顯示子目錄選擇器——選你要包含哪些子目錄
4. 完成——你的目錄樹現在活在 PenPage 裡了

一次連結，收錄整個 AI 專案

這才是重頭戲。連結你的專案根目錄，PenPage 自動發現所有 AI 工具用到的 .md 檔案：

AI 工具	PenPage 自動收錄
Claude Code	CLAUDE.md、.claude/agents/、.claude/rules/、.claude/plans/
Gemini CLI	GEMINI.md 及相關設定
Codex CLI	AGENTS.md 及 agent 定義

一次連結 → agent、rule、plan、skill、prompt——全部在 PenPage 的富文本編輯器裡編輯。AI 即時讀取你的修改。不用複製貼上，不用切換視窗。

完整的編輯-執行-同步工作流程看 #16 AI Coding Agent。

雙向同步

每一個修改都雙向同步——PenPage 到磁碟，磁碟到 PenPage。

事件	結果
在 PenPage 編輯頁面	磁碟上的檔案自動更新
在磁碟上修改檔案	PenPage 下次同步時拉取變更
兩邊都改了	自動分叉——產生兩個版本，不丟失資料
磁碟上的檔案被刪除	頁面移到 Trash
在 PenPage 刪除頁面	磁碟上的 .md 檔被移除

什麼時候同步？

• 切換頁面：當前頁面立即同步
• 切回瀏覽器分頁：所有連結資料夾全面掃描
• 背景：每 60 秒定期掃描
• 手動：右鍵資料夾 → Sync Directory

衝突？ PenPage 永遠不會覆蓋任何一方。如果兩邊都改了，它會產生兩個版本——你自己決定留哪個。

AI 專案模式：當 PenPage 偵測到 .penpage 目錄，檔案修改永遠優先——你的 AI 工具輸出不會被過時的 PenPage 副本覆蓋。

Link Update — 發現新子目錄

連結之後專案又新增了目錄？右鍵點連結的資料夾 → Link Update。PenPage 會掃描新的子目錄並提供連結選項——不需要先取消再重新連結。

Unlink（取消連結）

想斷開連結？右鍵資料夾 → Unlink Directory。

• 頁面保留在 PenPage——不會刪除
• 磁碟上的檔案不受影響
• 只是移除即時同步的連接
• 隨時可以重新連結同一個目錄

智慧去重

PenPage 用內容雜湊防止重複：

• 連結的目錄跟已有頁面重疊？重複的會被偵測並跳過
• 重新掃描時自動找出並清理重複的 .md 檔
• 空的 .md 檔（你從未編輯過的頁面）自動移除

瀏覽器要求

File Link 需要 File System Access API：

瀏覽器	支援
Chrome / Edge（桌面版）	完整支援——推薦
Safari / Firefox	不支援
手機瀏覽器	不支援

你的瀏覽器會記住你授權過的目錄。重啟瀏覽器後，PenPage 會靜默檢查權限——大多數情況不需要重新授權。

如果你只是要寫筆記...

File Link 是為進階使用者和開發者設計的。如果你只是寫筆記：

• PenPage 內建的儲存更簡單也更快
• 想跨裝置看，用雲端同步（#12）
• 想備份，用一鍵儲存/還原（#7）

支援檔案類型

僅 .md 和 .markdown。隱藏檔案（以 . 開頭的）會被跳過。