@itradingai/aiwiki 0.2.18 → 0.2.20

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.18",
+  "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",
@@ -38,8 +38,19 @@
     "LICENSE",
     "CONTRIBUTING.md",
     "SECURITY.md",
-    "docs/*.md",
+    "docs/20260607-aiwiki-feature-pruning-plan.md",
+    "docs/20260607-aiwiki-long-term-operating-roadmap.md",
+    "docs/AGENT_HANDOFF.md",
+    "docs/FAQ.md",
+    "docs/OBSIDIAN_DATAVIEW_PLAN.md",
+    "docs/README.md",
+    "docs/RELEASE.md",
+    "docs/ROADMAP.md",
+    "docs/SHOWCASE.md",
+    "docs/USAGE.md",
+    "docs/development-log.md",
     "docs/architecture.svg",
+    "examples",
     "skill"
   ],
   "bin": {

package/skill/LINT_PROTOCOL.md

@@ -9,17 +9,17 @@ Use this protocol when the user asks:
 
 ## Steps
 
-1. Call:
+1. Call JSON lint first:
 
 ```bash
-aiwiki lint
+aiwiki lint --json
 ```
 
-2. When you need machine-readable triage, call:
+2. If `safe_fixes.only_safe_fixes` is true and the user allows cleanup, apply the built-in safe fix and rerun JSON lint:
 
 ```bash
+aiwiki lint --fix-empty-dirs --json
 aiwiki lint --json
-aiwiki next
 ```
 
 3. Read the terminal report.
@@ -38,6 +38,7 @@ dashboards/Lint Report.md
 - `error`: broken structure such as a missing internal link.
 - `warning`: likely fix needed, such as missing source fields or stale fallback entries.
 - `info`: useful inventory, such as deterministic fallback count or duplicate titles.
+- `safe_fixes`: machine-readable count of safe fixes available/applied; `only_safe_fixes` means all current issues are safe to apply with the supported fixer.
 
 ## Repair Guidance
 
@@ -47,3 +48,4 @@ Prefer small, traceable fixes:
 - Fix broken wikilinks.
 - Add missing `source_card` or `raw_file` paths.
 - Ask the host Agent to provide `analysis` for scaffold entries.
+- Remove empty optional enhancement directories only through `aiwiki lint --fix-empty-dirs --json`; do not delete core directories, unknown directories, non-empty directories, or files.

package/skill/SKILL.md

@@ -3,7 +3,7 @@ name: aiwiki
 description: Agent-first AIWiki workflow for turning one URL/body into local Wiki knowledge files.
 ---
 
-<!-- aiwiki-skill-version: 0.2.18 -->
+<!-- aiwiki-skill-version: 0.2.19 -->
 
 # AIWiki Skill
 
@@ -132,7 +132,7 @@ Because AIWiki CLI does not call an LLM, high-quality summary and knowledge extr
   },
   "request": {
     "mode": "ingest",
-    "outputs": ["source_card", "wiki_entry", "creative_assets", "topics", "draft_outline", "processing_summary"],
+    "outputs": ["source_card", "wiki_entry", "processing_summary"],
     "language": "zh-CN"
   }
 }
@@ -208,13 +208,20 @@ aiwiki query "<topic>"
 
 ## Lint Protocol
 
-When the user asks to整理 / 检查 / lint the knowledge base, call:
+When the user asks to整理 / 检查 / lint the knowledge base, first call JSON lint:
 
 ```bash
-aiwiki lint
+aiwiki lint --json
 ```
 
-Explain warnings and errors as structure-health feedback. Do not frame lint as a requirement that the user manually review every item.
+If `safe_fixes.only_safe_fixes` is true and the user has allowed cleanup, apply the built-in safe fix and rerun JSON lint:
+
+```bash
+aiwiki lint --fix-empty-dirs --json
+aiwiki lint --json
+```
+
+Only `remove_empty_optional_dir` is auto-safe today. It removes known empty optional enhancement directories and must not delete core directories, unknown directories, non-empty directories, or files. Explain warnings and errors as structure-health feedback. Do not frame lint as a requirement that the user manually review every item.
 
 ## Source Role
 

package/docs/POSITIONING_CONTEXT_COMPILER_PLAN.md

