SSH（Secure Shell，安全外壳协议），是一套加密的远程登录协议，标准端口：22。 简单理解：安全地远程连接另一台计算机 / 服务器。

可以使用 SSH（安全外壳协议）在 GitHub 上的存储库中访问和写入数据。 通过 SSH 进行连接时，使用本地计算机上的私钥文件进行身份验证。

SSH 认证：解决「你能不能连上 GitHub、推送代码」（通道权限）

提交签名（SSH 签名 / GPG 签名）：解决「这条 commit 到底是不是你写的」（内容真伪）

两者完全独立、互不替代。

SSH 密钥用于 GitHub 连接认证

作用场景

当你使用 git@github.com:xxx/xxx.git（SSH 协议地址）进行 clone/pull/push,

• 使用 SSH 公私钥完成传输层身份校验
• 替代 HTTPS 方式输入账号密码 / Personal Access Token
• 全程通信流量加密

工作原理

• 本地保存私钥（保密），GitHub 账户保存你的公钥；
• 发起 SSH 连接时，服务器发起加密挑战；
• 本地私钥应答；GitHub 使用公钥验证通过 → 允许访问仓库。

关键特点

• 只在建立网络连接那一刻生效；
• 完全不保护 commit 本身；
• 无法防止提交伪造：任何人本地修改 git config user.name / user.email，就可以伪装成你提交代码并 push 到仓库。
• 举例：别人电脑上设置你的名字邮箱，通过他自己的 SSH 密钥推送，GitHub 只会显示提交人是你，无法识别伪造。

简易配置命令

# 生成ed25519密钥（推荐，优于RSA）
ssh-keygen -t ed25519 -C "你的github注册邮箱"
# 启动agent
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
# 复制公钥
cat ~/.ssh/id_ed25519.pub
GitHub 设置 → SSH and GPG keys → New SSH key
Key type 选择：Authentication Key（身份验证密钥）
测试连通：
bash
ssh -T git@github.com

Git 提交签名

核心目标

给每一条 commit/tag 数据本身打上数字签名

• 证明：这条提交由持有私钥的本人创建；
• 证明：提交内容生成后没有被篡改；
• GitHub 校验成功，展示绿色 Verified 标识。

Git 原生最早只支持 GPG 签名； Git ≥2.34 新增支持 SSH 签名（可以复用你现有的 SSH 密钥，不用额外生成 GPG）

如果你想用同一把 SSH 密钥既登录 github 又签名 commit： 必须在 GitHub 添加两次：一条 Authentication Key，一条 Signing Key

实操：使用 SSH 密钥对 commit 进行签名

Git 全局配置

# 指定使用SSH格式签名，而非默认gpg
git config --global gpg.format ssh
# 指定你的SSH公钥路径作为签名密钥
git config --global user.signingkey ~/.ssh/id_ed25519.pub
# 开启：所有commit自动签名（不用每次加参数-S）
git config --global commit.gpgsign true
# 开启tag自动签名
git config --global tag.gpgsign true

GitHub 网页端配置

Settings → SSH and GPG keys → New SSH key Title 随意填写； Key type 务必选择 Signing Key（不要选 Authentication！） 粘贴公钥 id_ed25519.pub 全部内容保存

验证

# 创建空测试提交
git commit --allow-empty -m "test ssh signed commit"
# 查看签名信息
git log --show-signature -1
git push

没什么特别好说的，我喜欢使用 ventoy 制作启动 U 盘，之后将 openSUSE 风滚草 的镜像拷贝进去就可以了。

KDE Plasma 桌面配置

我对于 Plasma 的配置非常简单，有以下几个步骤：

