Software on omegaatt

使用 Templater 來提昇 Obsidian 的生產力

raiven.kao@gmail.com (Raiven Kao) — Thu, 02 Jan 2025 00:00:00 +0000

這篇文章不涉及 Obsidian 完整使用說明以及 Templater 完整使用教學，僅以一個 use case 來展現如何使用 Templater 來提昇 Obsidian 的使用效率。

前言：

工作日誌，是一個甜蜜的負擔，有些人是因為公司要求，開始寫工作日誌，逐漸流於形式。

最初我也是因為工作需要「彙報」，才開始寫工作日誌。直到開始跑 scrum，開始明白 standup meeting 的意義，開始在意如何讓 stackholder 放心把事情交給我做，於是

參考了《SCRUM：用一半的時間做兩倍的事》以及實際執行的經驗，以下是我認為良好的彙報需要注意的關鍵因素：

昨天的進度：簡要說明昨天完成的具體工作，重點在成果而非過程。
今天的計劃：說明今天的工作重點，聚焦在需要達成的具體目標。如果是要跨超過一天的工作，也需要設定一個預計能完成的時間。
遇到的障礙：明確指出當前的問題或挑戰，並說明需要的幫助。當然也沒有必要什麼事都等到 standup meeting 才提出問題，有障礙應當即時反應。
與其他團隊或成員的依賴：說明需要其他人或團隊支持的地方，確保協作順暢，例如後端需要寄送的 email 內容，需要前端協助產生 html 等等。
以終為始、以成果為導向：聚焦於交付成果的進展，而非細節，例如：目前已完成 80% 的登入模組開發，預計明天可以驗收。

詳細的舉例不是這篇文章的重點，有空可以再寫成其他文章 D:

上述幾個要點，在工作日誌中被我濃縮成 markdown 的格式：

XXXX-XX-XX

昨日：
- 昨日1
- 昨日2
瓶頸：
- 瓶頸
今日：
- 今日1
- 今日2

Obsidian

高中時接觸了 markdown，大學接觸了 Hackpad，畢業後延續這個習慣，使用 Hackmd 來管理自己的工作日誌。

隨著時間的增長，開始發現 Hackmd 無論是官方 hosting 的免費版與企業版，或是 self-hosted 的 CodeMD，在單一大檔案編輯文件時，都會有明顯的延遲。若我將工作日誌拆成多個月份，又不好管理。

在 2023 年轉換工作之際，開始尋找其他 markdown 文字編輯器。

開源軟體的雙面刃：免費背後的隱藏成本

raiven.kao@gmail.com (Raiven Kao) — Fri, 01 Nov 2024 00:00:00 +0000

每日例行地開啟最愛的 Save for later，準備觀看有哪些部落格更新、產品釋出新版本時，一行醒目的提示告訴你「我們即將關閉伺服器」。

錯愕，這是 2024 年十月底每一位 Omnivore App 難民的心情。

一、開源軟體的普及與迷思

說到開源軟體，不外乎就是 free 或是 freedom 的軟體，可以說是免費的軟體，也可以說是自由的軟體。

早期的 LAMP Stack 相較於 Microsoft 的 Windows Server、IBM 或是 Oracle 付費的服務，每個組件都是免費的，廣泛受到 Geek 到大中小型企業的使用

同時，開源軟體顧名思義是開放原始碼，在授權許可下可以自由使用、修改、分享，許多人將開源與安全劃上等號。

二、開源軟體的安全現況

多雙眼睛的侷限

即便開放原始碼，所有人都能查看開放原始碼，如果有任何 bug 或是安全漏洞，都「應該」會被發現。我使用「應該」一詞，正因為許多人（包含我）在安裝開源軟體時，就如同安裝閉源軟體一樣，並不會查看全部的程式碼，確認安全後才進行安裝。而是做一個「大家都看過了，應該很安全」的假設。例如當你想用 Nginx 取代 Apache 時，可能僅會比較兩者的 feature 與 benchmark，並不會查看內部 tcp socket 是如何管理等等，或是 buffer overflow 時的錯誤處理機制。

開源是否暴露更多漏洞？

####安全問題的挑戰

當我們將軟體開源，等於是將所有安全問題也給暴露了出來。

舉例來說，假如我們 self-hosted 一個 NAS 服務，這個 NAS 使用指定的 port 進行 web 與 API 的存取，例如 :8787。當一個 Hacker 看到該 NAS 的 Auth 並沒有任何 rate limit，就可以直接在 NAS 內進行 port scan 或是 brute force 攻擊，取得這個 NAS 服務的控制權。

A smarter way to change directory: zoxide

