wiki-research

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Wiki Research — Autonomous Multi-Round Research

Wiki 研究 — 自主多轮研究

You are running an autonomous research loop on a topic, synthesizing what you find, and filing the results into the Obsidian wiki as permanent knowledge.

你将针对某个主题运行自主研究循环，整合研究发现，并将结果作为永久知识存入Obsidian wiki。

Before You Start

开始之前

Read

~/.obsidian-wiki/config

(preferred) or

.env

(fallback) to get

OBSIDIAN_VAULT_PATH

Read
```
$OBSIDIAN_VAULT_PATH/index.md
```
to understand what's already in the wiki — don't re-research things the wiki covers well
Read
```
$OBSIDIAN_VAULT_PATH/hot.md
```
if it exists — it surfaces recent context
Check
```
$OBSIDIAN_VAULT_PATH/references/research-config.md
```
if it exists — it may define source preferences, domains to skip, or confidence rules for this vault

Confirm the research topic with the user if it's ambiguous. Then proceed.

读取
```
~/.obsidian-wiki/config
```
（优先选择）或
```
.env
```
（备选）以获取
```
OBSIDIAN_VAULT_PATH
```
阅读
```
$OBSIDIAN_VAULT_PATH/index.md
```
以了解wiki中已有的内容——不要重复研究wiki已充分覆盖的内容
如果存在
```
$OBSIDIAN_VAULT_PATH/hot.md
```
，请阅读它——它会展示近期相关背景
如果存在
```
$OBSIDIAN_VAULT_PATH/references/research-config.md
```
，请查看它——它可能定义了此vault的来源偏好、需跳过的域名或置信度规则

如果研究主题不明确，请与用户确认后再继续。

Research Configuration (optional)

研究配置（可选）

references/research-config.md

exists in the vault, read it and apply any rules it defines:

Source preferences (e.g., prefer academic sources, avoid certain domains)
Domains to skip
Confidence scoring adjustments
Topic-specific constraints

If the file doesn't exist, proceed with defaults.

如果vault中存在

references/research-config.md

，请阅读并应用其中定义的规则：

来源偏好（例如，优先学术来源，避免特定域名）
需跳过的域名
置信度评分调整
特定主题的约束

如果该文件不存在，则使用默认配置继续。

Round 1 — Broad Survey

第一轮 — 广泛调研

Goal: Get a wide map of the topic.

Decompose the topic into 3-5 distinct angles (e.g., for "vector databases": what they are, when to use them, leading implementations, trade-offs, production gotchas)
For each angle, run 2-3
WebSearch
queries using varied phrasing
For the top 2-3 results per angle, use
```
WebFetch
```
(or
```
defuddle <url>
```
if available — cleaner extraction) to get content
From each fetched page, extract:
- Key claims — what the source explicitly states
- Concepts — ideas, terms, frameworks introduced
- Entities — tools, people, organizations mentioned
- Contradictions — places where sources disagree with each other

Track what's covered and what's missing as you go.

目标： 获取主题的全景概览。

将主题分解为3-5个不同角度（例如，对于“向量数据库”：定义、适用场景、主流实现方案、权衡因素、生产环境注意事项）
针对每个角度，运行2-3次
WebSearch
查询，使用不同的表述方式
针对每个角度的前2-3条结果，使用
```
WebFetch
```
（如果可用，也可使用
```
defuddle <url>
```
——提取内容更清晰）获取内容
从每个获取的页面中提取：
- 核心主张——来源明确陈述的内容
- 概念——引入的想法、术语、框架
- 实体——提及的工具、人物、组织
- 矛盾点——来源之间存在分歧的地方

在过程中记录已覆盖的内容和缺失的内容。

Round 2 — Gap Fill

第二轮 — 填补空白

Goal: Close the holes left by Round 1.

Review what Round 1 produced:

What questions did sources raise but not answer?
Where do sources contradict each other?
Which angles got thin coverage?

Run up to 5 targeted searches specifically addressing these gaps. Prefer primary sources, official documentation, and authoritative analyses over link aggregators.

Add findings to your working set. Update the contradiction list.

目标： 填补第一轮留下的信息空白。

回顾第一轮的成果：

来源提出但未解答的问题有哪些？
来源之间存在哪些矛盾？
哪些角度的覆盖不够充分？

运行最多5次针对性搜索，专门解决这些空白。优先选择原始来源、官方文档和权威分析，而非链接聚合平台。

将新发现添加到你的工作集中，并更新矛盾点列表。

Round 3 — Synthesis Check

第三轮 — 整合验证

Goal: Resolve contradictions; confirm depth is sufficient.

If major contradictions remain unresolved:

Run one final targeted pass (2-3 searches) to find authoritative resolution
If resolution is impossible, flag the contradiction explicitly in the synthesis page

If contradictions are minor or the topic feels well-covered after Round 2, skip additional searching and proceed to filing.

Halt condition: Stop when depth is achieved or 3 rounds are complete — do not loop indefinitely.

目标： 解决矛盾点；确认研究深度足够。

如果仍存在未解决的重大矛盾：

进行最后一次针对性搜索（2-3次查询）以找到权威结论
如果无法解决，在整合页面中明确标记该矛盾点

如果矛盾点较小，或经过第二轮后主题已得到充分覆盖，则跳过额外搜索，直接进入归档步骤。

停止条件： 当研究深度达标或完成3轮研究后停止——不要无限循环。

Filing — Write Wiki Pages

归档 — 撰写Wiki页面

Organize all findings into wiki pages across four output areas:

将所有研究发现整理为wiki页面，分为四个输出区域：

1. sources/ — One page per major reference

1. sources/ — 每个主要来源对应一个页面

For each significant source (typically 4-8 pages total):

yaml

