Principles

Methods

在最开始需要构建的关键体系就是检索的逻辑。

在双链部分由于原则上已经和思维高度同步，因此不需要做额外的增加思维成本的检索，只要在记录原子笔记的时候，顺其自然，高度提炼出明确、简洁的一句话概念即可。

在标签tags部分，我习惯把标签当作是一个object的二、三级属性来看待。例如《黄金时代》这本书，它的基础属性是book，我不会再重复标注它，而是写在property里，记下~Type: book~方便我通过函数来列举所有的书目，tag则记下文学、王小波。我习惯用单数来强调它是个属性，区别与复数的category集合的概念。

我看过许多博客和PKM，许多情况下，他们的tags在语义概念上都混用了，我习惯把tags和categories分开，分类就是分类，标签就是标签。category、property、tag还是需要在逻辑里有自然的分类，理清楚一个概念的内涵与外延。混用会导致tags越来越多，成百上千的tags反而会增加检索的成本，过个几年，大多数的tags你已经忘了当时为什么记下了，单独再去整理标签无疑是个巨大的工程，tags也失去了应当有的作用。tags的构建同样应当同步与自身的思维习惯，自身对概念、语义的记忆。

当然这也完全取决于每个人自己的习惯。

学习、获取信息和知识是在做加法，PKM里更多的应该是减法，Learn and unlearn。

可以参考我的思路：org-mode-pkm

example： Emacs，org-roam，模板创建Daily和note：

