@itradingai/aiwiki 0.2.19 → 0.2.20

package/examples/obsidian-vault-sample/09-runs/20260608-160603980-89f570/source-card.md

@@ -0,0 +1,62 @@
+---
+aiwiki_id: "llm-wiki-notes:source-card"
+title: "LLM Wiki Notes"
+type: "source_card"
+status: "to-review"
+slug: "llm-wiki-notes"
+source_type: "url"
+source_url: "https://example.com/llm-wiki"
+url: "https://example.com/llm-wiki"
+fetcher: "host-agent"
+created_at: "2026-06-08T16:06:03.980Z"
+captured_at: "2026-05-14T10:00:00+08:00"
+run_id: "20260608-160603980-89f570"
+content_fingerprint: "sha256:7e9fcf3257160956b260fe36c2c3dbdddf91b86856e989045eee547ff0019a9a"
+wiki_entry: "[[05-wiki/source-knowledge/llm-wiki-notes|Wiki 条目]]"
+source_card: "[[03-sources/article-cards/llm-wiki-notes|资料卡]]"
+raw_note: "[[02-raw/articles/llm-wiki-notes|原文]]"
+claims_note: "[[04-claims/_suggestions/llm-wiki-notes-claims|Claim 建议]]"
+assets_note: "[[06-assets/_suggestions/llm-wiki-notes-assets|素材建议]]"
+topics_note: "[[07-topics/ready/llm-wiki-notes-topics|选题]]"
+outline_note: "[[08-outputs/outlines/llm-wiki-notes-outline|大纲]]"
+run_summary: "[[09-runs/20260608-160603980-89f570/processing-summary|处理记录]]"
+grounding_evidence_available: false
+grounding_evidence_channel: "none"
+grounding_needs_review: true
+grounding_markers: ["unsupported_claims"]
+grounding_claim_count: "1"
+grounding_claim_quote_count: "0"
+grounding_unsupported_claim_count: "1"
+coverage_suspected_incomplete: false
+aliases: ["LLM Wiki Notes"]
+tags: ["aiwiki/source-card"]
+---
+
+# LLM Wiki Notes
+
+## Obsidian 链接
+
+- Wiki 条目：[[05-wiki/source-knowledge/llm-wiki-notes|Wiki 条目]]
+- 原文：[[02-raw/articles/llm-wiki-notes|原文]]
+- Claim 建议：[[04-claims/_suggestions/llm-wiki-notes-claims|Claim 建议]]
+- 素材建议：[[06-assets/_suggestions/llm-wiki-notes-assets|素材建议]]
+- 选题：[[07-topics/ready/llm-wiki-notes-topics|选题]]
+- 大纲：[[08-outputs/outlines/llm-wiki-notes-outline|大纲]]
+- 处理记录：[[09-runs/20260608-160603980-89f570/processing-summary|处理记录]]
+
+## 摘要
+
+这是一篇关于 LLM Wiki 的文章，讨论了 Agent-first 本地知识库、结构化条目和持续整理。
+
+## Problem / Evidence / Reuse
+
+- problem_solved: LLM Wiki 把资料整理成可持续维护的本地知识层。
+- evidence_boundary: review required before treating analysis as fact
+- reuse_scenarios: 研究, 写作
+- content_fingerprint: sha256:7e9fcf3257160956b260fe36c2c3dbdddf91b86856e989045eee547ff0019a9a
+
+## Grounding 状态
+
+- 证据通道：none
+- 需要复核：yes
+- 疑似标记：unsupported_claims

package/examples/obsidian-vault-sample/09-runs/20260608-160603980-89f570/topics.md

@@ -0,0 +1,29 @@
+---
+aiwiki_id: "llm-wiki-notes:topics"
+title: "LLM Wiki Notes Topics"
+type: "topic_candidates"
+status: "ready"
+slug: "llm-wiki-notes"
+source_url: "https://example.com/llm-wiki"
+source_type: "url"
+created_at: "2026-06-08T16:06:03.980Z"
+captured_at: "2026-05-14T10:00:00+08:00"
+run_id: "20260608-160603980-89f570"
+content_fingerprint: "sha256:7e9fcf3257160956b260fe36c2c3dbdddf91b86856e989045eee547ff0019a9a"
+wiki_entry: "[[05-wiki/source-knowledge/llm-wiki-notes|Wiki 条目]]"
+source_card: "[[03-sources/article-cards/llm-wiki-notes|资料卡]]"
+raw_note: "[[02-raw/articles/llm-wiki-notes|原文]]"
+claims_note: "[[04-claims/_suggestions/llm-wiki-notes-claims|Claim 建议]]"
+assets_note: "[[06-assets/_suggestions/llm-wiki-notes-assets|素材建议]]"
+topics_note: "[[07-topics/ready/llm-wiki-notes-topics|选题]]"
+outline_note: "[[08-outputs/outlines/llm-wiki-notes-outline|大纲]]"
+run_summary: "[[09-runs/20260608-160603980-89f570/processing-summary|处理记录]]"
+tags: ["aiwiki/topics"]
+---
+
+# 选题候选
+
+- Wiki 条目：[[05-wiki/source-knowledge/llm-wiki-notes|Wiki 条目]]
+- 资料卡：[[03-sources/article-cards/llm-wiki-notes|资料卡]]
+- 大纲：[[08-outputs/outlines/llm-wiki-notes-outline|大纲]]
+- LLM Wiki Notes

