dsh-scholar

DSH 科研插件集

为 DeepSeek Harness（DSH） 提供论文阅读、服务器监控和研究过程管理。三个插件可独立安装，也可以配合使用：保存论文与阅读证据，把想法整理成实验节点，再关联服务器上的训练进度。

本仓库采用单仓库、多 npm 包结构。每个插件有独立的构建入口、配置和 MIT 许可证。

公开范围固定为上表三个插件，以及必要的共享代码、文档和测试。提交前运行 npm run check:scope 和 npm run check:release；可用 git config core.hooksPath .githooks 启用推送前的历史范围检查。

全面适配DSH桌面端

当前源码为三个插件提供统一的桌面工作台界面：紧凑标题栏、文字操作菜单、卡片、搜索筛选、表单和空状态，跟随 DSH 明暗主题并支持键盘焦点与减少动态效果。界面样式不加载外部字体、图片或统计脚本。

• 论文库：分区继续位于左边，论文列表在右边独立滚动；窄面板收紧分区宽度，标题和状态按空间换行。
• 服务器看板：运行、异常、空闲状态计数保持可见，资源卡片与其他插件统一；连接、指纹和凭据操作保留原有保护。
• 研究主线图：清单、DAG、项目切换与实验台账采用统一的工具栏和卡片样式，并跟随桌面当前会话工作区。
• 桌面集成：应用内 PDF/报告预览、原生配置、目录选择、文件定位、对话草稿保护、下载及多个侧栏的空间协调。

Windows 官方桌面版 0.2.1-rc.2 已在隔离环境验证；macOS 尚未做真机验收。安装方式见官方桌面端，检查范围见兼容性说明。本次更新提交源码，不替换历史 v0.3.0 Release 安装包。

公开前的隐私、依赖、安装包和界面检查见提交检查记录。

三个插件如何配合

flowchart LR
  A[论文与阅读报告] --> B[Idea 卡片]
  B --> C[研究目标、假设与实验节点]
  D[SSH 服务器与训练日志] --> E[GPU 状态与实验进度]
  E --> C
  C --> F[实验台账与组会梳理]

关联由用户或对话中的工具操作建立。主线图可以打开关联论文和卡片，也可以匹配已绑定实验的服务器进度；插件不会仅凭一个想法自动启动远端训练。

📚 学者工作台

从文献收藏到阅读报告、交互式追问和 Idea 沉淀，集中放在 DSH 侧栏中。

• 论文库：arXiv / DOI 元数据补全、去重、PDF 附件、阅读状态、星级、分区、保存的筛选和最近浏览。分区栏默认在左侧，可手动收起；长列表独立滚动。
• 精读与追问：内置论文阅读管线，支持论文精读、轻量综合和速读；报告整理结论、证据、实验、局限与出处。完成阅读后，可基于保存的章节片段追问。
• 多篇对比：批量阅读或利用已归档结果，对比方法、证据和适用条件。
• Idea 书柜：分组、看板、表格、网格、列表五种视图，记录来源、创新点、证据和验证状态，支持卡片关联、Markdown 导出与回顾。
• 知识图谱：论文、概念和 Idea 节点；支持标签同步、模型辅助抽取、引用同步以及搜索、聚焦和关系过滤。
• 引用与对话：GB/T 7714、APA、BibTeX 格式，13 个对话工具；内容交付保留宿主输入框的已有草稿和附件。

阅读学者工作台完整介绍 →

🖥️ 服务器看板

通过 SSH 集中观察多台 Linux 服务器，适合同时维护多个 GPU 实验。

• 资源总览：GPU 利用率、显存、温度、功耗、占用进程，以及 CPU、内存、磁盘和负载；GPU 热力图定位到具体主机和显卡。
• 训练日志：手动指定或自动发现日志，展示尾部内容与曲线，解析常见键值、epoch、tqdm、YOLO 表格和 JSON 行格式。
• 图表与整理：曲线平滑、多卡叠图、放大查看、CSV 导出；主机可固定或收起，异常状态集中展示。
• 告警与恢复：主机失联、高温、日志停滞、进程消失等提示；失败采用退避重试，也可立即重试。
• 连接管理：密钥、密码和 SSH 配置导入，校验已记录的主机指纹，通过宿主管理凭据。配置冲突保留草稿并要求重新核对。

远端操作以读取系统状态、进程和日志为目的。日志停滞或进程消失是需要检查的信号，并不等于已经确认训练失败。

阅读服务器看板完整介绍 →

🧭 研究主线图

把研究目标、假设、实验、阅读与写作放进同一份项目记录，按 DSH 工作区定位。

• 目标与假设：记录研究问题、目标演变和假设状态，保留过程信息。
• 清单与 DAG：清单展示主线、分支和实验台账；有向图表达推进、输入和组成关系，写入时拒绝新建环路。
• 实验台账：记录做了什么、关键数据、结构化指标、结论和日期，支持回看及组会整理。
• 跨插件关联：按名称查找论文、Idea 和服务器，保留稳定 ID；服务器预览使用缓存，进度匹配有歧义时不会任意选择 GPU。
• 编辑保护：关联字段计入未保存草稿；节点与主线调整一次写入，避免只保存一半。
• 对话维护：14 个工具覆盖项目、目标、假设、节点、实验条目与关系；当前工作区的进展摘要可进入宿主对话上下文。

