Lolly
啟動應用程式

建立設計與範本

瀏覽器擴充功能

網頁無法讀取另一個網站的像素,所以 Lolly 網頁應用程式需要協助才能對頁面截圖。在 Chromium 系列瀏覽器(Chrome、Edge、Brave、Arc 或 Opera,Chrome 111 起)中,免費的 Lolly URL Screenshot 擴充功能提供這項協助,使用與桌面應用程式相同的擷取。安裝後:

每個請求都由你核准,而桌面應用程式在沒有擴充功能的情況下也能完成相同的工作。

安裝之前

在安裝擴充功能之前,Lolly URL Screenshot 仍會開啟,所以你可以編排截圖。工具控制項頂端的備註會說明缺少什麼。

URL Screenshot 工具的提示,提供擴充功能的安裝選項,會在擷取到檔案沒有可執行的主機時顯示 signed by Lollyvector SVG4 paths~2.4k nodes4 groups30 KBCheck it yourself取得已簽署檔案URL Screenshot 工具的提示,提供擴充功能的安裝選項,會在擷取到檔案沒有可執行的主機時顯示 signed by Lollyvector SVG4 paths~2.4k nodes4 groups30 KBCheck it yourself取得已簽署檔案

等待期間,每個控制項都能運作:目標 URL、捲動深度、穩定延遲、裁切內縮與重新著色。只有擷取本身需要擴充功能。

Lolly URL Screenshot 的控制項,包含目標網址、捲動深度、穩定延遲與裁切內縮,在擴充功能存在之前全部都可以使用 signed by Lollyvector SVG31 paths~1.7k nodes38 groups30 KBCheck it yourself取得已簽署檔案Lolly URL Screenshot 的控制項,包含目標網址、捲動深度、穩定延遲與裁切內縮,在擴充功能存在之前全部都可以使用 signed by Lollyvector SVG31 paths~1.7k nodes38 groups30 KBCheck it yourself取得已簽署檔案

安裝

從 Chrome 線上應用程式商店:即將推出。擴充功能發布後,一鍵即可安裝。

自行載入(開發者)。 擴充功能的原始碼位於儲存庫的 shells/chrome-extension/。打包步驟會從該資料夾建出正式版套件,僅適用於位於 https://lolly.tools 的 Lolly。

  1. 執行 pnpm run pack:chrome-extension。它會把套件建置到 dist/chrome-extension/。
  2. 開啟 chrome://extensions。
  3. 開啟 Developer mode(右上角)。
  4. 點擊 Load unpacked 並選擇 dist/chrome-extension/ 資料夾。
  5. 重新載入 Lolly 分頁。偵測在頁面載入時發生,所以「Get the extension」提示會消失。Lolly URL Screenshot(在 Utilities 下)隨後就能將擷取內容儲存到檔案,並可在 Lolly Batch 模式中使用。

如果要連接本機開發伺服器,請執行 pnpm run pack:chrome-extension:dev,改為載入 dist/chrome-extension-dev。該套件也接受 http://localhost:5173,其名稱中帶有 Development。

直接載入 shells/chrome-extension/ 資料夾本身也可以,用於 PNG 螢幕截圖。該資料夾沒有頁面走訪(打包步驟會把它建入),所以由它產生的 SVG 含有的是一張螢幕截圖,而不是形狀。

Lolly 提出要求時會發生什麼

Lolly 分頁要求一個頁面,你在擴充功能的核准視窗中按下 Approve once。背景分頁開啟、讀取頁面然後關閉。接著 Lolly 分頁得到結果。Lolly 分頁要求一個頁面,你在擴充功能的核准視窗中按下 Approve once。背景分頁開啟、讀取頁面然後關閉。接著 Lolly 分頁得到結果。Open this in Diagram Builder

  1. Lolly 提出要求。 一個小指令碼告訴 Lolly 擴充功能存在,所以不需要進一步設定就能開始擷取或讀取頁面。
  2. 你核准。 擴充功能開啟它自己的 Approve page request 視窗。它顯示提出請求的網站、它要的是螢幕截圖還是頁面內容,以及頁面位址。在你按下 Approve once 之前不會讀取任何內容。Cancel 或關閉視窗會結束請求。
  3. Chrome 每個網站詢問一次。 你第一次核准某個網站的請求時,Chrome 也會詢問擴充功能是否可以存取該網站。一旦你允許,Chrome 就會保留該存取權,但之後的每個請求仍需要各自的 Approve once。
  4. 頁面在背景分頁中讀取。 擴充功能在背景分頁中開啟目標頁面,透過 DevTools Protocol 擷取它(與桌面應用程式使用的 Page.captureScreenshot 相同),關閉分頁,並把結果交還給提出要求的 Lolly 分頁。