package/examples/obsidian-vault-sample/09-runs/20260608-160603980-89f570/wiki-entry.md

@@ -0,0 +1,103 @@
+---
+aiwiki_id: "llm-wiki-notes:wiki-entry"
+type: "wiki_entry"
+wiki_type: "source_knowledge"
+source_role: "input"
+represents_user_view: false
+status: "active"
+generation_mode: "agent_enriched"
+quality: "enriched"
+generated_by: "host_agent"
+llm_enriched: true
+title: "LLM Wiki Notes"
+slug: "llm-wiki-notes"
+source_url: "https://example.com/llm-wiki"
+source_type: "url"
+source_card: "03-sources/article-cards/llm-wiki-notes.md"
+raw_file: "02-raw/articles/llm-wiki-notes.md"
+claims_file: "04-claims/_suggestions/llm-wiki-notes-claims.md"
+topics_file: "07-topics/ready/llm-wiki-notes-topics.md"
+outline_file: "08-outputs/outlines/llm-wiki-notes-outline.md"
+run_summary: "09-runs/20260608-160603980-89f570/processing-summary.md"
+run_id: "20260608-160603980-89f570"
+content_fingerprint: "sha256:7e9fcf3257160956b260fe36c2c3dbdddf91b86856e989045eee547ff0019a9a"
+created_at: "2026-06-08T16:06:03.980Z"
+updated_at: "2026-06-08T16:06:03.980Z"
+summary: "LLM Wiki 把资料整理成可持续维护的本地知识层。"
+topics: ["LLM Wiki", "Agent-first", "content fingerprint", "evidence boundary"]
+claims: ["高质量知识提炼应由宿主 Agent 提供"]
+grounding_evidence_available: false
+grounding_evidence_channel: "none"
+grounding_needs_review: true
+grounding_markers: ["unsupported_claims"]
+grounding_claim_count: "1"
+grounding_claim_quote_count: "0"
+grounding_unsupported_claim_count: "1"
+coverage_suspected_incomplete: false
+tags: ["aiwiki/wiki-entry"]
+---
+# LLM Wiki Notes
+
+## Grounding 复核
+
+- 证据通道：none
+- 需要复核：yes
+- 疑似标记：unsupported_claims
+- Claim 引用覆盖：0/1
+
+## 一句话总结
+
+LLM Wiki 把资料整理成可持续维护的本地知识层。
+
+## 核心观点
+
+- Wiki Entry 是入库后的默认知识容器
+- 宿主 Agent 负责理解原文
+
+## 可复用知识点
+
+### Agent-first 边界
+
+CLI 负责落盘，Agent 负责理解。
+
+## Reusable Judgments
+
+### Review before reuse
+
+- judgment: Unsupported analysis should stay reviewable before it becomes reusable knowledge.
+- rationale: The host Agent may infer beyond the source.
+- evidence boundary: needs review if reused as a factual claim
+
+
+## Entities and Concepts
+
+- entities: AIWiki CLI, Host Agent
+- concepts: content fingerprint, evidence boundary
+
+## Tensions
+
+- automation speed vs evidence review
+
+## 相关概念
+
+- LLM Wiki
+- Agent-first
+
+## 适合用于什么场景
+
+- 研究
+- 写作
+
+## 可转化的选题
+
+- 为什么 Agent 需要本地 Wiki
+
+## Suggested Links
+
+- Grounding review workflow -> 05-wiki/source-knowledge/grounding-review (Connects this source to evidence review practice.)
+
+## 来源
+
+- Source Card: [[03-sources/article-cards/llm-wiki-notes|资料卡]]
+- Raw: [[02-raw/articles/llm-wiki-notes|原文]]
+- Run: [[09-runs/20260608-160603980-89f570/processing-summary|处理记录]]

package/examples/obsidian-vault-sample/_system/index.md

