dsh-paperpanel
DSH Web 中类似 Zotero 的论文和数据资料库面板——专注于 PDF/Word 阅读、选取内容添加笔记，以及直接编辑电子表格。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Floatingfur/dsh-paperpanel#c638807261486977c66ae44c6d9335b72ec3eb99
Paperpanel 以 dsh-paperpanel 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English · 简体中文
Turn papers (PDF/Word/TXT/MD) and data (CSV/TSV/Excel) from your local folders into a Zotero-style library, presented as a right-side floating drawer in DSH Web — browse papers on the right, read in a centered window, jot notes as you read, and edit spreadsheets in place.
shell.overlay; does not occupy the built-in details slot):
item list + type filters (All/Papers/Data/Notes). The Import button imports a whole folder or individual files
(choose a target directory; duplicate names get a timestamp suffix automatically). Hit Refresh after importing to see the new items.
screenshot
screenshotpdf.js (multi-page, selectable text layer)
screenshotdocx-preview (keeps headings/bold/tables); legacy .doc prompts you to resave as .docx同名.notes.md (<name>.notes.md) file
screenshot.bak backup is made first); sorting, search, pagination, ECharts charts (bar/line/pie) and column stats;
rows beyond 2000 become read-only automatically
screenshotpaperpanel_read and explain/summarizeclient/paperpanel-client.js (a single CommonJS file) → scripts/build-client.mjs builds client.js;
frontend libs (JSZip/docx-preview/SheetJS/ECharts/pdf.js) are inlined at build time — works fully offlinelib/scan.mjs, lib/read.mjs (pure Node, zero third-party deps)# Option 1: npm (once published)
dsh plugin --profile web add dsh-paperpanel
# Option 2: GitHub source
dsh plugin --profile web add github:Floatingfur/dsh-paperpanel
# Option 3: local development (link)
# In the web profile's package.json dependencies add "dsh-paperpanel": "link:<absolute path to this repo>"
# and add "dsh-paperpanel" under dsh.profile.bundles, then restart dsh web
After installing, restart dsh web and the Library drawer appears on the right.
Set the scanned root folders under config.libraryRoots in cordis.patch.yml (the sample points at samples).
Drop papers/data into those folders (or subfolders) and press Refresh in the drawer, or use the Import button to bring files in.
npm run build:client # regenerate client.js after editing client/ sources
Start dsh (auto-cleans a stale instance holding port 3080 first, to avoid EADDRINUSE multi-instance conflicts):
powershell -NoProfile -ExecutionPolicy Bypass -File scripts\start-dsh.ps1
dsh-paperpanel/
package.json # exports / dsh.bundle / dsh.client
cordis.patch.yml # bundle insert declaration (default libraryRoots)
index.mjs # Node half: HTTP routes + agent tools paperpanel_search / paperpanel_read
lib/scan.mjs # recursive scanning core
lib/read.mjs # text/CSV preview core
client/paperpanel-client.js # client source (drawer + centered reader)
scripts/build-client.mjs # bundler-free build (inlines vendor)
scripts/start-dsh.ps1 # start script (clears port 3080 stale instance)
scripts/vendor/ # frontend third-party UMD files (inlined into client.js at build)
client.js # build artifact (shipped with the plugin)
samples/ # smoke-test samples
GET /paperpanel/api/roots → { ok, roots }GET /paperpanel/api/manifest → { ok, scannedAt, roots, itemCount, items[] }GET /paperpanel/api/preview?path=… → text previewGET /paperpanel/api/file?path=… → raw file (used by PDF/Word rendering and the spreadsheet workbench)POST /paperpanel/api/import?name=…&dir=… → import a file into a data folder (allow-listed)POST /paperpanel/api/save → { path, content, encoding } writes the file back (backs up the original to .bak first)GET/POST /paperpanel/api/note?path=… → read/save the item's .notes.md notepaperpanel_search: search the catalog by title/path keyword or type.paperpanel_read: read an item's content (text body / CSV headers+rows / PDF metadata).To appear in DSH's plugin marketplace (dshmarket), submit to the curated list
awesome-dsh-plugin: add an entry
(plugin name, npm package, GitHub repo, description, screenshots, …); the site and marketplace pick it up
automatically, usually within a day. The marketplace only installs sources on the curated list — anything
else must be installed manually with dsh plugin add.
details slot is a single seat and this plugin deliberately does not occupy it; it uses
shell.overlay (the official additive overlay seat) instead.inputActions are bridged in through the session-header button — Ask AI to explain
is disabled when there is no active session.原文件.bak.*.notes.md note files are excluded from scanning so they never pollute the catalog.dsh.engines.dsh is declared, so it stays compatible across dsh versions and never breaks boot on a version mismatch.