DEV · 可驗證版本 Addressable Document Architecture

MetaEngine XFramework

同一份知識來源，
形成多種工作視圖。

XFramework 以可定址的 XML 文件作為共同來源，讓人員透過表單與畫布工作、讓軟體精確查詢與連結，也為 AI Agent 的受控操作建立可檢查的架構基礎。

進入完整工作環境開啟 XFramework 工作區

先了解架構查看分工探索五項機制

Canonical XML完整文件是權威來源
Strict round-trip無法保真時拒絕寫回
Derived projections視圖可重建、不製造第二份真相

表單介面經由結構層映射為 XML 文件的概念示意 — 01 / Architecture
介面可以改變，文件 identity、結構與參照仍維持同一套契約。

核心觀察知識一旦被拆成文件、表單資料、搜尋索引與圖譜副本，就很難回答「哪一份才是真的」。

一個來源

以 canonical XML 保存階層、順序、identity 與明示參照。

多種投影

表單、Graph、Flow、搜尋與閱讀視圖皆從同一來源形成。

受控操作

Workspace scope、ACL、ETag 與 audit 由 Server 守住權威邊界。

01 · Responsibility map

先看分工，再看功能。

架構層定義可長期維持的文件契約；產品層提供工作體驗；儲存層負責權限、並行與可靠保存。三者協作，但不互相取代。

使用者Who operates

People閱讀、編寫、審查

Software驗證、查詢、整合

AI AgentTarget · 受控操作

產品／應用Where work happens

XFramework WorkspaceCurrent · 文件、關係、Flow / Graph

Story Atlas / SEL Workbench不同客製程度的示範應用；後端逐一移轉

XRepo Workshop現行 Definition 與 Form／Codec 檢視；完整候選流程待補

核心架構What stays stable

MetaEngine XFramework可定址的結構化文件契約

DocumentIdentityReferenceProjectionGovernance

執行／儲存How it runs

Architectural XML RuntimeHTML template ↔ Editable DOM ↔ XML

XRepositoryCanonical XML · PostgreSQL authority

Server authorityScope · ACL · ETag · audit

重要邊界

XFramework 定義文件與治理原則；XRepo 保存 canonical XML，包含 Explorer、Workshop 與使用者管理；標準 Workspace 提供一般內容編輯。Story Atlas、SEL Workbench 等專用應用可保留自己的介面，透過受驗證的 adapter 採用 XRepo，不必另做通用 Form。

02 · Round-trip lifecycle

一次修改，走完一條可驗證的往返路徑。

Template 描述結構與呈現；Runtime 將 XML 展開為可操作 DOM；Server 在儲存時重新確認權限、版本並重建投影。

01
Describe
HTML data-x-* 宣告結構、欄位與重複片段。
02
Expand
完整 XML 依 template hierarchy 展開為 Editable DOM。
03
Operate
表單或專用 editor 修改值、順序與結構節點。
04
Validate
strict extraction 驗證能否保真重建，不可表示即 fail closed。
05
Commit
以 exact ETag 儲存完整 XML，原子重建索引與參照投影。

03 · Design mechanisms

逐項拆解 XFramework 的設計機制。

切換下列機制，查看它解決的問題、現行能力、技術邊界與最適合的應用模式。

CurrentCanonical document

結構本身就是資料，不只是一組欄位值。

階層、順序與重複片段都保存在完整 XML 中；HTML template 同時描述呈現與資料映射，讓一般瀏覽器控制項也能操作文件結構。

特色: HTML-native data-x-*，不另造一套 UI 語言。
功能: 展開、增刪、排序、驗證，再從 DOM 重建完整 XML。
應用模式: 適合文件樹與表單結構大致同構的內容；跨節點 topology 則交給註冊過的專用 editor。

操作 XML ↔ Form 往返 Demo →

template.html

<section data-x-container="workPlan">
  <input data-x-name="title">
  <div data-x-ref="step"></div>
</section>

expand→

Editable DOM計畫名稱

01盤點架構

02驗證發布

extract→

record.xml

<workPlan>
  <title>發佈 XFramework 入口</title>
  <step>盤點架構</step>
  <step>驗證發布</step>
</workPlan>

CurrentRecord + node identity

不只找到文件，也能精確回到文件裡的節點。

Server 管理 record identity；文件內以 x:id 或相容的 xml:id 建立 document-scoped anchor。兩者分工清楚，不把資料庫主鍵直接塞進內容模型。

特色: 文件 identity 與節點 identity 分離，各自保持穩定邊界。
功能: Anchor 驗證、永久定位、reference resolution 與精確導覽。
應用模式: 章節引用、任務步驟、Graph node、證據段落與深層連結。

在 Workspace 查看 Anchor 體驗 →

Record route/records/work-plan-017

XML發佈工作計畫

目的與範圍

x:id="review-gate" 審查關卡#

