Skip to content

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

KFK Obsidian 学习笔记套件

一套面向数学、深度学习、强化学习、信息论、组合优化与量化研究的中文 Obsidian 配置。它把 LaTeX 讲义的秩序感带进 Markdown,但刻意减少大面积彩色卡片:正文负责理解,卡片只负责真正的重点。

渲染效果预览

渲染范本第一页:PPO 裁剪笔记

点击图片查看完整 渲染范本 PDF — 六类学科示例的完整渲染效果(PPO 裁剪、信息论、深度学习张量、组合优化建模、量化回测),与 Obsidian 阅读视图 / PDF 导出完全一致,已覆盖中文字体回退与深浅色模式。

三分钟开始

  1. 下载本仓库 ZIP,解压后用 Obsidian 打开这个文件夹;或运行:

    git clone https://github.com/KafukaTree/KFKObsidian.git
  2. 打开 examples/00_样式总览.md。CSS 片段已经在仓库设置中启用。

  3. 复制 templates/学习笔记_raw.md 开始速记;需要整理时,让 Agent 使用 skills/kfk-note-polisher。

只想给已有 Vault 加样式?复制:

.obsidian/snippets/kfk-note-system.css

到你的 Vault 同名目录,然后在“设置 → 外观 → CSS 代码片段”中启用 kfk-note-system。

包含什么

目录 内容
.obsidian/ 最小可移植设置与 CSS;不包含个人工作区和插件缓存
templates/ raw 速记与正式学习笔记模板
examples/ 六个跨学科中文示例及一组 raw → 成稿示例
docs/ 快速开始、语义环境速查、Agent 使用手册
skills/kfk-note-polisher/ 供 Codex/Agent 读取的规范化笔记润色 Skill

视觉层级

层级 形状 典型类型
核心强调 浅粉完整卡片 keyformula、claim、keyidea、takeaway
轻提示 无背景、左侧细线 question、assumption、implementation、risk
正式数学 粉/橙/蓝完整卡片 theorem、definition、example
行内环境 无卡片背景 note、proof

一篇普通技术笔记通常只需要 2–5 个核心卡片。完整选型见 语义环境速查。

最小示例

> [!question] 问题
> 当前真正需要回答的问题。

> [!keyformula] 关键公式
> $$
> I(X;Y)=D_{\mathrm{KL}}(p(x,y)\|p(x)p(y)).
> $$

> [!risk] 风险
> 会使结论失效的条件。

Obsidian 的 Callout 语法要求每行以 > 开头。日常只写 raw 笔记即可,不必手工完成全部排版;Agent Skill 会负责结构化。

Agent 用法

将 skills/kfk-note-polisher 复制到 Codex Skill 目录,例如:

~/.codex/skills/kfk-note-polisher/

然后使用:

使用 $kfk-note-polisher,把 PPO裁剪_raw.md 润色为一份中文学习笔记。
保留我的疑问和不确定项,不要虚构出处。

详细说明见 Agent 使用手册。

插件与兼容性

  • 核心样式只依赖 Obsidian 原生 Markdown、MathJax 与 Callout。
  • Excalidraw 可选;CSS 已支持嵌入图居中。
  • TikZJax、Completr 等插件都不是必需项,因此仓库不打包第三方插件代码。
  • 插件选择与安装原则见 可选插件。
  • 支持阅读视图、Live Preview、浅色/深色模式与 PDF 导出。
  • 中文字体优先使用系统已有的 Noto Serif SC、思源宋体或楷体,并提供 Windows 回退字体。

隐私边界

仓库不包含个人工作区布局、插件数据、历史记录、私有笔记或 API 密钥。复制自己的 Vault 到公开仓库前,仍请先检查附件、Frontmatter、链接与 Git 历史。

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors