1692775560/dsh-Mimir-Academic-research · 上手攻略
- 仓库：1692775560/dsh-Mimir-Academic-research
- 链接：https://github.com/1692775560/dsh-Mimir-Academic-research
- 分类：学术写作 / Agent 工具 / dsh 插件
- 作者：spark
- 更新：2026-08-28
Mimir 是一个挂在 DeepSeek Harness（简称 dsh）之上的研究生命周期插件。它把"读论文 → 做实验 → 写 LaTeX → 出组会 PPT → 记成长"这一整条科研链路塞进 dsh 的 web 工作台，让 agent 在同一个上下文里帮你推进论文。本篇基于 README 与
CONTRIBUTING.md（截至 2026-08-28 主分支main）整理，所有命令与版本号均可在仓库内复现。
1. 是什么
Mimir 不是一个独立 CLI，而是一个 dsh 插件包（npm 名 dsh-mimir），安装到 dsh 之后在侧边栏多出一个 "Mimir" 入口。点进去是一个八视图 Web 工作台，dark/light、中英文可切换：
- Overview — pipeline 全景 + 统计
- Paper — Overleaf 风格的 LaTeX 编辑器：边写边编译、PDF 实时预览、一键 AI 修复编译错误
- Library — arXiv 订阅 + Web 检索 + AI 相关度评分 + PDF 全屏阅读器
- Experiments — 指标曲线 + 一键生成论文 figure
- Figures — 图片管理，可一键插回论文
- Meetings — 一键生成组会 PPT（直接抽论文 figure，可选 AI 配图）
- Servers — GPU 集群探测 + 远程任务投递
- Library / 成长时间线 — 成长记录时间轴 + 一键进展报告
除了 UI，它还向 dsh agent 注册一组工具（arxiv_search、web_search、wiki_note、figure_save、latex_compile、meeting_deck）和斜杠命令（/research-idea、/research-plan、/research-review、/paper-write、/paper-compile），同时内置 9 个科研 skill（literature review、novelty check、experiment planning、citation audit、rebuttal 等），agent 不用手动装载就能直接调。
2. 解决什么问题
科研同学通常要在多个工具之间来回切：Zotero / Paperpile 读文献，Overleaf 写 LaTeX，Weights & Biases / TensorBoard 看曲线，本地/服务器跑实验，PowerPoint / Keynote 做组会汇报。Mimir 的设计目标是把这些都收进 dsh 一个 web 界面，并由同一个 agent 上下文串联起来，目标是：
- 写论文时不再离开编译环境。 编辑器里改完立刻编译，编译报错直接让 agent 改源码而不是自己翻 log。
- 文献管理自动化。 arXiv 订阅推过来后，agent 用相关度评分排序，全屏阅读器直接看 PDF，需要时一键进入 related work 草稿。
- 实验曲线变 figure。 训练日志丢给 Experiments tab，自动出可插图的 matplotlib 风格图表。
- 组会 PPT 不再手动拼。 Meetings tab 把论文 figure + AI 配图拼成 PPT，省掉一晚上。
- 成长记录可追溯。 Ledger tab 把每次 commit / 论文版本 / 实验结果串成时间线，导师或答辩前可以直接出"进展报告"。
它不是一个通用 IDE，也不是 LLM 论文生成器——它的核心是把 dsh 这个 agent harness 当作"科研操作系统"扩展到论文写作全流程。
3. 快速安装
3.1 前置条件
按 README 要求：
- Node.js ≥ 22（
package.json的engines.node写死">=22"，实测 Node v24 可用） - dsh CLI（
npm install -g @deepseek-ai/dsh） - DEEPSEEK_API_KEY（agent 会话要用；其他 key 都可选）
- 可选：LaTeX 引擎（推荐
brew install tectonic，首次编译会下载宏包）；SearXNG（本地 web 检索用，README 提供一键脚本）；Zotero（在插件 config 里填zotero.apiKey+zotero.userId）
3.2 安装插件
⚠️ README 反复强调一个版本陷阱：dsh 的插件市场底层是 pnpm，新版本默认会被 pnpm 短暂 hold-back，所以"装最新版"经常装到的是 0.11.x / 0.12.x 旧版。务必显式 pin 版本：
# 升级前先卸
dsh plugin --profile web remove dsh-mimir
# 再装最新版（截至 2026-08-28 的已发布版本为 0.14.1，按 README 推荐写法）
dsh plugin --profile web add dsh-mimir@0.14.1
# 启动 dsh web 工作台
dsh web
# 浏览器打开 http://127.0.0.1:3080，侧边栏底部点 "Mimir"
配置文件在 profile 的 cordis.patch.yml，README 给了一份带全部可选项的注释模板：
examples/mimir-agent/cordis.yml（仓库内可直接 fetch）
3.3 启用可选能力
# LaTeX 编译：tectonic 一行搞定 macOS
brew install tectonic
# Web 检索：自带一键脚本，本地 venv + Docker-free
bash scripts/setup-web-search.sh
安装完成后数据落点：
- Wiki 持久化在
~/.dsh/storages/research_wiki.json - 工作区 artifacts 在
./.research（可通过workspaceDir改）
4. 核心用法
4.1 斜杠命令与 agent 工具
Mimir 注册的斜杠命令是它最常用的入口，每条对应一个研究阶段：
| 命令 | 用途 |
|---|---|
/research-idea |
从 Library 已有文献里生成候选课题方向 |
/research-plan |
出一份实验计划 + 里程碑 |
/research-review |
对当前草稿做同行评审式批注 |
/paper-write |
按 venue 模板（CVPR/NeurIPS/ACL/IEEE/ACM…）写正文 |
/paper-compile |
调 LaTeX 引擎并把编译日志塞回给 agent 修 |
工具层面在 dsh agent 里直接可调用：
arxiv_search/web_search— 文献 + Web 检索（后者走 SearXNG）wiki_note— 把当前会话要点写进 wiki，跨会话保留figure_save— 把图片入库到 Figures tablatex_compile— 后台跑 tectonic/latexmkmeeting_deck— 一键出组会 PPT
4.2 最小可跑流程（端到端）
下面是 README 隐含的 happy path，对应一个 5 分钟 demo：
# 1) 安装 + 启动
dsh plugin --profile web add dsh-mimir@0.14.1
dsh web # 浏览器访问 http://127.0.0.1:3080
# 2) 在侧栏点 Mimir，进入 Library tab，添加一个 arXiv 分类订阅
# 3) 在 agent 里：
# /research-plan -> 生成实验计划
# /paper-write -> 让 agent 起 LaTeX 草稿
# /paper-compile -> tectonic 编译，失败回灌给 agent 修
# 4) 训练脚本把 metric 日志写到 .research/experiments/ 下
# Experiments tab 自动出图 -> figure_save -> /paper-write 插入论文
# 6) 临近组会：
# meeting_deck -> 拉论文 figure + AI 配图生成 PPT
4.3 配置项（来自 README 表格）
| Key | 默认 | 说明 |
|---|---|---|
workspaceDir |
.research |
工作区根目录，artifacts / backups 都在这 |
latex.engine |
auto |
auto 会探测 latexmk / tectonic，或填绝对路径 |
search.command |
auto |
web 检索；auto 走 PATH 上的 sxng，或用包内自带版本 |
reviewer.maxRounds |
3 |
每项目评审轮数上限 |
backup.enabled / intervalMinutes / keep |
true / 60 / 24 |
wiki 定时快照策略 |
skills.enabled |
true |
是否注册内置 9 个 research skill |
⚠️ 版本注意：README 默认 workspaceDir = .research，但 CONTRIBUTING.md 的 CI 流程里也用 ./.research——两者一致；如果改这个路径，记得把 git ignore 一并改掉，否则 wiki snapshot 会进 git。
4.4 内置 skill 列表
README 列了 9 个 skill，覆盖一个完整 review 周期：
literature review · novelty check · experiment planning · citation audit · rebuttal · …（README 没有逐条展开，需要的话 dsh 进 Skills tab 查看完整列表）
5. 典型适用场景
- 博士在读 / 科研实习生：一个人 cover 整条论文链路，不想在 Overleaf + Zotero + W&B + PPT 之间来回切。
- 组里有 GPU 服务器但人在异地：Servers tab 直接探测 + 投递远程任务，不需要 ssh 进服务器再手动跑。
- 需要反复改 LaTeX 模板：内置 CVPR/NeurIPS/ACL/IEEE/ACM 等 venue 模板（0.10.0 引入），
format-to-venue一键转换格式。 - 临近答辩 / 进展汇报：Ledger tab 的"成长时间线"直接出一键进展报告；Meetings tab 出一键组会 PPT。
- 多人协作：由于底座是 dsh 的 host-client 架构，UI 走 dsh web（3080 端口），多人可以共享同一个 agent 上下文。
不适合的场景：
- 纯读论文不做实验：用 Zotero / Connected Papers 更轻量。
- 需要 GPU 集群做大规模训练：Mimir 不管调度，只负责"投递任务 + 拉曲线"，需要 Slurm / Kubernetes 自己接。
- 写非学术文档（博客、小说）：内置 9 个 skill 全部围绕论文评审，强行用在非学术场景性价比不高。
6. 坑与注意
- pnpm 装不到最新版 — 上面已经强调，显式
@0.14.1pin 住；否则停在 0.11.x / 0.12.x 是常态。 - tectonic 首次编译慢 — 首次跑会下载完整宏包到本地缓存，建议
latex.timeoutMs调大，否则 agent 会被超时误判为失败。 - HTTPS 代理 — 走校园网 / 公司 VPN 时，启动 dsh 前先
export HTTPS_PROXY=...，否则 arXiv / Web 检索全部 503。 - Web 检索本地 SearXNG —
bash scripts/setup-web-search.sh是 venv 版本，不依赖 Docker；如果已有 SearXNG 实例，sxng init指过去再重启 dsh。 - Zotero key — 在 zotero.org/settings/keys 生成，只勾只读权限别给写权限，避免 agent 误删文献库。
- wiki 版本锁 v2 —
CONTRIBUTING.md明确写：wiki domain 卡死在 v2，没有迁移机制。任何 schema 变更要么带默认值要么表空着；新字段写optional或.default(...)，且必须加一个"解析老 snapshot"的兼容性测试——否则一次 bump 会让所有用户文件全废。 - CSS 颜色必须走
var(--dsw-*, fallback)— 裸var(--x)不带 fallback 历史上有过一次把整个面板渲染成白色的 bug。 - LaTeX 高亮 overlay 与 textarea 共用字体度量 — 改其中之一必须 screenshot QA，否则会出现文字重影。
- PR 用 merge commit，不要 squash — 这样贡献者会在 Contributors 图上正确显示（README 显式要求）。
- 远程调用必须双 face — 加
@Remote方法后，本仓库pnpm run build会自动重生成 dsh api-remotes 的 client face；但如果你在 dsh 主仓里改，必须 host + client 两边都重新 build，否则浏览器会报this.remote.<x> is not a function。
7. 与同类对比
| 工具 | 定位 | 与 Mimir 差异 |
|---|---|---|
| Overleaf | 在线 LaTeX 编辑器 | 强在多人 LaTeX 协作；没有文献 / 实验 / PPT 联动，agent 集成也薄 |
| Zotero + Better BibTeX | 文献管理 | 文献库管理最专业；不覆盖实验曲线和写作 |
| W&B / TensorBoard | 实验追踪 | 指标 + artifact 强；不接 LaTeX 写作 |
| Notion AI / Obsidian | 笔记 + AI | 灵活但没有科研专用 skill，覆盖论文评审能力弱 |
| ARIS（Auto-claude-code-research-in-sleep） | 灵感来源（README 致谢） | ARIS 更偏 agent 自动跑实验；Mimir 更偏"工作台 + 写作闭环" |
| dsh + 其他插件 | dsh 生态 | dsh 是底座；Mimir 是科研插件，与其它插件可以叠加 |
⚠️ "同类对比" 这一节是基于 README + CONTRIBUTING 描述的定性比较，没有跑 benchmark；具体性能数字（编译速度 / 文献检索延迟 / PPT 渲染时长）仓库未给出，请勿当作排序依据。
8. 一句话推荐
如果你已经在用 dsh 做代码 agent，又嫌 Overleaf + Zotero + W&B + PPT 切来切去累得慌——把 dsh-mimir@0.14.1 装上，至少能省掉"复制 PDF 截图到 PPT"那一步。
原始 commit/PR/issue 链接：
- 主仓库 README：https://github.com/1692775560/dsh-Mimir-Academic-research/blob/main/README.md
- 贡献者指南：https://github.com/1692775560/dsh-Mimir-Academic-research/blob/main/CONTRIBUTING.md
- npm 包：https://www.npmjs.com/package/dsh-mimir
- 官方网站：https://mimir.smartlarkai.com
- dsh 底座：https://github.com/deepseek-ai/deepseek-harness
- SearXNG web 检索 PR：https://github.com/1692775560/dsh-Mimir-Academic-research/pull/114（作者 @hkwuks）
- Ledger view PR：https://github.com/1692775560/dsh-Mimir-Academic-research/pull/115（作者 @EriXPsy）
- 灵感来源 ARIS
- 配置文件示例：https://github.com/1692775560/dsh-Mimir-Academic-research/blob/main/examples/mimir-agent/cordis.yml
⚠️ 不确定处：
- 0.14.1 这个版本号是来自 README 的"pin example"，未独立核对 npm registry 上的 latest tag（npm 站点 fetch 被 403 拦截）；如果实际 latest 已是 0.15.x，请按 README 同样写法换成新版本。
- DSH CLI 是否已 GA未确认——
@deepseek-ai/dsh是私有包名，README 假定用户已经有 dsh 安装渠道；如果走 npm 公开安装路径失败，需要走 dsh 官方安装脚本（仓库 README 没列具体步骤，需自查）。 - 9 个内置 skill 的完整列表 README 只列了前 5 个，其余 4 个需在
dsh的 Skills tab 内查看；本文不做猜测。 - "未量化"指标：编译时长、检索延迟、PPT 生成耗时等性能数字仓库未给；本文不做估算。