1. 将任务栏移到上面，并缩小到 40
2. 设置 > Appearance > Icons 换一个喜欢的图标包，默认的图标包有一点丑，我选择的是 Papirus
3. 设置 > Workspace Behavior > Virtual Desktops 调整虚拟桌面的排列，我将行数设置为 1 行，默认 2 个虚拟桌面即可
4. 设置 > Window Management > Task Switcher 将任务切换效果从 Breeze 切换成 Compact，最简单的切换效果，顺便把 Alt + ` 的快捷键删除了
5. 设置 > Input Devices > Keyboard > Advanced 勾选 Configure keyboard options 和下面的 Make Caps Lock an additional Ctrl 我们当然要将大写锁定键完全换成 Ctrl

KDE Plasma 用户在登录系统后，首次链接无线网络时会遇到 KDE 钱包的报错提醒（缺少密钥）。

为了避免重复输入验证密码。打开 KDE 钱包，选择 新建钱包 ，然选择传统，blowfish 加密文件，然后不输入密码，直接确认保存。这样你就有了一个空（无验证密码）的 KDE 钱包。联网就无需验证身份了。

Yast 配置和软件源更改

首先我们需要安装一下简体中文语言包，我们在 Yast > Language > Seconday Language 中选中 Simplified Chinese 就可以安装上中文语言包了。

接着我们打开 Software Repositories 把我们安装后自带的一个本地仓库（类似于 openSUSE-20240216-0 ）删除。

我们再将官方源换成 中科大 openSUSE 源 ，由于 openSUSE 使用了 MirrorBrain 技术，中央服务器 (download.opensuse.org) 会按照 IP 地理位置中转下载请求到附近的镜像服务器（但刷新软件源时仍从中央服务器获取 元数据），所以更改软件源通常只会加快刷新软件源的速度，而对下载速度影响不大。

我们再添加一下 Packman 源，直接在终端中：

bash

sudo zypper ar -cfp 90 https://mirrors.ustc.edu.cn/packman/suse/openSUSE_Tumbleweed/ USTC:PACKMAN

之后我们刷新并更新风滚草即可：

bash

sudo zypper ref && sudo zypper dup
sudo reboot

接着我们安装一些多媒体编码器：

bash

sudo zypper dist-upgrade --from USTC:PACKMAN --allow-vendor-change
sudo zypper install --from USTC:PACKMAN ffmpeg gstreamer-plugins-{good,bad,ugly,libav} libavcodec-full vlc-codecs

网络代理配置

我们使用 v2raya 来进行网络代理，先安装 v2ray 内核和 v2raya

bash

sudo zypper in v2ray
opi v2raya

打开 v2raya 服务后按照 快速上手 即可使用网络代理，使用透明代理可以为几乎所有的程序进行网络代理。

bash

sudo systemctl enable --now v2raya.service

更多代理使用方法可以参考 配置代理 。

字体与中文输入法

在 KDE 中安装字体很简单，只需要把字体往 Font Management 里面拖动就行了（最好是放在 Personal Fonts 分组里面），之后你可以使用 fc-cache -fv 刷新字体。

比较传统的方法是放到下面的文件夹中，按照优先级排序是：

bash

Font directories:
        /usr/X11R6/lib/X11/fonts
        /opt/kde3/share/fonts
        ~/.local/share/fonts
        ~/.local/share/flatpak/exports/share/fonts
        /var/lib/flatpak/exports/share/fonts
        /usr/local/share/fonts
        /usr/share/fonts
        ~/.fonts
        /usr/share/fonts/100dpi
        /usr/share/fonts/75dpi
        /usr/share/fonts/Type1
        /usr/share/fonts/cyrillic
        /usr/share/fonts/encodings
        /usr/share/fonts/ghostscript
        /usr/share/fonts/misc
        /usr/share/fonts/texlive-lm
        /usr/share/fonts/truetype
        /usr/share/fonts/xscreensaver
        /usr/share/fonts/encodings/large

推荐放在 ~/.fonts 或是 ~/.local/share/fonts 文件夹中，然后同样用 fc-cache -fv 刷新字体即可。

我个人推荐的字体是 Sarasa Term SC Nerd ，因为它在 Emacs 中使用可以处理表格对齐的问题，同时包含 Nerd Fonts，比较省心。

输入法推荐安装 Fcitx5 ：

bash

sudo zypper in fcitx5 fcitx5-chinese-addons
sudo zypper in fcitx5-configtool #  安装配置工具（可选）

在安装 Fcitx5 的时候，会默认卸载替换掉旧的 Fcitx，我们跟随系统提示操作即可。

安装后重新登陆，我们在设置 > Reginonal Settings > Input Method 中点击 Add Input Method 添加 Pinyin 即可，这里的一些环境变量使用 X11 的 KDE 的话系统已经自动帮我们设置好了。

我们还可以点击 Configure addons 设置一些输入法 UI 等。

词典可以帮助改善输入法的使用体验，以下是两个受欢迎的词库：

• felixonmars/fcitx5-pinyin-zhwiki
• wuhgit/CustomPinyinDictionary

请根据仓库的 README 文件将下载或下载解压后的 .dict 文件放置到 ~/.local/share/fcitx5/pinyin/dictionaries/ 文件夹中（如果文件夹不存在，你需要手动新建此文件夹），再重启一下 fcitx5 即可。

安装软件

我将我一开始安装的一些软件列下来（我随便写了一些，可以按需下载安装）：

bash

通过 zypper 安装：
git
emacs
opi
keepassxc
mpv
telegram-desktop
qbittorrent
filezilla
wireshark
flameshot # 安装指南 (https://zh.opensuse.org/Flameshot)
cheat
nodejs
syncthing

通过 opi 安装
megasync
google-chrome-stable
v2raya

电源管理（针对笔记本电脑）

我们使用默认的 TLP 配置即可，你可以使用 TLPUI 来更简单地配置。

bash

sudo zypper in tlp
sudo systemctl disable tlp && sudo systemctl stop tlp
sudo systemctl enable tlp

我们在 TLPUI 中简单设置一下充电阈值即可，这样可以延长一些笔记本电池的寿命

bash

START_CHARGE_THRESH_BAT0=75
# 开始充电阈值
STOP_CHARGE_THRESH_BAT0=85
# 停止充电阈值

我们可以用下面这条命令检查电池状态：

bash

sudo tlp-stat -b

终端模拟器

这个选择自己称手的就行了，以前我比较喜欢折腾 shell，现在懒得去配置了，就用默认的 bash 就行了，安装一个 Ohmybash 能让它好看一些， 目前我最喜欢的 shell 居然是 emacs 里面的 eshell 吧（笑）。

此外，如果我使用 zsh，我个人很讨厌 Ohmyzsh，我会换成 zim 这种轻量化的配置框架。

终端模拟器的话我一直在用 kitty ，它对于颜色支持的比较好，而且还自带 kitten 插件，每次我到新机器上直接用 kitten 就能把主题啥的配置好，性能也非常快。

我最喜欢的终端字体是 CaskaydiaMono Nerd Font 。

此外，新的终端模拟器 Warp 在我写这篇文章的时候，已经可以在 Linux 上使用了，我在 MacOS 上一直很喜欢使用这个非常现代的终端。

终端模拟器的配置随便换个字体就行了，还有一点是我比较讨厌透明背景色的终端配置。

参考链接

• openSUSE WIKI 快速配置指南
• openSUSE WIKI 电池管理
• v2raya 用户文档

自己随便记录的关于 denote 的一些使用方法，绝大部分都是直接翻译的官方文档。

参考文档

denote 文档

标准笔记创建

提示用户输入以创建笔记的命令包括但不限于：

• denote
• denote-signature
• denote-type
• denote-date
• denote-subdirectory
• denote-rename-file
• denote-dired-rename-files

The denote-templates 选项

用户可以以模版开始创建一个新的笔记。

创建模版的配置：

elisp

(setq denote-templates
      '((report . "* Some heading\n\n* Another heading")
        (memo . "* Some heading\n\n* Another heading)))

更好的方法是用 concat 函数来将字符串连接起来：

emacs-lisp

(setq denote-templates
      `((report . "* Some heading\n\n* Another heading")
        (memo . ,(concat "* Some heading"
                         "\n\n"
                         "* Another heading"
                         "\n\n"))))