raiven.kao@gmail.com (Raiven Kao) — Tue, 24 Sep 2024 00:00:00 +0000

在日常的開發工作中，我們經常需要在不同的目錄間切換。雖然 cd 命令已經足夠好用，但如果有一個更聰明的工具能記住我們最常用的目錄，並讓我們用最少的按鍵就能快速跳轉，那豈不是更棒?

這就是 zoxide 的用武之地。zoxide 是一個由 Rust 編寫的「更聰明的 cd 命令」，靈感來自 z 和 autojump。它會記住你最常使用的目錄，讓你只需輸入幾個字符就能快速跳轉。

zoxide 的主要特性

自動匹配: 不需要輸入完整路徑，zoxide 會根據輸入自動匹配最相關的目錄：
自動紀錄過去的目錄: zoxide 會記住你最常使用的目錄，讓你只需輸入幾個字符就能快速跳轉。這些資料可以使用 zoxide query 來查詢，或是 zoxide edit 來管理。
互動式選擇: 結合 fzf，可以互動式地選擇目標目錄
輕量快速: 用 Rust 編寫，啟動迅速，幾乎不會影響 shell 的啟動時間

安裝與配置

zoxide 的安裝可以參考官方文件，我們就不多贅述了。

安裝完成後，我們需要在 shell 的配置文件中添加初始化命令。以 zsh 為例，在 ~/.zshrc 的末尾添加:

eval "$(zoxide init zsh)"

重新打開終端或執行 source ~/.zshrc 後，zoxide 就可以使用了。

使用方法

zoxide 的基本用法非常直觀，經過自動執行 zoxide init zsh 後，我們可以使用 z 和 zi

自動匹配:

❯ ls
  boo bar baz
❯ z bo
❯ pwd
  /home/raiven/boo

即便沒有輸入完整路徑，也能夠自動匹配最相關的目錄

❯ pwd
  /home/raiven/dev/omegaatt-blog
❯ z
❯ pwd
  /home/raiven
❯ z blog
❯ pwd
  /home/raiven/dev/omegaatt-blog

互動式選擇:

❯ zi
~ < 98/98(0)
296.0 /home/raiven/dev/omegaatt-blog
124.0 /home/raiven/dev/bookly
 50.0 /home/raiven/dev
 24.0 /home/raiven/dev/test
 12.0 /home/raiven/

這裡的 z 命令就像一個更聰明的 cd，而 zi 則是互動式版本。

在 Firefox 上使用 PWA 將網頁應用安裝成 Desktop App

raiven.kao@gmail.com (Raiven Kao) — Sun, 25 Aug 2024 00:00:00 +0000

前言

開應用時，跨平台的桌面解決方案時常困擾開發者，在 Linux Desktop 上要支援多種桌面協議與桌面管理系統，更是複雜許多。時常會看到 Electron 等等基於 chromium 的技術。

當然也可以像是 zed.dev 這樣的 geek 精神，自己寫了一套跨平台的 GUI 框架，但多數新創公司可能沒有這些資源來實現。例如已經非常成熟的 Notion.so、Obsidian 等等都是基於 Electron 實現的。

我並非一個 anti-Electron 或是 deGoogle 的人，但試圖找到其他解決方案正式樂趣之所在。

