From a5ac6948e7e4b5ae394b4ba1eb28daac71c46a16 Mon Sep 17 00:00:00 2001 From: AAsige <168331480+AAsige@users.noreply.github.com> Date: Fri, 7 Aug 2026 05:17:47 +0800 Subject: [PATCH] =?UTF-8?q?maintain=20|=20=E7=B2=BE=E7=AE=80=20CLAUDE.md?= =?UTF-8?q?=EF=BC=9A=E5=8E=8B=E7=BC=A9=E9=A1=B9=E7=9B=AE=E4=B8=8A=E4=B8=8B?= =?UTF-8?q?=E6=96=87=E6=B3=A8=E5=85=A5=EF=BC=881593B=E2=86=921048B?= =?UTF-8?q?=EF=BC=89=EF=BC=8C=E6=8C=87=E5=90=91=20WIKI-SCHEMA.md=20?= =?UTF-8?q?=E6=9D=83=E5=A8=81=E8=A7=84=E8=8C=83?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CLAUDE.md | 36 ++++++++++++------------------------ 1 file changed, 12 insertions(+), 24 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 753a2cd..248fb02 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,30 +1,18 @@ # CLAUDE.md -This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. +本仓库是 WikiLLM:一个基于 Markdown 的 LLM 维护型个人知识库(Obsidian 前端)。 -## Project Overview +## 目录结构 -WikiLLM is a system for building LLM-powered personal knowledge bases. The workflow consists of: +- `raw/` — 原始来源与不可变摘编(期货/股票/估值/宏观/量化 等域,见 `raw/期货/README.md`) +- `wiki/` — 编译后的可检索知识:`concepts/`、`practices/`、`queries/`,入口 `wiki/INDEX.md` +- `tools/` — `wiki-audit.ps1`(审计)、`wiki-reflect.ps1`(反思)、`wiki-push.ps1`(推送 Gitea) +- `wiki/_meta/WIKI-SCHEMA.md` — **权威规范**:分层、页面类型、frontmatter、哈希登记、导航、审计与推送流程 -1. **Data Ingest**: Source documents (articles, papers, repos, datasets, images) are indexed into a `raw/` directory -2. **Wiki Compilation**: An LLM incrementally "compiles" the raw data into a wiki of markdown files with summaries, backlinks, categorized concepts, and interlinked articles -3. **IDE**: Obsidian is used as the frontend to view raw data, compiled wiki, and visualizations -4. **Q&A**: The LLM can answer complex questions against the wiki by researching the related data -5. **Output**: Results are rendered as markdown files, Marp slides, or matplotlib images, viewable in Obsidian -6. **Linting**: LLM "health checks" find inconsistencies, impute missing data, suggest new article candidates -7. **Extra Tools**: Additional tools like a naive search engine over the wiki +## 核心原则 -## Directory Structure - -The project will eventually include these key directories: - -- `raw/` - Source documents and unprocessed data -- `wiki/` - LLM-compiled markdown wiki with articles, summaries, and links -- `tools/` - CLI tools for searching, processing, and enhancing the wiki - -## Core Principles - -- The LLM writes and maintains all wiki data; manual edits are rare -- User explorations and queries are filed back into the wiki to enhance it -- The system focuses on markdown files and Obsidian-compatible formats -- Images are downloaded locally for easy LLM reference +- LLM 负责编译与维护 wiki 页面;用户编辑过的 raw 文件视为受保护,不自动改写 +- 每个页面有 YAML frontmatter 与 `raw_sources`(指向仓库内真实文件+哈希) +- 新页面须链接到 `wiki/INDEX.md` 与至少一个相关页面 +- 每次维护后运行 `pwsh -File tools/wiki-audit.ps1`;推送用 `tools/wiki-push.ps1 -Audit` +- 详情一律以 `wiki/_meta/WIKI-SCHEMA.md` 为准