Auto-sync: 2026-04-18 16:02

wiki/concepts/Obsidian-CLI.md

@@ -0,0 +1,14 @@
+---
+title: "Obsidian CLI"
+type: concept
+tags: []
+sources: ["Obsidian-必装-Skills"]
+last_updated: 2026-04-18
+---
+
+## Description
+Obsidian 官方命令行工具，让 AI Agent 能够直接调用 Obsidian 的命令行接口。通过该工具，AI Agent 可以实现对笔记、任务、属性的增删改查，以及对插件开发环境的调试与管理。
+
+## Connections
+
+- Obsidian CLI 可配合 [[Claude Skills]] 实现 [[TUI]] 交互

wiki/concepts/Obsidian-Skills.md

@@ -0,0 +1,22 @@
+---
+title: "Obsidian Skills"
+type: concept
+tags: []
+sources: ["Obsidian-必装-Skills"]
+last_updated: 2026-04-18
+---
+
+## Description
+写给 AI Agent 的"说明书"，通过特定技能扩展 AI Agent 操作 Obsidian 的能力。这些 Skills 使 AI 能够执行网页内容抓取、笔记增删改查、数据库视图创建、Mermaid 图表生成、学习系统构建等任务。
+
+## Core Skills
+- **defuddle**：网页内容清洗工具，剔除广告和导航栏
+- **obsidian-cli**：Obsidian 官方命令行工具
+- **obsidian-bases**：.base 格式数据库配置文件创建
+- **obsidian-markdown**：Obsidian 增强 Markdown 编写
+- **json-canvas**：.canvas 白板文件创建
+- **obsidian-canvas-creator**：解决节点重叠的 Canvas 创建
+- **mermaid-visualizer**：Mermaid 架构图生成
+- **excalidraw-diagram**：手绘风格 Excalidraw 图表
+- **tutor-skills**：学习知识库构建与互动测验
+- **scholar-skill**：学术论文分级阅读

wiki/concepts/WSL.md

@@ -0,0 +1,40 @@
+---
+title: "WSL"
+type: concept
+tags: []
+last_updated: 2026-04-18
+---
+
+## Summary
+- Windows Subsystem for Linux（Windows Linux 子系统），Microsoft 开发的在 Windows 上运行 Linux 发行版的兼容层
+- 允许开发者直接在 Windows 上使用 Linux 工具、实用程序和 Bash，无需传统虚拟机或双系统启动
+
+## Key Features
+- 与 Windows 无缝集成，文件系统共享
+- 支持多个 Linux 发行版（Ubuntu、Debian、SUSE、Kali 等）
+- 可通过 Windows Terminal 管理
+- 直接调用 Windows 程序
+
+## Versions
+- WSL 1：一代架构，Linux 系统调用转换为 Windows API
+- WSL 2：二代架构，使用轻量级虚拟机，运行完整 Linux 内核，性能更优
+
+## Installation
+- Windows 10 2004+ 或 Windows 11：使用 `wsl --install` 一键安装
+- 老版本：手动安装，需启用"适用于 Linux 的 Windows 子系统"可选组件
+
+## Commands
+- `wsl --install`：一键安装（默认 Ubuntu）
+- `wsl -l -v`：列出已安装发行版
+- `wsl --set-version <Distro> <1|2>`：设置版本
+- `wsl -d <Distro>`：启动指定发行版
+
+## Connections
+- [[Ubuntu]] ← default_distro ← [[WSL]]
+- [[WSL2]] ← extends ← [[WSL]]
+- [[Windows Terminal]] ← manages ← [[WSL]]
+- [[PowerShell]] ← invokes ← [[WSL]]
+
+## Wiki Connections
+- [[Install WSL]] → describes → [[WSL]]
+- [[WSL2 启动与网络配置指南]] → describes → [[WSL2]]

wiki/concepts/WSL2.md

@@ -0,0 +1,33 @@
+---
+title: WSL2
+type: concept
+tags: [windows, linux, subsystem]
+---
+
+## Definition
+Windows Subsystem for Linux 2（WSL2）是 Microsoft 提供的 Windows 10/11 上的 Linux 兼容层，基于 Hyper-V 虚拟化技术，提供完整的 Linux 内核。
+
+## Core Features
+- 真正的 Linux 内核（而非 WSL1 的翻译层）
+- 系统调用兼容性大幅提升
+- 性能接近原生 Linux
+- 与 Windows 文件系统无缝集成
+
+## Key Commands
+- `wsl --install` — 快速安装 WSL2（含 Ubuntu）
+- `wsl -l -v` — 查看已安装分发版及状态
+- `wsl -d <分发版名称>` — 启动指定 Linux 发行版
+- `wsl --shutdown` — 强制停止所有 WSL 实例
+
+## Network Configuration
+WSL2 默认使用 NAT 模式，可通过 .wslconfig 启用镜像网络模式解决代理问题。
+
+## Aliases
+- Windows Subsystem for Linux
+- WSL
+- WSL 2
+
+## Related Concepts
+- [[镜像网络模式]]
+- [[.wslconfig]]
+- [[Ubuntu]]