PWA(Progressive Web App）

詳盡的 PWA 技術可以到 mozilla 的文件中查看，對我來說只要可以達到目的：可以在 Windows、Mac、Linux 上封裝成 Desktop Aplication 即可。

官方支援

mozilla 官方有一個文件針對「安裝網頁應用到桌面環境」的歷史講解，可以參考官方文件。

文中提到過去將網址「儲存」在桌面上的類似「書籤」的方法(SSB)，以及與 PWA 的不同之處：PWA 的使用者資料是儲存在桌面環境中。

PWA Add-on

上述文件內有提到需要使用 Fan-maded 的 PWA Add-on 來安裝 PWA：Progressive Web Apps for Firefox by Filip Štamcar。

他是一個開源的 Firefox 擴充套件(filips123/PWAsForFirefox)，具有完整的文件。

安裝過程

在 Firefox 瀏覽氣上安裝 PWA Add-on
瀏覽器會自動跳到設定頁面，首先會需要同意 EULA
接著會需要安裝 connector，需要透過該 connector 才能連結瀏覽器本身與 extension。 connector 由 Rust 編寫，使該 extension 可以在跨平台的桌面環境中管理 firefox 設定檔、runtime 等等未開放給 extension 存取的資源。

Windows: Windows 的 connector 除了手動安裝外，也推薦使用 winget 來安裝，類似於 apt/yum 的套件管理工具。
Linux Linux 的 connector 可以到 github release 上找到，例如我的作業系統是 OpenSUSE Tumbleweed，則可以下載 .rpm 檔案。
```
sudo zypper in ./firefoxpwa-2.12.1-1.x86_64.rpm
```
- Debian/Ubuntu(DEB):
- Redhat/Fedora/OpenSUSE(RPM):

接著會需要安裝不同於原生 Firefox 的 runtime，根據描述，會下載並由 connector 自動修改成支援 PWA 的 runtime。
到這邊已經完成 PWA extension 的安裝，可以嘗試使用 PWA 的方式來安裝 web app to desktop app。
首先需要打開你想要安裝成 Desktop App 的網頁，如果在不同的網頁嘗試設定，extension 會自動判斷該網頁 CORS Error，即便是 https://www.notion.so 與 https://notion.so 也屬於不同的 Origin。接著點擊 PWAForFirefox 的圖示，可以看到已經安裝好的 extension。
接著一步一步的跟著指引設定好該 PWA 的設定。
完成，可以在應用程式選單內找到剛剛建立的 PWA 應用程式。
開啟後可以自動開啟網頁應用程式，並具有獨立的設定檔。

使用感受

三四年前在 Windows 上習慣使用 Notion Desktop 版本，在 Linux 上反而已經習慣要用網頁來打開，這次嘗試使用 PWA 後倒是經常忘記有將它安裝成 Desktop Application。

透過 Distrobox 解決 Linux 環境依賴問題

raiven.kao@gmail.com (Raiven Kao) — Sat, 18 May 2024 00:00:00 +0000

前言

自從一年前嘗試使用 KDE Neon 後，主要的桌面開發環境就從 wsl 整個遷移到 Linux 上。這一年來感受到，KDE Neon 可能正如 reddit 上的留言闡述的那樣，只是 KDE 團隊的「實驗場」，可以享受到「最」新的 Plasma 與「較」新的 Kernel，卻始終是基於 Ubuntu 22.04 LTS，即便 Ubuntu 24.04 LTS 推出之際，也不再讓我感受性感。

因緣際會，在 Ubuntu 24.04 LTS 發布之際，我決定從 KDE Neon distro hopping 到 OpenSUSE Tumbleweed，這是一個由 SUSE 公司推出的滾動式發行版，軟體包在 SUSE 測試過後便會推送到 OpenSUSE 的 Repo（其他 OpenSUSE 的功能省略）。這次的轉換主要是為了獲得最前沿的 Linux 體驗。OpenSUSE Tumbleweed 的滾動更新模式能確保我始終使用最新的軟體和技術，這對我來說是一個有趣的選擇，即便有可能收到有問題的 xz 更新 XD。

❯ fastfetch
                                     ......             raiven@raiven-suse
     .,cdxxxoc,.               .:kKMMMNWMMMNk:.         ------------------
    cKMMN0OOOKWMMXo. A        ;0MWk:'      ':OMMk.      OS: openSUSE Tumbleweed 20240517 x86_64
  ;WMK;'       'lKMMNM,     :NMK'             'OMW;     Host: FMV UH-X
 cMW;             WMMMN   ,XMK'                 oMM.    Kernel: 6.8.9-1-default
.MMc             ''^*~l. xMN:                    KM0    Uptime: 1 hour, 14 mins
'MM.                   .NMO                      oMM    Packages: 3211 (rpm), 37 (flatpak)
.MM,                 .kMMl                       xMN    Shell: zsh 5.9
 KM0               .kMM0' .dl>~,.               .WMd    DE: KDE Plasma 6.0.4
 'XM0.           ,OMMK'    OMMM7'              .XMK     WM: KWin (Wayland)
   *WMO:.    .;xNMMk'       NNNMKl.          .xWMx      WM Theme: Nordic
     ^ONMMNXMMMKx;          V  'xNMWKkxllox0NMWk'       Theme: Breeze (NordicDarker) [QT], Breeze-Dark [GTK2], Breeze [GTK3]
         '''''                    ':dOOXXKOxl'          Icons: Zafiro-Nord-Dark-Black [QT], Zafiro-Nord-Dark-Black [GTK2/3/4]
                                                        Font: Noto Sans (10pt) [QT], Noto Sans (10pt) [GTK2/3/4]
                                                        Cursor: Nordic (24px)
                                                        Terminal: tmux 3.4
                                                        CPU: 13th Gen Intel(R) Core(TM) i5-1335U (12) @ 4.60 GHz
                                                        GPU: Intel Iris Xe Graphics @ 1.25 GHz [Integrated]
                                                        Memory: 9.86 GiB / 15.27 GiB (65%)
                                                        Swap: 677.00 MiB / 2.00 GiB (33%)
                                                        Disk (/): 88.81 GiB / 1.82 TiB (5%) - btrfs

即便是已經足夠穩定的 OpenSUSE，也是可以很輕易的被搞的不穩定，正如 debian 在 DontBreakDebian 一文中提到的：

WSL2 中使用 systemd 管理 podman 的 container

raiven.kao@gmail.com (Raiven Kao) — Mon, 13 Feb 2023 00:00:00 +0000

原本使用 wsl-distrod 來作為 wsl 中 systemd 的實現方式，後來 microsoft 宣布 wsl 支持 systemd 後，distrod 等等 repo 就沒有在更新了呢，是巧合嗎?我不這麼認為。

這篇簡略紀錄 wsl2 中啟用 systemd 作為 process 管理工具以及配合紅帽推出的 podman 來取代(斷捨離)docker desktop。

環境

wsl2 + ubuntu 22.04

❯ neofetch
            .-/+oossssoo+/-.               raiven@raiven
        `:+ssssssssssssssssss+:`           -------------
      -+ssssssssssssssssssyyssss+-         OS: Ubuntu 22.04.1 LTS on Windows 10 x86_64
    .ossssssssssssssssssdMMMNysssso.       Kernel: 5.10.43.3-microsoft-standard-WSL2
   /ssssssssssshdmmNNmmyNMMMMhssssss/      Uptime: 3 hours, 10 mins
  +ssssssssshmydMMMMMMMNddddyssssssss+     Packages: 2005 (dpkg), 4 (snap)
 /sssssssshNMMMyhhyyyyhmNMMMNhssssssss/    Shell: zsh 5.8.1
.ssssssssdMMMNhsssssssssshNMMMdssssssss.   Theme: Adwaita [GTK3]
+sssshhhyNMMNyssssssssssssyNMMMysssssss+   Icons: Adwaita [GTK3]
ossyNMMMNyMMhsssssssssssssshmmmhssssssso   Terminal: Windows Terminal
ossyNMMMNyMMhsssssssssssssshmmmhssssssso   CPU: AMD Ryzen 9 5900X (24) @ 3.700GHz
+sssshhhyNMMNyssssssssssssyNMMMysssssss+   GPU: dbac:00:00.0 Microsoft Corporation Device 008e
.ssssssssdMMMNhsssssssssshNMMMdssssssss.   Memory: 1427MiB / 15966MiB
 /sssssssshNMMMyhhyyyyhdNMMMNhssssssss/
  +sssssssssdmydMMMMMMMMddddyssssssss+
   /ssssssssssshdmNNNNmyNMMMMhssssss/
    .ossssssssssssssssssdMMMNysssso.
      -+sssssssssssssssssyyyssss+-
        `:+ssssssssssssssssss+:`
            .-/+oossssoo+/-.

wsl2 中啟用 systemd

請確保 wsl2 的版本是 version 2，可以在 cmd/powershell 中查看

Prometheus 學習筆記 - 基本架構與資料結構

raiven.kao@gmail.com (Raiven Kao) — Sat, 18 Sep 2021 00:00:00 +0000

Prometheus Overview

架構

Exporter: 要被採集的目標 job 中曝露 metrics 的組件，負責轉換資訊成 prometheus 可解讀的格式。由於某些早於 prometheus 的 service 因為某些原因，不想主動在服務中曝露 metrics，故可以用一些額外的 exporter 將這些 service 中的 metrics 轉成 prometheus 格式，並曝露埠。
- node exporter
- mysql exporter
Push Gateway: 由於有些任務時間太短，可能不到 prometheus pull 的週期，可讓這些 jobs 主動把 metrics push 到這個 push gateway，好讓 premetheus server 可以 pull。

Prometheus Server

Retrieval(retrieval system): 主要負責 pull 指定的 target

# /etc/prometheus/prometheus.yml
scrape_configs:
  - job_name: "prometheus"
    static_configs:
      - targets: ["localhost:9090"]
  - job_name: "node_exporter"
    static_configs:
      - targets: ["localhost:9100"]

TSDB: 時間序列資料庫，存放 pull 到的 metrics
HTTP Server: 為 PromeQL 查詢提供接口

Service Discovery:
- kubernetes: 自動發現 k8s 中 pod 增加減少以及 probe 異動等等
- file_sd: 通過 config 實現服務的自動發現
Alert Manager: 當 prometheus server 發現某某某 job 已經達到設定好的通知閾值進行通知的 service。
PromeQL: 無論是自帶 web UI 或是串接 Grafana，都是通過 http 進行 PromeQL 查詢後做視覺化處理 TSDB 中的時間序列資料。

資料結構

下面範例中會有更詳細說明