/showfolio-slim
你打造了它。現在展示它。你自己製作整個影片—故事、視覺、音訊、渲染—使用機器上既有的工具。
無論風格如何,它都應該感覺像一個現代、流暢、精美的展示影片:畫面上或配樂中沒有任何不該存在的東西。每支影片都呈現一個 由 Octacer 打造的 專案(請參閱下方的「Octacer 品牌框架」)。
用法:/showfolio-slim [輸入] [選項]。選項(旗標或自然語言):
| 選項 | 預設值 |
|---|---|
--tone <預設或自由形式> | 推斷;若無明確符合則為 default |
| `--format landscape | vertical |
--duration <秒> | 在步驟 0 詢問(約 40、60 或 90 秒) |
將輸出寫入目前目錄下的 showfolio-output/(如果已存在則加上時間戳記 showfolio-output-YYYY-MM-DD-HHmmss/)。將所有中間檔案(影格、下載、腳本、音軌)保留在內部的 work/ 子資料夾中。
0. 輸入
在開始任何事前,先以一則訊息向使用者詢問三個問題,然後等待回答。你可以先快速瀏覽路由或頁面列表,以便問題 2 能提供實際選項。跳過已在調用中回答的任何問題。
- 長度: 影片大約應該多長?~40 秒、~60 秒、~90 秒,或使用者自訂的數字。如果他們沒有回答,則使用 60 秒並告知。
- 要展示什麼: 哪些功能或頁面必須出現在影片中?列出你找到的主要項目。請他們標記最引以為傲的那個;它會獲得最多的螢幕時間。
- 目的: 用一句話說明,這個專案是做什麼的?
每個必展示項目都有自己的場景。最喜歡的項目獲得最長的片段和最強的時段。目的句是故事和分享文案的主軸。如果命名的功能在程式碼中不存在,或者目的與程式碼實際功能矛盾,請說明。
登入檢查。 然後判斷要顯示的頁面是否位於登入之後(登入路由、認證中介軟體或路由守衛、認證函式庫如 NextAuth、Clerk、Supabase、Firebase、Auth0、Passport、Devise)。如果是,則取得測試憑證:
- 使用者已提供 → 使用它們。
- 否則在儲存庫中尋找示範或測試帳戶:README 或文件(「demo account」、「test user」)、種子腳本和固定資料、端對端測試登入輔助函式、
.env.example。絕不打開真實的.env檔案、金鑰或 secrets 資料夾。如果找到,告訴使用者是哪個帳戶和在哪裡找到的,並確認這是安全的測試帳戶。 - 什麼都沒找到 → 向使用者要求測試帳戶以及應用程式執行的 URL(本機或 staging),並告知這僅用於登入和擷取畫面。
如果他們不想分享,則用虛構資料從程式碼重建登入後的畫面。
如果無法連線到應用程式(沒有可解析的 URL,或者在本機執行會影響共享或生產資料庫),則不要執行它。使用儲存庫中已有的真實螢幕截圖(docs、README、設計資料夾)作為產品圖層,並仍然讓它們具有互動性。在每個螢幕截圖的實際輸入框上方放入複製的輸入元件。對於懸停狀態,複製游標下的卡片或按鈕的裁切副本。像應用程式會做的那樣滑入面板並滑出結果。隨著狀態變化在連續的螢幕截圖之間切換。告訴使用者你使用了哪個來源。憑證僅在無頭瀏覽器工作階段中使用。透過環境變數傳遞它們,絕不寫入任何檔案,也絕不在畫面上顯示。影片中的登入畫面顯示一個虛構的電子郵件和一個遮罩的密碼,而真實的使用者資料則按照以下規則處理。
模糊,不要丟棄。 如果重要的畫面顯示真實的個人資料(電子郵件、姓名、電話號碼、頭像、客戶記錄),保留畫面並僅模糊那些地方:在文字稍大的框上使用強高斯模糊(在 1080p 下約 8–12px),使其即使在放大時也無法讀取。僅當隱私資料就是內容且模糊後沒有任何用處時,才丟棄畫面。在每個影格中模糊相同的位置,包括縮放和平移過程中。已經使用佔位符或虛構資料的螢幕截圖不需要模糊。
1. 檢查
首先判斷輸入是什麼,然後從中收集素材。只有來源會改變;從以下問題開始的所有內容對每個輸入都相同。仔細閱讀步驟 0 中的必展示功能。
| 輸入 | 如何識別 | 素材來源 |
|---|---|---|
| 專案 | 沒有給定輸入,且目前目錄是一個專案 | 程式碼 |
| 網站 | 一個 http(s):// URL,或一個裸網域如 example.com | 即時網站 |
如果輸入不符合任何類型,或者沒有輸入且目前目錄不是一個專案,請詢問使用者要展示什麼。
專案
閱讀程式碼:主頁面、樣式(確切的顏色和字型)、README、路由和關鍵元件。最好的素材是使用中的產品—找到它的節奏:每個必展示功能的進入 → 關鍵操作 → 結果。
你擁有原始碼,所以直接使用它:將專案的真實元件、樣式表、字型、圖片和動畫匯入或渲染到影片中,而不是重建它們。對於需要登入的頁面,執行應用程式並使用步驟 0 的測試憑證登入,以擷取真實的登入後畫面。
網站
以訪客看到的樣子取得網站。許多網站使用 JavaScript 建構頁面,因此單純的下載可能會回傳一個幾乎空白的殼。如果是這樣,請在無頭瀏覽器中載入頁面以取得渲染後的結果。關閉 cookie 橫幅和其他覆蓋層,並逐段滾動,因為在滾動時才會動畫出現的內容在單次全頁擷取中會保持空白。使用步驟 0 的測試憑證登入以存取登入後的頁面。
- 文案: 標題、標語、章節標題、功能名稱、行動呼籲、推薦。也檢查 title、meta description 和社交預覽標籤。
- 識別: 來自網站 CSS 的確切顏色和它載入的字型。
- 視覺: 標誌、產品螢幕截圖、英雄圖片、示範影片。將你要使用的下載到
work/中。 - 螢幕截圖: 以影片的長寬比擷取頁面以了解佈局。在影片中,重複使用網站的真實標記、CSS 和素材並對它們進行動畫處理,而不是在平面螢幕截圖上平移。
- 使用中的產品: 檢查示範影片、運作方式章節和連結的文件,以了解進入 → 關鍵操作 → 結果流程。
然後,對於每個輸入
在規劃之前,回答:這是什麼(一句話,從使用者的目的句開始)?它是為誰而設,為他們做什麼?它的與眾不同之處是什麼?最令人印象深刻或最有趣的主張是什麼?視覺鉤子是什麼?哪個真實的 UI 或流程展示了每個必展示功能?適合什麼風格?一句話的分享標題是什麼?
Octacer 品牌框架
影片有兩個永不混合的圖層。產品圖層是專案真實的畫面、UI、文案和資料,使用專案本身的顏色和字型,保持不變。Octacer 框架是圍繞在它們之間和周圍的一切:舞台背景、標題、標題、功能標籤、轉場、片頭、片尾和角落標誌。
- 色板(固定): 舞台墨水色
#040408,面板色#0b0e14,髮絲邊框rgba(255,255,255,0.10),可選的精細網格rgba(255,255,255,0.05),資訊用白色#FFFFFF,標籤用淡色rgba(255,255,255,0.65),萊姆色#A3DC2F(亮色#BBEF44)作為訊號色。沒有其他色調。萊姆色上的文字總是#040408。 - 萊姆色有含義: 活動狀態、驗證勾號、小的點擊漣漪、目前功能區段、進度填充。產品畫面上的東西周圍沒有萊姆色框;游標和縮放負責指示。永遠不要將其用作裝飾:沒有發光、斑點、發光點或水洗效果。
- 字型: Space Grotesk 粗體用於標題和功能名稱,Montserrat 用於內文和標題,JetBrains Mono 大寫加上
0.14em字元間距用於眉標(FEATURE 02 · DOCUMENT READER)。三者都在 Google Fonts 上。如果已安裝 /showfolio 技能,其assets/brand/fonts/中有自行託管的版本。 - 標誌: 始終是這個 SVG。絕不使用字型拼寫「octacer」,重新繪製,重新著色或添加效果。路徑 1 是萊姆色標記,同時充當「O」。路徑 2–7 是字母 C-T-A-C-E-R。對於角落標誌,單獨使用路徑 1 搭配
viewBox="0 0 29 28"。
<svg width="170" height="28" viewBox="0 0 170 28" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M17.9411 26.5149C16.793 26.8285 15.5839 27 14.3328 27C11.9515 27 9.71789 26.3893 7.78272 25.3239L14.3328 8.39238L19.7575 25.8763C24.4208 23.8505 27.6733 19.2966 27.6733 14.0001C27.6733 6.82026 21.7005 1 14.3328 1C6.96495 1 0.992188 6.82032 0.992188 14.0001C0.992188 18.1696 3.00904 21.878 6.14118 24.2568" stroke="#A3DC2F" stroke-width="1.5" stroke-miterlimit="10"/>
<path d="M35.7461 13.9987C35.7461 6.79727 41.2824 1 49.0918 1C53.8214 1 57.9645 3.37658 60.0911 7.04919L58.3678 8.02135C56.6813 4.92475 53.1249 2.83627 49.0918 2.83627C42.3456 2.83627 37.6893 7.80533 37.6893 13.9986C37.6893 20.1917 42.3456 25.1607 49.0918 25.1607C53.1615 25.1607 56.7546 23.0362 58.4412 19.8676L60.1643 20.8399C58.0745 24.5486 53.8949 26.9971 49.0919 26.9971C41.2824 26.9974 35.7461 21.2002 35.7461 13.9987Z" fill="white"/>
<path d="M80.1452 2.80037H72.079V26.2051H70.0994V2.80037H62.0332V1H80.1452V2.80037Z" fill="white"/>
<path d="M97.1224 19.7958H84.2534L81.7602 26.2051H79.707L89.6796 1H91.7328L101.669 26.2051H99.6155L97.1224 19.7958ZM96.4259 17.9954L90.7062 3.34047L84.9867 17.9954H96.4259Z" fill="white"/>
<path d="M103.025 13.9987C103.025 6.79727 108.562 1 116.371 1C121.101 1 125.244 3.37658 127.37 7.04919L125.647 8.02135C123.961 4.92475 120.404 2.83627 116.371 2.83627C109.625 2.83627 104.969 7.80533 104.969 13.9986C104.969 20.1917 109.625 25.1607 116.371 25.1607C120.441 25.1607 124.034 23.0362 125.721 19.8676L127.444 20.8399C125.354 24.5486 121.174 26.9971 116.371 26.9971C108.562 26.9974 103.025 21.2002 103.025 13.9987Z" fill="white"/>
<path d="M146.801 24.4046V26.205H132.025V1H146.618V2.80037H133.969V12.5944H145.701V14.3948H133.969V24.4048L146.801 24.4046Z" fill="white"/>
<path d="M161.614 15.8708H153.511V26.205H151.568V1H161.688C165.867 1 169.277 4.34867 169.277 8.45347C169.277 11.8742 166.894 14.7548 163.631 15.6189L170.01 26.205H167.774L161.614 15.8708ZM153.511 14.0706H161.688C164.804 14.0706 167.334 11.5501 167.334 8.45347C167.334 5.32083 164.804 2.80037 161.688 2.80037H153.511V14.0706Z" fill="white"/>
</svg>
- 片頭標記(1.5–2.5 秒,計入時長): 墨水色舞台。萊姆色標記逐漸繪製(
pathLength="1",動畫化stroke-dashoffset1→0)。然後字母以 40–60 毫秒的間隔依序浮現或淡入。保持約 0.5 秒,然後顯示鉤子。沒有光暈、粒子或發光效果。 - 功能區段: 框架字型中的眉標和功能名稱。真實畫面在面板色的瀏覽器或裝置框架內播放,帶有髮絲邊框,居中於墨水色背景上。標題位於畫面外部。
- 角落標誌: 標記,右下角,約寬度的 6–9%,邊距約寬度的 3%,在產品場景期間保持 70–85% 的不透明度。
- 片尾(3–5 秒): 專案名稱 → 完整 Octacer 標誌 →
Built by Octacer(淡色 Montserrat),可選的octacer.com使用 JetBrains Mono。對於行動呼籲,僅使用 Map Your System。 - 風格永不改變框架: 風格僅設定節奏和文案能量。若無指定風格,偏好
polished或app-store。 - 不虛構 Octacer 主張: 沒有客戶名稱、數字、獎項或推薦。僅「Built by Octacer」、專案本身的事實和使用者的目的句。
2. 規劃
編寫 showfolio-plan.md:輸入答案(長度、必展示列表(標記最喜歡的)、目的,以及如何處理登入(絕不包含憑證本身))、切入點、鉤子、每個必展示功能一個區段、妙句、風格、視覺識別,以及逐場景分鏡腳本(時長總和為目標長度)。
如果使用者指出某個部分—新版本、新功能、某個切入點—讓這成為影片的焦點。
形狀: Octacer 標記(1.5–2.5 秒)→ 鉤子(3–5 秒)→ 目的/揭示(4–8 秒)→ 每個必展示功能一個區段(每個 6–15 秒;最喜歡的獲得最長)→ 片尾含 Octacer 標誌(3–5 秒)。一個起始形狀,而非範本。
創意法則
- Octacer 框架,真實產品。 產品的畫面保持完全原樣。它們周圍的一切都是 Octacer:色板、字型、SVG 標誌、開頭的標誌標記,以及結尾的「Built by Octacer」。
- 使用者要求的長度。 在步驟 0 的目標 ±10% 範圍內。用產品而非填充內容來填滿它:每個功能流程的更多內容,絕非對空畫面更久的停留。
- 展示他們要求的內容。 每個必展示項目都有自己的場景;最喜歡的獲得最多時間。
- 對陌生人來說要清晰。 看過一次後,從未聽過它的人都知道它做什麼、為誰設計以及如何取得。以此為開頭,而不是如何構建。
- 鉤子就是一切。 前 2 秒決定是否有人繼續觀看。先規劃它。
- 展示事物本身。 重複使用來源中的真實事物—其 UI、元件、文案、圖片、影片和動畫—而不是重新創建它。僅重建無法重複使用的部分。偏好運行的應用程式完成其工作,而非解釋它的登陸頁面。當展示產品使用時,使用小的說明性 UI 文字是可以的(檔案名稱、「已匯出」的提示);不允許虛構的主張、數字或推薦。絕不抽象填充。
- 具體。 它必須感覺是為這個確切的專案製作的。使用其自己的文案和主張;沒有通用的 SaaS 語言(禁止使用「簡化您的工作流程」)。
- 可讀。 節奏來自動作和剪輯,而不是過早移開文字。任何讀者應該閱讀的文字行都必須完全可見且穩定足夠長的時間以供閱讀(大約每個詞 0.3 秒),從整行在畫面上時開始計算。僅作為紋理的文字不需要閱讀。
- 讓它活起來。 一個接一個出現的事物….(原文截斷)