{
  "markdown": "# LLM Wiki\n\nKho tri thức cá nhân vận hành cùng LLM, lưu kiến thức theo Markdown để dễ đọc bằng Obsidian, quản lý bằng Git và truy xuất bằng agent. Repository biến nguồn thô thành các trang kiến thức có cấu trúc, nguồn gốc rõ ràng và có thể bảo trì lâu dài.\n\n## Khả năng chính\n\n- **Ingest nguồn kiến thức:** Biên dịch tài liệu trong `raw/` thành các concept bền vững trong `wiki/`.\n- **Truy vấn và tổng hợp:** Agent tìm từ catalog, đọc các concept liên quan, đánh giá nguồn, độ mới và mâu thuẫn trước khi trả lời.\n- **Provenance và trust:** Mỗi claim phụ thuộc nguồn được liên kết đến tài liệu gốc; trạng thái, mâu thuẫn và thay thế phiên bản được biểu diễn trong wiki.\n- **Bảo trì wiki:** Kiểm tra metadata, index, link, provenance, lifecycle và các rủi ro như dữ liệu nhạy cảm.\n- **Tìm kiếm mở rộng tùy chọn:** QMD cung cấp BM25 và semantic/hybrid retrieval bằng cache cục bộ; Markdown và index vẫn là nguồn dữ liệu chính.\n- **Tương thích công cụ:** Nội dung là Markdown chuẩn, có thể mở trực tiếp bằng Obsidian và quản lý lịch sử thay đổi bằng Git.\n\n## Cấu trúc repository\n\n```text\nraw/       Nguồn gốc, bất biến sau khi được đưa vào repository\nwiki/      Tri thức đã được tổng hợp theo OKF v0.2\n  index.md Catalog đầy đủ, điểm vào cho truy vấn\n  log.md   Lịch sử thay đổi theo thứ tự mới nhất\noutputs/   Báo cáo và kết quả tạm thời được yêu cầu\n.pi/       Skills và prompt cho agent\n.qmd/      Cấu hình cache tìm kiếm QMD (database tạo ra chỉ lưu cục bộ)\ntools/     Script kiểm tra cấu trúc và cập nhật QMD\n```\n\n`LLM-WIKI.md` là contract trung tâm: định nghĩa phạm vi, quyền sở hữu dữ liệu, định dạng concept, retrieval policy và các bất biến khi thay đổi wiki.\n\n## Cách dùng cơ bản\n\n### 1. Mở kho tri thức\n\nClone repository, sau đó mở thư mục bằng Obsidian nếu muốn duyệt và chỉnh sửa Markdown trực quan:\n\n```bash\ngit clone <repository-url>\ncd llm-wiki\n```\n\nĐọc `LLM-WIKI.md` trước khi thay đổi nội dung để tuân thủ quy ước của kho.\n\n### 2. Thêm và ingest nguồn mới\n\n1. Đặt tài liệu nguồn vào `raw/`. Không sửa lại file nguồn sau khi đã lưu; khi có đính chính, thêm một file nguồn mới.\n2. Trong agent, dùng prompt/skill **wiki-ingest** (hoặc yêu cầu agent ingest file cụ thể).\n3. Agent kiểm tra dữ liệu nhạy cảm, đối chiếu nội dung đã có, rồi chỉ tạo hoặc cập nhật các concept cần thiết trong `wiki/`.\n\nVí dụ yêu cầu:\n\n```text\nIngest raw/my-source.md vào wiki.\n```\n\nMỗi concept có YAML frontmatter, mô tả ngắn cho index, trạng thái và danh sách nguồn. `wiki/index.md` cùng `wiki/log.md` được cập nhật trong một mutation hoàn chỉnh.\n\n### 3. Đặt câu hỏi cho wiki\n\nDùng **wiki-query** hoặc prompt `wiki-query` và nêu rõ câu hỏi. Agent ưu tiên đọc `wiki/index.md`, chọn concept phù hợp, kiểm tra relationship, provenance, freshness và contradictions trước khi tổng hợp.\n\n```text\nWiki hiện có nói gì về confirmation bias? Hãy nêu nguồn và các điểm chưa chắc chắn.\n```\n\nCâu trả lời tạm thời không làm thay đổi wiki. Khi kết quả tạo ra synthesis có giá trị tái sử dụng, có thể yêu cầu agent lưu kết quả vào wiki.\n\n### 4. Kiểm tra chất lượng\n\nYêu cầu agent chạy **wiki-lint** để audit và sửa các lỗi cơ học. Có thể chạy structural check trực tiếp:\n\n```bash\npython3 tools/wiki_check.py\n```\n\nBáo cáo lint được lưu tại `outputs/wiki-lint-YYYY-MM-DD.md`. Các thay đổi wiki hợp lệ phải được index, kiểm tra lại và ghi một entry vào `wiki/log.md`.\n\n## Tìm kiếm QMD (tùy chọn)\n\nQMD là cache tìm kiếm cục bộ cho `wiki/`, không phải nguồn sự thật. Chỉ nên dùng khi wiki lớn hoặc tìm kiếm chính xác không đủ hiệu quả.\n\nCần Node.js 22+ hoặc Bun 1+ và QMD CLI. Cài đặt sau khi bạn chấp thuận việc cài global package:\n\n```bash\nnpm install -g @tobilu/qmd\n./tools/qmd-update.sh\n```\n\nThêm `--embed` khi cần semantic retrieval:\n\n```bash\n./tools/qmd-update.sh --embed\n```\n\nFile cấu hình `.qmd/index.yml` được theo dõi bởi Git; SQLite index và model tải về là cache cục bộ, đã được bỏ qua bởi `.gitignore`.\n\n## Quy tắc dữ liệu quan trọng\n\n- `raw/` là evidence source of truth; `wiki/` là bản tổng hợp vận hành để truy vấn.\n- Không đưa credentials, private key, token, PII hoặc thông tin confidential vào `wiki/`, `outputs/` hay `log.md`.\n- Không xem kết quả search là bằng chứng cuối cùng: luôn đọc concept được chọn và kiểm tra metadata, nguồn, trạng thái và mâu thuẫn.\n- Lưu insight bền vững vào `wiki/`; chỉ lưu deliverable tạm thời vào `outputs/`.\n\n## Skills và prompts\n\n| Thành phần | Mục đích |\n| --- | --- |\n| `wiki-ingest` | Biên dịch nguồn và durable insight vào wiki |\n| `wiki-query` | Truy xuất, đánh giá và tổng hợp tri thức |\n| `wiki-lint` | Audit và sửa sức khỏe cấu trúc/nội dung của wiki |\n| `qmd-setup` | Thiết lập QMD cache cục bộ |\n| `qmd-retrieval` | Xếp hạng candidate bằng QMD khi cần |\n| `wiki-learn` | Tạo bài viết hướng dẫn cho người mới từ tri thức wiki |\n\nChi tiết đầy đủ về chính sách và quy trình nằm trong [LLM-WIKI.md](LLM-WIKI.md).\n",
  "bytes": 4841,
  "sha": "d73810ddf96843f061ea0ad0e002aec1363437ec073759625f88770457ab2691",
  "repo_slug": "hiennguyen9874/llm-wiki",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_hiennguyen9874_llm_wiki_wiki_index_md_5fd8e5a6/readme"
}