@@ -1,347 +0,0 @@
-# AIWiki 定位调整与产品方案
-
-本文基于 `20260607-aiwiki定位.md` 的判断，并结合当前 AIWiki 仓库现状整理。结论是：文档大方向可取，但不能把 AIWiki 改成重学习、重记忆、重人工复习的 Knowledge MEMO。AIWiki 更适合继续做 Agent-first 本地上下文编译器。
-
-## 一句话定位
-
-AIWiki 不是替代搜索，也不是替你读书，而是把你真正需要反复调用的资料、判断和输出，编译成 AI 能查询、能引用、能检查、能继续使用的本地知识资产。
-
-更锋利的对外表达：
-
-> 公开知识交给搜索。
-> 私有判断、项目经验、输出风格、证据链，交给 AIWiki。
-
-## 建议取舍判断
-
-| 文档建议 | 判断 | 原因 | 落地优先级 |
-| --- | --- | --- | --- |
-| 不把 AIWiki 宣传成普通个人知识库或资料索引 | 可取 | 当前 README 已强调 Agent-first 和本地 LLM-wiki 后端，但还可以更明确地区分搜索、收藏夹和上下文编译器 | P0 |
-| 保留 Markdown Wiki 形态 | 可取 | AIWiki 面向人和 Agent 协作，Markdown 的可读、可 diff、可回滚、可被 Agent 编辑是核心优势 | P0 |
-| 强化个人判断层 | 强烈可取 | 当前 payload 已有 `source_role=processing`，但产品心智和目录/命令输出还没有把 personal insight 变成一等资产 | P0 |
-| 强化输出资产层 | 强烈可取 | 当前已有 `source_role=output` 和 `represents_user_view=true` 边界，这是 AIWiki 最有差异化的一层 | P0 |
-| `context` 从资料检索升级为任务上下文包 | 强烈可取 | 当前 `context` 已是 JSON 结构，适合加 `mode` 和按任务分组的结果，不需要推倒重做 | P0 |
-| `query` 输出按资料类型分组 | 可取 | 这是低成本心智升级：从“搜索结果”变成“知识资产调度” | P1 |
-| `lint` 从结构检查升级为知识质量检查 | 可取 | 当前 lint 已有元数据边界、fallback、grounding 检查，可继续加入 insight/output/evidence 使用关系检查 | P1 |
-| `next` 从命令导航升级为加工建议 | 可取 | 适合帮助用户把资料推进到 insight、output、topic 或 review，而不是只提示下一条 CLI 命令 | P1 |
-| 新增 Retain / Review | 部分可取 | 可以做轻量回看，但不应成为主流程，也不要第一阶段引入 FSRS 或 Anki 式学习系统 | P2 |
-| 把 AIWiki 改成纯人脑内化工具 | 不建议 | 会偏离当前 Agent-first CLI 边界，也会让产品过重 | 不做 |
-| 引入多知识库、自动采集、内置网页抓取 | 不建议 | 与当前仓库 AGENTS.md 和 README 边界冲突；这些属于 AIWiki Pro 或宿主 Agent/服务层，不属于基础 CLI | 不做 |
-
-## 产品原则
-
-1. AIWiki 只沉淀值得复用的上下文，不收藏所有公开知识。
-2. 外部资料默认不代表用户观点。
-3. 用户自己的输出和判断比外部输入更值钱。
-4. AIWiki CLI 不调用 LLM；高质量分析由宿主 Agent 提供，AIWiki 负责规范、落盘、追踪、检查。
-5. 保持单知识库、单命令 `aiwiki`、本地 Markdown 的基本边界。
-6. Review / Retain 是增强闭环，不是默认主流程。
-
-## 三类知识资产模型
-
-### 1. Source Knowledge：来源证据
-
-用于保存外部文章、网页、报告、视频转写、书籍摘录等。
-
-建议字段：
-
-```yaml
-source_role: input
-wiki_type: source_knowledge
-represents_user_view: false
-```
-
-价值标准：
-
-- 是否能作为证据引用。
-- 是否能支撑观点或反驳观点。
-- 是否能生成选题、方案、脚本或研究方向。
-- 是否能和已有资料、判断、输出建立连接。
-
-### 2. Personal Insight：个人判断
-
-用于保存用户或宿主 Agent 帮用户整理出的判断、取舍、冲突、决策理由。
-
-建议先复用现有 `source_role=processing`，并把 `wiki_type` 从宽泛的 `thought_note` 收窄为更明确的 `personal_insight` 或 `decision_note`。第一阶段可以兼容旧值。
-
-建议字段：
-
-```yaml
-type: insight_note
-source_role: processing
-wiki_type: personal_insight
-represents_user_view: true
-confidence: low | medium | high
-based_on:
-  - 03-sources/article-cards/example.md
-  - 05-wiki/source-knowledge/example.md
-used_for:
-  - article
-  - product_decision
-  - client_solution
-  - research
-```
-
-条目应回答：
-
-- 我认同什么，为什么。
-- 我反对什么，为什么。
-- 对项目、文章、产品或客户方案有什么启发。
-- 能否转成文章观点、产品决策或执行动作。
-- 和我已有判断是否冲突。
-
-### 3. Output Knowledge：可复用输出
-
-用于保存用户已经发布或交付过的文章、方案、PRD、README、报价、视频脚本、群内回答等。
-
-建议字段：
-
-```yaml
-source_role: output
-wiki_type: personal_knowledge
-represents_user_view: true
-```
-
-价值标准：
-
-- 能反映用户真实观点。
-- 能反映用户表达风格。
-- 能被新文章、新方案、新脚本复用。
-- 能回溯到支撑它的 source 和 insight。
-
-## 命令方案
-
-### `aiwiki context`
-
-定位：从“相关资料包”升级为“任务上下文包”。
-
-新增 `--mode`：
-
-```bash
-aiwiki context "AI知识库是否还有必要" --mode write
-aiwiki context "AIWiki产品定位" --mode decide
-aiwiki context "Karpathy LLM Wiki" --mode research
-aiwiki context "我的公众号文章风格" --mode style
-aiwiki context "某个知识点" --mode learn
-```
-
-建议返回结构：
-
-```json
-{
-  "schema_version": "aiwiki.context.v2",
-  "query": "AIWiki产品定位",
-  "mode": "decide",
-  "external_sources": [],
-  "personal_insights": [],
-  "past_outputs": [],
-  "conflicts": [],
-  "usable_arguments": [],
-  "missing_context": [],
-  "recommended_next_action": ""
-}
-```
-
-兼容策略：
-
-- 保留 v1 `matches` 结构一段时间。
-- v2 可以先在结果中新增字段，不立刻移除旧字段。
-- `--mode` 缺省为 `general`。
-
-### `aiwiki query`
-
-定位：给人看的知识资产摘要，不是普通搜索结果。
-
-建议输出分组：
-
-```text
-外部资料
-- ...
-
-个人判断
-- ...
-
-已发布输出
-- ...
-
-证据与冲突
-- ...
-
-建议下一步
-- ...
-```
-
-优先级：
-
-- 命中 output 和 insight 时，展示在 source 前面。
-- source 只作为证据，不默认当成结论。
-
-### `aiwiki lint`
-
-定位：从文件结构健康检查升级为知识资产健康检查。
-
-保留现有检查：
-
-- 缺少系统文件。
-- Source Card 没有 Wiki Entry。
-- Wiki Entry 缺少 source_card / raw_file。
-- fallback scaffold 过期。
-- grounding needs review。
-- `represents_user_view=true` 但不是 output。
-- 重复 URL、重复标题、断链。
-
-新增质量检查：
-
-- 某主题只有 source，没有 insight。
-- 某 insight 没有 `based_on`。
-- 某 output 没有关联 source 或 insight。
-- source 被错误标记为代表用户观点。
-- claim 没有 source quote 或证据边界。
-- 某主题存在冲突观点但没有决策结论。
-- enriched entry 只有摘要，没有 reusable judgment / reusable knowledge。
-
-### `aiwiki next`
-
-定位：从命令导航升级为加工建议。
-
-建议输出：
-
-```text
-当前最值得做：
-- 这 3 篇 source 只有摘要，没有个人判断。
-- 这个主题已有 5 条 source，可以生成主题页。
-- 这条 output 没有证据链，建议补 linked sources。
-- 这个观点和历史输出存在冲突，建议进入 review。
-```
-
-### `aiwiki review` 或 `aiwiki retain`
-
-定位：轻量回看，不做重学习系统。
-
-第一版只做候选生成：
-
-```text
-今日建议回看：
-- 3 条个人 insight
-- 2 条高价值 source knowledge
-- 1 条已输出文章中的核心观点
-
-可生成卡片：
-- 观点卡
-- 证据卡
-- 反驳卡
-- 案例卡
-- 输出卡
-```
-
-暂不做：
-
-- FSRS。
-- 每日强制复习。
-- Anki 兼容。
-- 学习进度系统。
-
-## README 与对外话术
-
-建议把开头改得更锋利：
-
-```text
-AIWiki 是一个 Agent-first 本地上下文编译器。
-
-它不替代搜索，也不替你读书，而是把你真正需要反复调用的资料、判断和输出，编译成 AI 能查询、能引用、能检查、能继续使用的本地知识资产。
-```
-
-“它解决什么”建议改成：
-
-- 公开资料搜索得到，但你的使用场景、判断和输出痕迹搜不到。
-- 链接和资料散在聊天记录里，后续很难被 Agent 复用。
-- AI 总结过一次内容，但没有沉淀成可追踪、可查询、可检查的上下文资产。
-- 想把来源证据、个人判断、选题、大纲和已输出内容放进同一个本地知识系统。
-- 想让宿主 Agent 负责理解内容，让 AIWiki 负责稳定落盘、连接和检查。
-
-不建议继续主打：
-
-```text
-打造你的 AI 个人知识库
-```
-
-这个说法太泛，容易被理解成“AI 时代还要不要收藏夹”。
-
-## 分阶段落地
-
-### P0：定位与 schema 心智对齐
-
-目标：不大改代码，先把产品定位和现有字段解释清楚。
-
-任务：
-
-1. 更新 README、FAQ、USAGE 的定位话术。
-2. 在 docs 中新增“三类资产模型”说明。
-3. 在 Agent handoff / skill 中要求宿主 Agent 区分 source、insight、output。
-4. 明确 `source_role=input` 永远不默认代表用户观点。
-5. 为 `processing` 角色补充 personal insight 示例 payload。
-
-验收：
-
-- 新用户能在 README 前 30 秒理解 AIWiki 不是搜索替代品。
-- 文档能解释 source、insight、output 三层差异。
-- 不引入新命令、不破坏旧 payload。
-
-### P1：任务上下文与质量检查
-
-目标：让 AIWiki 从“能查到资料”升级为“能为任务组织上下文”。
-
-任务：
-
-1. `context` 增加 `--mode`。
-2. `context` 输出新增 `external_sources`、`personal_insights`、`past_outputs`、`conflicts`、`usable_arguments`、`missing_context`。
-3. `query` 输出按资产类型分组。
-4. `lint` 增加 insight/output/evidence 质量检查。
-5. `next` 增加加工建议。
-
-验收：
-
-- 同一个 query 在 `write`、`decide`、`research`、`style` 下返回不同的建议结构。
-- 有 insight/output 时优先暴露，不被 source 淹没。
-- `lint` 能指出“只有资料、没有个人判断”和“输出没有证据链”。
-
-### P2：轻量回看闭环
-
-目标：吸收 Retain 思想，但不把 AIWiki 变成学习软件。
-
-任务：
-
-1. 新增 `review` 或 `retain` 的候选生成命令。
-2. 支持观点卡、证据卡、反驳卡、案例卡、输出卡。
-3. Review Queue 只作为入口，不成为默认强制流程。
-
-验收：
-
-- 命令能生成今日回看候选。
-- 不需要用户维护复杂学习计划。
-- 不引入 FSRS 或重型记忆系统。
-
-## 不做清单
-
-- 不做通用网页抓取。
-- 不做多知识库。
-- 不做 CLI 内置 LLM。
-- 不做默认人工审核流程。
-- 不把 Review Queue 变成强制主流程。
-- 不把 AIWiki 改成 Anki 或 Knowledge MEMO。
-- 不用 `aiwiki-pro` 作为用户命令。
-
-## 推荐任务拆分
-
-1. `AIWIKI-POS-001`：更新 README / FAQ / USAGE 定位话术。
-2. `AIWIKI-POS-002`：补充三类资产模型文档和示例 payload。
-3. `AIWIKI-CTX-001`：为 `context` 增加 `--mode` 和 v2 结果字段。
-4. `AIWIKI-QRY-001`：让 `query` 按 source / insight / output 分组展示。
-5. `AIWIKI-LINT-001`：增加知识质量 lint。
-6. `AIWIKI-NEXT-001`：让 `next` 输出加工建议。
-7. `AIWIKI-REV-001`：设计轻量 review / retain 候选生成。
-
-## 最终判断
-
-这份定位文档对 AIWiki 是利好。它指出了“普通个人知识库/资料索引”在 AI 时代价值下降，这个判断应该接受；但它没有否定 AIWiki 的 Agent-first 本地上下文后端方向。真正可取的调整，是把 AIWiki 从“存知识”进一步收窄成“存上下文、判断和使用痕迹”。
-
-AIWiki 下一步最该做的不是扩功能，而是把已有地基讲清楚、排出优先级，然后补齐 personal insight、output knowledge、task context 和 quality lint 这四块。