對於 SVG,擴充功能是走訪頁面,而不是拍攝螢幕的圖片。隨擴充功能打包的一段指令碼會在那個背景分頁中讀取頁面的版面,並把頁面變成形狀與轉外框的文字,所以檔案在任何尺寸下都保持清晰,每個部分也都保持可編輯。頁面上的圖片會以原本的圖片帶入;頁面以畫布、影片或 SVG 無法表達的效果所繪製的內容,則複製自同一時刻的螢幕截圖。Lolly 會拿結果與該螢幕截圖比對,當兩者差異過大時,SVG 改為放入螢幕截圖。

為了以頁面自己的字體將文字轉外框,擴充功能會把頁面載入的字型檔案交給 Lolly。Chrome 不會把字型的位元組保存在擴充功能能讀取的地方,所以擴充功能會再向頁面要求每個字型一次。你的瀏覽器通常會從快取回應,而頁面自己的安全政策仍然適用於該請求。

一次核准涵蓋一個請求,並在 30 秒後過期。一次只能有一個請求等待或執行,而已核准的請求會在 55 秒後停止。如果 Lolly 頁面關閉或改變,或目標頁面移到另一個網站,請求就會被取消。

擷取在你的瀏覽器、你的網路上執行,所以 localhost 與內部網站可以使用。頁面以你的瀏覽器工作階段載入,所以你已登入的頁面可能在結果中顯示私人資訊。擷取內容不會上傳:唯一的網路流量是你自己的瀏覽器載入你所要求的頁面,加上(針對 SVG)再載入一次該頁面的字型檔案。

擷取執行時,你可能會在暫時分頁上短暫看到 "…started debugging this browser" 橫幅。那是 DevTools Protocol 在運作,橫幅會在截圖完成時消失。

為 Lolly Design System Setup 讀取網站

Lolly Design System Setup 中的 Website 來源會從你已有的網站開始建立設計系統。在 Chromium 瀏覽器中,由擴充功能讀取頁面。在桌面應用程式中,由應用程式自行擷取頁面。在沒有擴充功能的瀏覽器中,不提供 Website 圖塊。

貼上位址只會填入欄位。在你開始讀取並按下 Approve once 之前不會讀取任何內容。

權限

擴充功能的 manifest.json 宣告了四項權限,外加一次對一個網站要求的網站存取。它設定 minimum_chrome_version: 111,目前版本為 0.5.0。

權限用途何時授予
debugger透過 DevTools Protocol 驅動背景分頁,由它擷取螢幕截圖,並在 SVG 時執行頁面走訪。安裝時
tabs開啟暫時的背景分頁並在事後關閉,並檢查自你核准後 Lolly 頁面與目標頁面是否都沒有移動。安裝時
scripting為 Website 來源,在你指定的網站內執行單頁讀取器。安裝時
storage只在工作階段儲存空間中記下它所開啟分頁的 id,讓瀏覽器在讀取中途暫停擴充功能時,該分頁仍會關閉。下次啟動時清除;不儲存任何關於你的資料。安裝時
optional_host_permissions: ["http:///", "https:///"]網站存取,安裝時不授予。當你按下 Approve once 時,擴充功能會向 Chrome 要求存取該請求中的那一個網站。你第一次核准該網站的請求時,在 Chrome 詢問你之後

擴充功能只讀取你核准的那一個頁面。它不會讀取或傳送你的瀏覽資料,也不會上傳任何內容。

疑難排解