以下內容提供你一份 易懂、可直接上手的 Graph Commons 使用指南，
包含：
什麼是 Graph Commons（認識工具）
基礎概念（節點／關係／屬性）
操作介面說明
Step-by-step 新手快速入門流程
匯入資料（CSV / Google Sheet）
編輯與調整關係強度
版本管理（Fork / Merge）
視覺化、樣式調整
團隊協作方式
高階用法（分析、群聚、嵌入、API）
適合你要做的：
內部知識地圖、概念間關係可視化、多人共同編輯、可調整距離與強度。
🟥 1. 什麼是 Graph Commons？
Graph Commons 是一個：
可視化知識圖（Knowledge Graph）
社群型網路建構平台（多人共同編輯）
完全圖像化操作（非技術者也會用）
每個節點與每條連線都有 metadata（欄位、強度、分類）
它最適合用來呈現：
文件 → 文件 的關聯
文件 → 概念 的連結
人 → 文件 → 主題 的互動
以及你說的：每個人自己定義的關係強度
🟥 2. Graph Commons 基本概念（非常重要）
✔ 2.1 Node（節點）
代表一個「東西」：
檔案
概念
事件
人物
組織
主題
每個節點可以有：
名稱
類型（Type）
描述
Tags
圖片
自訂欄位（任何屬性）
✔ 2.2 Edge / Connection（關係）
代表兩個節點之間的「連結」。
關係可以包含：
類型（relation type，例如 related to / influences）
weight / strength（你可自訂的強度）
Annotation（文字描述）
Graph Commons 比較特別：連線也可以放很多欄位 → 可以做強度、距離、信心度等。
✔ 2.3 Map（地圖）
一張地圖包含：
全部 node + edge
人員編輯紀錄
視覺布局
你可以：
分享
Fork
匯出
匯入資料
🟥 3. 操作介面（UI）簡介
主要分成 4 個區域：
🔸 3.1 左側工具列
常用功能：
Add Node（新增節點）
Add Connection（新增連線）
Search（搜尋節點）
Style（變更顏色、大小）
Inspect（檢視屬性）
Import / Export
Settings（地圖設定）
🔸 3.2 主畫布（Canvas）
用來：
拖曳節點
放大縮小
選取多個節點
調整布局（手動）
🔸 3.3 右側屬性面板（Property Panel）
你點任何 node / edge → 右側會出現：
類型
描述
自訂欄位
Tags
圖片
連線欄位（例如 weight）
🔸 3.4 上方（Map Tools）
你可以：
分享地圖
Fork 地圖
匯入資料
下載圖像
調整圖片限制
🟥 4. 新手快速入門（10 分鐘會用）
以下是一個「10 分鐘完成一張知識圖」的快速操作。
Step 1：新增一張 Map
點：
Create New Map → Empty Map
Step 2：建立第一個 Node（節點）
點：
Add Node → 點畫布空白處
輸入：
Name（例如：User Guide）
Type：Document
Description：此為教學文件
Tags：Knowledge
OK！
Step 3：建立第二個 Node
同樣方式再加一個，例如：
Concept A
Concept B
Person John
Step 4：建立關係（Edge）
選兩個 Node，點：
Add Connection
輸入：
Relationship type：related to / depends on / explains
Weight（你可以自訂欄位，例如：strength = 0.7）
描述（為什麼相關）
Step 5：調整距離（手動拖曳）
Graph Commons 的核心特色：
使用者直接拖曳節點近／遠
重排位置
用人類直覺調整視覺布局
這是你想要的「人類可調整距離」的關鍵。
Step 6：用右側屬性欄位調整強度
點線（Connection）→右側面板：
新增自訂欄位：
欄位名稱：Strength
欄位類型：Number
值：110 或 01
之後就能用視覺工具或篩選器改變呈現。
Step 7：設定顏色 / 樣式
左側選：
Style → By Type / By Field / By Group
你可以：
文件類型變藍色
概念類型變綠色
人物變橘色
強度高的線變粗
強度低的線變透明
→ 這能呈現一種「視覺距離」。
Step 8：分享 / 協作
點：
Share Map
設定：
Public
Private
Invite Collaborators
Step 9：Fork（每位使用者自己的版本）
這對你的需求很重要！
每位使用者可以：
點 Fork Map
修改自己的版本
不會影響主版本
可以再合併（需要人工判斷）
非常適合：
每個人有不同的認知距離、不同的權重評分。
🟥 5. 資料匯入（大量資料時必用）
Graph Commons 支援：
CSV
JSON
Google Sheet
Excel
匯入三種層級：
5.1 匯入節點
欄位：
| id | name | type | description | tag | url | … |
5.2 匯入關係
欄位：
| source | target | type | strength | description |
5.3 匯入整張 Map
把 node + edge 都放進同一個匯入檔。
非常適合：
把組織內 500 個文件、1000 個概念一次匯入
然後讓大家在圖上慢慢調整
🟥 6. 調整關係強度（你的核心需求）
Graph Commons 原生支援：
✔ 方式 1：用自訂欄位（最常用）
例如：
在 connection 上新增欄位 strength (01 或 110)
讓使用者手動修改
✔ 方式 2：用拖曳間接表達距離（最有人性）
把節點拉近 = 有關
拉遠 = 疏離
Graph Commons 會儲存位置（layout 是一部分資料）
✔ 方式 3：用「不同地圖（Fork）」表示不同人的理解
Alice 版本 → strength 不同
Bob 版本 → strength 不同
這對你非常重要。
🟥 7. 視覺調整（樣式）
Graph Commons 可以設定：
Node 顏色
Node 圖示
Edge 顏色 / 粗細
依 metadata 自動著色（例如 strength > 0.6 → 紅色）
這是建立「可讀性高的知識圖」的關鍵。
🟥 8. 協作方式（企業常用流程）
✔ 模式 A：主版本（Admin）＋ 個人版本（Fork）
管理者維護主版本
每個人 fork 修改
最後人工整合回主版本
✔ 模式 B：多人共編一張圖（共享編輯）
適合較小的團隊
非技術者可輕鬆加節點／加關係
技術者負責清理結構、做匯入
✔ 模式 C：資料由技術匯入、非技術編輯細節
技術團隊：匯入 1000 nodes + 5000 edges
非技術團隊：把關係補強、調強度、增補 metadata
這種組合很適合你的使用情境。
🟥 9. 高階用法（進階）
⭐ 9.1 社群偵測（Community Detection）
Graph Commons 有 clustering，會自動為你尋找：
文件群
主題群
使用者知識群
⭐ 9.2 最短路徑（Shortest Path）
可以：
找概念 A → 概念 B 的最短關係鏈
用於探索「原來這兩個無關的主題，是透過哪份文件連在一起的？」
⭐ 9.3 嵌入（Embed）
你可以把地圖嵌入到：
公司 Wiki
Notion
Confluence
讓整個組織都可以用。
⭐ 9.4 API 使用
Graph Commons 有 REST API，可用來：
動態更新資料
從公司資料庫同步
自動產生 node / edge
非常適合技術背景的你。