能力浏览器
设计插件前，搜索完整的公开目录。每项能力都独立版本化；每项依赖都必须写入 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 视图和生命周期检查器，使用相同的运行时目录，并显示更新时的权限差异和能力不可用的确切原因。