@biaoo/tiangong-wiki 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Biao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# @biaoo/tiangong-wiki
+
+[中文](./README.zh-CN.md)
+
+> Inspired by Karpathy's [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) — instead of re-deriving answers from raw documents on every query (like RAG), the LLM **builds and maintains a persistent wiki** that compounds over time.
+
+`@biaoo/tiangong-wiki` is the infrastructure for this pattern: a CLI that turns a directory of Markdown files into a queryable knowledge base with full-text search, semantic search, knowledge graph, and an interactive dashboard.
+
+## Features
+
+| | |
+|---|---|
+| **Knowledge that compounds** | Every source and every question makes the wiki richer — compiled once, kept current |
+| **Your files, your data** | Plain Markdown you own; no cloud, no database server, no lock-in |
+| **Find anything** | Metadata filters, keyword search, and semantic search in one CLI |
+| **See connections** | Relationships auto-extracted into a navigable knowledge graph |
+| **Ingest raw materials** | Drop files into a vault; AI reads and converts them to structured pages |
+| **AI-agent native** | Ships as a [Codex / Claude Code skill](./SKILL.md) for autonomous knowledge work |
+| **Visual dashboard** | Browse the graph, inspect pages, and search from a web UI |
+
+## Install
+
+```bash
+npm install -g @biaoo/tiangong-wiki
+```
+
+<details>
+<summary><strong>Use as an AI Agent Skill</strong></summary>
+
+After installing the npm package, register it with your agent:
+
+```bash
+npx skills add Biaoo/tiangong-wiki -a codex          # Codex
+npx skills add Biaoo/tiangong-wiki -a claude-code    # Claude Code
+npx skills add Biaoo/tiangong-wiki -a codex -g       # Global (cross-project)
+```
+
+Or let the setup wizard handle everything:
+
+```bash
+tiangong-wiki setup
+```
+
+</details>
+
+## Quick Start
+
+```bash
+tiangong-wiki setup                                   # interactive config wizard
+tiangong-wiki doctor                                  # verify configuration
+tiangong-wiki init                                    # initialize workspace
+tiangong-wiki sync                                    # index Markdown pages
+```
+
+```bash
+tiangong-wiki find --type concept --status active     # structured query
+tiangong-wiki fts "Bayesian"                          # full-text search
+tiangong-wiki search "convergence conditions"         # semantic search
+tiangong-wiki graph bayes-theorem --depth 2           # graph traversal
+```
+
+```bash
+tiangong-wiki daemon run                              # start dashboard & HTTP API
+tiangong-wiki dashboard                               # open dashboard in browser
+```
+
+> Environment variables are managed via `.wiki.env` (created by `tiangong-wiki setup`). See [references/env.md](./references/env.md) for the full reference.
+
+## CLI
+
+```
+Setup         setup · doctor · check-config
+Indexing      init · sync
+Query         find · fts · search · graph
+Inspect       list · page-info · stat · lint
+Create        create · template · type
+Vault         vault list | diff | queue
+Export        export-graph · export-index
+Daemon        daemon run | start | stop | status
+Dashboard     dashboard
+```
+
+See [references/cli-interface.md](./references/cli-interface.md) for the full command reference.
+
+## Architecture
+
+```
+┌──────────────────────────────────────────────────────────┐
+│                     Vault (raw input)                     │
+│           PDFs, docs, notes, bookmarks, clippings         │
+└────────────────────────┬─────────────────────────────────┘
+                         │ vault diff / vault queue
+                         ▼
+┌──────────────────────────────────────────────────────────┐
+│              Agentic Workflow (Codex SDK)                 │
+│                                                          │
+│  ┌─────────┐  read    ┌────────────┐  discover  ┌─────┐ │
+│  │ Parser  │ ──────►  │ tiangong-wiki-skill │ ────────►  │ LLM │ │
+│  │ Skills  │  source  │ find / fts │  + decide  │     │ │
+│  └─────────┘          └────────────┘            └─────┘ │
+│  pdf · docx · pptx                                       │
+│                                                          │
+│  → skip / create page / update page / propose only       │
+└────────────────────────┬─────────────────────────────────┘
+                         │ write pages
+                         ▼
+┌──────────────────────────────────────────────────────────┐
+│                    Markdown Pages (SSOT)                  │
+│                    wiki/pages/**/*.md                     │
+└────────────────────────┬─────────────────────────────────┘
+                         │ tiangong-wiki sync
+                         ▼
+┌──────────────────────────────────────────────────────────┐
+│                   SQLite Index (index.db)                 │
+│                                                          │
+│  pages          structured metadata (dynamic columns)    │
+│  pages_fts      FTS5 full-text search                    │
+│  vec_pages      sqlite-vec vector embeddings             │
+│  edges          knowledge graph (source → target)        │
+└──┬───────────┬───────────┬───────────┬───────────────────┘
+   │           │           │           │
+   ▼           ▼           ▼           ▼
+  find        fts       search       graph
+   │           │           │           │
+   └───────────┴───────────┴───────────┘
+                     │
+                     ▼
+          JSON stdout / HTTP daemon
+                     │
+        ┌────────────┴────────────┐
+        ▼                         ▼
+   CLI / Scripts            Web Dashboard
+```
+
+**Vault → Pages** — Raw materials land in the vault. An agentic workflow reads each file, discovers the current ontology via `tiangong-wiki type list / find / fts`, and decides whether to skip, create, or update a page.
+
+**Dual engine** — Markdown files are the source of truth. SQLite is a derived index rebuilt by `tiangong-wiki sync`, enabling queries that plain files cannot support.
+
+**Flexible schema** — Three-tier column model (fixed, deploy-level, template-level) with automatic `ALTER TABLE` on config changes.
+
+## Tech Stack
+
+| | |
+|---|---|
+| Language | TypeScript (ESM) |
+| Runtime | Node.js >= 18 |
+| CLI | [Commander.js](https://github.com/tj/commander.js) |
+| Database | [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) + [sqlite-vec](https://github.com/asg017/sqlite-vec) |
+| Dashboard | [Preact](https://preactjs.com/) + [G6](https://g6.antv.antgroup.com/) |
+| Build | [Vite](https://vite.dev/) |
+| Test | [Vitest](https://vitest.dev/) |
+
+## Development
+
+```bash
+git clone https://github.com/Biaoo/tiangong-wiki.git
+cd tiangong-wiki
+npm install && npm run build
+
+npm run dev -- --help        # CLI from source
+npm run dev:dashboard        # dashboard dev server
+npm test                     # run tests
+```
+
+## Contributing
+
+Issues and pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

package/README.zh-CN.md

@@ -0,0 +1,167 @@
+# @biaoo/tiangong-wiki
+
+[English](./README.md)
+
+> 受 Karpathy 的 [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) 启发 —— 不再像 RAG 那样每次从原始文档重新推导答案，而是让 LLM **构建并维护一个持久化的 wiki**，知识随使用不断积累。
+
+`@biaoo/tiangong-wiki` 为这个模式提供基础设施：一个 CLI，将 Markdown 文件目录变为可查询的知识库，支持全文搜索、语义搜索、知识图谱和交互式仪表盘。
+
+## 特性
+
+| | |
+|---|---|
+| **知识持续积累** | 每添加一个素材、每提出一个问题，wiki 都变得更丰富 —— 编译一次，持续更新 |
+| **你的文件，你的数据** | 纯 Markdown，你完全拥有；无需云端、无需数据库服务、无锁定 |
+| **随时找到任何知识** | 元数据过滤、关键词搜索、语义搜索，一个 CLI 搞定 |
+| **看见知识关联** | 自动提取页面间关系，构建可导航的知识图谱 |
+| **摄入原始素材** | 将文件放入 vault，AI 自动阅读并转化为结构化页面 |
+| **AI Agent 原生** | 作为 [Codex / Claude Code Skill](./SKILL.md) 使用，支持自主知识工作 |
+| **可视化仪表盘** | 通过 Web 界面浏览图谱、查看页面、搜索内容 |
+
+## 安装
+
+```bash
+npm install -g @biaoo/tiangong-wiki
+```
+
+<details>
+<summary><strong>作为 AI Agent Skill 使用</strong></summary>
+
+安装 npm 包后，将其注册到你的 Agent：
+
+```bash
+npx skills add Biaoo/tiangong-wiki -a codex          # Codex
+npx skills add Biaoo/tiangong-wiki -a claude-code    # Claude Code
+npx skills add Biaoo/tiangong-wiki -a codex -g       # 全局安装（跨项目可用）
+```
+
+或使用配置向导一步完成：
+
+```bash
+tiangong-wiki setup
+```
+
+</details>
+
+## 快速开始
+
+```bash
+tiangong-wiki setup                                   # 交互式配置向导
+tiangong-wiki doctor                                  # 验证配置
+tiangong-wiki init                                    # 初始化工作区
+tiangong-wiki sync                                    # 索引 Markdown 文件
+```
+
+```bash
+tiangong-wiki find --type concept --status active     # 结构化查询
+tiangong-wiki fts "贝叶斯"                             # 全文搜索
+tiangong-wiki search "优化算法的收敛条件"                # 语义搜索
+tiangong-wiki graph bayes-theorem --depth 2           # 图遍历
+```
+
+```bash
+tiangong-wiki daemon run                              # 启动仪表盘和 HTTP API
+tiangong-wiki dashboard                               # 在浏览器中打开仪表盘
+```
+
+> 环境变量通过 `.wiki.env` 管理（由 `tiangong-wiki setup` 创建）。完整参考见 [references/env.md](./references/env.md)。
+
+## CLI
+
+```
+配置引导      setup · doctor · check-config
+索引管理      init · sync
+查询          find · fts · search · graph
+自省          list · page-info · stat · lint
+创建          create · template · type
+Vault        vault list | diff | queue
+导出          export-graph · export-index
+守护进程      daemon run | start | stop | status
+仪表盘        dashboard
+```
+
+完整命令参考见 [references/cli-interface.md](./references/cli-interface.md)。
+
+## 技术架构
+
+```
+┌──────────────────────────────────────────────────────────┐
+│                    Vault（原始素材）                        │
+│           PDF、文档、笔记、书签、剪藏                        │
+└────────────────────────┬─────────────────────────────────┘
+                         │ vault diff / vault queue
+                         ▼
+┌──────────────────────────────────────────────────────────┐
+│              Agentic Workflow（Codex SDK）                 │
+│                                                          │
+│  ┌─────────┐  解析    ┌────────────┐  发现体系  ┌─────┐  │
+│  │ Parser  │ ──────►  │ tiangong-wiki-skill │ ────────► │ LLM │  │
+│  │ Skills  │  素材    │ find / fts │  + 决策   │     │  │
+│  └─────────┘          └────────────┘           └─────┘  │
+│  pdf · docx · pptx                                       │
+│                                                          │
+│  → 跳过 / 创建页面 / 更新页面 / 仅提议                      │
+└────────────────────────┬─────────────────────────────────┘
+                         │ 写入页面
+                         ▼
+┌──────────────────────────────────────────────────────────┐
+│               Markdown 页面（唯一真实来源）                  │
+│                    wiki/pages/**/*.md                     │
+└────────────────────────┬─────────────────────────────────┘
+                         │ tiangong-wiki sync
+                         ▼
+┌──────────────────────────────────────────────────────────┐
+│                  SQLite 索引 (index.db)                    │
+│                                                          │
+│  pages          结构化元数据（动态列）                       │
+│  pages_fts      FTS5 全文搜索                              │
+│  vec_pages      sqlite-vec 向量嵌入                        │
+│  edges          知识图谱（source → target）                 │
+└──┬───────────┬───────────┬───────────┬───────────────────┘
+   │           │           │           │
+   ▼           ▼           ▼           ▼
+  find        fts       search       graph
+   │           │           │           │
+   └───────────┴───────────┴───────────┘
+                     │
+                     ▼
+          JSON stdout / HTTP daemon
+                     │
+        ┌────────────┴────────────┐
+        ▼                         ▼
+   CLI / 脚本              Web 仪表盘
+```
+
+**Vault → Pages** — 原始素材进入 vault，Agentic Workflow 逐个阅读，通过 `tiangong-wiki type list / find / fts` 发现当前知识体系，决定跳过、创建或更新页面。
+
+**双引擎** — Markdown 文件是唯一真实来源，SQLite 是由 `tiangong-wiki sync` 构建的衍生索引，提供纯文件无法实现的查询能力。
+
+**灵活 Schema** — 三级列模型（固定列、部署列、模板列），配置变更时自动 `ALTER TABLE`，无需手动迁移。
+
+## 技术栈
+
+| | |
+|---|---|
+| 语言 | TypeScript (ESM) |
+| 运行时 | Node.js >= 18 |
+| CLI 框架 | [Commander.js](https://github.com/tj/commander.js) |
+| 数据库 | [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) + [sqlite-vec](https://github.com/asg017/sqlite-vec) |
+| 仪表盘 | [Preact](https://preactjs.com/) + [G6](https://g6.antv.antgroup.com/) |
+| 构建 | [Vite](https://vite.dev/) |
+| 测试 | [Vitest](https://vitest.dev/) |
+
+## 开发
+
+```bash
+git clone https://github.com/Biaoo/tiangong-wiki.git
+cd tiangong-wiki
+npm install && npm run build
+
+npm run dev -- --help        # 从源码运行 CLI
+npm run dev:dashboard        # 仪表盘开发服务器
+npm test                     # 运行测试
+```
+
+## 参与贡献
+
+欢迎提 Issue 和 Pull Request。如果是较大的改动，请先开 Issue 讨论。

package/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: tiangong-wiki-skill
+description: "Local-first wiki query and page-maintenance interface over Markdown knowledge pages indexed into SQLite. Use when an agent should discover existing knowledge before answering, inspect vault changes or queue state, choose how new durable knowledge fits the current ontology, or create/update wiki pages in a local knowledge workspace."
+---
+
+# Wiki Skill
+
+## Core Goal
+- Use the local wiki as the durable knowledge layer for future work, not just the current conversation.
+- Query SQLite first, then read or edit the Markdown files that remain the source of truth.
+- Treat page types as runtime-discovered ontology. Do not hardcode a default destination for new knowledge.
+
+## Use When
+Use `tiangong-wiki-skill` when:
+- You should check whether the answer already exists in the local wiki before writing a fresh answer.
+- You need to inspect the current ontology, template structure, or type recommendations before creating a page.
+- A durable insight, correction, workflow, lesson, or source-derived knowledge should be preserved for reuse.
+- New files appeared in `vault/` and you need to inspect `vault diff` or `vault queue` before deciding what knowledge work to do.
+- You need a structured view of the graph, stale content, orphan pages, provenance, or general workspace health.
+- You need to create or update a page and immediately re-index it.
+
+## Retrieval Strategy
+- Exact metadata, type, tag, status, node id, or dynamic column filter: `tiangong-wiki find`
+- Keyword or short literal clue: `tiangong-wiki fts`
+- Fuzzy natural-language retrieval with embeddings configured: `tiangong-wiki search`
+- Graph neighborhood, prerequisites, or multi-hop relations: `tiangong-wiki graph`
+- Single-page metadata, edges, provenance, or file path: `tiangong-wiki page-info`
+- Workspace inventory or health: `tiangong-wiki list`, `tiangong-wiki stat`, `tiangong-wiki lint`
+- Ontology discovery: `tiangong-wiki type list`, `tiangong-wiki type show`, `tiangong-wiki type recommend`
+- Vault ingestion status: `tiangong-wiki vault diff`, `tiangong-wiki vault list`, `tiangong-wiki vault queue`
+
+## Knowledge Capture Workflow
+Use this when new knowledge should become part of the wiki.
+
+1. Query for close existing pages with `tiangong-wiki find`, `tiangong-wiki fts`, or `tiangong-wiki search`.
+2. Discover the current ontology with:
+   - `tiangong-wiki type list --format json`
+   - `tiangong-wiki type show <type> --format json`
+   - `tiangong-wiki type recommend --text "<summary>" --keywords "a,b,c" --format json`
+3. Update the best existing page when the knowledge object already exists.
+4. Create a new page only when the knowledge object is distinct and the current ontology supports it cleanly.
+5. Edit the Markdown file directly.
+6. Run `tiangong-wiki sync --path <page-id>`.
+7. Run `tiangong-wiki lint --path <page-id> --format json`.
+
+```bash
+tiangong-wiki find --type method --tag evidence
+tiangong-wiki type list --format json
+tiangong-wiki type recommend --text "A repeatable workflow for evidence review" --keywords "workflow,procedure" --limit 5 --format json
+tiangong-wiki create --type method --title "Evidence Review Workflow"
+tiangong-wiki sync --path methods/evidence-review-workflow.md
+tiangong-wiki lint --path methods/evidence-review-workflow.md --format json
+```
+
+## Vault Review Workflow
+Use this when `vault/` may contain source files that should influence wiki knowledge.
+
+1. Run `tiangong-wiki sync` to refresh indexes, vault metadata, and queue state.
+2. Inspect recent vault changes with `tiangong-wiki vault diff`.
+3. Inspect queue state with `tiangong-wiki vault queue`.
+4. Discover the ontology through `tiangong-wiki type list/show/recommend` before deciding what to create or update.
+5. Preserve provenance with `sourceRefs` and any source-specific fields required by the chosen page type.
+6. Remember that `source-summary` is only one possible type. A vault file may lead to `skip`, an update to an existing page, a new page of any registered type, or a proposal to evolve the ontology.
+
+```bash
+tiangong-wiki sync
+tiangong-wiki vault diff
+tiangong-wiki vault queue
+tiangong-wiki type list --format json
+tiangong-wiki type recommend --text "Operational brief about evidence review" --keywords "operations,evidence" --limit 5 --format json
+tiangong-wiki find --type method --tag evidence
+```
+
+## Maintenance Rules
+- Do not assume any single page type is the default landing zone for vault files.
+- Prefer updating the best existing page before creating near-duplicates.
+- Use CLI discovery instead of static assumptions about templates or registered types.
+- If the current ontology is not a clean fit, consider template evolution deliberately; do not improvise undocumented structure.
+- After every mutation, re-index and lint the changed page before trusting query results.
+
+## Layer Boundary
+- `SKILL.md` describes the on-demand skill interface used by agents during queries and manual knowledge maintenance.
+- Automatic vault-to-wiki processing, daemon scheduling, queue retries, NAS polling, and workflow artifacts belong to the service layer.
+- Service-layer operations are documented in `references/service-admin.md`.
+
+## Environment Contract
+Required:
+- `WIKI_PATH`
+
+Optional for semantic retrieval or vector-based type recommendation:
+- `EMBEDDING_BASE_URL`
+- `EMBEDDING_API_KEY`
+- `EMBEDDING_MODEL`
+- `EMBEDDING_DIMENSIONS`
+
+Automatic vault processing uses additional `WIKI_AGENT_*` variables, but those belong to the service layer rather than the skill interface. Read `references/service-admin.md` when operating the daemon or queue worker.
+
+## Output Contract
+- Query commands return JSON to stdout.
+- Mutating commands return JSON summaries or created file paths to stdout.
+- `lint`, `check-config`, `template list/show`, `type list/show/recommend`, and `daemon status` support text or JSON output where documented.
+- Errors are emitted as structured JSON to stderr with `type=config|runtime|not_found|not_configured`.
+
+## References
+- `references/cli-interface.md`
+- `references/data-model.md`
+- `references/template-design-guide.md`
+- `references/runtime.md`
+- `references/env.md`
+- `references/wiki-maintenance-instruction.md`
+- `references/vault-to-wiki-instruction.md`
+- `references/service-admin.md`
+
+## Assets
+- `assets/wiki.config.default.json`
+- `assets/templates/`

package/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Tiangong Wiki Skill"
+  short_description: "Query, route, and maintain local wiki knowledge"
+  default_prompt: "Use the tiangong-wiki CLI and tiangong-wiki-skill to inspect existing wiki knowledge, discover the current ontology, and create or update durable pages in the local workspace."

package/assets/config.example.env

@@ -0,0 +1,18 @@
+WIKI_PATH=/data/workspace/wiki/pages
+VAULT_PATH=/data/workspace/vault
+WIKI_DB_PATH=/data/workspace/wiki/index.db
+WIKI_CONFIG_PATH=/data/workspace/wiki/wiki.config.json
+WIKI_TEMPLATES_PATH=/data/workspace/wiki/templates
+WIKI_SYNC_INTERVAL=86400
+
+EMBEDDING_BASE_URL=https://api.openai.com/v1
+EMBEDDING_API_KEY=your-embedding-api-key
+EMBEDDING_MODEL=text-embedding-3-small
+EMBEDDING_DIMENSIONS=384
+
+VAULT_SOURCE=local
+# When VAULT_SOURCE=synology, also set:
+# VAULT_SYNOLOGY_REMOTE_PATH=/homes/user/vault
+# SYNOLOGY_BASE_URL=https://nas.example.com:5001
+# SYNOLOGY_USERNAME=your-username
+# SYNOLOGY_PASSWORD=your-password

package/assets/templates/achievement.md

@@ -0,0 +1,32 @@
+---
+pageType: achievement
+title: Achievement Title
+nodeId: achievement-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+achievementType:
+date:
+issuer:
+verifiable: "yes"
+---
+
+## 成就描述
+
+简洁但具体地写出这项成就是什么，以及它代表了什么结果。
+
+## 获得过程
+
+说明获得这项成就经历了哪些关键步骤、难点和投入，而不是只写最终结果。
+
+## 能力体现
+
+解释这项成就证明了哪些能力、经验或可信度，方便后续被 resume 或 profile 引用。
+
+## 证明材料
+
+列出证书、链接、发布记录、截图或其他可核验证据，并同步到 sourceRefs。

package/assets/templates/bridge.md

@@ -0,0 +1,33 @@
+---
+pageType: bridge
+title: Bridge Title
+nodeId: bridge-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+fromCourse:
+toCourse:
+transferType:
+fromConcepts: []
+toConcepts: []
+---
+
+## 来源知识
+
+写清楚这个迁移起点来自什么课程、项目、领域或知识体系。
+
+## 目标场景
+
+写清楚这个迁移最终要解决什么目标问题，以及目标场景里的限制条件。
+
+## 迁移方式
+
+分步骤说明原知识是如何被翻译、映射或改造后用于目标场景的。
+
+## 迁移陷阱
+
+指出最容易误迁移的地方，以及哪些条件不满足时这个 bridge 不应复用。

package/assets/templates/concept.md

@@ -0,0 +1,47 @@
+---
+pageType: concept
+title: Concept Title
+nodeId: concept-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+confidence: medium
+masteryLevel: medium
+prerequisites: []
+---
+
+## 核心理解
+
+用两到四句话说明这个概念到底是什么，以及它为什么值得记住。
+
+## 前置知识
+
+列出理解这个概念之前必须已经掌握的知识、术语或背景。
+
+## 关键公式/定义
+
+写下最关键的定义、公式、判别标准或符号约定，不要只写标题。
+
+## 直觉/类比
+
+用一个直觉模型、类比或反例帮助未来的读者快速建立感觉。
+
+## 典型应用
+
+说明这个概念通常在哪些问题、项目或课程场景里真正会被用到。
+
+## 容易混淆
+
+写出它最容易和什么混淆，以及区分它们的判断线索。
+
+## 开放问题
+
+记录你当前还没完全吃透的点、边界条件或后续要继续查的内容。
+
+## 来源
+
+说明这个概念主要来自哪些来源，并确保这些来源同步写入 frontmatter 的 sourceRefs。

package/assets/templates/faq.md

@@ -0,0 +1,31 @@
+---
+pageType: faq
+title: FAQ Title
+nodeId: faq-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+frequency:
+---
+
+## 问题
+
+用用户真实会问出来的语言写下这个高频问题，而不是抽象化改写。
+
+## 简短回答
+
+先给出一段可以直接复用的短答案，方便快速回复。
+
+## 详细解释
+
+补充条件、例外、例子和判断边界，说明为什么短答案成立。
+
+## 相关概念
+
+列出应当一起阅读的 concept、method 或 source-summary 页面，帮助继续深入。
+
+如果这个问题已经不再高频，也请在正文里说明是否应该降级维护或归档。

package/assets/templates/lesson.md

@@ -0,0 +1,31 @@
+---
+pageType: lesson
+title: Lesson Title
+nodeId: lesson-slug
+status: draft
+visibility: private
+sourceRefs: []
+relatedPages: []
+tags: []
+createdAt: 2026-04-06
+updatedAt: 2026-04-06
+context:
+severity: medium
+actionable: "yes"
+---
+
+## 发生了什么
+
+按事实顺序描述事件经过、背景条件和真正触发结果的关键节点。
+
+## 从中学到了什么
+
+提炼这次事件留下的稳定认知，而不是只重复事件本身。
+
+## 以后怎么做
+
+写出未来遇到相似情况时的行动规则、检查步骤或预防动作。
+
+## 验证
+
+说明你打算如何验证这个 lesson 真的能改善结果，而不是停留在口头总结。