通用——日常杂记

本文记录一些日常通用的笔记，定期整理入其他的路径下

---

日常笔记

• Linux 中，realpath 命令可显示文件绝对路径
• jsonl 文件中每一行是一个 json 字符串
• Linux 中，汇总显示当前文件夹下占用大小：du -bsh
  • -s 参数表示总结性展示一个数字即可
• Python 中，函数内部若不使用 return 而是 ...，则表示返回 None
• Python 中，x = a or b 等价于 x = a if a else b

---

arXiv 提交论文

• 新作者一般需要找人帮忙背书才能提交到 arXiv
• 背书人一般需要在相关领域上传至少 3 篇左右文章到 arXiv 上才可以
• 帮人背书：
  • https://arxiv.org/auth/endorse?x=XXXXXX
  • XXXXXX 是系统生成的唯一识别 ID

---

名词释义

FDE

• FDE（Forward Deployed Engineer）：前线/前置部署工程师，也叫前沿部署工程师
  • 最早由美国企业 Palantir 提出，现在是 AI 大模型时代非常核心的岗位，字节、OpenAI、Google 等都在大规模招聘
• 简单理解：
  • 派驻到客户现场、打通技术和真实业务场景的复合型工程师
  • 集工程师+产品经理+解决方案架构师+交付顾问于一身，核心不是做功能，而是让技术真正给客户业务创造价值
• 思考：不管技术怎么迭代（传统软件 到 AI 大模型），都需要有人深入业务现场、快速解决真实痛点、落地可产生价值的技术方案，这就是 FDE 的长期价值

---

reStructuredText（.rst）文件简介

• .rst 是 reStructuredText 的缩写，一种轻量级标记语言，主要用于书写技术文档、API 文档和说明手册，是 Python 社区 Sphinx 文档工具的默认格式

主要特点

• 比 Markdown 功能更强：支持标题层级、表格、代码块、提示框、交叉引用等

• 结构化文档友好：适合中大型文档、多章节、自动生成 HTML/PDF

• Sphinx + Docutils 渲染：广泛用于 Python 官方文档、开源库文档（NumPy、Requests 等）

• 示例：

  =========
  项目文档
  =========
  
  简介
  ----
  这是一个 **reStructuredText** 示例
  
  .. note::
  
  这是一个注意事项
  
  .. code-block:: python
  
  def hello():
  	print("Hello, world!")

• 常见用途

  • Sphinx 项目文档（index.rst、conf.py 配合）
  • Python 包说明文档
  • 技术规范、用户手册（VeRL 项目使用的就是 .rst 格式）

• 一句话对比 .md 和 .rst

  • Markdown = 简单快捷（README / 博客）
  • RST = 功能完整（正式、结构化技术文档）