• Org-tag
  

  org里的标签功能也很全面，支持多个分组，可以自动补全，还支持自定义标签的快捷键。这很好的保证了之前所说的 标签的统一性 ，大小写或者单复数不统一会很麻烦。

  在org的任意标题之后加上 :TAG1::TAG2: 就打上了标签。

  进阶用法 如下：

  在Org Mode中，你可以通过按下快捷键来为项目或任务添加预定义的标签。以下是具体的步骤：

  1. 光标定位：将光标移动到你想要添加标签的项目或任务上。
  2. 添加标签：按下快捷键 C-c C-q ，org-set-tags-command，这将打开标签过滤器。可以直接在标题的最后输入标签。在输入冒号后，M-TAG 提供了标签的自动补全和选择功能。
  3. 使用快捷键：在标签过滤器中，输入你为标签分配的字符常量作为快捷键。例如，如果你为 @work 标签分配了字符 w ，那么在标签过滤器中输入 w 。
  4. 确认添加：按下 Enter 键，这将为项目或任务添加相应的标签。

  默认情况下，org 模式使用标准的 minibuffer 来输入标签 。然而，emacs 还提供了另外一种叫做 fast tag selection 的快速标签选择方式。在这种方式下可以仅用一个键来完成标签的选择和反选。要想使用这种方式，首先要为常使用的标签分配一个唯一字符。这个字符可以通过配置 org-tag-alist 来设置。比如，需要在很多文件中为很多项添加 ':home:' 标签。在这种情况下，可以这样设置：

  (setq org-tag-alist '(("@work" . ?w) ("@home" . ? h ) ("@laptop" . ?l)))

  如果标签仅仅和当前使用的文件相关，那么可以像下面这样在文件中添加 TAGS 选项：

  #+TAGS: @work(w) @home(h) @tennisclub(t) laptop(l) pc(p)

  标签接口会在一个 splash windows 中显示可用的标签。如果想在一个特定的标签后换行，需要在标签列表中插入一个 '\n' 。

  #+TAGS: @work(w) @home(h) @tennisclub(t) \n laptop(l) pc(p)

  或者将他们写成两行

  #+TAGS: @work(w) @home(h) @tennisclub(t)
  #+TAGS: laptop(l) pc(p)

  也可以像下面这样用大(花)括号手动将标签进行分组

  #+TAGS: { @work(w) @home(h) @tennisclub(t) } laptop(l) pc(p)

  在这种情况下， @work(w) @home(h) @tennisclub(t) 三个标签最多同时选择一个

  org 也允许多个分组。当光标在这些行上的时候，不要忘了按 C-c C-c 来激活其它修改。

  如果要在 org-tags-alist 中设置排它的标签组，必需要用 :startgroup 和 :endgroup 标签对，而不是用大括号。类似的，可以用 :newline 来声明一个新行。上面的例子也可以用下面的方式进行设置：

  (setq org-tag-alist '((:startgroup . nil)
                        ("@work" . ?w) ("@home" . ?h)
                        ("@tennisclub" . ?t)
                        (:endgroup . nil)
                        ("laptop" . ?l) ("pc" . ?p))

  Ref:

  • Tags (The Org Manual)
  • emacs org mode 中的标签全参考 - 咖啡加茶 - 博客园
  • 强大的 Org mode(4): 使用 capture 功能快速记录 · ZMonster's Blog
• Org-agenda
  

  最开始是不打算用org-agenda的，因为没有太多TODO要去管理。用 #TODO 来标注TODO搜索也并不麻烦。但是考虑到时间久了，agenda也可以通过标注时间戳来回顾非TODO项，还是启用了。和org-roam配合，可以很清晰的回顾一个星期内重要的笔记。以后需要清除掉这些时间戳也很方便，一个正则搞定。

  之前考虑到和其他笔记软件通用的问题，journal全部以单独的文件按照年份生成，现在改为集中在一个 journal.org 文件里。要不然以后org-agenda每次要扫描几年的journal文档会很头疼，现在改为每年一个单独的 20xx-journal.org 文件。

  需要注意的是：在最开始设置好org-agenda要包括的文件或文件夹

  ;; 单独的文件
  (setq org-agenda-files '("~/your/path/to/1.org" "~/your/path/to/2.org"))
  ;; 文件夹
  ;; 这样会把目录下包括子文件夹的文件都添加进去 https://emacs-china.org/t/org-txt-agenda/13506/5
  (setq org-agenda-files (directory-files-recursively "~/your/directory/" "\\.org$"))
  ;; 文件夹但不包括子文件夹
  (setq org-agenda-directory "~/your/agenda/directory/")

  这是现在的样子：

  

• TODOs
  

  • 你可以通过在TODO项目下新建一个大纲树，并在子树上标记子任务来实现这个功能。为了能对已经完成的任务有个大致的了解，你可以在标题的任何地方插入 [/] 或者 [%] 。当每个子任务的状态变化时，或者当你在标记上按 C-c C-c时，这些标记状态也会随之更新。

      * TODO Organize party [1/3]
        - [-] call people [1/2]
          - [ ] Peter
          - [X] Sarah
        - [X] order food
        - [ ] think about what music to play

    Org mode 允许定义进入状态和离开状态时的额外动作，可用的动作包含两个:

    • 添加笔记和状态变更信息(包括时间信息)，用"@"表示
    • 只添加状态变更信息，用"!"表示

    这个通过定义带快速选择键的关键词时，在快速选择键后用"X/Y"来表示，X表示进入该状态时的动作，Y表示离开该状态时的动作。对于一个状态(以"DONE"为例)，以下形式都是合法的:

      DONE(d@)       ; 进入时添加笔记
      DONE(d/!)      ; 离开时添加变更信息
      DONE(d@/!)     ; 进入时添加笔记，离开时添加变更信息

    • 除了基于 headline 的任务管理外，Org mode 还提供基于列表的任务管理，即将每个列表项作为任务，方法是在列表标记与列表项内容之间添加一个 "[ ]" 标记(注意中间包含一个字符的预留位置)，这个标记在 Org mode 中被称为 checkbox 。这种任务只有三种状态(待办、进行中和完成)，分别用 [ ], [-] 和 [X] 表示。

      若要将用 checkbox 标记的任务标记为完成，将光标移动到对应的行，然后使用快捷键 "C-c C-c" 即可。对于包含子任务的任务，如果其子任务未全部完成，用此快捷键更改其子任务状态时，该任务的状态会自动设置为 "进行中([-])"，表示子任务未全部完成；当用快捷键将所有子任务标记为完成时，它会自动更新为完成状态。

      用"TODO"等关键词标记为headline为任务时，使用的快捷键同样适用于checkbox，不过略有不同:

      快捷键	功能	备注
      C-S-return	在当前列表项的内容后面建立一个同级列表项，标记为 "[ ]"	无列表项时不创建
      M-S-return	在当前列表项后建立一个同级列表项，标记为 "[ ]"

      使用 shift+← →方向键 也可以快速更改TODO的状态。

    • TODO sequence

         (setq org-todo-keywords
               '((sequence "TODO(t)" "DOING(i)" "|" "DONE(d@)")))
         (setq org-log-done 'time) ;; 每次当你将一个项从 TODO (not-done) 状态变成任意的 DONE 状态时，那么，它就会自动在标题的下面插入一行下面的内容：CLOSED: [timestamp]

  Ref：

  • 新人提问，org格式中，重复任务在某一天完成后，却不能在agenda正确显示。。。 - Emacs-general - Emacs China
  • Master-Emacs-From-Scratch-with-Solid-Procedures/06.Emacs-as-Agenda-by-Org
  • Agenda Views (The Org Manual)
  • emacsist.github.io/emacsist/orgmode/orgmode手册学习笔记.html
  • 强大的 Org mode(2): 任务管理 · ZMonster's Blog
  • Org-mode 简明手册 - open source - 博客园
• Org-capture
  

  Org-capture 是org-mode做笔记比较核心的功能，结合capture-templates可以在不离开当前buffer的情况下，快速记录、捕捉特定的内容到特定的文件和位置。加上时间戳还可以在agenda里以时间线回顾。

  目前PKM里的Journal-日志、clip-剪藏、task-TODO等都是用org-capture处理的。

  一定要在最开始先设置好org的默认笔记目录： (setq org-directory "~/your/path/org/")

  需要注意的是：对于Doom-Emacs，需要在 (after！org) 里写上关于org的配置来覆盖Doom-Emacs的默认配置。

  如果常规的org-capture参数不足以满足你的需求，这个函数可能对你有帮助：

  ;; org-capture支持自定义函数，通过function来执行
  (defun my-org-goto-last-todo-headline ()
      "Move point to the last headline in file matching \"* Notes\"."
      (end-of-buffer)
      (re-search-backward "\\* TODOs"))
  (add-to-list 'org-capture-templates
              '("t" "Task" entry (file+function "~/Vandee/pkm/org/Journal.org"
                                                  my-org-goto-last-todo-headline)

  下面是org-capture的模板和相关配置：

  (after! org
    ;; (server-start)
    ;; (require 'org-protocol)
    (org-link-set-parameters "zotero" :follow
                             (lambda (zpath)
                               (browse-url
                                ;; we get the "zotero:"-less url, so we put it back.
                                (format "zotero:%s" zpath))))
    (setq org-agenda-files '("~/Vandee/pkm/org/Journal.org" "~/Vandee/pkm/org/clip.org"))
    ;; (setq org-agenda-include-diary t)
    ;; (setq org-agenda-diary-file "~/Vandee/pkm/org/Journal.org")
    (setq org-directory "~/Vandee/pkm/org/")
    (global-set-key (kbd "C-c c") 'org-capture)
    ;;(setq org-default-notes-file "~/Vandee/pkm/inbox.org")
    (setq org-capture-templates nil)
    ;; (add-to-list 'org-capture-templates
    ;;              '("j" "Journal" entry (file+datetree  "~/Vandee/pkm/Journals/Journal.org")
    ;;                "* [[file:%<%Y>/%<%Y-%m-%d>.org][%<%Y-%m-%d>]] - %^{heading} %^g\n %?\n"))
    (add-to-list 'org-capture-templates
                 '("j" "Journal" entry (file+datetree "~/Vandee/pkm/org/Journal.org")
                   "* TODOs\n* Inbox\n- %?"))
    (add-to-list 'org-capture-templates
                 '("i" "Inbox" entry (file+datetree "~/Vandee/pkm/org/Inbox.org")
                   "* %U - %^{heading} %^g\n %?\n"))
    (defun my-org-goto-last-todo-headline ()
      "Move point to the last headline in file matching \"* Notes\"."
      (end-of-buffer)
      (re-search-backward "\\* TODOs"))
    (add-to-list 'org-capture-templates
                 '("t" "Task" entry (file+function "~/Vandee/pkm/org/Journal.org"
                                                   my-org-goto-last-todo-headline)
                   "* TODO %i%? \n%T"))
    (add-to-list 'org-capture-templates '("c" "Collections"))
    (add-to-list 'org-capture-templates
                 '("cw" "Web Collections" item
                   (file+headline "~/Vandee/pkm/org/websites.org" "实用")
                   "%?"))
    (add-to-list 'org-capture-templates
                 '("ct" "Tool Collections" item
                   (file+headline "~/Vandee/pkm/org/tools.org" "实用")
                   "%?"))
    (add-to-list 'org-capture-templates
                 '("cc" "Clip Collections" entry
                   (file+headline "~/Vandee/pkm/org/clip.org" "Clip")
                   "* %^{heading} %^g\n%T\nSource: %^{source}\n%?"))

  Ref：

  • 强大的 Org mode(4): 使用 capture 功能快速记录 · ZMonster's Blog
  • Capture (The Org Manual)