阅读研究主线图完整介绍 →

安装与更新

支持 DSH Web 与官方 DSH Desktop。桌面适配已在 Windows 官方桌面版 0.2.1-rc.2 的隔离环境验证；插件保留旧版 SettingsProvider 的兼容入口。开发需要 Node.js 20 或以上，桌面运行使用宿主自带的运行时。

npm 已发布版本

dsh plugin --profile web add dsh-scholar-desk
dsh plugin --profile web add dsh-server-dashboard
dsh plugin --profile web add dsh-trajectory

按需安装一个或多个。安装或升级后，完整重启 DSH 宿主并重新加载页面。

**GitHub Release v0.3.0 已包含三个插件的预构建包与 SHA-256 校验文件。**见 v0.3.0 下载与升级说明。本次 GitHub 发布不包含 npm 发布，上述包名安装命令仍使用 npm 上的已发布版本。

当前源码

建议使用不含空格的克隆路径。下面的命令均在仓库根目录执行：

git clone https://github.com/smilewhenever777/dsh-scholar.git
cd dsh-scholar
npm ci --prefix dsh-scholar
npm ci --prefix dsh-server-dashboard
npm ci --prefix dsh-trajectory
npm run build --prefix dsh-scholar
npm run build --prefix dsh-server-dashboard
npm run build --prefix dsh-trajectory
dsh plugin --profile web add ./dsh-scholar
dsh plugin --profile web add ./dsh-server-dashboard
dsh plugin --profile web add ./dsh-trajectory

只需要一个插件时，只执行对应的安装、构建和注册命令。部分宿主版本对含空格的本地路径处理不完整，排查方式见插件安装说明。

看板本轮采用带 revision 的配置协议，应同时加载新宿主与新客户端。遇到配置冲突请重新加载并核对草稿。

官方桌面端

本轮桌面适配位于当前源码，历史 v0.3.0 标签和 Release 安装包不包含这些新增改动。先启动桌面端一次以初始化 profile，并从托盘完整退出。按上面的源码步骤安装依赖、构建，再使用桌面应用“管理 dsh 命令”提供的 CLI。在 PowerShell 的仓库根目录执行：

$pluginRoot = (Get-Location).Path.Replace('\', '/')
dsh plugin --profile desktop add "link:$pluginRoot/dsh-scholar"
dsh plugin --profile desktop add "link:$pluginRoot/dsh-server-dashboard"
dsh plugin --profile desktop add "link:$pluginRoot/dsh-trajectory"

桌面端使用独立的 desktop profile。只安装到 web profile 不会为官方桌面端启用插件。安装后从托盘菜单完整退出 DSH，再重新启动；关闭窗口可能只是隐藏应用。

• 三个插件共用抽屉布局；空间不足时保留最近展开的面板，其他面板收成可点击的窄栏。原生右栏展开后若无法并排，插件抽屉退回左侧入口；重新展开插件会让原生右栏收起。
• 学者工作台在应用内预览 PDF 和报告，保留报告脚本沙箱；不会将应用内文档链接交给外部浏览器。
• 主线图跟随桌面实际显示的会话工作区，文件引用使用宿主“显示文件位置”能力；不可用时明确提示复制结果。
• 学者与主线设置可调用宿主目录选择器；选择目录后仍需保存。Web 环境保留手工填写方式。
• 桌面与 Web 的设置、凭据属于各自的宿主配置；迁移时核对数据目录和凭据，不会自动复制另一份 profile 的服务器密钥。

适配细节、审查结果和验证范围见 桌面兼容性说明。

数据存在哪里，哪些操作会联网

三个插件没有独立遥测。自定义 HTTP 路由限制本机 loopback 并检查浏览器来源；对局域网开放宿主 Web UI 不会同时开放这些路由。凭据存储保护由宿主 provider 实现，“保存在本地”不代表一定经过加密。

开发与验证

安装三个插件的依赖后，在仓库根目录运行：

npm ci
npx playwright install chromium
npm test
npm run check:release

npm test 构建三个插件并检查存储、路由、凭据、界面、契约和滚动。check:release 检查 Git 候选文件、常见敏感信息模式、公开链接和 npm 文件清单。三个插件打包前都会重新构建。

本轮覆盖 328 项断言，并在干净目录重新安装依赖、构建。浏览器使用真实组件与合成数据，SSH、模型和凭据写入使用隔离替身；不能替代用户真实服务器和模型的验收。详见 测试说明。

运行数据、设置备份、诊断日志、截图和依赖目录被 Git 规则排除。

文档与更新记录

许可证

三个插件均采用 MIT 许可证，具体声明见各插件目录的 LICENSE。