工作原理

一個 Slack 討論串——圖表、原始碼和決策依據都在這裡。

Arialine 是一款 Slack 應用。你描述系統,它來繪製。在討論串中與 @arialine 對話即可更新。每次修改都會成為一個帶編號的版本,並連結到引發該修改的那條訊息。本頁將完整展示整個流程。

免安裝試用

先親手走一遍完整流程。

建立看板、應用提議、再撤銷,並開啟真實的 HTML 檔案——然後在下方瞭解每個環節的原理。

# architecture

Priya Nair10:38 AM
Before tomorrow's review — can someone sketch how checkout hands off to fulfillment? I keep losing track of where the order gets written.
Dana Okafor10:40 AM
+1, a diagram in this thread would save us 20 minutes of explaining.

↓點選傳送即可 @ 提及 Arialine

@Arialine draw checkout-review: Checkout API → Payment processor → Fulfillment worker → Orders database
01

建立

七種方式建立看板

七種方式的結果相同:頻道中的一條根訊息,包含 PNG 預覽、可互動的 .html 檔案,以及 History、Branch 和 Export 控制元件。透過 Export 開啟 Show source。後續版本出現在討論串中;決策日誌在後臺單獨發布。在 Slack Free 上,它保留在看板討論串中,不會佔用頻道的 Canvas 標籤頁。

  • @提及 + 描述

    @Arialine create a checkout funnel with a retry queue and a DLQ after 3 tries

    +
    稱呼 Aria、Arialine 或 @arialine:create a checkout funnel with a retry queue and DLQ after 3 tries
  • 討論後提及

    Dana Okafor10:52 AM

    @Arialine turn this into a diagram
    14 repliesLast reply today at 10:51 AM
    @arialine turn this into a diagram——使用最近 72 小時內相關的討論;如果兩個主題同樣可能,會詢問你指的是哪一個
  • 貼上 Mermaid

    Priya Nair9:14 AM

    @Arialine render this
    flowchart LR
      A[Checkout] --> B{Paid?}
      B -->|yes| C[Ship]
    @arialine 後接貼上的 Mermaid——Arialine 會校驗並渲染
  • 附加 .mmd 檔案

    Sam Moreau2:03 PM

    @Arialine make this a boardMMDpayments.mmdMermaid
    @arialine 並附上 .mmd/.mermaid 檔案
  • 直接分享 .mmd 檔案

    Sam Moreau2:03 PM

    MMDpayments.mmdMermaid

    ArialineAPP2:03 PM

    🟢 payments · v1 · built from payments.mmd
    把檔案拖進頻道——Arialine 自動建立看板(可關閉)
  • “Render as diagram”快捷方式

    Priya Nair9:20 AM

    Order service writes to Postgres, then publishes OrderCreated to Kafka.

    Arialine

    Render as diagram

    Render as canvas

    懸停或長按訊息 → More actions → Render as diagram
  • /arialine 或 ‘New diagram’
    New diagram

    Post in channel

    # architecture

    Paste Mermaid or describe the diagram

    flowchart LR
      API --> Queue --> Worker
    CancelCreate
    輸入 /arialine(或 ⚡ 選單 → New diagram),然後貼上 Mermaid 或描述圖表——有效的 Mermaid 無需 AI 即可渲染
02

結構

一條錨點訊息上的兩個檔案

Arialine 會同時發布兩個檔案——可互動的 .html 和 .png。.png 是你在任何裝置的 Slack 中看到的預覽。在瀏覽器中開啟 .html,即可平移縮放,並使用 Decisions、Source 和 History 面板。

根訊息是錨點:每次修改後,它的檔案都會替換為最新渲染,因此討論串頂部始終是當前圖表。下方的版本回復儲存了每一份被取代的 .png + .html——什麼都不會丟失。

03

Edit

在討論串中與 @arialine 對話

稱呼 Aria、Arialine 或 @arialine,然後說 “在閘道器和資料庫之間加一層快取” 或 “去掉簡訊步驟”。Arialine 會改寫 Mermaid 並重新渲染,替換根訊息上的檔案,再發布一行版本回復:v2 — added Redis caching layer — by @you,附帶 ↩︎ Undo this change 和 ⏪ Rewind to here 按鈕。

你也可以對任意訊息新增 📌 回應,把它提議為一項修改。Arialine 會結合上下文閱讀這條訊息,然後發布一張帶有 Apply、Edit proposal 和 Dismiss 的卡片。

04

版本

撤銷單項修改,或回退整個看板

歷史是追加式的。撤銷某項修改或回退到早期版本,本身也會成為一個新的被記錄的版本。任何內容都不會被覆蓋,因此審計和覆盤始終與實際一致。

在討論串裡問 “為什麼這裡有死信佇列?”,Arialine 會根據決策日誌回答——引用原訊息、註明是誰說的,並附上原始 Slack 訊息的連結。

05

分支與頭腦風暴

探索替代方案,而不影響原圖

點選根訊息上的 Branch(或說 @arialine branch this at v3 called experiment),即可把任意版本分叉為一個全新的看板。分支擁有自己的討論串和決策日誌,並連結回源版本。

提及 @arialine brainstorm …,或明確請 Arialine 幫忙出主意。它會針對當前圖表給出 2–3 個替代方案——每個都以預覽呈現,並附兩個按鈕:Adopt to this board(作為新版本替換當前圖表)或 Branch to new board(保持原圖不變)。

06

決策日誌

一個記錄圖表為何如此的 Slack Canvas

在 Slack 允許的情況下,每個看板都會有一個包含兩部分的決策日誌 Canvas。Timeline 按從新到舊列出每個版本及其渲染圖。Decisions 是日誌:改了什麼、誰做的決定,以及每條來源訊息的連結。在 Slack Free 上,同樣的日誌會以訊息形式儲存在看板討論串中。

決策日誌是存檔,HTML 檔案是可以探索的圖表。兩者結合,既回答“它現在是什麼樣?”,也回答“我們是怎麼走到這一步的?”——哪怕是半年後才加入團隊的人也能看懂。

07

Markdown 轉 Canvas

分享 .md 檔案——得到原生 Slack Canvas,Mermaid 自動渲染

Slack 不會在訊息中渲染 Markdown,上傳的 .md 檔案只顯示為純文字片段。Arialine 會把分享的 .md 轉換為真正的 Slack Canvas——保留標題、列表和表格——其中每個 mermaid 程式碼塊都會變成嵌入的圖表圖片。一份文件,在 Slack 中完整可讀。

08

隨處嵌入

把圖表放進團隊常看的任意 Canvas

讓 Arialine 把看板的當前版本追加到它有權訪問的任意 Slack Canvas——專案文件、頻道 Canvas 或會議 Canvas。Arialine 會渲染最新版本、上傳,並嵌入到 Canvas 末尾。

09

Slack AI (MCP)

透過 Slack 內建助手操作 Arialine

Arialine 提供 Model Context Protocol 伺服器,Slackbot 可以代你建立、編輯、分支和查詢看板。只需說 “用 Arialine 把這段討論畫成圖表”——Slackbot 會呼叫合適的工具,Arialine 發布看板,決策日誌會記錄是誰提出的請求。

想看完整教程?

文件涵蓋每個快捷方式、每條斜槓命令和每項管理員設定。

把 Arialine 帶進你的下一次設計討論。

一鍵安裝。從一個頻道開始:Arialine 只會在你邀請它的地方參與,預設設定也盡量減少干擾。