• Org-roam
  

  Org-roam 是Emacs的一个包，也是org-mode 的扩展，可以简单的实现双链，通过org-roam-ui直观的预览。

  

  也不是必须，只需要解决双链的查看就可以了。

  org-roam也有它的capture，可以直接生成org笔记。而org-roam的「 node-insert 」可以快速在文档里直接插入新的笔记。与常规的org-mode .org 文件不同的是，它可以通过带id的node「 节点 」链接来实现org-mode里的双链功能。每一个org-roam笔记都有唯一的id。

  其他属性和使用基本与org-mode一致，也是生成 .org 文件。同样也需要配置org-roam的capture-templates。原来用org-roam创建Journal日志文件，现在已经用org-capture替代。

  org-roam-ui也有和Logseq一样的网点图谱「 Graph View 」，也提供大纲结构视图，对于我来说用起来很亲切。如果你觉得org-mode可读性不强，那么org-roam-ui一定会让你喜欢。org-roam-ui是在浏览器里通过 org-roam-protocol 访问，需要在配置加上 (require 'org-roam-protocol) 。

  同样也需要在最开始设置好org-roam笔记的文件夹： (setq org-roam-directory "~/your/roam/directory/")

  有一个坑，org-roam会自动生成一个 .orgids 文件来记录生成的每个org-roam笔记的id，如果不设置会在系统根目录下自动生成。加上 (org-id-locations-file "~/your/path/to/.orgids")即可。在一开始我一度认为我的电脑是不是哪里出了问题🤣，这个文件冷不丁的就冒出来了，删了重启又有了。官方文档和各大论坛里都没有这个设置，困扰了我很久，还是GPT帮我解决了。

  下面是模板和相关配置：

  ;; (setq org-roam-dailies-directory "~/Vandee/pkm/Journals/")
  (setq org-export-with-toc nil) ;;禁止生成toc
  (use-package org-roam
    :ensure t
    :init
    (setq org-roam-v2-ack t)
    :custom
    ;; (org-roam-dailies-capture-templates
    ;;  '(("d" "daily" plain "* %<%Y-%m-%d>\n* TODO\n- \n* Inbox\n- %?"
    ;;     :if-new (file+head "%<%Y>/%<%Y-%m-%d>.org" "#+TITLE: %<%Y-%m-%d>\n"))))
    (org-roam-directory "~/Vandee/pkm/roam/")
    (org-id-locations-file "~/Vandee/pkm/roam/.orgids")
    (org-roam-capture-templates
     ~(("n" "note" plain "%?"
        :if-new (file+head "${title}.org"
                           "#+TITLE: ${title}\n#+UID: %<%Y%m%d%H%M%S>\n#+FILETAGS: \n#+TYPE: \n#+SOURCE: \n#+DATE: %<%Y-%m-%d>\n")
        :unnarrowed t))
     )
    (org-roam-completion-everywhere t)
    :bind (("C-c n l" . org-roam-buffer-toggle)
           ("C-c n f" . org-roam-node-find)
           ("C-c n i" . org-roam-node-insert)
           ("C-c n I" . org-roam-node-insert-immediate)
           ("C-c n c" . org-roam-capture)
           ;; ("C-c n j" . org-roam-dailies-capture-today)
           :map org-mode-map
           ("C-M-i" . completion-at-point)
           ;; :map org-roam-dailies-map
           ;; ("Y" . org-roam-dailies-capture-yesterday)
           ;; ("T" . org-roam-dailies-capture-tomorrow))
    ;; :bind-keymap
    ;; ("C-c n d" . org-roam-dailies-map)
    :config
    (require 'org-roam-dailies) ;; Ensure the keymap is available
    (org-roam-db-autosync-mode)
    (require 'org-roam-protocol)
    )

  org-roam-capture模板分组

  ;; org-roam-capture模板分组
  (setq org-roam-capture-templates
        '(
          ("d" "default" plain (function org-roam-capture--get-point)
           "%?"
           :file-name "%<%Y%m%d%H%M%S>-${slug}"
           :head "#+title: ${title}\n#+roam_alias:\n\n")
          ("g" "group")
          ("ga" "Group A" plain (function org-roam-capture--get-point)
           "%?"
           :file-name "%<%Y%m%d%H%M%S>-${slug}"
           :head "#+title: ${title}\n#+roam_alias:\n\n")
          ("gb" "Group B" plain (function org-roam-capture--get-point)
           "%?"
           :file-name "%<%Y%m%d%H%M%S>-${slug}"
           :head "#+title: ${title}\n#+roam_alias:\n\n")))

  Ref：

  • org-roam v2 的 backlinks buffer 能否显示指向当前文件的所有 headlines 的反链 - Org-mode - Emacs China
  • org-roam的官方论坛：Org-roam - discourse
  • https://systemcrafters.net/build-a-second-brain-in-emacs/5-org-roam-hacks/
  • 使用 org-roam 构建自己的知识网络 · ZMonster's Blog
  • Boris Buliga - org-roam
  • Org-roam(v2) 以及 org-roam-ui 的使用姿势（已支持Emacs 29 内置的 sqlite) - Org-mode - Emacs China
