feat(vault): Phase 3 tools + batch citation/relation enrichment

This commit is contained in:
2026-07-01 15:20:40 +08:00
parent 8273017082
commit 407a9213bf
548 changed files with 53410 additions and 2113 deletions
+225 -2
View File
@@ -1,17 +1,28 @@
---
categories:
- "[[LLM Wiki]]"
- '[[LLM Wiki]]'
tags:
- wiki
- prompt-engineering
- template
created: 2026-04-08
source: "[[llm-wiki]]"
source: '[[llm-wiki]]'
type: concept
aliases:
- Idea File 模板
- 提示词模板
- Prompt Template
relations:
- type: part_of
target: '[[Obsidian]]'
description: 同源:llm-wiki
confidence: 3
- type: extends
target: '[[RAG vs 持久化知识库]]'
confidence: 2
- type: extends
target: '[[BYOAI]]'
confidence: 2
---
# 优秀提示词的结构化模板 — Idea File 模式
@@ -93,6 +104,218 @@ A pattern for building personal knowledge bases using LLMs.
**包含三个部分**
| 部分 | 说明 | 示例 |
|
------|
------|------|
| **当前问题** | 主流方式的痛点 | "Most people's experience with LLMs looks like RAG…" |
| **新方法** | 你的创新方案 | "Instead of retrieving, the LLM incrementally builds…" |
| **关键差异** | 为什么这更好 | "The wiki is a persistent, compounding artifact" |
---
### 3. 应用场景 (Examples)
使用 **场景 → 价值** 格式:
```markdown
- **Personal**: tracking goals, health, psychology...
- **Research**: going deep on a topic over weeks...
- **Reading a book**: filing each chapter as you go...
```
让 Agent 理解适用范围,不限定死实现方式。
---
### 4. 架构设计 (Architecture)
使用**分层**或**组件**结构:
```markdown
There are three layers:
- **Raw sources** — your curated collection...
- **The wiki** — LLM-generated markdown files...
- **The schema** — a document that tells the LLM...
```
每层清晰定义职责,便于 Agent 理解全局。
---
### 5. 核心操作/工作流 (Operations)
**三种操作**模式:
```markdown
**Ingest.** You drop a new source... [描述 + 示例流程]
**Query.** You ask questions... [描述 + 输出形式]
**Lint.** Periodically, ask the LLM to health-check... [描述 + 检查项]
```
每个操作包含:触发条件、执行流程、预期产出。
---
### 6. 关键组件 (Key Components)
```markdown
Two special files help navigate:
- **index.md** is content-oriented...
- **log.md** is chronological...
```
说明核心组件及其作用,而非完整实现细节。
---
### 7. 工具推荐 (Tips and Tricks)
```markdown
- **Obsidian Web Clipper** is a browser extension...
- **qmd** is a good option...
```
推荐工具但不强制,保持灵活性。
---
### 8. 为什么有效 (Why This Works)
```markdown
The tedious part is not the reading or thinking—
it's the bookkeeping. LLMs don't get bored...
```
解释**原理**而非具体实现,让 Agent 理解本质后可自行扩展。
---
### 9. 说明 (Note) — 最重要的一部分
```markdown
This document is intentionally abstract.
It describes the idea, not a specific implementation.
The exact directory structure... will depend on your domain.
The right way to use this is to share it with your LLM agent
and work together to instantiate a version that fits your needs.
```
**核心意图**:这是想法,不是实现;请根据你的需求定制。
---
## Idea File 的核心原则
| 原则 | 说明 |
|------|------|
| **分享想法,不给代码** | 只描述"做什么",不规定"怎么做" |
| **抽象但具体** | 说明理念但不限定实现细节 |
| **模块化** | 每个部分独立,可选择使用 |
| **可扩展** | "Your agent will build out the specifics" |
| **协作式** | "Work together with your LLM agent" |
---
## 相关页面
- [[LLM Wiki]] — 模板的实际应用案例
- [[RAG vs 持久化知识库]] — 背景对比
- [[BYOAI]] — 自带 AI 概念
- [[Contamination Mitigation]] — 另一个 Idea File 示例
## 来源
---
## 核心概念
| 页面 | 简介 |
|------|------|
| [[Idea File 模板]] | Agent时代的思路分享范式 |
- [[llm-wiki]] — Karpathy Gist 原文
# 优秀提示词的结构化模板 — Idea File 模式
> 基于 Karpathy 的 llm-wiki.md 分析提炼
---
## 核心理念
> "在这个 LLM Agent 的时代,分享具体的代码或应用已经意义不大了。你只需要分享想法,然后对方的 Agent 会根据你的具体需求来定制和构建。"
这是 **Idea File(想法文件)** 模式的核心:**只分享思路,不分享代码;Agent 会帮你实现具体细节。**
---
## Idea File 模板结构
```
┌─────────────────────────────────────────────────────────┐
│ 1. 标题 (Title) │
│ - 一句话定义 (One-liner) │
├─────────────────────────────────────────────────────────┤
│ 2. 核心思想 (The Core Idea) │
│ - 当前问题/主流方式 │
│ - 新的方法/理念 │
│ - 关键差异点 │
├─────────────────────────────────────────────────────────┤
│ 3. 应用场景 (Examples) │
│ - 场景1 │
│ - 场景2 │
│ - 场景3 │
├─────────────────────────────────────────────────────────┤
│ 4. 架构设计 (Architecture) │
│ - 层1xxx │
│ - 层2xxx │
│ - 层3xxx │
├─────────────────────────────────────────────────────────┤
│ 5. 核心操作/工作流 (Operations) │
│ - 操作1:描述 + 示例 │
│ - 操作2:描述 + 示例 │
│ - 操作3:描述 + 示例 │
├─────────────────────────────────────────────────────────┤
│ 6. 关键组件 (Key Components) │
│ - 组件1:用途 │
│ - 组件2:用途 │
├─────────────────────────────────────────────────────────┤
│ 7. 工具推荐 (Tools & Tips) │
│ - 工具1 │
│ - 工具2 │
├─────────────────────────────────────────────────────────┤
│ 8. 为什么有效 (Why This Works) │
│ - 原理分析 │
│ - 优势说明 │
├─────────────────────────────────────────────────────────┤
│ 9. 说明 (Note) │
│ - 可定制性 │
│ - 模块化原则 │
└─────────────────────────────────────────────────────────┘
```
---
## 各部分详解
### 1. 标题 + 一句话定义
```markdown
## LLM Wiki
A pattern for building personal knowledge bases using LLMs.
```
**目的**:让 Agent 立即理解这是关于什么的
---
### 2. 核心思想 (The Core Idea)
**包含三个部分**
| 部分 | 说明 | 示例 |
|------|------|------|
| **当前问题** | 主流方式的痛点 | "Most people's experience with LLMs looks like RAG…" |