维护单独的笔记目录 silos

silos 这个概念就是笔记存放在不同地方，目录与目录之间是分离的，我们把这样的目录叫做 silos 。

要创建一个 silos ，首先我们需要在笔记目录下创建一个 .dir-locals.el 文件，在创建的时候 Emacs 会提醒我们是否存储这个路径变量，我们选择是即可。

我们向 .dir-locals.el 文件中写入：

emacs-lisp

;;; Directory Local Variables.  For more information evaluate:
;;;
;;;     (info "(emacs) Directory Variables")

((nil . ((denote-directory . "/path/to/silo/")
         (denote-infer-keywords . nil))))

下面是我的笔记目录（ 01Index 是我的 denote-directory ）：

bash

./01Index/
├── .DS_Store
├── 20240228T160157--mastering-eshell__emacs_linux_shell.assets
├── 20240228T160157--mastering-eshell__emacs_linux_shell.org
├── 20240315T225352--c语言程序设计现代方法__c.org
├── 20240317T201104--cpp-primer__cpp.org
├── 20240407T230222--西方哲学史__reading.org
└── ltximg
./02Area/
├── .dir-locals.el
├── 20240201T021341--emacs-manual-note__emacs.assets
├── 20240201T021341--emacs-manual-note__emacs.org
├── 20240302T153745--计算机网络原理__network.assets
├── 20240302T153745--计算机网络原理__network.org
├── 20240320T175109--操作系统__operatingsystem.assets
├── 20240320T175109--操作系统__operatingsystem.org
├── 20240328T141613--计算机系统结构__computerarchitecture.assets
└── 20240328T141613--计算机系统结构__computerarchitecture.org
./03Resource/
├── .dir-locals.el
├── 20240221T162109--kde-plasma-桌面-korganizer-等软件关闭后仍然占用约-800-m-内存__bug_kde.assets
├── 20240221T162109--kde-plasma-桌面-korganizer-等软件关闭后仍然占用约-800-m-内存__bug_kde.org
└── 20240222T000349--opensuse-tumbleweed-和-kde-的个人安装过程__kde_linux_opensuse.org
./04Project/
├── .dir-locals.el
└── 20240417T220159--denote-使用方法__emacs.org

