← 全部的單
GitHub #289 ↗
畫布・功能
讓畫布上什麼檔都放得進來:上傳(或拖進、貼上)之後,圖、PDF、錄音、影片在元件裡就看得到,任何檔都能下載;也能從自己看得到的其他畫布複製一份過來;再拉一條線接到智慧元件繼續做(錄音或影片的聲音轉逐字稿、文件的字給文字生成)。
#289 畫布「檔案」元件:上傳任何格式、預覽、下載、從其他畫布挑、接進智慧元件(第 3.5 波)
狀態
等審查
誰在做
負責人+Claude
做到哪
主體做完,在 PR
#317
(10/04 開,最新推上去的那一版 CI 五個 job 與 Vercel 預覽都綠)。審查者 10/04 要求修改三條(高:很大的 .txt 會整份載進瀏覽器;中:上傳途中畫布變成不能寫,狀態列會一直卡在「上傳中」;低~中:存檔後回收檔案的時間點可能誤收別人剛用的檔)。負責人這邊 10/05 在本機修完三條,推前審查又多抓兩條一起修(aa882157、c05f1f88),10/05 查的時候還沒推上 PR。還差兩塊沒做:文件的字真的送進文字生成(B4c)與告知 v27(B5),要等
#306
合了才做,所以
#317
合了這張也不關。
卡在
合併
#317
:等負責人這邊把本機的修正推上去、審查者重看(他說高那條修了就核准)、負責人本人在
#317
回遷移的「同意」(
#326
列為負責人自己的動作)。關這張:等
#306
(告知 v26 的更正)合進 main,B4c 與告知 v27 才能接在它後面做。
下一步
負責人+Claude 把本機修正推上
#317
,在 PR 上逐條回審查者、並說一聲 Vercel 已恢復(審查者要等這句才重跑閘門);負責人在
#317
回遷移「同意」;PM 宜芳安排重審與合併(負責人 10/05:之後一律先給宜芳看、由她分派)。
#317
合併部署後,由 PM 或測試員照下面的驗收在測試租戶點一遍;
#306
合了之後再開 B4c+告知 v27 的 PR。
提醒:
一、
#317
合了這張也不會關:還差 B4c 與告知 v27,卡在
#306
。
#306
是告知的更正(正式站現在 BFL 訓練條款那一段講錯了),10/03 開到現在還在等審查,建議優先排。二、
#317
的審查狀態:審查者 10/04 要求修改,10/05 再看說「高那條修了就核准」,另外兩條可以另開單;負責人這邊 10/05 本機已經三條一起修、還多修了推前審查抓到的兩條(存檔回收跟上傳搶鎖可能卡死、排隊上傳被擋只看得到最後一個錯誤),但 10/05 查的時候還沒推上去。審查者也說 Vercel 恢復後要有人在 PR 上講一聲他才重跑閘門,目前還沒人講。三、這個 PR 順手改了兩件會讓正式站既有畫面變樣的事:文字框與智慧元件的卡變窄 22/26px、可能多換一行(負責人 10/04 裁);新東西擠滿時改成往畫面外放(PR 標「負責人留意」,沒看到回覆,列在還沒定的)。四、
#289
本文已經過期的地方:「元件上兩顆鈕:下載、放進這張畫布」跟實作不同——「放進這張畫布」在挑檔面板上,元件上只有「下載」(影片多一顆「取這一格」);本文「待定」三題(大小上限、抽字在哪做、出處怎麼記)都已在
ADR-0124
修訂(十)定了,本文沒更新。五、這張的設計寫在
ADR-0124
修訂(十),目前只在 PR
#317
裡,main 上的 ADR 還看不到。六、檔案空間:這張做的是「維持 5 GB+刪掉還空間」;
#326
10/05 已裁之後跟方案綁,由
#302
做——
#302
還掛著「待負責人裁決」標籤,
#297
也一樣,兩張都已在
#326
裁了,標籤可能該拿掉。七、排在這張後面的:
#252
從 Compute 匯入、
#297
送到 Compute、
#298
/
#299
第 3.7 波、
#293
助理部署元件、
#315
案件文件 PDF 預覽;
#278
第 4.5 波與第 5 波文件也要先有這一層。八、畫面上沒有地方看得到機構用了多少空間,「刪掉就還空間」PM 沒辦法自己點來驗,只能靠後端測試。
一步一步 12
已經定的 18
還沒定的 3
怎麼驗收 11
這張不做 11
這張要解決什麼
事務所裡用畫布做案子的人(例如建築師、設計師),以及被分享、只能看的同事
,手上有 PDF 圖說、Word 文件、現場錄音、影片、3D 檔,但今天的畫布只收圖片和錄音(單檔 10 MB),別張畫布上的檔也拿不到,只能下載再上傳——要能 把任何檔放上畫布、在畫布上直接看、需要時下載;從別張畫布拿檔過來;並且直接接到智慧元件繼續做,不用離開畫布
一步一步
12 步
使用者(能編輯這張畫布的人)
打開一張畫布,按左側工具列的「檔案」(原本叫「圖片」,這一版併進來改名)
展開兩個選項:上傳檔案、從其他畫布挑
畫布左側工具列
選取
便條
文字
形狀
檔案(按下去展開)
展開的選單:上傳檔案/從其他畫布挑
生成圖片(機構有開放智慧元件才出現)
手繪
顏色
使用者
按「上傳檔案」選一個或好幾個檔(任何格式);也可以直接把檔拖進畫布、或 Ctrl+V 貼上,一次最多 10 個
系統分流:PNG、JPG、WebP 而且 10 MB 以內的,照舊變成畫布上的一般圖片;其他(更大的照片、PDF、Word、錄音、影片、3D、任何格式)變成檔案元件。左上角顯示「上傳中」與進度。空的檔或超過 500 MB 的不收,原因寫在檔案鈕旁邊;拖進 PDF 不會再讓瀏覽器離開畫布。
上傳中
左上:上傳中:第一個檔名與進度(還有 N 個)
檔案鈕旁邊:放檔案失敗的原因(太大、空的、畫布現在不能寫)
知道了(收掉錯誤)
系統
把每個檔案元件放到畫面上的空位
連著放好幾個也不會疊在一起;看得到的範圍擠滿了,就往畫面外找空位、再把畫面移過去。元件標題列是副檔名、檔名、大小、×;預覽照種類:圖直接顯示,錄音與影片用播放器,PDF 畫在元件裡可以換頁(30 MB 以內自動載、30~100 MB 按了才載、更大的只能下載),Word 與文字檔顯示字,其他格式寫「這種檔不能在畫布上預覽,可以下載」。
檔案元件
PDF|設計說明.pdf|2.3 MB|×
預覽區:PDF 的這一頁
‹ › 換頁(PDF)
下面那一行:這份檔給智慧元件用的那一份準備好了沒
下載
取這一格(只有影片)
載入預覽(30~100 MB 的 PDF)
系統(在使用者的瀏覽器裡做)
PDF、Word 放上來就當場抽字;錄音放上來就當場轉成語音轉文字要的格式。影片、以及從別張畫布放進來的,等連上語音轉文字時才轉,也可以自己按
元件下面那一行講狀態。抽字、轉檔都在瀏覽器裡做,不會送出去;要連進智慧元件、按下執行才送。
檔案元件下面那一行
抽字中…/轉成錄音中…
已準備好,可以接語音轉文字
這一版還不能送進文字生成・抽出 1,234 字
這份 PDF 沒有文字層(掃描檔),不做文字辨識
抽出文字/轉成錄音/再試一次
使用者
點選一個錄音檔或影片的檔案元件,按選取上方的「✦ 智慧元件」→「語音轉文字」,再按「執行」
右邊放一個語音轉文字元件、線自動接好;跑完出現逐字稿(聲音三分鐘以內)。這要機構有開放智慧元件、管理者已勾過最新版的告知。
選取上方的智慧鈕
✦ 智慧元件
錄音或影片:語音轉文字
圖:草圖轉渲染
局部重畫
文字生成
PDF
Word
文字檔:這一版不給
執行(在語音轉文字元件裡)
逐字稿
使用者
(這一版)點選 PDF、Word 或文字檔
「✦ 智慧元件」不出現:文件的字還送不出去,要等
#306
合併、B4c 與告知 v27 上線之後才接得進文字生成。元件上那一行已經先寫明「這一版還不能送進文字生成」。
使用者
在影片的檔案元件上按「取這一格」
影片現在這一格變成畫布上另一張一般圖片,放在影片旁邊、檔名帶時間;那張圖照圖片的接法可以連到草圖轉渲染等智慧元件。
使用者(任何看得到其他畫布的人)
按「檔案」→「從其他畫布挑」
工具列旁浮出挑檔面板,只列這個人看得到的其他畫布上的檔與生成的字(逐字稿、文字生成),照畫布分組、最近的在前。看不到的畫布連名字都不出現;系統轉出來的錄音、抽出來的字不列。
挑檔面板
從其他畫布挑
你看得到的其他畫布上的檔與生成的字。放進來是複製一份,之後跟著這張畫布
依畫布分組,每一列一個檔或一段生成的字
放進這張畫布
下載(只有檔案元件有)
×(收起,也可以按 Esc)
沒有東西時:你看得到的其他畫布上還沒有檔案或生成的字。別人的畫布要先分享給你,才挑得到
使用者
在挑檔面板按「放進這張畫布」
系統在伺服器端複製一份(新的檔),記下出處:從哪張、誰拿的、什麼時候。放在畫面中間附近;生成的字放進來會變成一個 .txt 的檔案元件。之後這份跟著這張畫布的分享走,來源刪掉、來源畫布封存都照樣在。只能看這張畫布的人放不進來,面板上會講「畫布現在不能寫入」。
複製進來的檔案元件
MP3|現場錄音.mp3|4.1 MB|×
從「另一張畫布的名字」複製(看的人讀不到那張就寫「從另一張畫布複製」)
下載
使用者(能編輯或只能看都可以)
按檔案元件右下的「下載」
不管什麼格式都存成檔案,不在瀏覽器裡打開(HTML、SVG 這類也不會在我們的網址下被當網頁執行);畫布有還沒存的修改也不會跳出「要離開嗎」。
使用者
按檔案元件標題列的 ×,或選起來按鍵盤 Delete
直接刪掉(跟其他元件一樣,不做兩段式),連到它的線一起清掉。畫布沒有復原;之後存檔時,沒有人在用、而且上傳超過一小時的檔會作廢、不再算進機構的檔案空間。
系統
每次上傳都先算機構的檔案空間(目前每個機構 5 GB;還在上傳中的也算進去)
放不下時,先把這個機構所有畫布上沒人用的檔案元件收一輪再算;還是放不下就擋下來並講原因。兩個人同時上傳也不會一起擠過上限。
已經定的
18 條
排在第 3 波(
#267
)之後馬上做,叫第 3.5 波
負責人 2026-10-03(
#289
本文「已經裁定的」第 1 點)
跨畫布:讀得到那張就能拿(等同下載再上傳);複製一份到這張,之後跟著這張的分享走,並記下出處(從哪張、誰拿的)
負責人 2026-10-03(
#289
本文第 2 點)
「其他畫布的資料」=上傳的檔與智慧元件生成的成品(圖、聲音、字);便條與文字框的內容不在這一次
負責人 2026-10-03(
#289
本文第 3 點)
任何格式都收、都能下載;文件一律當附件下載,不在網頁上執行。圖、PDF、MP3/M4A/WAV、MP4/WebM 在元件裡預覽;Word/Excel/PPT 先不預覽
負責人 2026-10-03(
#289
本文第 4 點)
錄音與影片的聲音可以接「語音轉文字」;PDF/Word 抽出的字可以接「文字生成」
負責人 2026-10-03(
#289
本文第 4 點)
單檔上限先定 500 MB,算進機構的檔案空間;之後有需要再調
負責人 2026-10-03(
ADR-0124
修訂(十)二,在 PR
#317
裡)
每個機構的檔案空間維持 5 GB,這一波補上「刪掉就還空間」
負責人 2026-10-03 追加(
ADR-0124
修訂(十)背景)
文字生成一次收的字從 6,000 調高到 30,000
負責人 2026-10-03 選「調高」(
ADR-0124
修訂(十)五;
#289
10/04 留言)
影片「取這一格」=變成畫布上另一張圖,看得到送出去的是哪一張
負責人 2026-10-04(
ADR-0124
修訂(十)五)
使用者自己上傳的 .txt 也算「字」,可以接文字生成
負責人 2026-10-04(
ADR-0124
修訂(十)五)
告知 v27 的文字照草稿:新增出境類別「文件的文字」、檔案的聲音算錄音、影片那一格算參考圖;程式等
#306
合進 main 才改,兩個租戶都要重勾
負責人 2026-10-04 點頭(
ADR-0124
修訂(十)六)
文字框與智慧元件的卡改成跟選取框對齊;代價是正式站既有的文字框、智慧元件內容會窄 22/26px
負責人 2026-10-04 裁「對齊」(PR
#317
10/05 留言;
#316
第六節原本列為待裁)
從 Compute 匯入(
#252
)的入口另外放在畫布工具列,但匯入的檔用檔案元件同一種樣子顯示,元件上看得到來源(Compute 任務、原檔名、匯入時間)
負責人 2026-10-03(
#252
留言、
#289
10/03 留言)
「送到 Compute」(
#297
)的入口放在檔案元件旁;排在
#252
與第一階段帳務之後
#326
第二節(負責人 10/05「照PM建議」)
檔案空間之後跟方案綁:Free 5、Starter 20、Pro 100、Studio 500 GB,照機構各算一份,管理者手動設的優先;降級後已超量只擋新上傳、不刪檔
#326
第一節(
#302
,宜芳分派)
PDF 不交給瀏覽器內建的檢視器打開,改在元件裡畫、不執行 PDF 裡的腳本(避免假表單把填的字送出去)——工程決定,不是負責人裁的
ADR-0124
修訂(十)四(推前審查)
抽字、轉錄音在使用者的瀏覽器裡做;放上畫布、抽字、轉檔都不送出去,連進智慧元件、按下執行才送——工程決定
ADR-0124
修訂(十)六
檔案元件的 × 直接刪、不做兩段式(鍵盤 Delete 與其他元件都是直接刪,文法要一致)——工程決定,偏離原計畫
ADR-0124
修訂(十)八
還沒定的
3 題
新放的東西在畫面擠滿時,要往畫面外放、再把畫面移過去(
#317
的新做法),還是照 9/27 驗收定的「疊在正中間」?
照
#317
:往畫面外找空位、畫面移過去
改回:擠滿了就疊在正中間
建議:
#317
已改成往外放並在瀏覽器實測;PR 上標了「負責人留意」,沒看到負責人回。沒有反對就照新的
誰裁:負責人
單檔 500 MB 夠不夠?3D 高斯點雲(3DGS)這類檔常到 1 GB
先維持 500 MB
調到 1 GB(單次上傳還做得到)
更大要改成分段上傳
建議:
負責人 10/03 說先這樣、之後有需要再調;從 Compute 匯入如果只記位置不複製,就不受這個上限(做
#252
時確認)
誰裁:負責人裁;要調時由宜芳分派
刪掉的檔案元件只是「不算空間」,實體還留在儲存桶。之後什麼時候真的刪掉、留多久?
建議:
ADR-0124
修訂(十)二寫明:之後做孤兒清理時,被回收的檔要留一段時間再刪,不然「存檔時又指回來就復原」會指到空的。目前沒有單子在追
誰裁:宜芳分派(要的話另開單)
怎麼驗收
11 項
前提:
#317
合併並部署之後;用測試帳號 farside_dev 登入正式站(測試租戶);手邊準備一份有文字的 PDF、一份 Word、一個 MP3、一支 3 分鐘以內的 MP4、一個 .txt
操作:
開一張自己建的畫布,按左側「檔案」→「上傳檔案」,一次選這五個檔
應該看到:
出現五個檔案元件、彼此不重疊;PDF 可以 ‹ › 換頁;MP3、MP4 播得出來;PDF、Word、.txt 下面寫「這一版還不能送進文字生成・抽出 N 字」;MP3 寫「已準備好,可以接語音轉文字」
前提:
同一張畫布;準備一張 10 MB 以內的 PNG、一張超過 10 MB 的照片、一個空的檔
操作:
把 PNG 拖進畫布、再複製一張截圖按 Ctrl+V 貼上;接著拖大照片、再拖空檔
應該看到:
PNG 與截圖變成畫布上的一般圖片(跟以前一樣);大照片變成檔案元件;空檔在「檔案」鈕旁邊出現錯誤說明,頁面沒有離開畫布;再按「檔案」,錯誤收掉、選單打開
前提:
測試租戶有開放智慧元件、告知已勾到最新版;畫布上有剛才的 MP3 與 MP4
操作:
點選 MP3 →上方「✦ 智慧元件」→「語音轉文字」→「執行」;再對 MP4 做一次
應該看到:
每次都在右邊多一個語音轉文字元件、線自動接好,跑完出現逐字稿
前提:
畫布上有剛才的 PDF
操作:
點選 PDF,看選取上方
應該看到:
不出現「✦ 智慧元件」(這一版文件的字還送不出去;B4c 上線後才該出現,到時要重驗這一條並接文字生成跑一次)
前提:
畫布上有剛才的 MP4
操作:
播到一半暫停,按「取這一格」
應該看到:
影片旁邊多一張一般圖片,畫面是剛才那一格
前提:
另一張自己的畫布上先放一個檔,並跑過一次語音轉文字(有逐字稿)
操作:
回到第一張畫布,按「檔案」→「從其他畫布挑」
應該看到:
面板照畫布分組列出那個檔與那段逐字稿;沒有系統轉出來的 .wav、抽出來的 .txt。按「放進這張畫布」會放一份進來,元件上寫「從「那張畫布的名字」複製」;逐字稿放進來是一個 .txt 檔案元件
前提:
上一步複製進來的檔
操作:
回到來源那張畫布把原檔刪掉、讓它存檔,再回來重新整理這張
應該看到:
這張的複本照樣在,還能預覽、還能下載
前提:
任一檔案元件;另外上傳一個 .html 或 .svg
操作:
在畫布有還沒存的修改時按「下載」
應該看到:
瀏覽器把檔存下來,不在新分頁打開、不顯示網頁內容;也沒有跳出「要離開嗎」
前提:
請測試員用另一個同機構的帳號,建一張沒有分享給你的畫布並放一個檔
操作:
用測試帳號打開挑檔面板
應該看到:
看不到那張畫布、也看不到那個檔(跨機構與同機構跨人的隔離另外由後端測試守著:PR
#317
的 CI「後端:pytest」要是綠的)
前提:
一張別人分享給你、只能看的畫布,上面有檔案元件
操作:
打開它,預覽並下載那個檔;再試著用挑檔面板放東西進這張
應該看到:
預覽、下載都可以;放不進來,會講「畫布現在不能寫入」
前提:
ADR-0124
修訂(十)列給負責人的驗收
操作:
上傳一支約 300 MB 的影片並播放;另外在 iPad(820 寬)與 1180、1440 寬各開一次
應該看到:
能傳完、能播;三種寬度都看得到預覽、按得到下載。這幾項 PR 上寫明還沒驗(還有 Safari 實機、30,000 字長輸入的速度)
這張不做
文件的字真的送進文字生成(B4c)與告知 v27(B5):等
#306
合了另一個 PR 做,這張到那時才關
Word/Excel/PPT 預覽(要伺服器轉檔,跟 ffmpeg 同一題,之後再說)
掃描 PDF 的文字辨識(OCR):等沙箱,
#298
裁
DWG 當圖面:第一版只收 DXF/PDF(
#298
裁)
便條、文字框的內容不能從其他畫布挑
超過 500 MB 的檔;超過三分鐘的聲音分段
掃毒與內容檢查(防線是強制下載、檔案放在跟 app 不同的網域;ADR 寫明是缺口)
畫布上的一般圖片與智慧元件的成品刪掉不還空間(還被版本紀錄引用,另案)
Compute 的兩個入口(
#252
匯入、
#297
送出)這一波只留位置,不畫按鈕
已上線的「案件文件」PDF 預覽改成同一種畫法:另開
#315
,不在這張
檔案空間跟方案綁:
#302
做,不在這張
相關的單
#252
#267
#274
#278
#279
#293
#296
#297
#298
#299
#302
#306
#314
#315
#316
#317
#326