<!-- Generated from Home.md by scripts/build_docs_site.py -->

# Asset-Aware MCP Docs

Asset-Aware MCP 是給 AI agents 使用的 citation-ready 文件工作流伺服器。它把
PDF、DOCX/DFM、表格、圖片、section、citation index、Foam evidence pack 與選用
KG/RAG 串成可驗證的文件流程。

這個網站改成章節式導覽：先選你正在做的任務，再進入對應的詳細頁或 reference。
目前內容對齊 `0.7.0` 正式文件。

## 0.7.0 highlights

- `document(op="pointer_index")`, `document(op="structural_retrieve")`, and
  `document(op="compare")` add section-level structural retrieval and
  comparison without increasing the balanced public tool count.
- `document(op="audit")` now covers safety, native structure, segmentation
  coverage, and accessibility readiness artifacts.
- A2T tables now use stable row IDs, row search/filter/paging, citation
  coverage, artifact-only large-table render, and explicit skipped-large-table
  UX.

<div class="path-grid">
  <section class="path-card">
    <p class="card-kicker">Path 1</p>
    <h3>先跑起來</h3>
    <p>安裝、設定 MCP client、檢查 runtime、確認 VS Code extension 或 stdio server 可用。</p>
    <p><a href="#/getting-started">快速開始</a> · <a href="#/vs-code-extension">VSIX / MCP 設定</a></p>
  </section>
  <section class="path-card">
    <p class="card-kicker">Path 2</p>
    <h3>選文件流程</h3>
    <p>PDF、章節導覽、DOCX/DFM、A2T table 先分流，不混在同一頁。</p>
    <p><a href="#/workflow-chapters">流程章節</a> · <a href="#/pdf-workflow">PDF</a> · <a href="#/docx-dfm-workflow">DOCX</a></p>
  </section>
  <section class="path-card">
    <p class="card-kicker">Path 3</p>
    <h3>建立可驗證證據</h3>
    <p>所有 claim 都回到 span、locator、hash、context 與 citation bundle；LLM wiki 是呈現層。</p>
    <p><a href="#/citation-provenance">引用與證據</a> · <a href="#/llm-wiki">LLM Wiki</a> · <a href="#/knowledge-graph">KG</a></p>
  </section>
  <section class="path-card">
    <p class="card-kicker">Path 4</p>
    <h3>維運、reference 與上線 gates</h3>
    <p>長任務、ETL profile、精確 tool/resource contract、code 位置、release 檢查集中在這條路徑。</p>
    <p><a href="#/tool-chooser">Tool Chooser</a> · <a href="#/mcp-tools">MCP Tools</a> · <a href="#/release-testing">Release</a></p>
  </section>
</div>

## 最短路徑

| 你要做什麼 | 先讀 | 然後讀 |
|---|---|---|
| 第一次安裝 | [快速開始](#/getting-started) | [VS Code Extension And MCP Setup](#/vs-code-extension) |
| 處理 PDF | [流程章節](#/workflow-chapters) | [PDF Document Workflow](#/pdf-workflow) |
| 找章節與定位 | [Document Sections And Navigation](#/document-sections) | [Citation Provenance](#/citation-provenance) |
| 編輯 Word / DFM | [流程章節](#/workflow-chapters) | [DOCX DFM Workflow](#/docx-dfm-workflow) |
| 產出引用結論 | [Citation Provenance](#/citation-provenance) | [LLM Wiki Knowledge Base](#/llm-wiki) |
| 建立 LLM wiki | [LLM Wiki Knowledge Base](#/llm-wiki) | [Knowledge Graph](#/knowledge-graph) |
| 做表格 | [A2T Tables](#/a2t-tables) | [DOCX DFM Workflow](#/docx-dfm-workflow) |
| 查完整 API | [Tool Chooser](#/tool-chooser) | [MCP Tools](#/mcp-tools) |
| 追背景任務或 ETL | [Background Jobs](#/background-jobs) | [ETL Profiles](#/etl-profiles) |
| 準備發布 | [Release And Testing](#/release-testing) | [Git Harness Hygiene](#/git-harness-hygiene) |

## Code 對齊

網站內容由 `docs/wiki/**` 產生到 GitHub Pages payload。工具與 resource 數量來自
`src/presentation/tools/**`、`src/presentation/resources/**`，並由
`tests/unit/test_docs_site_reference_sync.py` 檢查 reference、metadata、連結與 endpoint 統計。
