能力瀏覽器
設計外掛前，搜尋完整的公開目錄。每項能力都獨立版本化；每項依賴都必須寫入 manifest 的 requires 部分。
29 項能力
能力
library領域 · v 1.0.0- 外掛可以
- 讀取書籍、檔案、元資料、目錄、集合，以及匯入或移除書庫項目。
- 授權
library:read / library:write- 宿主負責
- 書庫不變條件、事件溯源寫入、檔案和投影。
reading領域 · v 1.0.0- 外掛可以
- 檢視目前會話，並導覽、更新位置、進度和閱讀時間。
- 授權
reading:read / reading:write- 宿主負責
- 閱讀器生命週期、進度語意和已提交事件。
annotations領域 · v 1.0.0- 外掛可以
- 透過標準命令讀取或更改反白和筆記。
- 授權
annotations:read / annotations:write- 宿主負責
- 驗證、歸屬、持久性和事件順序。
conversations領域 · v 1.0.0- 外掛可以
- 讀取書籍和全域執行緒摘要。
- 授權
conversations:read- 宿主負責
- 對話寫入、提示語組裝和記憶。
settings領域 · v 1.0.0- 外掛可以
- 發現、讀取、更新並訂閱明確授權的設定路徑。
- 授權
settingsAccess- 宿主負責
- 目錄、目標、驗證、持久性和變更效果。
selectionActions貢獻 · v 1.0.0- 外掛可以
- 向選取區和標註選單加入命令。
- 授權
無- 宿主負責
- 選單位置、呼叫介面、載入和無障礙。
headerActions貢獻 · v 1.0.0- 外掛可以
- 加入閱讀器或書庫工具列動作，並顯示由宿主算繪的檢視。
- 授權
無- 宿主負責
- 位置、導覽、彈出層、頁面和焦點。
commands貢獻 · v 1.0.0- 外掛可以
- 加入顯式的命令面板命令。
- 授權
無- 宿主負責
- 註冊表、面板、快速鍵和結果呈現。
settingsOptions貢獻 · v 1.0.0- 外掛可以
- 為一個已宣告的外掛設定解析動態選項。
- 授權
無- 宿主負責
- 表單算繪、備用輸入和數值驗證。
voiceProviders貢獻 · v 1.0.0- 外掛可以
- 列出聲音並合成用於朗讀的編碼音訊。
- 授權
無- 宿主負責
- 播放、節奏、預先擷取、反白和備援。
contentProviders貢獻 · v 1.0.0- 外掛可以
- 為 RSS 等虛擬書籍載入章節。
- 授權
無- 宿主負責
- 書庫繫結、閱讀模型、導覽和呈現。
readerModes貢獻 · v 1.0.0- 外掛可以
- 提供受限的句子或段落分段。目前僅限內建外掛。
- 授權
reader:modes- 宿主負責
- 閱讀器控制項、生命週期、算繪和導覽。
agentTools貢獻 · v 1.0.0- 外掛可以
- 註冊閱讀助理可以呼叫的命名空間工具。
- 授權
agent:tools- 宿主負責
- 編排、工具可見性、核准和對話介面。
agentContextProviders貢獻 · v 1.0.0- 外掛可以
- 為目前使用者輪次回傳受限的參考區塊。
- 授權
agent:context- 宿主負責
- 來源、裁切、提示語位置和生命週期。
agentRetrievalProviders貢獻 · v 1.0.0- 外掛可以
- 將可搜尋的外掛來源公開為命名空間助理工具。
- 授權
agent:retrieval- 宿主負責
- 查詢 schema、限制、結果裁切和工具描述。
memoryCandidateProviders貢獻 · v 1.0.0- 外掛可以
- 在一輪對話後提出事實、偏好、洞察或摘要。
- 授權
agent:memory- 宿主負責
- 範圍檢查、去重、接納和持久記憶寫入。
themes貢獻 · v 1.0.0- 外掛可以
- 提供語意化應用程式和閱讀器主題資料。
- 授權
ui:themes- 宿主負責
- 驗證、CSS 產生、選取和套用。
fonts貢獻 · v 1.0.0- 外掛可以
- 提供獲核准的字型元資料和內建字型資源。
- 授權
ui:themes- 宿主負責
- 檔案驗證、載入、選取器項目和目前選取。
storage服務 · v 1.0.0- 外掛可以
- 使用外掛專屬範圍的 KV 和文件集合。
- 授權
無- 宿主負責
- 命名空間隔離、持久性、快照和變更事件。
secrets服務 · v 1.0.0- 外掛可以
- 在外掛專屬範圍的金鑰槽中存取憑證。
- 授權
無- 宿主負責
- 加密、不揭露和命名空間隔離。
ui服務 · v 1.0.0- 外掛可以
- 顯示宿主提示，或開啟宿主儲存/匯出流程。
- 授權
無- 宿主負責
- 呈現、路徑選取和平台整合。
schedules服務 · v 1.0.0- 外掛可以
- 將工作繫結到 manifest 宣告的週期任務。
- 授權
無- 宿主負責
- 頻率、啟動時補執行、防止重疊和釋放。
session服務 · v 1.0.0- 外掛可以
- 訂閱目前閱讀會話的受限事實。
- 授權
無- 宿主負責
- 事件來源、資料範圍和訂閱生命週期。
network服務 · v 1.0.0- 外掛可以
- 透過原生宿主客戶端發出 HTTP 請求。
- 授權
service:network- 宿主負責
- 權限強制、傳輸和回應橋接。
llm服務 · v 1.0.0- 外掛可以
- 進行受限的一次性文字或結構化模型呼叫。
- 授權
service:llm- 宿主負責
- 供應商設定、憑證、schema 處理和限制。
clipboard服務 · v 1.0.0- 外掛可以
- 向系統剪貼簿寫入文字。
- 授權
service:clipboard- 宿主負責
- 平台呼叫和權限強制。
viewsSchema · v 1.0.0- 外掛可以
- 回傳 markdown、清單、表單、詳情和受限區塊樹。
- 授權
無- 宿主負責
- 元件、HTML 安全、版面、無障礙和導覽。
settingsSchema · v 1.0.0- 外掛可以
- 宣告由宿主算繪的外掛設定欄位。
- 授權
無- 宿主負責
- 表單行為、驗證、儲存路由和金鑰處理。
themesSchema · v 1.0.0- 外掛可以
- 宣告語意主題權杖和內建字型元資料。
- 授權
無- 宿主負責
- 語法驗證、產生 CSS、載入和選取。
如何閱讀目錄
- 授權表示呼叫時需要的權限或精確設定授權。
- 無表示不需要額外的安裝權限，並不代表存在未記錄的環境能力。
- 宿主負責標記外掛無法替換或繞過的邊界。
- 每項能力旁的版本直接來自宿主的標準能力目錄。
readerModes 在特權閱讀器契約確定前仍僅限內建外掛。manifest 只能指名目錄中的能力；宿主仍會根據 actor、權限、版本和生命週期階段篩選可見的執行時檢視。
權限預覽
貼上 manifest，將使用者授權與相容性及執行宣告分開。它反映安裝同意的意義，但不能替代儲存庫驗證器，也不能證明外掛可以啟用。
審核預覽
使用者授權 · 語意權限
annotations:read— 讀取反白和筆記。agent:retrieval— 向助理公開可搜尋的外掛來源。service:network— 發出由宿主中介的網路請求。
使用者授權 · 精確設定授權
- 發現
appearance.theme - 讀取
appearance.theme
相容性 · 不是權限
- 領域
annotations^1.0.0 - 領域
settings^1.0.0 - 貢獻
commands^1.0.0 - 貢獻
agentRetrievalProviders^1.0.0 - 服務
storage^1.0.0 - 服務
schedules^1.0.0 - 服務
network^1.0.0 - Schema
settings^1.0.0
執行宣告 · 不是權限
- 私有資料 schema:
1 - 1 個週期任務
安裝對話框實際授予什麼
語意 permissions 和精確的 settingsAccess 項目授予權限。正式的同意對話框會用直白的語言呈現二者。能力要求、排程任務、schema 版本、主題和字型可作為審核上下文，但不會被悄悄重新標記為權限。
此預覽刻意保持本機且無狀態。下一步開發工具是在應用程式內提供 actor 檢視和生命週期檢查器，使用相同的執行時目錄，並顯示更新時的權限差異和能力無法使用的確切原因。