@@ -0,0 +1,37 @@
+# AIWiki System Index
+
+Use this file as the human and Agent entry point for the knowledge base.
+
+## Core Areas
+
+- [[02-raw/articles|Raw Articles]]
+- [[03-sources/article-cards|Source Cards]]
+- [[04-claims/_suggestions|Claim Suggestions]]
+- [[05-wiki|Wiki Entries]]
+- [[06-assets/_suggestions|Asset Suggestions]]
+- [[07-topics/ready|Topic Pipeline]]
+- [[08-outputs/outlines|Draft Outlines]]
+- [[09-runs|Processing Runs]]
+
+## Dashboards
+
+- [[dashboards/AIWiki Home|AIWiki Home]]
+- [[dashboards/Review Queue|Review Queue]]
+- [[dashboards/Recent Runs|Recent Runs]]
+- [[dashboards/Lint Report|Lint Report]]
+
+## System Files
+
+- [[_system/purpose|Purpose]]
+- [[_system/log|Log]]
+- [[_system/schemas/aiwiki-frontmatter|Frontmatter Schema]]
+
+## Common Commands
+
+```bash
+aiwiki status
+aiwiki next
+aiwiki query "<topic>"
+aiwiki context "<topic>"
+aiwiki lint
+```

package/examples/obsidian-vault-sample/_system/log.md

@@ -0,0 +1,8 @@
+# AIWiki System Log
+
+This lightweight log is reserved for important workspace events. It keeps the base edition file-first and does not require a database.
+
+## Entries
+
+<!-- Add manual or future automated events below. -->
+

package/examples/obsidian-vault-sample/_system/purpose.md

@@ -0,0 +1,31 @@
+# AIWiki Knowledge Base Purpose
+
+This file defines what this knowledge base is for. Host Agents should read it before ingesting, querying, or reorganizing content.
+
+## Goal
+
+Build a local, traceable AI knowledge base that turns useful articles, notes, and source material into Obsidian-ready Markdown.
+
+## Suitable Materials
+
+- Articles, notes, transcripts, and references that can become source cards, wiki entries, claims, topics, outlines, or reusable assets.
+- External materials with clear source information.
+- User-owned drafts or published work when the user explicitly says the material represents their own output.
+
+## Unsuitable Materials
+
+- Content without a usable source or context.
+- Purely private, sensitive, illegal, or unsafe material.
+- Generic web noise that cannot become reusable knowledge.
+- Claims that cannot be tied back to evidence.
+
+## Multi-Knowledge-Base Boundary
+
+This base AIWiki workspace is a single knowledge base. If the user later creates multiple knowledge bases, each one should have its own purpose file and Agents should route material according to that local purpose.
+
+## Agent Rules
+
+- Respect this purpose before ingesting material.
+- Keep evidence and inference separate.
+- Do not treat external input as the user's own view unless the user says so.
+- Prefer traceable source cards and wiki entries over unsupported summaries.

package/examples/obsidian-vault-sample/_system/schemas/aiwiki-frontmatter.md

@@ -0,0 +1,21 @@
+# AIWiki Frontmatter Schema
+
+AIWiki 使用 Obsidian 原生 Properties 作为基础数据库层，Dataview 只作为可选增强。
+
+## Shared Fields
+
+- `aiwiki_id`: AIWiki 内部稳定标识。
+- `type`: `source_card`, `raw_article`, `claim_suggestions`, `asset_suggestions`, `topic_candidates`, `draft_outline`, `processing_summary`。
+- `status`: `to-review`, `ready`, `draft`, `reviewed`, `archived`, `fetch-failed`。
+- `slug`: 来源标题或 URL 生成的 slug。
+- `source_url`: 原始 URL，若没有则为空。
+- `source_type`: `url`, `file`, `text` 等来源类型。
+- `created_at`: AIWiki 写入时间。
+- `captured_at`: 宿主 Agent 读取来源的时间。
+- `run_id`: 本次处理记录目录名。
+- `source_card`, `raw_note`, `claims_note`, `assets_note`, `topics_note`, `outline_note`, `run_summary`: Obsidian 内部链接字符串。
+- `tags`: AIWiki 类型标签。
+
+## Rule
+
+正文中的 wikilink 用于人工阅读；frontmatter 字段是 Dataview 查询和数据库筛选的来源。

package/examples/obsidian-vault-sample/_system/templates/review-note.md

@@ -0,0 +1,16 @@
+---
+type: "review_note"
+status: "draft"
+source_card: ""
+created_at: ""
+tags: ["aiwiki/review"]
+---
+
+# 审阅记录
+
+## 判断
+
+## 可复用结论
+
+## 后续动作
+

package/examples/obsidian-vault-sample/_system/templates/source-card.md

@@ -0,0 +1,34 @@
+---
+aiwiki_id: ""
+type: "source_card"
+status: "to-review"
+slug: ""
+title: ""
+source_url: ""
+source_type: ""
+created_at: ""
+captured_at: ""
+run_id: ""
+source_card: ""
+raw_note: ""
+claims_note: ""
+assets_note: ""
+topics_note: ""
+outline_note: ""
+run_summary: ""
+tags: ["aiwiki/source-card"]
+---
+
+# 资料卡
+
+## Obsidian 链接
+
+- 原文：
+- Claim 建议：
+- 素材建议：
+- 选题：
+- 大纲：
+- 处理记录：
+
+## 摘要
+

