AIA-Wiki Schema

Datasys 開發的 Agent 專用知識庫規範。每次 session 開始必須先讀此檔案。


目錄結構

/sandbox/wiki/
├── SCHEMA.md                        # 本檔案(規範)
├── index.md                         # 頁面目錄(自動維護)
├── log.md                           # 操作日誌(append-only)
├── [img_xxx.jpg]                    # 圖片放根目錄
├── entities/
│   ├── companies/[Company].md
│   ├── products/[Product].md
│   └── events/[Event].md
├── concepts/[Concept].md
├── analysis/
│   └── [event-name]/[Article].md
└── raw/
    └── images/                      # 圖片備份

圖片規則

  • 圖片檔存放於 wiki 根目錄(與 index.md 同層)
  • 文章內引用語法:![[img_xxx.jpg]]
  • raw/images/ 為備份,不在文章中直接引用

Frontmatter 規範

---
title: 頁面標題
type: company | product | concept | analysis | event | schema
tags: [tag1, tag2]
created: YYYY-MM-DD
---

各類型頁面必填欄位

company

  • title、tags
  • 公司簡介(一段)
  • 產品列表(wikilink)
  • 技術專長(wikilink 到 concepts)
  • 相關分析(wikilink 到 analysis)

concept

  • title、tags
  • 技術說明
  • 採用廠商(wikilink 到 companies)

analysis

  • title、type: analysis、tags、company(wikilink)
  • ![[img_xxx.jpg]] 圖片嵌入
  • 場景分析 yaml block
  • 相關頁面 wikilinks

用途語法
跨頁連結[[PageName]]
顯示別名[[PageName|顯示文字]]
圖片嵌入![[img_xxx.jpg]]

分析文章存檔路徑

/sandbox/wiki/analysis/<event-name>/<subject-sanitized>.md

event-name 命名:活動名稱(如 2026-expo),不明時使用 YYYY-MM


操作後必做

  1. 更新 index.md — 在對應區塊加入新頁面
  2. Append log.md — 格式:|- <YYYY-MM-DD HH:MM> <操作描述>: <路徑>

index.md 規範(重要)

更新 index.md 時,必須保留以下固定 header,不得修改

---
title: AIA-Wiki Index
type: index
tags: [index]
---
 
# AIA-Wiki
 
> Datasys 開發的 Agent 專用知識庫系統。基於 LLM-Wiki 概念,以 Markdown AI 可讀格式為核心,支援可視節點與即時部署。

header 之後才是目錄內容。禁止在 header 加入 Last updatedTotal pages 等動態資訊。