dsh-paper-reader
DSHA 论文阅读器：输入框点「论文」进入三栏界面 —— 左：工作区文稿目录树；中：黑底论文（PDF 走 pdf.js）；右：随时可聊的实时 Agent 对话（总结只是开场白）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:iasmndjxjz/dsh-paper-reader#a3d32a58dd07d135ce0d1698234c3b033d751845Paper Reader 以 dsh-paper-reader 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →DSHA（DeepSeek Harness）插件：论文阅读器。两种形态，随时切换，中间的聊天永远可用。
三栏形态（输入框右侧点「论文」）：
┌──────────┬────────────────────────┬─────────────────────┐
│ 目录 │ 论文正文（黑底） │ 实时对话 │
│ 工作区树 │ Markdown / PDF(pdf.js)│ 真 Agent · 流式 · 随时可聊 │
└──────────┴────────────────────────┴─────────────────────┘
停靠形态（三栏里点「停靠」，或从右侧栏打开）：论文+目录挂在右侧栏，中间的原生聊天一动不动，点「三栏阅读」切回来。
ctx.agents 创建/恢复，挂上 Agent 预设 → 工具齐备），
面板只是把它流式增量画成气泡；会话会落盘，重启后接着聊，也会出现在会话列表里。dsha-plugin import /tmp/dsh-paper-reader.zip # 打包方式见下
# 插件行是 patchReload: startup → 在 App 里重启一次 DSHA Web 生效
打包（zip 里必须有一层 dsh-paper-reader/，且不要带 node_modules）：
python3 - <<'PY'
import zipfile, os
root, out = '/root/dsh-paper-reader', '/tmp/dsh-paper-reader.zip'
with zipfile.ZipFile(out, 'w', zipfile.ZIP_DEFLATED) as z:
for base, dirs, files in os.walk(root):
dirs[:] = [d for d in dirs if d not in ('node_modules', '.git')]
for f in files:
full = os.path.join(base, f)
z.write(full, os.path.relpath(full, '/root'))
PY
卸载：dsha-plugin delete dsh-paper-reader（同样需重启）。
Esc / 「返回对话」回到原聊天。| 环境变量 | 说明 |
|---|---|
DSHA_PAPER_ROOTS | 追加可读根目录（: 分隔）。默认只有 dsh 进程工作目录（本机 = /root）。例：DSHA_PAPER_ROOTS=/sdcard/Download:/sdcard/Documents |
DSHA_PAPER_PDFJS_DIR | 覆盖 pdfjs-dist 所在目录（默认插件内 node_modules/pdfjs-dist） |
全部挂在 prefix /api/paper-reader，复用浏览器鉴权（未鉴权 401、非信任域 403）：
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /health | {ok, roots, version, chat:{available, model}} |
| GET | /tree?root=&all=1 | 工作区文稿目录树 |
| GET | /file?path= | 单篇：{kind, text, rawUrl, size, mtime} |
| GET | /raw?path=&download=1 | 原始字节（PDF/图片，正确 MIME + CSP sandbox） |
| GET | /text?path= | pdf.js 抽取的文字（PDF / 文本；带缓存） |
| GET | /pdfjs/* | 转发 pdfjs-dist 静态资源（主模块/worker/cmaps/standard_fonts/wasm） |
| GET | /chat?path= | 这篇论文的对话历史 {sessionId, messages, chat} |
| POST | /chat | 驱动真 Agent，NDJSON 流：start / delta / tool / done / error / cancelled |
| POST | /chat/cancel | 停止正在跑的一轮 |
| POST | /chat/reset | 清空这篇论文的对话（下次开新会话） |
| POST | /summary | 旧的一次性总结接口（走 ctx.llm，保留备用） |
安全边界：路径先 realpath 再按路径边界校验必须落在允许根目录内（防 .. 与同前缀逃逸），不跟随软链接，目录树跳过隐藏目录/node_modules/dist，节点上限 1500。
/sdcard 默认不在可读范围，需用 DSHA_PAPER_ROOTS 显式开启。patchReload: startup：安装/更新/卸载后都要重启 DSHA Web。cd /root/dsh-paper-reader
pnpm install --ignore-scripts # devDependencies：react / react-dom / jsdom（pdfjs-dist 是运行时依赖）
pnpm test
test/test-host.mjs：文件接口、越界/穿越防护、鉴权 401/403。test/test-chat.mjs：真 http 服务 + 假 agents 服务，覆盖会话创建/恢复、预设挂载、上下文注入、
流式事件、工具名、取消、重置、模型失败要暴露、PDF 抽取（真 pdf.js）、pdfjs 资源转发。test/test-client.mjs：jsdom + react-dom 真挂载，覆盖三栏、目录树、Markdown、实时对话
（历史/发送/流式/工具标签/停止/新对话）、PDF 走 pdf.js 并自动退回 iframe、停靠模式与两种形态互切。| 文件 | 作用 |
|---|---|
lib/index.js | 宿主半：路由层（文件/PDF 抽取/对话/总结）与路径安全 |
lib/chat.js | 论文对话引擎：会话映射落盘、真 Agent 创建/恢复、Agent 预设挂载、流式转发 |
lib/pdf-text.js | pdf.js：宿主侧文字抽取 + 浏览器侧资源定位 |
lib/client.js | 浏览器半：输入框按钮、三栏面板、停靠标签、自带 Markdown 渲染与样式 |
test/*.mjs | 三套集成测试 |
MIT。