package/examples/obsidian-vault-sample/aiwiki.yaml

@@ -0,0 +1,18 @@
+product: aiwiki
+schema_version: 1
+created_at: "2026-06-08T16:06:03.826Z"
+
+knowledge_base:
+  id: default
+  name: AIWiki
+  language: zh-CN
+
+agent:
+  url_first: true
+  fetch_owner: host_agent
+  cli_fetch_webpage: false
+
+review:
+  wiki_merge_policy: manual
+  claim_policy: suggest_only
+  asset_policy: suggest_only

package/examples/obsidian-vault-sample/dashboards/AIWiki Home.md

@@ -0,0 +1,31 @@
+# AIWiki 首页
+
+AIWiki 的 Obsidian 入口。Dataview 是可选增强；未安装时仍可使用下方普通链接、Properties、Backlinks 和 Graph View。
+
+## 原生链接入口
+
+- [[dashboards/Wiki Entries|Wiki 条目]]
+- [[dashboards/Source Cards|资料卡]]
+- [[dashboards/Review Queue|待审队列]]
+- [[dashboards/Recent Runs|最近处理]]
+- [[dashboards/Topic Pipeline|选题管线]]
+- [[dashboards/Lint Report|结构检查]]
+- [[_system/schemas/aiwiki-frontmatter|字段说明]]
+
+## 最近收录
+
+```dataview
+TABLE status, source_url, captured_at, run_summary
+FROM "03-sources/article-cards"
+WHERE type = "source_card"
+SORT captured_at DESC
+```
+
+## 待审队列
+
+```dataview
+TABLE type, status, source_card, raw_note, run_summary
+FROM "03-sources/article-cards" or "04-claims/_suggestions" or "06-assets/_suggestions" or "08-outputs/outlines"
+WHERE status = "to-review"
+SORT created_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Recent Runs.md

@@ -0,0 +1,10 @@
+# 最近处理
+
+处理记录用于追溯每次宿主 Agent 入库的 payload、产物和告警。
+
+```dataview
+TABLE status, source_url, source_card, raw_note, created_at
+FROM "09-runs"
+WHERE type = "processing_summary"
+SORT created_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Review Queue.md

@@ -0,0 +1,12 @@
+# 待审队列
+
+未安装 Dataview 时，可直接打开 [[03-sources/article-cards]]、[[04-claims/_suggestions]]、[[06-assets/_suggestions]] 和 [[08-outputs/outlines]] 手工审阅。
+
+## 待审内容
+
+```dataview
+TABLE type, source_url, source_card, raw_note, claims_note, assets_note, outline_note
+FROM "03-sources/article-cards" or "04-claims/_suggestions" or "06-assets/_suggestions" or "08-outputs/outlines"
+WHERE status = "to-review"
+SORT captured_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Source Cards.md

@@ -0,0 +1,10 @@
+# 资料卡
+
+资料卡用于追踪来源、原文、Claim 建议、素材建议、选题和大纲。
+
+```dataview
+TABLE status, source_url, wiki_entry, raw_note, captured_at
+FROM "03-sources/article-cards"
+WHERE type = "source_card"
+SORT captured_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Topic Pipeline.md

@@ -0,0 +1,10 @@
+# 选题管线
+
+选题和大纲是从资料卡继续写作的入口。
+
+```dataview
+TABLE status, source_card, outline_note, source_url, created_at
+FROM "07-topics/ready" or "08-outputs/outlines"
+WHERE type = "topic_candidates" or type = "draft_outline"
+SORT created_at DESC
+```

package/examples/obsidian-vault-sample/dashboards/Wiki Entries.md

@@ -0,0 +1,10 @@
+# Wiki 条目
+
+AIWiki 每次成功入库都会生成 Wiki Entry。这里是知识层入口，不要求先经过 Review Queue 才能查询。
+
+```dataview
+TABLE wiki_type, source_role, represents_user_view, quality, source_card, raw_file, updated_at
+FROM "05-wiki"
+WHERE type = "wiki_entry"
+SORT updated_at DESC
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itradingai/aiwiki",
-  "version": "0.2.19",
+  "version": "0.2.20",
   "type": "module",
   "description": "Agent-first AI knowledge base CLI for turning articles, links and notes into Obsidian-ready source cards, topics, outlines and reusable knowledge assets.",
   "license": "MIT",
@@ -50,6 +50,7 @@
     "docs/USAGE.md",
     "docs/development-log.md",
     "docs/architecture.svg",
+    "examples",
     "skill"
   ],
   "bin": {