← 全部的單
GitHub #293 ↗
助理・功能
讓能編輯畫布的人在 dock 跟助理講一句話,助理就在那張畫布上放好智慧元件、寫好描述、接好線;「執行」還是人自己按。
#293 助理部署畫布元件:跟助理講一句話就放好智慧元件、接好線(測試用)
狀態
還沒開始
誰在做
未指派
做到哪
三題 10/05 照 PM 建議定了(
#293
留言、
#326
第三節)。還沒有分支或 PR。今天助理在畫布上只有兩支讀的工具 canvas_find、canvas_read(
#217
上線),還不能在畫布上新增任何東西;排在它前面的檔案元件
#289
在 PR
#317
等審查。
卡在
三件事:一、PM 宜芳還沒指派歸屬(單上沒有「我們處理中」或「委託處理」標籤);二、排程上要等檔案元件
#289
(PR
#317
)先合;三、動手前要先修訂
ADR-0104
/0108/0124,回答下面「還沒定的」第 1~3 題,給負責人過目。
下一步
PM 宜芳指派歸屬、把「待負責人裁決」標籤拿掉,並跟負責人定它跟第 3.7 波誰先;接手的人先寫 ADR 修訂草稿(怎麼寫進畫布、告知要不要升、權限表怎麼對)給負責人看,
#289
合併後再開工。
提醒:
一、「待負責人裁決」標籤可以拿掉了:三題 10/05 都定了(
#293
留言、
#326
第三節)。二、歸屬兩邊講法不一致:
#326
的分工表把「三、助理」寫在畫布這邊(負責人+Claude),但
#293
的留言是請你指派、單上也還沒有歸屬標籤——等你定。三、10/05 的「直接寫」跟目前 ADR 打架:
ADR-0104
第 10、11 條和
ADR-0108
都寫「直接畫要等即時同步」,程式裡畫布群的上限也是照這個收成「提議」;dock 那一列的說明和告知 v25 都寫著助理在畫布上只能讀。所以這張動手前一定要先修 ADR(
#293
本文自己也這樣寫),還沒定的第 1~3 題就是修 ADR 時要回答的。四、
#326
說「不用升告知」,但照
ADR-0108
新工具就要重勾,實際上多半還是要升一次——升了的話正式租戶要管理者重勾,重勾前助理和智慧元件都會停。五、
#293
本文列了六種能力(生成圖片、草圖轉渲染、局部重畫、文字生成、朗讀、語音轉文字);檔案元件
#289
和第 3.7 波的 placeholder 上線之後,助理能放的種類要不要跟著擴,單上沒寫。六、排在它前面的
#317
還卡在
#306
(見
#289
流程頁),所以這張短期內不會開工。
一步一步 11
已經定的 14
還沒定的 6
怎麼驗收 9
這張不做 5
這張要解決什麼
負責人與測試員(測的是畫布元件,也順便測助理本身);之後是一般能編輯畫布的成員
,每測一次畫布元件,都要手動一個一個把智慧元件拉上畫布、寫描述、拉線,很花時間;也不想寫腳本去種——要能 在 dock 講一句「在這張畫布放一個生成圖片,描述寫清水模住宅,接到那張便條」,畫布上就出現對應的元件和線,接著自己按執行
一步一步
11 步
管理者(測試租戶)
到 dock › 助理設定 › 能做什麼,確認「畫布」那一列不是關閉(要設到「提議」還是「直接畫」才會直接寫,見還沒定的第 3 題);如果這一版升了告知,先重勾一次(見還沒定的第 2 題)
助理可以讀、也可以在畫布上新增東西
dock › 助理設定 › 能做什麼
能做什麼
畫布:關閉/提議/直接畫(下拉,只有管理者能改)
那一列的說明:現在能做到哪裡(今天寫的是「只有讀」,這張做完要改)
儲存(放寬時會跳兩段式確認)
能編輯這張畫布的成員
打開一張畫布(/firm/canvas/某張),上面已經有一張便條,再打開 dock
dock 知道你正開著哪一張畫布(不用另外講是哪一張)
單張畫布+dock
畫布標題
畫布上一張便條,寫著要做的東西
dock 圖示(打開助理)
能編輯這張畫布的成員
在 dock 打:「在這張畫布放一個生成圖片,描述寫清水模住宅,接到那張便條」
送出,助理開始處理
dock 對話
輸入框:在這張畫布放一個生成圖片,描述寫清水模住宅,接到那張便條
送出
系統(助理)
先檢查:你在這張畫布的角色是不是可以編輯、畫布群有沒有開、畫布有沒有封存、有沒有租戶外的協作者或有效的編輯連結;再讀這張畫布,找出你講的那張便條
任何一關沒過就不寫,回一句講清楚是哪一關(見後面幾步);都過了才往下
系統(助理)
在畫布上新增一個「生成圖片」元件、描述欄寫「清水模住宅」、加一條從便條連到元件的線;位置放在你指的那張便條附近。存檔時先拿最新的畫布再加上去,有人剛好在改就合併,不蓋掉別人的修改
畫布存檔多了這三樣東西;不跑元件、不送任何東西出去、不花錢
系統(助理)
在 dock 回報放了什麼
講明放了幾個元件、描述寫了什麼、接了幾條線;提醒要跑請自己在元件上按「執行」
dock 對話(助理回覆)
放好了:生成圖片 1 個,描述「清水模住宅」,從便條連進來 1 條線。
要產生圖片請在元件上按「執行」,我不會替你按。
能編輯這張畫布的成員
看畫布(新元件是馬上出現,還是要重新整理才看得到,取決於還沒定的第 1 題);重新整理一次
元件和線都在,重新整理後也還在
單張畫布(放好之後)
便條 → 一條線 → 生成圖片元件
生成圖片
描述:清水模住宅
輸入:便條 1
執行
能編輯這張畫布的成員
點這個元件,改一下描述,按「執行」
跟手動拉的元件完全一樣:可以編輯、可以跑、成品出來;這一次的出境照常記錄、照常花用量
生成圖片元件(執行後)
描述(可以改)
執行
產生的圖
只能看(Viewer)的成員
在同一張畫布叫助理放元件
助理說你在這張畫布只能看、不能替你放;畫布沒有任何變化
dock 對話(被擋)
你在這張畫布是「只能看」,我可以幫你讀,不能幫你放東西。
任何成員
畫布群被管理者設成關閉時叫助理放元件;或對一張封存的畫布叫助理放元件
助理講出是哪一格擋住:畫布群關閉就指到 dock › 助理設定 › 能做什麼 › 畫布、由管理者改;封存就講這張已封存、不能改。畫布沒變
dock 對話(設定關著/封存)
「能做什麼 › 畫布」現在是關閉,要請管理者到 dock › 助理設定打開。
這張畫布已封存,不能新增東西;要先還原。
能編輯這張畫布的成員
跟助理說「順便幫我按執行」
助理說它不會替你按,請在元件上自己按;元件沒有開始跑,也沒有送出或花錢
dock 對話(不替人按)
我不會替你按執行(那一步會把內容送出去、會花用量),請在元件上自己按。
已經定的
14 條
「部署」只做到放元件、寫描述、接線;不替人按執行(不出境、不花錢)
負責人 10/05「照PM建議」(
#293
留言、
#326
第三節第 1 點)
直接寫進畫布,但只限不花錢、不出境的動作(9/29 說過「直接畫上去要等即時同步」,這次照 PM 建議限縮在這類動作上直接寫)
負責人 10/05(
#293
留言、
#326
第三節第 2 點)
排在檔案元件
#289
之後
負責人 10/05(
#293
留言、
#326
第三節第 3 點)
助理用畫布=讀+提議+直接寫+歸檔,範圍是這個人有權限的每一張畫布
負責人 2026-09-29 四題(
ADR-0104
〈助理使用畫布〉表格第 1、2 題)
助理操作智慧元件歸權限表的「畫布」群;助理要「跑」元件一律先發核准卡
ADR-0124
R13(負責人 2026-09-30 q4 裁決)
每一輪只碰使用者點名或正開著的那一張畫布
ADR-0104
〈助理使用畫布〉第 1 條(已實作,
#217
)
寫到哪一張、放在哪裡,只能來自使用者講的話或選取,不能由畫布上的字決定
ADR-0104
〈助理使用畫布〉第 2 條(設計條款)
只能看(Viewer)的人:助理可以替他讀,不能替他寫
ADR-0104
〈助理使用畫布〉第 7 條、
ADR-0108
〈2026-09-29 修訂〉、
#293
驗收條件
只新增;改寫、刪除、移動畫布上既有的東西不在範圍,另裁
ADR-0104
〈助理使用畫布〉第 10 條、
ADR-0108
〈2026-09-29 修訂〉「不在範圍」
封存的畫布擋所有內容變更(admin 也不例外)
ADR-0114
〈2026-09-29 修訂〉第二節、
ADR-0118
決策三
有租戶外協作者的畫布、開著有效編輯連結的畫布,助理今天不碰
ADR-0104
〈助理使用畫布〉第 12 條、
ADR-0124
R9、告知 v25
測試只在測試租戶
#293
本文〈已經裁定的〉
告知每升一次版,文字先給負責人過目
#274
裁決第 2 題
做完要在瀏覽器實測、錄影放展示頁,連結附在這張與 PR
#293
驗收條件、
#274
本文末段
還沒定的
6 題
「直接寫」實際怎麼寫進畫布?
ADR-0104
第 10、11 條寫的是:直接畫要等即時同步(CanvasRoom,
ADR-0120
還沒開始做),而且不准伺服器自己另當一個寫入者(理由:開著畫布的人看不到、跟自動存檔搶版本、純字串會吃字、署名和復原沒地方記)。10/05 的裁決讓這類動作先直接寫,但沒講用哪條路
伺服器讀最新的畫布、加上元件和線、走既有的版本檢查存回去(
#293
本文的寫法比較像這個;要正面回應第 11 條列的風險,例如開著畫布的人要重新整理才看得到)
助理只回「要放什麼」,由正開著那張畫布的瀏覽器用前端同一份 canvas-doc.ts 寫進去、走既有的存檔(馬上看得到、不多一個寫入者;代價是畫布要開著)
等 CanvasRoom 做好再經它寫(最乾淨,但會晚很多)
建議:
Claude 的看法(不是裁決):第二個最貼
#293
本文「用 canvas-doc.ts 同一份、走既有存檔、不另開寫法」,也不違反第 11 條。不管選哪個,都要先寫進
ADR-0104
修訂給負責人過目再動手
誰裁:負責人(看 ADR-0104 修訂草稿)
告知要不要升、兩個租戶要不要重勾?
#326
說選「不替人按執行」就不用升告知;但
ADR-0108
〈同意指紋〉規定新工具進清單就要重勾,而且告知 v25 現在寫著「它還不能在畫布上新增、修改或刪除任何東西」——做完這句就不對了
升告知:改掉那一句、兩個租戶的管理者重勾
不升:照
#326
字面(要另外改
ADR-0108
的〈同意指紋〉規則)
建議:
建議升:
#326
講的「不用升」是指不碰「替人按執行」那一段;新工具與告知那一句照
ADR-0108
走,升版前文字先給負責人過目
誰裁:負責人
權限表怎麼對?畫布群有三段(關閉/提議/直接畫),標準預設是「提議」;上限在即時同步之前被收成提議,而「提議」本身也還沒做。標準預設下叫助理放元件,該怎樣?
只要畫布群不是關閉就直接寫(最貼
#326
字面;等於標準預設多了寫入、預設變寬,
ADR-0108
要求在 dock 公告)
只有設成「直接畫」的機構才直接寫;設「提議」時助理講要請管理者改哪一格(預設不變寬,測試租戶設成直接畫就能測)
建議:
建議第二個:裁決沒講到標準預設,照現有三段的意思走、不放寬預設;不管選哪個,上限只對「放元件、寫描述、接線」這一類升上來
誰裁:負責人
畫布上要不要看得出哪些是助理放的、能不能一鍵復原助理這一批?
ADR-0104
第 10 條要求直接畫要有貢獻紀錄與整批復原,
ADR-0114
要求寫入要具名(今天畫布只記最後是誰存的)
第一版就記「誰叫的、哪一輪、直接寫沒有人逐筆接受」,畫面上標出來
第一版只在伺服器記一筆,畫面上不標
等 CanvasRoom 的貢獻紀錄一起做
建議:
建議至少在伺服器記下「誰叫的、哪一輪」,照
ADR-0114
三段署名的形狀;畫面標不標由負責人定
誰裁:負責人
跟第 3.7 波(
#298
/
#299
接點選單與 placeholder)誰先?兩邊都寫「緊接
#289
」
先第 3.7 波
先
#293
併成同一波
建議:
跟
#274
流程頁同一題:Claude 傾向先第 3.7 波,因為助理放元件、接線會用到同一份「吃什麼出什麼」的宣告(建議,不是裁決)
誰裁:負責人定先後,PM 宜芳分派
這張歸誰?
標「我們處理中」(負責人+Claude),排在
#274
裡
降成
#274
的子項,不單獨排
標「委託處理」由宜芳分派給別人
建議:
#326
的分工表已經把「三、助理」放在畫布這邊(負責人+Claude),標「我們處理中」最一致
誰裁:PM 宜芳
怎麼驗收
9 項
前提:
測試租戶、測試帳號登入;畫布群照還沒定的第 3 題設好;一張畫布上已經有一張便條
操作:
打開那張畫布,在 dock 打「在這張畫布放一個生成圖片,描述寫清水模住宅,接到那張便條」
應該看到:
助理回「放好了」並講明放了什麼;畫布上出現一個生成圖片元件、描述欄是「清水模住宅」、有一條從便條連到元件的線;按重新整理之後都還在
前提:
上一步助理放好的元件
操作:
點元件、改描述、按「執行」
應該看到:
跟手動從工具列拉出來的元件一模一樣:能編輯、能跑出圖;工程確認這一次的出境紀錄照常有一筆
前提:
用一個在這張畫布只能看(Viewer)的帳號登入
操作:
在 dock 叫助理放一個元件
應該看到:
助理說沒有權限;畫布沒有任何變化(重新整理確認)
前提:
兩個分頁(或兩個人)同時開著同一張畫布,A 正在改便條上的字
操作:
B 在 dock 叫助理放元件;之後兩邊都重新整理
應該看到:
A 改的字還在,助理放的元件和線也在,沒有誰蓋掉誰
前提:
管理者把「能做什麼 › 畫布」設成關閉
操作:
叫助理放元件
應該看到:
助理講出是「能做什麼 › 畫布」關著、要請管理者改;畫布沒變。改回來之後同一句再講一次,放得進去(正面對照)
前提:
一張封存的畫布
操作:
點名那張畫布叫助理放元件
應該看到:
助理說這張已封存、不能新增;畫布沒變
前提:
助理剛放好一個元件
操作:
跟助理說「順便幫我按執行」
應該看到:
助理說它不會替你按;元件沒有開始跑、沒有新的出境紀錄、沒有用量
前提:
PR 開出來了
操作:
打開 PR 看測試結果
應該看到:
有自動測試證明:別的租戶、只能看的人、外部 AI 工具的權杖都寫不進去;助理寫進去的元件與線跟前端 canvas-doc.ts 產生的是同一個形狀;有人同時在改時不蓋掉
前提:
以上都過了
操作:
看這張 issue 與 PR
應該看到:
都附了展示頁的錄影連結(只錄測試租戶)
這張不做
不替人按「執行」(會出境、會花錢;真要做得升告知、兩個租戶重勾)
不改寫、刪除、移動畫布上既有的東西——第一版助理寫描述只寫在它這次新放的元件上
不做助理讀元件結果、發卡跑元件那三支(smart_list/smart_read/smart_run,
ADR-0124
決策五;
#274
排在「之後」)
不做 CanvasRoom 即時同步(
ADR-0120
,另一件事)
外部 AI 工具的權杖、背景排程不能用這個能力(
ADR-0104
〈界線〉)
相關的單
#217
#274
#289
#298
#299
#317
#326