部署與驗證

Exact targetwork-plan-017#review-gate可被連結、解析與回到同一節點

CurrentLocal + portable locators

參照是一個明示的 locator，不是系統猜出的關係。

x:ref 表示由文件描述決定範圍的 locator；x:ref-uri 提供可攜的 HTTPS URI。Reference projection 讓來源、目標與 backlink 可以被導覽。

特色: 來源 placement、target locator 與授權判斷彼此獨立。
功能: 解析本地 anchor、URI locator、反向連結與失效診斷。
應用模式: 文件依賴、引文、上下游工作、跨資源導覽；typed relation 另由版本化 domain contract 負責。

查看 Reference 與索引 Lab →

來源文件work-plan-017x:ref="policy-004#approval"

resolve→

目標文件policy-004x:id="approval"

←backlink projection

每次 resolve 仍重新套用 Workspace / app scope 與 actor ACL。

CurrentRebuildable views

同一份 XML，可以形成不同角色需要的工作視圖。

表單負責編寫、Graph／Flow 負責 topology 操作、Catalog 與索引負責跨文件發現。切換右側視圖，canonical source 始終不變。

特色: projection 可重建，避免多份資料各自演化。
功能: Form、Graph／Flow、Search／Index 與專屬 Reader。
應用模式: 同一內容服務作者、管理者、讀者與整合程式。

操作 XML → 索引結構 →

Source of truthCanonical XMLwork-plan-017.xml

標題發佈 XFramework 入口狀態Review

Current safeguardsProvenance target

內容可以在 XML，權限與並行控制不能由 XML 自行宣告。

Workspace scope、record identity、owner、visibility、ETag 與 audit 由 Server 管理。廣義 provenance、structured Agent change set 與 review contract 則是明確標示的下一階段。

特色: 內容語意與 authority boundary 分離，避免 metadata 自我授權。
功能: Current：ACL、CSRF、strong ETag、audit snapshot、payload 與 XML 安全限制。
應用模式: 多人交接、審查式發布、受控整合；Agent 身分、patch、diff 與核准仍屬 Target。

查看 Current／Target 邊界 →

PUT canonical XMLIf-Match: "v17"

1ScopeWorkspace + app

2ACLactor can write?

3ETagstill current?

4Validatesafe + conforming?

Atomic commitXML + projectionsnew ETag · audit snapshot

04 · Canonical + derived

內容保留完整語意，投影提供跨文件的觀察方式。

第二層不是另一份手動維護的資料模型。它從 XML 抽出文件種類、搜尋 association、錨點與參照；查到結果後，仍回到原文件閱讀與修改。

Layer 01Canonical XMLAuthoritative · writable through contract

<workPlan xmlns:x="urn:xml-seed-template:architecture">
　<title x:index="TITLE">Release</title>
　<step x:id="review" x:ref="policy#approval">…</step>
</workPlan>

element hierarchy
text + order
identity + locator metadata

Layer 02Derived projectionsQueryable · navigable · disposable

TYPEworkPlan

INDEXTITLE → Release

ANCHOR#review

REFpolicy#approval

Catalog + equality search
anchor resolution
references + backlinks

Server authority

Workspace scope · record identity · owner · visibility · ETag · audit

通用 metadata 慣例是跨應用溝通建議，不是一套新的 blanket schema

TITLE

標題發現與顯示線索；不是唯一值。

IDENTITY

現行 XFramework profile 中是 server-reserved、exactly-one 的 route RecordId mirror。

CURRENTSTATUS

共通狀態描述；不是 visibility，狀態詞彙仍由應用定義。

CONTEXTID

組織與 context 線索；不是 WorkspaceId、owner 或 ACL。

既有強制邊界不變：owner／audit 的權威仍在 Server；任何慣例都不允許任意往 strict profile 插入 metadata，也不因出現在 XML 中而取得授權。

它刻意不做什麼？

索引值不會變成新的 SQL 欄位或 capability token。
多條件交集是 record-level，不推論同一 XML node 的 correlation。
range、full-text、typed relation 與 RAG 需要另外版本化的契約。

查看應用實作範例（非 Framework 詞彙表） →

05 · Application patterns

從通用表單，到需要領域語意的專用畫布。

Repository contract 是儲存與移轉的必要條件；Generic Form 是標準 Workspace 編輯的選用介面。依資料形狀選擇 Generic Form、Flow／Graph 等 Semantic Codec，或專用應用 editor，底層仍回到同一份 canonical XML。metadata 與 references 留在文件本體；檢視介面可以另行投影。

AaCurrent

Generic Form Engine

結構化文件與重複片段

當 XML tree 與使用者編輯結構大致同構，以 template 驅動 scalar、enum、date、hierarchy、repeat、ordering 與 validation。

工作計畫與資料夾設定
內容 metadata 與簡單階層
Media Asset 是通用附件能力的一種參考文件類型
嚴格 semantic round-trip