• Org-export
  

  单独导出成MD、HTML或其他格式，Org-mode里就可以，也可以使用这些工具 。批量导出，由于每个人的排版和格式习惯不同，还是自己用自己熟悉的语言，写几个正则，搞个脚本。

  ;; 当前buffer下，替换markdown的链接和标题格式到org-mode的格式，排除图片的转换、替换代码块格式。
  (defun my-markdown-to-org ()
    (interactive)
    (save-excursion
      ;; 转换Markdown标题为Org-mode标题
      (goto-char (point-min))
      (while (re-search-forward "^\s*\\(#+\\) \\(.*\\)" nil t)
        (let ((level (length (match-string 1)))
              (title1 (match-string 2)))
          (replace-match (concat (make-string level ?*) " " title1)))))
    ;; 转换Markdown链接为Org-mode链接,但是跳过图片链接
    (goto-char (point-min))
    (while (re-search-forward "\\[[\(.*?\][\(.*?\)\]])" nil t)
      (let ((title (match-string 1))
            (url (match-string 2)))
        (unless (and (string-match "\\(jpeg\\|png\\|svg\\)" url)
                     (string-match "https" url))
          (replace-match (format "[[%s][%s]]" url title)))))
    ;; 转换Markdown代码块为Org-mode代码块
    (goto-char (point-min))
    (while (re-search-forward "^~~~" nil t)
      (if (looking-back "^~~~")
          (progn
            (replace-match "#+begin_src")
            (re-search-forward "^~~~" nil t)
            (if (looking-back "^~~~")
                (replace-match "#+end_src"))))))

  • Markdown to org-mode:

    Pandoc转换md到org会有小问题，批量转换还是悠着点。

    一个改善 Markdown to Org 转换的 Pandoc Filter 脚本 - Org-mode - Emacs China

    How to migrate Markdown files to Emacs org mode format - Emacs Stack Exchange

  Ref：Exporting (The Org Manual)、工具 | Org mode

• Org with Zotero
  

  书和论文的PDF文件，我现在全部放在Zotero。快速复制单个笔记到org-mode也挺简单：

  通过下载这个文件到 zotero 资料目录下的 translators 文件下，将其命名为 Zotero Select Item.js ，重启 Zotero 后在编辑-> 首选项中配置便捷复制的 Item Format 为 Zotero Select Item:

  这样就可以自定义复制粘贴过去的格式了。

  {
  "translatorID":"76a79119-3a32-453a-a0a9-c92640e3c93b",
  "translatorType":2,
  "label":"Zotero Select Item",
  "creator":"Scott Campbell, Avram Lyon",
  "target":"html",
  "minVersion":"2.0",
  "maxVersion":"",
  "priority":200,
  "inRepository":false,
  "lastUpdated":"2012-07-17 22:27:00"
  }
  function doExport() {
          var item;
          while(item = Zotero.nextItem()) {
                  Zotero.write("zotero://select/items/");
                  var library_id = item.libraryID ? item.libraryID : 0;
                  Zotero.write(library_id+"_"+item.key);
          }
  }

  然后在Emacs的配置文件里加上：

  (org-link-set-parameters "zotero" :follow
                          (lambda (zpath)
                          (browse-url
                              ;; we get the "zotero:"-less url, so we put it back.
                              (format "zotero:%s" zpath))))

  Ref：

  • https://hsingko.pages.dev/post/2022/07/04/zotero-and-orgmode/
  • https://www.mkbehr.com/posts/a-research-workflow-with-zotero-and-org-mode/