---
title: >-
  <Source title>
category: references
tags: [<2-4 domain tags>]
sources:
  - "<URL>"
source_url: "<URL>"
created: <ISO-8601 timestamp>
updated: <ISO-8601 timestamp>
summary: >-
  <1-2 sentences describing what this source covers, ≤200 chars>
provenance:
  extracted: 0.X
  inferred: 0.X
  ambiguous: 0.X
---

Body: title, URL, what it covers, key claims (with provenance markers), limitations.

针对每个重要来源（通常总共4-8个页面）：

yaml

---
title: >-
  <Source title>
category: references
tags: [<2-4 domain tags>]
sources:
  - "<URL>"
source_url: "<URL>"
created: <ISO-8601 timestamp>
updated: <ISO-8601 timestamp>
summary: >-
  <1-2 sentences describing what this source covers, ≤200 chars>
provenance:
  extracted: 0.X
  inferred: 0.X
  ambiguous: 0.X
---

正文：标题、URL、涵盖内容、核心主张（带有来源标记）、局限性。

2. concepts/ — One page per substantive concept

2. concepts/ — 每个重要概念对应一个页面

For each significant concept surfaced across sources:

Standard concept frontmatter + body. Link concepts to each other and to source pages.

针对所有来源中出现的每个重要概念：

标准概念前置元数据 + 正文。将概念彼此链接，并链接到来源页面。

3. entities/ — Tools, organizations, people

3. entities/ — 工具、组织、人物

For each significant entity encountered (tools, libraries, companies, key authors):

Standard entity frontmatter. Link back to concepts that use the entity and sources where it appears.

针对遇到的每个重要实体（工具、库、公司、关键作者）：

标准实体前置元数据。链接回使用该实体的概念页面，以及出现该实体的来源页面。

4. synthesis/Research: [Topic].md — Master synthesis

4. synthesis/Research: [Topic].md — 主整合页面

The primary output: a structured synthesis of everything found.

yaml

---
title: >-
  Research: <Topic>
category: synthesis
tags: [<3-5 domain tags>, research]
sources: [<list of source URLs or page paths>]
created: <ISO-8601 timestamp>
updated: <ISO-8601 timestamp>
summary: >-
  Synthesis of <N>-round research on <topic>. Covers <core findings in ≤200 chars>.
provenance:
  extracted: 0.X
  inferred: 0.X
  ambiguous: 0.X
---

主要输出：所有研究发现的结构化整合内容。

yaml

---
title: >-
  Research: <Topic>
category: synthesis
tags: [<3-5 domain tags>, research]
sources: [<list of source URLs or page paths>]
created: <ISO-8601 timestamp>
updated: <ISO-8601 timestamp>
summary: >-
  Synthesis of <N>-round research on <topic>. Covers <core findings in ≤200 chars>.
provenance:
  extracted: 0.X
  inferred: 0.X
  ambiguous: 0.X
---

Research: <Topic>

Overview

<2-4 sentence executive summary of what the research found>

Key Findings

Core Concepts

Entities & Tools

Contradictions & Open Questions

Sources Consulted

<Linked list of all source pages> ```

Cross-linking

交叉链接

After filing all pages:

Every concept page should link to at least 2 source pages
Every source page should link to the concept pages it informed
The synthesis page should link to all concept, entity, and source pages produced

Check

index.md

for existing pages on the same topics — merge into existing pages rather than creating duplicates.

完成所有页面归档后：

每个概念页面应至少链接到2个来源页面
每个来源页面应链接到其涉及的概念页面
整合页面应链接到所有生成的概念、实体和来源页面

检查

index.md

中是否存在相同主题的现有页面——合并到现有页面中，而非创建重复页面。

Update Tracking Files

更新跟踪文件

.manifest.json
— Add a

research

entry:

json

{
  "type": "research",
  "topic": "<topic>",
  "researched_at": "TIMESTAMP",
  "rounds_completed": 3,
  "sources_fetched": N,
  "pages_created": ["..."],
  "pages_updated": ["..."]
}

index.md
— Add all new pages under their respective sections.

log.md
— Append:

- [TIMESTAMP] WIKI_RESEARCH topic="<topic>" rounds=N sources_fetched=N pages_created=M

hot.md
— Update Recent Activity with the research topic and core finding. Update Active Threads if this is ongoing. Update

updated

timestamp.

.manifest.json
— 添加一个

research

条目：

json

{
  "type": "research",
  "topic": "<topic>",
  "researched_at": "TIMESTAMP",
  "rounds_completed": 3,
  "sources_fetched": N,
  "pages_created": ["..."],
  "pages_updated": ["..."]
}

index.md
— 在相应章节下添加所有新页面。

log.md
— 追加内容：

- [TIMESTAMP] WIKI_RESEARCH topic="<topic>" rounds=N sources_fetched=N pages_created=M

hot.md
— 在“Recent Activity”中更新研究主题和核心发现。如果研究仍在进行，更新“Active Threads”。更新

updated

时间戳。

Quality Checklist

质量检查清单

3 rounds completed (or halted at sufficient depth)
Synthesis page exists at
```
synthesis/Research: [Topic].md
```
Source pages written for major references
Concept and entity pages written for significant items
Contradictions flagged in synthesis page
All pages cross-linked
```
index.md
```
,
```
log.md
```
,
```
hot.md
```
,
```
.manifest.json
```
updated

3轮研究完成（或在深度达标时停止）
整合页面已创建，路径为
```
synthesis/Research: [Topic].md
```
已为主要来源撰写来源页面
已为重要条目撰写概念和实体页面
整合页面中已标记矛盾点
所有页面已完成交叉链接
```
index.md
```
、
```
log.md
```
、
```
hot.md
```
、
```
.manifest.json
```
已更新