wiki/concepts/obsidian-bases.md

@@ -0,0 +1,19 @@
+---
+title: "obsidian-bases"
+type: concept
+tags: []
+sources: ["Obsidian-必装-Skills"]
+last_updated: 2026-04-18
+---
+
+## Description
+让 AI 能够创建和维护 .base 格式配置文件的 Skill。生成的数据库支持类似 Notion 的动态视图，包括表格（table）、卡片（cards）、列表（list）和地图（map）四种类型。
+
+## Capabilities
+- 支持强大的公式系统
+- 可读取笔记的 Frontmatter 属性
+- 支持文件元数据（创建时间、字数等）
+- 支持条件判断、日期运算、字符串处理
+
+## Dependencies
+- Maps 插件：使用 map 视图时需要额外安装

wiki/concepts/obsidian-canvas-creator.md

@@ -0,0 +1,19 @@
+---
+title: "obsidian-canvas-creator"
+type: concept
+tags: []
+sources: ["Obsidian-必装-Skills"]
+last_updated: 2026-04-18
+---
+
+## Description
+加强版的 json-canvas skill，解决了节点重叠和空间分布不均的问题。内置径向布局（MindMap）和自由排版（Freeform）算法，能够自动计算节点坐标、处理连接线路径，并根据文本长度动态调整节点尺寸。
+
+## vs json-canvas
+- **侧重点**：json-canvas 关注底层 JSON 语法正确性；本 Skill 侧重高层排版策略和空间坐标计算
+- **自动化程度**：json-canvas 机械摆放节点；本 Skill 根据布局算法计算 X/Y 坐标确保节点不重叠
+- **结构化逻辑**：本 Skill 引入 MindMap 和 FreeForm 模式，自动处理父子层级关系
+
+## Usage
+```
+把这markdown知识笔记转换成一个mindmap格式的 Obsidian Canvas。

wiki/concepts/scholar-skill.md

@@ -0,0 +1,33 @@
+---
+title: "scholar-skill"
+type: concept
+tags: []
+sources: ["Obsidian-必装-Skills"]
+last_updated: 2026-04-18
+---
+
+## Description
+基于 OpenClaw 框架的学术研究 Skill，通过 L1-L3 分级阅读策略在后台长时间静默解析论文，并自动将结构化笔记、核心记忆与知识冲突报告写入本地 Obsidian 知识库。
+
+## Reading Levels
+- **L1**：快速分发，评估论文优先级
+- **L2**：标准阅读，提取核心观点
+- **L3**：深度解构，生成双链卡片和反思报告
+
+## Dependencies
+- **基础环境**：本地 Python 环境 + Obsidian 客户端
+- **核心框架**：OpenClaw 智能体框架
+- **依赖 Skills**（通过 ClawHub 安装）：
+  - `obsidian-direct`（必须）：绕过官方限制直接读写 .md 文件
+  - `arxiv-watcher`（必须）：通过 ArXiv API 抓取文献
+  - `durable-task-runner`（必须）：支持 L3 级长时间挂机任务调度与断点续传
+  - 可选：`tavily`、`pdf`、`academic-research-hub`
+
+## Special Features
+- **超长周期任务编排**：L3 级深度阅读设计为长达 2.5 小时的异步挂机任务，依赖 durable-task-runner 处理多次 LLM 推演循环和 API 限流
+- **周期性反思机制**：内置时间触发器逻辑，周末或月末强制对"临时存储的知识"进行 L2/L3 反思
+- **人类确认防呆机制**：当 AI 发现新论文推翻旧笔记结论时，生成确认单放进 0-Inbox 文件夹等待人工审核
+
+## Risks
+- **财务毁灭风险**：2.5 小时 L3 循环和高频 RAG 会消耗大量 Token
+- **数据覆写风险**：obsidian-direct 使用民间 Python 暴力文件 I/O，易引发文件冲突

wiki/concepts/tutor-skills.md

@@ -0,0 +1,23 @@
+---
+title: "tutor-skills"
+type: concept
+tags: []
+sources: ["Obsidian-必装-Skills"]
+last_updated: 2026-04-18
+---
+
+## Description
+两个 Skill（tutor-setup 和 tutor）构成"输入-内化-检测"完整闭环：
+- **tutor-setup**：将文档或代码库一键转化为结构化的 Obsidian 知识库，生成双链、MOC 和复习题
+- **tutor**：读取知识库进度数据，在终端内生成互动式测验，追踪并攻克知识薄弱点
+
+## Dependencies
+- 智能体工具：Claude Code、OpenCode
+
+## Usage
+- `/tutor-setup`：在特定工作目录触发构建
+- `/tutor`：在已有 StudyVault 的目录下触发复习
+
+## Special Features
+- **模式自动侦测**：自动扫描当前工作目录，检测到 package.json 或 pom.xml 等工程文件自动进入"代码库模式"；若只有 PDF/纯文本则进入"文档模式"
+- **Token 消耗风险**："代码库模式"会递归读取大量源文件并进行架构溯源，短时间内消耗大量 Token

wiki/concepts/上下文基质.md

@@ -0,0 +1,43 @@
+---
+title: "上下文基质"
+type: concept
+tags: []
+---
+
+## Aliases
+- Context Substrate
+- Camp 2
+- 上下文基质
+- 文件式上下文
+
+## Definition
+
+Camp 2 类别的 AI 记忆架构。维护结构化、人类可读的上下文，随会话累积。不"提取"任何东西——上下文本身就是文件。Agent 读取、写入文件，整个系统随时间累积。
+
+## Key Characteristics
+
+- 优化目标：累积（Compounding）
+- 典型问题："系统是否随时间变得更好？"
+- 智能在累积
+- 用户可以直接读取、编辑、修正文件，理解 Agent 知道什么
+
+## Architecture
+
+Agent 工作流程：
+1. 会话开始前读取结构化上下文
+2. 在该上下文中工作
+3. 写入/更新上下文
+4. 下次会话，上下文比之前更丰富
+
+## Examples
+
+- [[OpenClaw]]：358k stars，Markdown 文件存储，DAM 夜间整理
+- [[Zep]]：4.4k stars，重新定位为"上下文工程"
+- [[Thoth]]：145 stars，10 种实体类型 + 67 种关系
+- [[TrustGraph]]：2k stars，Context Cores 可版本化上下文
+
+## Related Concepts
+
+- [[Markdown 文件]] — 典型存储格式
+- [[记忆巩固]] — 夜间自动整理机制
+- [[记忆后端]] — Camp 1 的替代方案

wiki/concepts/记忆后端.md

@@ -0,0 +1,42 @@
+---
+title: "记忆后端"
+type: concept
+tags: []
+---
+
+## Aliases
+- Memory Backend
+- Camp 1
+- 记忆后端
+- 记忆后端模式
+
+## Definition
+
+Camp 1 类别的 AI 记忆工具。核心工作流程：对话发生 → 系统提取事实或存储内容 → 事实存入数据库（向量数据库、图数据库或两者）→ 下次对话时检索相关事实并注入。
+
+## Key Characteristics
+
+- 优化目标：召回（Recall）
+- 典型问题："关于 X 我说过什么？"
+- 智能在提取和检索
+- 用户从不直接接触记忆，信任系统记住正确的事情
+
+## Limitations
+
+- 记忆是扁平条目，无关系
+- 每次提取需要 LLM 调用
+- 存储的事实不随时间演化
+- 无法解决跨会话上下文累积问题
+
+## Examples
+
+- [[Mem0]]：53.1k stars，四操作（add, search, update, delete）
+- [[MemPalace]]：46.2k stars，逐字存储
+- [[Supermemory]]：21.8k stars，时间感知
+- [[Honcho]]：2.4k stars，对人和 Agent 建模
+
+## Related Concepts
+
+- [[向量数据库]] — 典型存储后端
+- [[事实提取]] — 记忆化的核心技术
+- [[上下文基质]] — Camp 2 的替代方案

wiki/concepts/设计模式库.md

@@ -0,0 +1,21 @@
+---
+title: "设计模式库"
+type: concept
+tags: []
+sources: []
+last_updated: 2026-04-18
+---
+
+## Definition
+预定义的 Logo 设计模式集合，AI 根据用户信息匹配生成 6+ 风格不同的 SVG 设计变体。
+
+## Core Elements
+- 核心图形：几何图形的抽象化设计
+- 二进制指令：点阵、模块化表现
+- 流动智能：平行线、流线设计
+- 系统原点：六边形、几何核心
+- 语法壳：括号、光标元素
+- 胶囊支架：胶囊形状
+
+## Usage
+基于产品名称、行业、核心概念匹配设计模式，生成多个变体供用户选择。

wiki/concepts/语义形状系统.md

@@ -0,0 +1,19 @@
+---
+title: 语义形状系统
+type: concept
+tags: []
+date: 2026-04-18
+---
+语义形状系统是 fireworks-tech-graph 中的形状词汇表，将语义概念映射为固定形状：
+- 用户/人类：圆形 + 身体路径
+- LLM/模型：圆角矩形，双边框
+- Agent/编排器：六边形
+- 短期记忆：虚线边框圆角矩形
+- 长期记忆：实线圆柱体
+- Vector Store：带内环圆柱
+- Graph DB：三圆簇
+- 工具/函数：带齿轮图标矩形
+- API/网关：六边形单边框
+- 消息队列：横向管道
+- 文档/文件：折角矩形
+- 决策节点：菱形

wiki/concepts/镜像网络模式.md

@@ -0,0 +1,33 @@
+---
+title: 镜像网络模式
+type: concept
+tags: [wsl, network, windows]
+---
+
+## Definition
+镜像网络模式（Mirrored Networking）是 WSL2 的网络配置选项，使 WSL2 与 Windows 共享网络堆栈，解决 NAT 模式下的代理和端口访问问题。
+
+## Configuration
+在用户目录的 `.wslconfig` 文件中添加：
+
+```ini
+[wsl2]
+networkingMode=mirrored
+dnsTunneling=true
+firewall=true
+autoProxy=true
+```
+
+## Benefits
+- WSL2 可直接访问 Windows 的代理
+- 解决 localhost 代理无法镜像的问题
+- 无需手动配置宿主机 IP
+- 自动同步 Windows 的网络状态
+
+## Usage
+配置完成后需执行 `wsl --shutdown` 使配置生效。
+
+## Related Concepts
+- [[WSL2]]
+- [[.wslconfig]]
+- [[代理链]]

wiki/concepts/静态站点托管.md

@@ -0,0 +1,55 @@
+---
+title: "静态站点托管"
+type: concept
+tags: []
+---
+
+## Definition
+
+静态站点托管（Static Site Hosting）指将静态 HTML、CSS、JavaScript 文件部署到 Web 服务器上对外提供服务。Quartz 支持 Nginx、Apache、Caddy 三种自托管方案。
+
+## Hosting Solutions
+
+- [[Nginx]] — 高性能反向代理和静态文件服务
+- [[Apache]] — 通过 .htaccess 进行 URL 重写配置
+- [[Caddy]] — 自动 HTTPS，Caddyfile 简明配置
+
+## Configuration
+
+### Nginx
+
+需要配置 try_files 规则处理无扩展名 URL：
+
+```nginx
+try_files $uri $uri.html $uri/ =404;
+```
+
+### Apache
+
+需要启用 mod_rewrite 模块处理 .html 扩展名：
+
+```apache
+RewriteCond %{REQUEST_FILENAME} !-f
+RewriteCond %{REQUEST_FILENAME} !-d
+RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_URI}.html -f
+RewriteRule ^(.*)$ $1.html [L]
+```
+
+### Caddy
+
+Caddyfile 配置：
+
+```caddy
+example.com {
+    root * /path/to/quartz/public
+    try_files {path} {path}.html {path}/ =404
+    file_server
+}
+```
+
+## Related Concepts
+
+- [[静态站点生成]]
+- [[HTTPS]]
+- [[域名]]
+- [[Let's Encrypt]]

wiki/concepts/静态站点生成.md

@@ -0,0 +1,26 @@
+---
+title: "静态站点生成"
+type: concept
+tags: []
+---
+
+## Definition
+
+静态站点生成（Static Site Generation, SSG）是一种将 Markdown 等源文件在构建时预渲染为 HTML、CSS、JavaScript 静态文件的生成技术。Quartz、 Hugo、Jekyll、Astro 等都是静态站点生成工具。
+
+## Use Cases
+
+- 个人博客
+- 文档网站
+- 项目主页
+- 知识库
+
+## Connections
+
+- [[Quartz]]：Obsidian 的静态站点生成器
+- [[Obsidian]]：内容来源
+
+## Related Concepts
+
+- [[静态站点托管]]
+- [[动态站点]]（如 Next.js、Nuxt）

wiki/concepts/高级展示图.md

@@ -0,0 +1,22 @@
+---
+title: "高级展示图"
+type: concept
+tags: []
+sources: []
+last_updated: 2026-04-18
+---
+
+## Definition
+带专业背景和灯光效果的 Logo 商业展示图，用于社交媒体、文档、海报等场景。
+
+## Two Approaches
+- **Nano Banana 图片生成**：12 种专业背景风格
+  - 暗色系：The Void、Frosted Horizon、Fluid Abyss、Studio Spotlight、Analog Liquid、LED Matrix
+  - 亮色系：Editorial Paper、Iridescent Frost、Morning Aura、Clinical Studio、UI Container、Swiss Flat
+- **WebGL Shader 动态背景**：6 种交互式背景
+  - LED Matrix、Fluid Warping、Fabric Wave、Off-Center Ripple、Holographic Dispersion、Spiral Vortex
+
+## Advantages
+- 静态图片适合社交媒体、文档、海报
+- 动态背景适合网页、演示、交互场景
+- 无限缩放不失真