之后我们还要用自定义用户配置命令自动选择 silo ，这样我们平常使用 denote 命令的时候默认将笔记放到 01Index 中， 当我们切换到 02Area 时，我们这时使用 denote 相关命令，笔记就会自动存放到当前的 silo 中了。

我的用户配置如下：

emacs-lisp

(defvar my-denote-silo-directories
    `("/home/MEGA/02Area"
      "/home/MEGA/03Resource"
      "/home/MEGA/04Project"
      ;; You don't actually need to include the `denote-directory' here
      ;; if you use the regular commands in their global context.  I am
      ;; including it for completeness.
      ,denote-directory)
    "List of file paths pointing to my Denote silos.
  This is a list of strings.")

  (defvar my-denote-commands-for-silos
    '(denote
      denote-date
      denote-subdirectory
      denote-template
      denote-type)
    "List of Denote commands to call after selecting a silo.
  This is a list of symbols that specify the note-creating
  interactive functions that Denote provides.")

  (defun my-denote-pick-silo-then-command (silo command)
    "Select SILO and run Denote COMMAND in it.
  SILO is a file path from `my-denote-silo-directories', while
  COMMAND is one among `my-denote-commands-for-silos'."
    (interactive
     (list (completing-read "Select a silo: " my-denote-silo-directories nil t)
           (intern (completing-read
                    "Run command in silo: "
                    my-denote-commands-for-silos nil t))))
    (let ((denote-directory silo))
      (call-interactively command)))

关于 silo 的实现并不优雅，这是一个比较新的功能。我们现在只能凑合用了，我觉得作者应该将 silo 这种分散仓库概念集合到对于 denote-directory 的配置中。

因为毕竟我不可能总是将笔记放在一个文件夹中，总是用 denote-subdirectory 也不是办法。

笔记文件命名规范

笔记被存放在 denote-directory 中，默认是 ~/Documents/notes 。

默认遵循下面这个命名规范：

text

DATE==SIGNATURE--TITLE__KEYWORDS.EXTENSION

DATE 字段以 年-月-日 的格式表示日期，后跟大写字母 T 表示当前时间，同时 DATE 也作为每个笔记文件的唯一标识符。

SIGNATURE 字段中包含一串字母数字字符。签名没有明确定义的用途，由用户定义。一个用例是使用它们在文件之间建立顺序关系（例如 1、1a、1b、1b1、1b2 等）。

