# Source architecture

`dsh-pdf-reader` 是一个 DeepSeek Harness 双面插件：根目录下的 TypeScript 运行在主机侧，`client/` 构建为浏览器侧阅读器。两侧通过 Harness 提供的公开接口交换有界索引、OCR 授权和页面结果。

## 主机侧

- `index.ts`：插件入口，注册 PDF 文档工具、OCR 授权代理和惰性资源路由
- `limits.ts`：文件、Canvas、索引和资料等共享资源边界
- `pdf-format.ts`：PDF 输入格式校验
- `pdf-document-index.ts`：按对话保留的多文档原生文字索引、容量边界与来源链接协议
- `pdf-ocr.ts`：OCR 授权、预算和浏览器代理协议

## 浏览器侧

- `client/index.ts`：浏览器入口，注册 Harness 插槽并连接主输入框
- `client/PdfPanel.tsx`：多文档标签、文件生命周期和阅读窗口
- `client/PdfViewer.tsx`：pdf.js 页面渲染、选择、截图、缩放、旋转和虚拟化
- `client/PdfOutlineSidebar.tsx`：目录、书签和搜索入口
- `client/PdfAnnotationDrawer.tsx`：批注中心
- `client/PdfEvidenceDrawer.tsx`：跨 PDF 图文资料及批量 AI 操作
- `client/PdfThumbnailDrawer.tsx`：虚拟化缩略图导航
- `client/PdfToggle.tsx`：打开或收起阅读器的浮动入口

## 主要模块

- `client/composer-*.ts`：文字、图片和图文联合请求与 Harness composer 的兼容边界
- `client/pdf-annotations.ts`、`client/pdf-annotation-save.ts`：批注模型、恢复与标准 PDF 写入
- `client/pdf-bookmarks.ts`、`client/pdf-outline.ts`：书签编辑和目录投影
- `client/pdf-evidence.ts`、`client/pdf-citations.ts`：图文资料、来源编号和回答回链
- `client/pdf-session-store.ts`：按对话持久化 PDF 标签、阅读状态和共享资料
- `client/pdf-document-index-sync.ts`、`client/pdf-background-index.ts`、`client/pdf-index-policy.ts`：浏览器与主机间的有界文字索引同步、空闲分批与图片文档探测策略
- `client/pdf-ocr-client.ts`、`client/ocr-runtime.ts`：用户授权后的按需 OCR、有界 LRU 页面缓存和运行时释放
- `client/pdf-search.ts`、`client/pdf-text-selection.ts`：原生文字搜索与选择
- `client/pdf-page-layout.ts`、`client/pdf-rotation.ts`、`client/geometry.ts`、`client/render-constraints.ts`：页面布局、坐标变换和资源约束
- `client/pdfjs.ts`：pdf.js、Worker 和内置二进制资源入口

构建由根目录的 `tsdown.config.ts` 生成主机入口、浏览器 bundle 和惰性 OCR 运行时；插件清单位于 `package.json` 与 `cordis.yml`。