# 前言
差生文具多系列，这里分享（备忘）一下我的科研+开发工作流以及工具链，主要涉及到：
- 文献搜索 & 阅读
- 博客记录
- 组会 Slides 制作
- 科研代码
- 日常开发与实验
- 多端同步
这里，多端同步会掺杂在各个部分，可以选择自己需要的同步方法。
考虑到我已经切换回 Windows 开发，因此这里介绍的主要在 Windows 的工具链，关于纯 Linux 的分享可以参考 Hyprland-Yes 与 Manjaro-Linux，虽然主要是在玩赛博暖暖（
!Attention 很多工具其实都可以关注 github 上使用 awesome 开头的仓库，例如：
可以在这里关注一下 Awesome 列表：The awesome list
# 文献搜索 & 阅读
# 文献搜索
这个通常没有什么好用的工具（如果 Google 算工具的话），一般是在网站上找，这里推荐几个好用的网站和一些浏览器插件
# 网站
出版社的官网：
好处是省事，坏处是不知道自己学校买没买版权（
如果买了的话，可以通过
Access via Institute来获取访问权限并下载，因为有些文章可能只能在官网上下载一些教授的主页
典型的例子：https://leria-info.univ-angers.fr/~jinkao.hao/ 甚至可以在主页上找到文章的代码/可执行文件
需要挂梯子才能访问，文献量大但其实在
CS领域的文章并没有特别多，较新的文章不一定能找到，好处是可以通过doi进行搜索查询不需要挂梯子，文献量大（可惜是预印本），几乎所有要发出去的
CS领域文章都能在这里找到，较新的文章也一应俱全，缺点是因为是预印本，和出版社用的模板也不太一样，而且还得时刻注意作者有没有更新过（可能不是最新版），而且不能搜索doi找图书的好去处，但会议期刊文献不推荐在这里找，你可以把这个网站视为秽土转生的
zlib找文章&biblatex 的好去处，很多文章都可以提供 PDF 的连接，好用
同样是找文章的好去处，不需要翻墙就可以使用，个人觉得这个更偏向人肉某个老师，不太适合找某一个主题的文章
似乎是清华做的一个网站，感觉在可视化和联想以及 AI 上做的不错，之前用过这个网站的 AI 读文章功能，这个网站也有对应的 Google 插件
# 插件
CCF-Rank，一个浏览器插件，可以在 Google 的浏览器商店里找到：
其作用如下，可以显示文章，会议的 CCF 等级（包括 semantic scholar， dblp，google scholar 上面的文章）
# Zotero
Zotero 作为我文献收集与阅读的工具
# 简介
Your personal research assistant
Zotero is a free, easy-to-use tool to help you collect, organize, annotate, cite, and share research.
选用原因：开源免费（当然存储需要付费），插件生态丰富，跨平台（Linux/Windows/MacOS），多端同步
安装的步骤省略，这里主要分享两个：
- 插件
- 如何多端同步
# 插件
可以在 Zotero 中文社区 查看推荐的插件以及安装方法
这里推荐我使用的插件：
由于我没有 OpenAI 的账号，因此用不了 GPT 的 Token，否则很建议下载 Awesome GPT 这个插件，用来替代翻译的插件
# 同步
一般而言，Zotero 提供的免费额度应该是够用的（100 MB），但也可以自定义存储方式，这里我使用的是 坚果云 的云端存储。
具体的操作可以参考坚果云官方的文章 坚果云使用 Zotero 配置过程详解
可以不用安装坚果云的客户端，感觉其实很鸡肋，不如直接用
WebDAV不过
WebDAV也有一个缺点，就是坚果云会限制这个的使用次数，比如很短的时间内发送了巨量的请求，同步了一千个文件之类的，这样的话这个应用的Token就会被 ban 掉，需要重新生成一个Token
# 博客记录
这里其实应该是 “博客与本地知识库”
# 关于博客
和网上大多数静态博客系统一样，我使用 Markdown 写博客，使用 Hugo 生成静态的 html 文件，然后通过 Github Pages 进行部署。
我使用的主题是 Stack，当然自己魔改了一部分，支持了一些新的特性（主要是卡片链接），可以参考 魔改版本 Stack
这个主题网上美化/配置的教程很多，想要使用的话还是很简单的，在这里不再赘述
最后，关于文章中的图片，我使用的是 picgo + 腾讯云对象存储，这样可以通过腾讯云的对象存储作为在线图床，就不用担心图片无法显示在公网上了
关于 picgo 如何配置，请阅读它的文档或者直接 Google 一下配置，教程也十分多
如果想知道如何在书写时自动上传，请往下阅读
# 关于 Markdown 的书写
我将博客还有一系列本地 Markdown 的书写与管理都集中在 Obsidian 之中，当然，如果你只是书写单个 md 文件的话，也可以使用 Typora 或者 Marktext，甚至 vscode 也是可以的，但如果你想连同笔记，博客，日记等等都在一起管理的话，那我推荐使用 Obsidian
关于 Obsidian 的教程也十分之多，这里我主要分享一些插件和网站：
# 网站
# 主题与插件
我使用的主题为 Border ，并使用了插件 Style Setting 进行了一些改造，但不是很多，感觉预设已经很够用了
字体使用的是：中文 霞鹜文楷，英文 Bookerly，代码 Monaco
页面显示如下：
插件主要有：
Pangu：排版，用于中英文之间插入空格，强迫症患者福音Admonition：一种Callout，例如什么 NOTE, WARNING 之类的引用框，主要是样式好看Advanced Tables： 表格编辑工具Background Image：背景图片Calendar：一个日历，需要配合插件dataviewDay Planner进行使用，最简单的用法就是TODO List，今日待办之类的
Codeblock Customizer：客制化代码块的显示Excalidraw：排名第一的画图插件（虽然我平时用的也不是很多）Image auto upload Plugin：和 picgo 一块使用的插件，在复制图片时可以直接上传到图床上，然后替换图片的 urlLazy Plugin Loader：插件的懒加载插件，快速启动 obsidian，防止加载插件卡住Linter：用来格式化（自动添加，更新）文件的yaml，或者说frontmatterOpen In New Tab：打开一个新的标签页Remotely Save：远端同步，这里我使用的也是 坚果云 的WebDAV进行存储Style Setting： 上文所说的，客制化主题必备插件Tasks：更好的显示TODO ListImage Toolkit：更好的显示图片（主要是想放大和缩小）
# 组会 Slides 制作
关于 Slides 的制作，有三种方式：
- 传统的
PPT Beamer风格的学术SlidesReval.js网页Slides
三种方式可以自由选择，优缺点如下：
PPT的制作稍微简单，不需要做任何动画，也不需要花里胡哨的模板（很适合赶工的时候做），但缺陷很明显，数学和代码的支持很差，有时候只能截个图放上去，很不美观（不美观的数学公式会让人难以理解……也生不出看下去的欲望）Beamer模板写起来困难，但数学公式和代码都较为美观，并且模板问题难以解决，毕竟不是每个人都有心思去做模板的Reval.js强依赖于其他人写好的插件拓展，而且语法会有些啰嗦，虽然可以使用 Markdown 语法的话，但想要做出动画效果也同样得使用他自己的一些语法，好在支持数学公式和代码块，并且可以把 Slides 直接挂在网上
# Typst
首先，我们回答一个问题：为什么选择 Beamer？
答案是：数学公式
众所周知的是，PPT 对于数学的支持一向不友好，想打出漂亮的数学公式可能比做一份完整的 PPT 还费时间，所以，为什么不选择数学更友好更优美的 Latex 呢？
但，Latex 的入门是一个很大的问题，花费一个月的时间在折腾自己的模板上，还没弄明白的事情也常有发生，这个时候就要开始推荐 Typst 了。
但是 Typst 的出现让学术 Slides 变得更简单了！关于 Typst，一个简单的说法就是：Markdown 增强版本的 Latex
拥有着 Markdown 风格的语法，可以轻松的写出文档，同时也拥有较为强大的排版能力，值得注意的是 typst 的数学语法比 Latex 看起来要舒服很多，最重要的一点是，它是增量编译（人话：即时预览）
我们并不会在这里讲述太多 Typst 的语法细节，也不会告诉大家如何去学一门新的（编程）语言，遇到有不会的时候，请学会 RTFM 和 STFW
# 如何制作
如果你想使用 Typst 来制作 Slides 的话，可以使用Polylux 或更加中文化（以及更加现代的）Touying
更加建议使用
Touying社区更加活跃
随着 Typst 社区的发展，以及有很多包和模板可以使用了，例如：
- pinit 用于高亮文本块，并显示箭头
- codly 更好看的方式显示代码块
- cetz 与 fletcher 画图的必备利器，可以对标
Latex中的TikZ - lovelace 伪代码（算法流程）的制作
- curryst 我用来写规约/推导的数学公式的包
一个简单的例子如下，使用了 BUAA Touying Template 以及上面的一些包：
# 科研代码
使用的设备均为 Windows11 系统：
- 本地台式：
14700KF+4080S+32G+2TB - 本地笔记本：
13th-i5+16G+512G
一般而言都是在台式机上干重活（相当于会跑一下代码测试一下），笔记本对我来说是一个 ssh 工具，或者是简单写一个不吃配置的代码的工具
开发环境使用的是 WSL2-Ubuntu-24.04 + Windows，其中：
WSL2主要用来写科研代码，因为经常用到C++/C，Rust，Python和Bash之类的，Linux对这些开发比较友好Windows环境主要是用来开发一些需要用到字体的项目，例如Typst的模板开发，Latex的书写，Markdown的书写，Steam 的启动
使用的编辑器是 VS Code 与各类语言的 LSP
对于
WSL的配置我们略过，网上的教程也很多，甚至微软官方的教程也很详细，可以参考
# VS Code
UPD：在有 LLM 之后，更推荐使用 cursor，它可以兼容
vscode的所有插件，且自带强大的 AI 补全
在刚上大学的时候其实觉得
VS Code并不是很好用，主要是配置起来很麻烦，感觉不如CLion这种IDE，但自从知道了Remote SSH插件之后，突然就香了
我们这里推荐的 VS Code 及其插件的配置如下
# 主体开发
必装插件：Remote - SSH, WSL（如果要使用本地开发），Remote Explorer ，Dev Containers(用于连接 Docker 容器)
# Remote-SSH 的一些 Trick
由于使用 Remote - SSH 其实会频繁要求认证（也就是输密码），我们可以通过两个东西来避免这一点
.ssh/config
首先，我们需要编辑这个文件，然后把常用的服务器都保存进去，写成如下形式：
Host NAME
HostName <ip>
Port 22
User <user>
这样，我们就可以在命令行/VS code 中找到名为 NAME 的服务器，然后 ssh/点击即可连接上，但这时还是会要求输入密码
ssh-copy-id命令
如果你使用 Windows，是没有这个命令的，但是可以通过打开 git bash 来使用这个命令，具体的使用方式是，命令行中输入：
ssh-copy-id NAME
然后输入一次密码即可，这样，后续再进行操作都无需输入密码进行认证（服务器上输入 sudo 并不属于这种类型的认证）
# AI
AI 自动补全插件。如果你已经申请了 Github 的黄书包（也就是教育版本），那么你可以免费使用 Copilot ，这是一个 LLM 代码补全工具，补全程度甚至可以自己写代码，有了这个，程序员只需要当无情的 Tab 键入机器就行。
但这个有一个缺点：补全的有点太多了，有时候我们并不需要把一整个函数都补全，但是 Copilot 就会自己做这个事情
但如果你没有黄书包，但是你也想使用 LLM 补全的话，可以考虑这几个软件（都在 VS Code 中有插件）
# Codeium
这是一个免费的 AI 补全工具，效果不错，但能力当然不如 Copilot，并且也存在一次补全太多的缺点
但瑕不掩瑜，免费就是它最大的卖点，而且比 TabNine 要智能很多，也对内存更加友好（TabNine 会偏本地化一些，会记录你的代码习惯和风格到本地）
但对于 VS Code 而言，这个插件还有一个缺点：如果你在服务器上写代码，那么需要重新安装这个插件，并配置你的 API 密钥，较为麻烦（因为每到一个新机器就需要重新配置一遍）
# Tabnine
免费，但占用内存大，比较能吃硬盘空间，而且补全似乎不够智能（在 2023 年是这样的）
# Continue
目前我正在使用的 AI 补全插件，好处是你可以自主选择 AI 模型，可以接入不同的 API，例如 GPT4，Claude，国内的大模型，甚至自己本地训练的大模型，并且支持项目内搜索与问题，最重要的是，一次补全不会补出来一篇文章，基本都是一行一行补全，只是速度不是特别快。
最好的一点是，他对于 VS Code 而言是基于工作区的，也就是只需要在本地有这个插件即可，不需要在每一台机器上都要下一遍
然而缺点是配置较为麻烦，在这里可以贴一下我的配置：
我是用的是 DeepSeek 的模型，因为他的 Token 收费便宜，进入官网后申请 API 密钥，然后我们开始配置 VS Code 中的 Continue:
打开这个设置后，会出现一个 config.json 的文件，复制粘贴以下内容即可：
{
"models": [
{
"title": "DeepSeek",
"provider": "openai",
"model": "deepseek-coder",
"apiBase": "https://api.deepseek.com",
"apiType": "openai",
"apiKey": "",
"useLegacyCompletionsEndpoint": false,
"contextLength": 8192
}
],
"tabAutocompleteOptions": {
"template": "Please teach me what I should write in the `hole` tag, but without any further explanation and code backticks, i.e., as if you are directly outputting to a code editor. It can be codes or comments or strings. Don't provide existing & repetitive codes. If the provided prefix and suffix contain incomplete code and statement, your response should be able to be directly concatenated to the provided prefix and suffix. Also note that I may tell you what I'd like to write inside comments. \n{{{prefix}}}<hole></hole>{{{suffix}}}\n\nPlease be aware of the environment the hole is placed, e.g., inside strings or comments or code blocks, and please don't wrap your response in ```. You should always provide non-empty output.\n",
"useCache": true,
"maxPromptTokens": 2048
},
"tabAutocompleteModel": {
"title": "DeepSeek-V2",
"model": "deepseek-coder",
"apiKey": "",
"contextLength": 8192,
"apiBase": "https://api.deepseek.com",
"completionOptions": {
"maxTokens": 4096,
"temperature": 0,
"topP": 1,
"presencePenalty": 0,
"frequencyPenalty": 0
},
"provider": "openai",
"useLegacyCompletionsEndpoint": false
},
"docs": []
}
在留白的 apiKey 中填上自己申请的 APIKey 即可。
如果需要使用其他的模型，可以自行查阅官网文档进行配置。
# 版本管理
我的版本管理主要使用 git,插件选择 Git Graph,可以可视化 Commit 的历史,例如:
不是很推荐使用
Gitlens,感觉冗余信息太多了,对写代码之类的干扰严重(
# 外观 & 显示
# 主题
Github Theme Dark Default，高亮如下所示：
之前使用的主题是 Tokyo Night，也很好看，换这个是因为在我之前的笔记本上，感觉完全的黑色+透明度更适合那个
Archlinux的桌面背景（
# 图标主题
Material Icon Theme，这里主要是用来更好的显示文件夹的图标，看起来花哨一些（
# 字体
中文 霞鹜文楷，代码 Monaco，配置的方法如下：打开设置后（Ctrl + ,），写下如下设置（注意是在 Windows 环境下）
# 其他
还有一些插件，能让写代码的时候有更好的视觉体验
Better Comments： 显示更好的注释样式，例如//!会显示成红色，颜色也可以自己修改Error Lens：更好的显示错误与警告（不需要再把鼠标移上去，现在在行尾就能看见错误是什么了）Highlight Line：更好的显示光标的位置Log File Highlighter：为控制台的LOG显示高亮，主要是为了看ERROR和PASS的颜色Todo Tree：更好的查看 TODO，FIXME，NOTE 等标签，但是需要配置颜色
# 语言插件及其环境
# C++/C
clangd：用于代码的高亮和补全，主要是解析项目结构C/C++：微软自家的插件，写C/C++必须会安装的插件，但其补全功能与clangd冲突，需要关闭Better C++ Syntax：更好的语法高亮clang-format：格式化插件CodeLLDB：调试用的插件，当然也可以直接用gdbVim：更好的打字体验，但需要一些配置和学习
配置后的样式如下：
当然，我的 Vim 也进行了一些配置，让 VS Code 的一些快捷键还能用（
打开 setting.json 后，输入以下内容：
"vim.insertModeKeyBindings": [
{
"before": [
"j",
"j"
],
"after": [
"<Esc>"
]
}
],
"vim.handleKeys": {
"<C-d>": true,
"<C-s>": false,
"<C-z>": false,
"<C-a>": false,
"<C-c>": false,
"<C-x>": false,
"<C-v>": false,
"<C-w>": false,
"<C-p>": false
},
这里映射了 jj 为 esc 键，然后取消了 Ctrl 的一系列快捷键（感觉还是用 Windows 的顺手，尤其是复制粘贴）。
# 构建工具与包管理
- C Compiler: gcc(version 13.2.1) clang(version 16.0.6)
- C++ Compiler: g++(version 13.2.1) clang++(version 16.0.6)
- C/C++ build tools: cmake(version 3.28.3) xmake(version 2.8.8) make(version 4.4.1)
一般我使用的工具链是 CMake + ninja 作为构建工具, 使用 gcc/g++ 编译,使用 gdb 进行调试
这里,如果你的
libc(++)是glibc(++)的话,我推荐使用gcc/g++进行编译,因为这俩会有优化 如果一定要使用clang/clang++,请先把libc(++)改成对这俩编译器友好的,例如 LLVM-libc
# XMake
如果你想写一个简单的小项目，但是这个项目依赖的库或者包有点多，例如你可能需要使用 boost 来解析参数，你可能需要 dense_unorderedmap 来替代 STL 中的 unorderedmap，但这个时候，Cmake 似乎就对你很不友好了，而如何管理这些包也成为了一个难题
这个时候，你就需要 xmake 来帮你完成这个需求，xmake 的配置文件十分简单，你也可以使用 xmake 来初始化一个项目，缺少的包也可以通过 xmake 来进行下载和导入
最重要的是，xmake 有中文文档, 阅读这个中文文档进行安装和使用，xmake 对于小型项目而言十分友好，能够快速帮你构建项目，并且不需要烦恼依赖问题
# Python
PythonPython Debugger这两个算是必装插件了，没有这两个不知道怎么写Python
关于 Python 的格式化插件，有很多选择，这里可以选择 ruff 这个插件
如果你更喜欢使用 jupyter 的话，也可以安装 jupyter 的插件，有一个名为 Jupyter 的拓展包，直接安装即可
但是不知道为什么，我如果使用
jupyter的话运行时间长了会导致内核卡死，这个问题到目前都没有解决
# 包管理
Python 的包管理器有很多,这里推荐两个现代 Python 常用的:
我目前常用的管理器是 poetry,uv 虽然快,但是感觉有很多功能都没实现,比如我最想要的 uv shell 这种(
# Rust
安装 rust 这个拓展包集合,但是由于里面有一个 crate 的拓展以及被弃用了,这里没有更新,因此还需要下载其他的插件:
Dependi:用于检测依赖包的版本,不仅适用于rust,还可以检查nodejs,python等的包版本Even Better TOML:用来高亮Cargo.toml的拓展,其他的.toml文件也可以使用(