開啟 Form Demo →

⌁Current

Semantic compound editor

Flow、Graph 與結構關係

當操作涉及 topology、跨節點 join 或一次原子修改多個節點，由註冊過的專用 editor 與 codec 管理。

Graph node / edge
Flow step / route
Relation Set assertions

進入 Workspace 體驗 →

⌕Current

Discovery projection

Catalog、索引與參照導覽

用 DocumentType 與 x:index 找到文件，再以 anchor、reference 與 backlink 回到可讀、可操作的原始內容。

跨類型 equality search
Saved View 消費端組合
節點定位與 backlink

操作索引 Lab →

✦Pilot

Domain composition

敘事知識與多文件組合

將 Work、Unit、Entity、Analysis、Flow、Graph 與 Relation Set 組成可檢索、可導覽的領域體驗，而不把業務詞彙塞進 framework core。

多文件家族協作
專屬閱讀與分析視圖
共同 identity / reference 基礎

查看 Narrative Forms →

06 · Honest capability map

清楚區分已能操作的能力，與下一階段架構。

本頁說明隨新版 XRepo 發布的實作。Template 是實驗性 DEV；Seed 是正式資料來源，兩站的升級與資料切換各自驗證。Current 表示已有實作與契約證據；Target 仍待完成，不代表正式站已啟用。

Current

現在可以驗證

HTML template ↔ DOM ↔ XML strict round-trip
Record / node identity、anchor、reference、backlink
Form、Flow、Graph、Catalog 與 equality index
Workspace scope、ACL、CSRF、strong ETag、audit snapshot
XRepo 的 PostgreSQL canonical XML、可重建 projections 與唯讀 Explorer
單一現行 Definition、批次遷移與歷史唯讀
附件、歷史版本保留、Workspace／個人空間額度

Target

下一階段契約

Mixed-content rich document profile
共同 Anchor／Reference／RelationSet 以外的語意擴充
廣義 provenance / evidence / citation model
Agent identity、scoped patch、diff、review 與 commit
完整 Workshop 候選編輯、審查與發布流程
Seed、Story Atlas、SEL Workbench 各自完成驗證後的後端切換

07 · Guided examples

依你想理解的層次，選一條體驗路徑。

範例是教學入口，不等同於產品工作區。若要保存、管理與跨文件操作，請使用獨立的 Workspace 入口。

約 5 分鐘01

XFramework Workspace

準備從介紹進入實際工作環境？

在 Workspace 中建立與管理 canonical XML 文件，操作 Form、Flow、Graph、Relation、附件、Catalog 與 Saved View，並走完整的權限與 ETag 儲存流程。

Product workspace · Current開啟 XFramework 工作區

同一份知識來源，
形成多種工作視圖。

一個來源

多種投影

受控操作

先看分工，再看功能。

一次修改，走完一條可驗證的往返路徑。

逐項拆解 XFramework 的設計機制。

結構本身就是資料，不只是一組欄位值。

不只找到文件，也能精確回到文件裡的節點。

參照是一個明示的 locator，不是系統猜出的關係。

同一份 XML，可以形成不同角色需要的工作視圖。

內容可以在 XML，權限與並行控制不能由 XML 自行宣告。

內容保留完整語意，投影提供跨文件的觀察方式。

從通用表單，到需要領域語意的專用畫布。

結構化文件與重複片段

Flow、Graph 與結構關係

Catalog、索引與參照導覽

敘事知識與多文件組合

清楚區分已能操作的能力，與下一階段架構。

現在可以驗證

下一階段契約

依你想理解的層次，選一條體驗路徑。

理解 XML ↔ Form 往返

理解 XML → 索引結構

理解多文件應用組合

準備從介紹進入實際工作環境？

同一份知識來源，形成多種工作視圖。

一個來源

多種投影

受控操作

先看分工，再看功能。

一次修改，走完一條可驗證的往返路徑。

逐項拆解 XFramework 的設計機制。

結構本身就是資料，不只是一組欄位值。

不只找到文件，也能精確回到文件裡的節點。

參照是一個明示的 locator，不是系統猜出的關係。

同一份 XML，可以形成不同角色需要的工作視圖。

內容可以在 XML，權限與並行控制不能由 XML 自行宣告。

內容保留完整語意，投影提供跨文件的觀察方式。

從通用表單，到需要領域語意的專用畫布。

結構化文件與重複片段

Flow、Graph 與結構關係

Catalog、索引與參照導覽

敘事知識與多文件組合

清楚區分已能操作的能力，與下一階段架構。

現在可以驗證

下一階段契約

依你想理解的層次，選一條體驗路徑。

理解 XML ↔ Form 往返

理解 XML → 索引結構

理解多文件應用組合

準備從介紹進入實際工作環境？

同一份知識來源，
形成多種工作視圖。