• Org-mode美化
  

  我觉得原生的就挺好看，可读性也还好。

  • minad/org-modern: :unicorn: Modern Org Style
  • 想向各位道友收集一下美化 org 的配置 - Org-mode - Emacs China
  • coldnew/pangu-spacing：emacs minor-mode用于在中文/日文/韩文和英文字符之间添加空格
  • 大模型时代我们怎么玩Emacs：1. 中英文输入时的空格 | remacs的世界 比pangu实用。

  ;; 设置标题大小
  (after! org
    (custom-set-faces!
      '(outline-1 :weight extra-bold :height 1.25)
      '(outline-2 :weight bold :height 1.15)
      '(outline-3 :weight bold :height 1.12)
      '(outline-4 :weight semi-bold :height 1.09)
      '(outline-5 :weight semi-bold :height 1.06)
      '(outline-6 :weight semi-bold :height 1.03)
      '(outline-8 :weight semi-bold)
      '(outline-9 :weight semi-bold))
    (custom-set-faces!
      '(org-document-title :height 1.2)))
  ;;字体，设置正文大小
  (setq doom-font (font-spec :family "霞鹜文楷等宽" :weight 'regular :size 14))
  ;; 设置行内make up，直接显示*粗体*，/斜体/，=高亮=，~代码~
  (setq org-hide-emphasis-markers t)
  ;; 盘古，中英文混合排版美化
  ;;https://github.com/coldnew/pangu-spacing
  (use-package pangu-spacing)
  (add-hook 'org-mode-hook
            '(lambda ()
               (set (make-local-variable 'pangu-spacing-real-insert-separtor) t)))

• Org-protocol
  

  Org-protocol可以在Emacs里更方便的剪藏网页内容，做after reading。也不是必须，多切换一次窗口也还好。

  • protocol

    求助: 在网页剪藏时用org-capture模板生成独立文件名 - Org-mode - Emacs China

    用org-mode做网页书签的可以进来看一下 - Org-mode - Emacs China

    什么样才是正确的org-protocol姿势 - Org-mode - Emacs China

    Org-roam User Manual-org-protocol

  • 插入网页连接：

    技巧分享：在 emacs 中获取 firefox 当前标签页并生成 org link

    org-protocol-capture-html

    或利用org-roam-capture-ref： https://www.zmonster.me/2020/06/27/org-roam-introduction.html

    或者使用浏览器插件：k08045kk/CopyTabTitleUrl

    Firefox这个反骨仔，经常不适配各种系统。比如不支持mac的applescript。

• 网页摘录和after-reading
  

  利用org-capture，做剪藏和摘录很方便。现在保存在 clip.org 文件里，可以在agenda里按时间线回顾，由于agenda里只有标题，也起到了类似Anki卡片回顾的作用：

  

  有一个JavaScript我一直在用，可以选定一个网页的特定内容，在翻译和剪藏的时候挺有用，同时也微微提升了一点阅读体验。我用 DeepLX 通过沉浸式翻译如果单次翻译内容太多会报错和限制，Deepl的中文翻译还是吊打其他的。

  下面的代码保存到书签，单击书签就可以了：

  javascript:(function(){var e=document.body;const n=document.head.appendChild(document.createElement("style"));n.textContent=".mainonly { outline: 2px solid red; }";const t=CSS.supports("selector(:has(*))");function o(n){n instanceof HTMLElement&&(e.classList.remove("mainonly"),(e=n).classList.add("mainonly"))}function s(e){o(e.target)}function a(o){if(o.preventDefault(),t)n.textContent=":not(:has(.mainonly), .mainonly, .mainonly *) { display: none; }";else{n.textContent=":not(.mainonly *, .mainonly-ancestor) { display: none; }";var s=e;do{s.classList.add("mainonly-ancestor")}while(s=s.parentElement)}l()}function i(n){n.preventDefault(),n.deltaY<0?o(e.parentElement):o(e.firstElementChild)}function l(){document.removeEventListener("mouseover",s),document.removeEventListener("click",a),document.removeEventListener("wheel",i)}document.addEventListener("mouseover",s),document.addEventListener("click",a),document.addEventListener("wheel",i,{passive:!1}),document.addEventListener("keydown",(function o(s){if("Escape"===s.key&&(n.remove(),document.removeEventListener("keydown",o),l(),e?.classList.remove("mainonly"),!t))for(const e of document.getElementsByClassName("mainonly-ancestor"))e.classList.remove("mainonly-ancestor")}))}())

  after-reading我一直用的 Omnivore，开源免费，支持RSS和Newsletter，可以自动同步高亮标注、摘录到Obsidian和Logseq。这部分用来做 流动知识的检索，文档+RAG现在的项目也越来越多了。用AI来过滤、总结这些信息流很巴适。

  简单写了一个python用来直接获取高亮摘录并与本地LLM问答：RSS 订阅和本地 LLM 结合的初步尝试 - 流动知识检索 | Vandee's Blog

  有条件直接上 Readwise，配合Notion、Obsidian、Logseq都挺好用。Pocket、memos 也挺不错，可以把阅读整合到PKM里。

  欢迎来到 n8n 中文教程 | 简单易懂的现代魔法这里给出了一个 omnivore 到 notion 的 workflow。

  最近还是入坑了 Readwise。

  • tools
    

    • 网站：https://jina.ai/reader/

      Github：https://github.com/jina-ai/reader

      它可以提取网页内容并转换为markdown格式，还支持直接搜索，支持API。

      Reader does two things:

      • Read: It converts any URL to an LLM-friendly input with https://r.jina.ai/https://your.url. Get improved output for your agent and RAG systems at no cost.
      • Search: It searches the web for a given query with https://s.jina.ai/your+query. This allows your LLMs to access the latest world knowledge from the web.

      添加下面代码到书签保存，点击书签就可以提取网页内容到markdown格式了。

        javascript: var currentUrl = window.location.href;var newUrl = "https://r.jina.ai/" + currentUrl;window.open(newUrl, '_blank');window.history.pushState({}, '', currentUrl);

    以这个工具为跳板，就可以干许多有意思的事情了。

    • JimmyLv/BibiGPT-v1 这个项目可以自己部署，总结B站、YouTube、抖音等等的视频内容，挺好用。
    • u-Sir/drag-to-preview，最近发现一个Firefox浏览器插件，可以选中网页链接拖拽弹出单独的窗口预览网页，在窗口外区域鼠标点击即可关闭，很符合我的胃口。
• 输入法设置
  

  由于使用了evil，如果使用系统的输入法，每次在 :w 保存的时候，需要来回切换中英。推荐两种解决方案：SIS和pyim。

  • SIS
    

    emacs-smart-input-source 是一个可以自动切换输入法的Emacs包。

    之前在配置SIS的时候，可能是mac系统的问题，安装macism之后，Emacs一直弹窗辅助功能设置，最近突然好了。SIS比pyim方便，不需要再内置输入法，可以直接用系统的输入法。

    (use-package sis
      ;; :hook
      ;; enable the /context/ and /inline region/ mode for specific buffers
      ;; (((text-mode prog-mode) . sis-context-mode)
      ;;  ((text-mode prog-mode) . sis-inline-mode))
      :config
      ;; For MacOS
      (sis-ism-lazyman-config
       ;; English input source may be: "ABC", "US" or another one.
       ;; "com.apple.keylayout.ABC"
       "com.apple.keylayout.ABC"
       ;; Other language input source: "rime", "sogou" or another one.
       ;; "im.rime.inputmethod.Squirrel.Rime"
       "im.rime.inputmethod.Squirrel.Hans")
      ;; enable the /cursor color/ mode
      ;; (sis-global-cursor-color-mode t)
      ;; enable the /respect/ mode
      (sis-global-respect-mode t)
      ;; enable the /context/ mode for all buffers
      (sis-global-context-mode t)
      ;; enable the /inline english/ mode for all buffers
      (sis-global-inline-mode t)
      )

  • pyim
    

    pyim 也可以达到相同的效果。只是这个输入法是Emacs内置的。

    可能是由于我用Homebrew安装的Emacs-plus，再加上使用的doomemacs，emacs报错：编译时无法找到 emacs-module.h ，一直无法在Emacs里加载 emacs-rime 。Emacs-rime的文档里写加上 (rime-emacs-module-header-root "~/emacs/include") ，我试了所有的Emacs可能的路径都不行。我在Linux-Ubuntu虚拟机里，没有任何问题。

    这个输入法是Emacs里内置的，如果没有指定内置的输入法，会使用系统自带的。把内置的输入法设置好，同时也解决了中英混合输入的问题，在写代码的时候，来回切换输入法太磨叽了。

    不知道是什么没设置好，每次新打开一个buffer都需要重新激活pyim，暂时先加了一个org-mode的hook，在org-mode里自动激活pyim。

    (add-hook 'org-mode-hook
              (lambda ()
                (toggle-input-method)
                (setq default-input-method "pyim")))

    pyim 设置 ：

    ;;输入法 https://github.com/tumashu/pyim
    (global-set-key (kbd "C-\\") 'toggle-input-method)
    (use-package pyim
      :init
      :config
      (pyim-default-scheme 'xiaohe-shuangpin)
      (setq default-input-method "pyim")
      )
    (use-package pyim-basedict
      :config
      (pyim-basedict-enable))
    (add-hook 'org-mode-hook
              (lambda ()
                (toggle-input-method)
                (setq default-input-method "pyim")))
    ;; 设置 pyim 探针
    ;; 设置 pyim 探针设置，这是 pyim 高级功能设置，可以实现 *无痛* 中英文切换 :-)
    ;; 我自己使用的中英文动态切换规则是：
    ;; 1. 光标只有在注释里面时，才可以输入中文。
    ;; 2. 光标前是汉字字符时，才能输入中文。
    ;; 3. 使用 M-j 快捷键，强制将光标前的拼音字符串转换为中文。
    (setq-default pyim-english-input-switch-functions
                  '(;; pyim-probe-dynamic-english
                    pyim-probe-isearch-mode
                    ;; pyim-probe-program-mode
                    pyim-probe-org-structure-template
                    pyim-probe-evil-normal-mode
                    ))
    (setq-default pyim-punctuation-half-width-functions
                  '(pyim-probe-punctuation-line-beginning
                    pyim-probe-punctuation-after-punctuation))
    ;; 键位绑定，解绑，转换
    ;; 修改默认键位映射，取消command键位
    (setq mac-option-modifier 'meta)

    Ref：

    • （重新设计）中英文混打：OS输入法管理包 smart-input-source - Emacs-general - Emacs China
  • RIME
    

    

    如果说PKM是纸，那么输入法就是笔。

    再次强烈推荐 RIME | 中州韻輸入法引擎，配合 iDvel/rime-ice: Rime 配置：雾凇拼音 | 长期维护的简体词库，多平台多端同步。已经使用了几年，非常巴适，手机端也可以同步配置。

    以前输入法就各种偷偷记录用户输入习惯，现在各个输入法又还要内置AI再记录一遍。本地配置、不需要联网的输入法是我的刚需，更何况，rime还可以自挂词库。

    一个巨坑，最近的RIME更新在Release 1.0.0 · rime/squirrel版本里改变了候选词横向和竖向的设置：

    style/horizontal 將徹底移除，雖然本版程序仍支持，但會被新控件的默認值覆蓋
    請使用 candidate_list_layout: stacked/linear 和 text_orientation: horizontal/vertical

    而且最好直接在输入法外观的配置文件里，修改输入法外观的配置，而不是通用配置，反正我在通用设置里不起作用。

    下面是简单的安装步骤 ：

    ;; mac:
    ;; mac rime: https://rime.im/download/
    Homebrew: brew install --cask squirrel
    或者直接下载
    ;; mac rime-ice
    使用东风破 plum 安装: https://github.com/rime/plum
    curl -fsSL https://raw.githubusercontent.com/rime/plum/master/rime-install | bash
    安装 rime-ice:
    ℞ 安装或更新全部文件
    bash rime-install iDvel/rime-ice:others/recipes/full
    ℞ 安装或更新所有词库文件（包含下面三个）
    bash rime-install iDvel/rime-ice:others/recipes/all_dicts
    ℞ 安装或更新拼音词库文件（ cn_dicts/ 目录内所有文件）
    bash rime-install iDvel/rime-ice:others/recipes/cn_dicts
    ℞ 安装或更新英文词库文件（ en_dicts/ 目录内所有文件）
    bash rime-install iDvel/rime-ice:others/recipes/en_dicts
    ℞ 安装或更新 opencc （ opencc/ 目录内所有文件）
    bash rime-install iDvel/rime-ice:others/recipes/opencc
    ;;或使用 rime-auto-deploy：https://github.com/Mark24Code/rime-auto-deploy，这个和plum只用选一个。
    =======================================================
    ;;Linux
    ibus:
    https://github.com/rime/home/wiki/RimeWithIBus
    sudo apt-get install ibus-rime                   #ibus
    fcitx5:
    sudo pacman -Sy fcitx5-rime                      # Arch Linux
    sudo apt update && sudo apt install fcitx5-rime  # Ubuntu / Debian / Deepin
    sudo zypper install fcitx5-rime                  # OpenSUSE
    sudo dnf install fcitx5-rime                     # Fedora
    plum and rime-ice：
    git clone --depth 1 https://github.com/rime/plum ~/plum
    ;; 切换到东风破的目录
    cd ~/plum
    ;; 如果你使用Fcitx5，你需要加入参数，让东风破把配置文件写到正确的位置
    rime_frontend=fcitx5-rime bash rime-install iDvel/rime-ice:others/recipes/full
    ;; 如果你是用IBus，则不需加参数，因为东风破默认是为IBus版的RIME打造。
    bash rime-install iDvel/rime-ice:others/recipes/full

    其他可以参考下面的文章:

    • 自由输入法 RIME 简明配置指南 - 少数派
    • RIME + 雾凇拼音，打造绝佳的开源文字输入体验 - 少数派
    • 让 RIME 体验更上一层楼：如何用 MediaWiki 扩展词库 - 少数派 导入wiki
    • gshang2017/rime-dict: RIME输入法(拼音)自用词库(包含英语，基础，维基，搜狗等词库)，词频基于腾讯AI向量词库逆序生成。 自建词库，导入专业领域词汇
• Others
  
  • lijigang/100-questions-about-orgmode: It's all about orgmode !
  • emacs-immersive-translate: Emacs 版本的沉浸式翻译（支持多个翻译后端） - Emacs-general - Emacs China
  • 混用 org-ql、columnview、org-roam、org-capture、org-super-links 塑造我的笔记流程 - Org-mode - Emacs China
  • 我想分享一下我的emacs配置和学习思路，并向大家介绍一些我觉得有用的package - Emacs-general - Emacs China

  • https://emacs-china.org/t/ekg-flomo/27505/12

    https://github.com/ahyatt/ekg

    ekg：提供一个类似obsidian里dataview的查询汇总功能

  • https://github.com/protesilaos/denote

    denote：提供类似org-roam的双链，快速插入等功能

  • Emacs里的其他笔记相关使用包

    jrblevin/deft: Deft for Emacs

    caiorss/org-wiki: Wiki for Emacs org-mode built on top of Emacs org-mode.

    Kungsgeten/org-brain: Org-mode wiki + concept-mapping

    weirdNox/org-noter: Emacs document annotator, using Org-mode

    toshism/org-super-links: Package to create links with auto backlinks

    alphapapa/org-ql: A searching tool for Org-mode.

    Web/Omni Search In Emacs with consult-web or Ditching the Browser's Default Search Engine

  • 我的 Neovim Zettelkasten：我如何使用 Vim 和 Bash 在 Markdown 中做笔记 |米沙·范登伯格 很强，之前用bash来生成md笔记的思路一下子扩展了。使用CLI来做笔记是一个很终极的方案。

Ollama

Open WebUI

Open WebUI 提供一个WebUI运行本地LLM，目前GitHub 31k star。良好的兼容ollama，聊天数据本地保存，可本地导入文档做RAG查询。

社区提供了插件和功能，质变的是：可以让本地LLM搜索web的内容。

Open WebUI 在2024-10-06的版本中更新了支持类似Claude artifacts的artifacts: 🎨 Artifacts Feature: Render web content and SVGs directly in the interface, supporting quick iterations and live changes，不过只支持原生的HTML和CSS。还更新了Overview，可以在白板里展示对话的内容，太实用了，史诗级更新！

其他主要功能 ：

• 📚 本地 RAG 集成：通过突破性的检索增强生成 (RAG) 支持深入探索聊天交互的未来。此功能将文档交互无缝集成到您的聊天体验中。您可以将文档直接加载到聊天中或将文件添加到文档库中，在查询之前使用 # 命令轻松访问它们。
• 🔍 RAG 的网络搜索：使用 SearXNG 、 Google PSE 、 Brave Search 、 serpstack 、 serper 、 Serply 、 DuckDuckGo 和 TavilySearch 并将结果直接注入您的聊天体验中。
• 🌐 网页浏览功能：使用 # 命令后跟 URL，将网站无缝集成到您的聊天体验中。此功能允许您将网络内容直接合并到您的对话中，从而增强交互的丰富性和深度。

docker部署相当简单 ：

• CLI: docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

• Docker compose: https://github.com/open-webui/open-webui/blob/main/docker-compose.yaml

    services:
      ollama:
        volumes:
          - ollama:/root/.ollama
        container_name: ollama
        pull_policy: always
        tty: true
        restart: unless-stopped
        image: ollama/ollama:${OLLAMA_DOCKER_TAG-latest}
      open-webui:
        build:
          context: .
          args:
            OLLAMA_BASE_URL: '/ollama'
          dockerfile: Dockerfile
        image: ghcr.io/open-webui/open-webui:${WEBUI_DOCKER_TAG-main}
        container_name: open-webui
        volumes:
          - open-webui:/app/backend/data
        depends_on:
          - ollama
        ports:
          - ${OPEN_WEBUI_PORT-3000}:8080
        environment:
          - 'OLLAMA_BASE_URL=http://ollama:11434'
          - 'WEBUI_SECRET_KEY='
        extra_hosts:
          - host.docker.internal:host-gateway
        restart: unless-stopped
    volumes:
      ollama: {}
      open-webui: {}

• Updating | Open WebUI

Ref：Open WebUI 官方手册

Aider

conda activate yourenv
python -m pip install -U aider-chat

(use-package aider
  :config
  (setq aider-args '("--model" "ollama/llama3.1"))
  (setenv "OLLAMA_API_BASE" "http://127.0.0.1:11434")
  (global-set-key (kbd "C-c a") 'aider-transient-menu)
  )

(package! aider
  :recipe (:host github :repo "tninja/aider.el" :files ("aider.el")))

gptel

gptel: A simple LLM client for Emacs 是Emacs的一个包，可以在Emacs里直接和LLM对话，目前在用。

最近更新了 ，可以支持直接添加文件、文本到上下文，awesome！居然还支持转换MD格式到Org？

您可以使用 gptel 的查询包含其他文本区域、缓冲区或文件。这个附加上下文是“实时”的，而不是快照。添加后，将在每次查询时扫描并包含区域、缓冲区或文件。

您可以从菜单中将选定的区域、缓冲区或文件添加到 gptel 的上下文中，或调用 gptel-add 。 （要添加文件，请在 Dired 中使用 gptel-add 或使用专用的 gptel-add-file 命令。）

Ref: https://github.com/karthink/gptel?tab=readme-ov-file#include-more-context-with-requests

To add context 添加上下文
gptel-add	Add/remove a region or buffer to gptel’s context. Add/remove marked files in Dired. 在 gptel 上下文中添加/删除区域或缓冲区。在 Dired 中添加/删除标记的文件。
gptel-add-file	Add a (text-readable) file to gptel’s context. Also available from the transient menu. 将（文本可读）文件添加到 gptel 的上下文中。也可以从瞬态菜单中获得。

;; 基本配置
(use-package! gptel
 :config
 (setq! gptel-api-key "your key"))
;; or
;; :key can be a function that returns the API key.
(gptel-make-gemini "Gemini" :key "YOUR_GEMINI_API_KEY" :stream t)
;; or
;; Perplexity offers an OpenAI compatible API
(gptel-make-openai "Perplexity"         ;Any name you want
  :host "api.perplexity.ai"
  :key "your-api-key"                   ;can be a function that returns the key
  :endpoint "/chat/completions"
  :stream t
  :models '(;; has many more, check perplexity.ai
            "pplx-7b-chat"
            "pplx-70b-chat"
            "pplx-7b-online"
            "pplx-70b-online"))
;; or
;; Ollama
(gptel-make-ollama "Ollama"             ;Any name of your choosing
  :host "localhost:11434"               ;Where it's running
  :stream t                             ;Stream responses
  :models '("mistral:latest"))          ;List of models

Kotaemon

Chipper