TITEL 字段默认小写，并且带有连字符。

KEYWORDS 字段由一个或多个条目组成，这些条目用下划线分隔，输入 KEYWORDS 时用逗号分隔。

Examples:

text

20220610T043241--initial-thoughts-on-the-zettelkasten-method__notetaking.org
20220610T062201--define-custom-org-hyperlink-type__denote_emacs_package.md
20220610T162327--on-hierarchy-and-taxis__notetaking_philosophy.txt

denote-prompts 可以按照如下方式来配置：

text

DATE.EXT
DATE--TITLE.EXT
DATE__KEYWORDS.EXT
DATE==SIGNATURE.EXT
DATE==SIGNATURE--TITLE.EXT
DATE==SIGNATURE--TITLE__KEYWORDS.EXT
DATE==SIGNATURE__KEYWORDS.EXT

链接笔记

denote 提供了不同的命令在笔记之间创建链接。

所有的被链接的文件都必须是 denote 文件，无法识别其他文件。

添加一个单独的链接

denote-link 命令在 minibuffer 中选择一个文件插入到当前文件中作为链接。链接的格式取决于当前的文件是 Org 还是 Markdown。

我们也可以再 Org 文件中支持链接到标题，使用 denote-org-store-link-to-heading 命令，其他文件格式不支持。

当使用前缀键（默认是 C-u ）调用 denote-link ，无论文件类型如何，他都会设置链接为 [[denote:IDENTIFIER]] 的格式。

默认情况下，链接的描述是这样确定的：

denote-org-store-link-to-heading 用户选项

选项 denote-org-store-link-to-heading 确定 org-store-link 是否链接到当前 Org 文件的标题。

org-store 就是把当前的链接存储起来，之后用 org-insert-link 插入，而 denote-org-store-link-to-heading 选项会影响到这个命令。

当该选项为非 nil 时， org-store-link 就是将当前标题的链接存储起来，而不是存储 denote 文件的链接。

如果标题没有 CUSTOM_ID ，则创建 PROPERTIES 它并将其包含在标题的抽屉中。如果存在 CUSTOM_ID ， org-store-link 按原样使用。

插入执行 org 文件中标题的链接

作为 denote-org-extras.el 拓展的一部分， denote-org-extras-link-to-heading 会提供执行 Org 文件标题的链接。

链接形式如下：

text

[[denote:IDENTIFIER::#ORG-HEADING-CUSTOM-ID]][Description::Heading text]]

插入一个符合正则表达式的链接

命令 denote-add-links 添加数个链接，链接匹配正则表达式。这些链接作为列表排版插入，例如：

text

- link1
- link2
- link3

可以使用的正则表达式示例：

• journal 匹配所有包含 journal 标题名字的笔记。
• _journal 匹配所有关键字为 journal 的笔记。
• ^2022.*_journal 匹配所有在 2022 开始的笔记，并且含有关键字 journal 。
• \.txt 匹配拓展名为 txt 的文件。

链接到一个已存在的笔记或者创建一个新的笔记

在一个人的笔记工作流程中，他们可能在阐述某个主题时，但他们想要连接到另一个主题时。 Denote 提供了几个方便的命令：

• denote-link-after-creating

  在后台创建一个新笔记并且直接链接到这里。

• denote-link-after-creating-with-command

  这个命令和上面一个类似，只是提示输入创建笔记的命令。

• denote-link-or-create

  使用 denote-link 在目标文件，必须时创建它。

反向链接的 buffer

denote-backlinks 会生成一个自定义的缓冲区，其中显示指向当前笔记的反向链接。 “反向链接”是返回当前条目的链接。

默认情况下，反向链接的 buffer 设计为显示链接到当前条目的注释的文件名。每个文件名都显示在自己的行上。

text

Backlinks to "On being honest" (20220614T130812)
------------------------------------------------

20220614T145606--let-this-glance-become-a-stare__journal.txt
20220616T182958--feeling-butterflies-in-your-stomach__journal.txtx

反向链接缓冲区使用的是 Emacs 内置的 Xref 基础设施。在某些操作系统上，用户可能需要将某些可执行文件添加到相关的环境变量中。