插件架构

PathTogether 提供宿主、数据和权限；插件只获得完成当前任务所需的能力。HistoPilot 是第一个完整 AI 插件，但协议不把平台绑定在 HistoPilot 上。

什么是 PathTogether 插件

一个可运行插件由三部分组成：描述身份、版本和权限的 manifest；运行在 sandbox iframe 中的 UI bundle；以及按需独立部署的后端服务。PathTogether 负责安装关系、来源校验、授权和能力 API，不提供插件市场。

两条通信通道

HostBridge：浏览器中的 Viewer 协作。 iframe 通过受校验的 request、response 和 event 消息读取当前 viewport、请求跳转、获得短期 UI 会话或同步标注变化。插件不能直接访问平台 DOM、OpenSeadragon 实例或全局变量。

Plugin Contract：服务端能力调用。 插件后端通过版本化 /api/plugin/v1 获取 capability、读取授权切片的 metadata/region、监听事件并创建标注。访问 token 短期有效且带 installation、用户、切片和方法范围；平台仍会根据当前数据库状态再次鉴权。

┌ PathTogether Web ─────────────────────────────┐
│ Viewer / annotations / sharing               │
│      ↕ HostBridge                            │
│ HistoPilot UI (sandbox iframe)                │
└──────────────────────┬────────────────────────┘
                       │ same-origin gateway
┌ PathTogether API ────┴────────────────────────┐
│ auth / slide / region / annotation / events  │
└──────────────────────┬────────────────────────┘
                       │ /api/plugin/v1 + scoped token
                HistoPilot service

谁拥有什么

• PathTogether：用户、项目、切片与资产版本、标注、评论、分享、权限、插件 installation 和操作记录；
• HistoPilot：模型配置、AI session、message/event、compaction、视觉工作集与缓存；
• 正式 AI 标注：保存在 PathTogether，并带上 plugin、run、model 和创建者来源；
• 明确禁止共享：数据库表、WSI 文件路径、平台全局对象和长期服务凭据。

安装、运行与停用

1. owner 安装并批准 manifest/UI bundle；
2. 平台为 installation 创建可轮换凭据并授予最小权限；
3. 用户打开插件面板并为当前任务建立短期授权；
4. 插件后端只在授权范围内读取 region 或写入标注；
5. 停用 installation 后，新 token 交换和后续能力调用立即失败；人工工作流继续运行。

HistoPilot-DSH 不在这条插件链里

HistoPilot-DSH 是 DeepSeek Harness 的工具适配器，位于 HistoPilot 上游。它调用 HistoPilot 的高层任务接口，不安装进 PathTogether，也不直接使用 PathTogether 的 Viewer HostBridge。

• PathTogether 插件目录
• HistoPilot 插件