dsh-scholar

DSH 科研插件集

为 [DeepSeek Harness（DSH）](https://www.npmjs.com/package/@deepseek-ai/dsh) 提供论文阅读、服务器监控和研究过程管理。三个插件可独立安装，也可以配合使用：保存论文与阅读证据，把想法整理成实验节点，再关联服务器上的训练进度。

| 插件 | 适合解决的问题 | npm 包 |

|---|---|---|

| [📚 学者工作台](./dsh-scholar/README.md) | 论文存在哪里、讲了什么、哪些想法值得验证 | dsh-scholar-desk |

| [🖥️ 服务器看板](./dsh-server-dashboard/README.md) | 哪台机器在运行什么、训练是否停滞、GPU 是否异常 | dsh-server-dashboard |

| [🧭 研究主线图](./dsh-trajectory/README.md) | 当前研究目标是什么、证据如何积累、下一步推进哪个节点 | dsh-trajectory |

本仓库采用单仓库、多 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 尚未做真机验收。安装方式见[官方桌面端](#官方桌面端)，检查范围见[兼容性说明](./tests/DESKTOP-COMPATIBILITY.md)。本次更新提交源码，不替换历史 v0.3.0 Release 安装包。

公开前的隐私、依赖、安装包和界面检查见[提交检查记录](./tests/PUBLICATION-REVIEW.md)。

三个插件如何配合

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 个对话工具；内容交付保留宿主输入框的已有草稿和附件。

[阅读学者工作台完整介绍 →](./dsh-scholar/README.md)

🖥️ 服务器看板

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

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

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

[阅读服务器看板完整介绍 →](./dsh-server-dashboard/README.md)

🧭 研究主线图

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

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

[阅读研究主线图完整介绍 →](./dsh-trajectory/README.md)

安装与更新

支持 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 下载与升级说明](https://github.com/smilewhenever777/dsh-scholar/releases/tag/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