Skip to content

hencter/Nova

Repository files navigation

Nova 知识库

AI 维护 · 人类导航 · 自举进化 · 开箱即用

Nova 是一个自举式个人知识库系统(self-bootstrapping knowledge vault)。它由 AI 代理持续维护:自动摄入知识、交叉链接、健康检查、自动 git 提交——你只需要负责跟它对话。


安装前提

工具 用途 安装
Git 版本控制 winget install Git.Gitgit-scm.com
Obsidian 可视化浏览知识库 obsidian.md
OpenCode / Crush AI 代理运行环境 见下方说明

Git 自动检测:首次启动时 Nova 会检测 Git 是否已安装。如未安装,会自动尝试 winget install Git.Git(Windows)/ brew install git(macOS)/ apt install git(Linux),并告知用户安装结果。

AI 运行环境:原版 OpenCode(opencode-ai/opencode)已于 2025-09-18 归档。推荐使用其接替者 Crush(Charm 团队维护,26.5k stars)或 OpenCode by SST。两者均支持 Agent Skills 开放标准。


启动流程(2 分钟)

# 1. 进入仓库
cd Nova

# 2. 启动 AI 代理
crush       # 或:opencode

首次启动:强制初始化

Nova 通过双重触发器检测是否需要初始化:

触发器 场景 行为
log.md 无历史条目 全新仓库,从未被使用 进入初始化问答题
user-config.mdowner_name: "未设置" 他人克隆/下载,log 有效但身份未配置 强制进入初始化问答

只要满足任一条件,Nova 会自动询问:

Nova: 你想叫我什么名字?
你:   星尘

Nova: 我怎么称呼你?
你:   小明

Nova: 你主要用这个知识库做什么?
你:   AI 研究和日常笔记

Nova: 初始化完成。从现在起我是你的 星尘,请多指教。

设计意图:克隆或下载 Nova 的用户不会继承原主人的身份。即使 log.md 已存在历史记录,也会因为 owner_name: "未设置" 强制触发个性化流程。在完成命名之前,Nova 会拒绝所有请求——这是故意的保护机制,确保每个用户都能拥有属于自己的 Nova。这在 AGENTS.md §Boot Sequence 中有完整规范。

初始化后你可以用中文向 Nova 提问:

  • "帮我学习 MCP 协议"
  • "摄入这篇文章:[链接]"
  • "介绍一下 Git 的数据模型"
  • "帮我新建一篇关于 React Server Components 的笔记"

知识库结构

总目 目录 内容
concepts.md concepts/ 29 篇原子概念笔记(AI Agent、Git、ZK、OKF 等)
tools.md tools/ 8 篇工具深度分析(OpenCode/Crush、Claude Code、Aider 等)
patterns.md patterns/ 5 篇设计模式(多代理、上下文管理、权限模型等)
_identity.md _identity/ Nova 的自我认知与个性化指南
_meta.md _meta/ 关于知识库本身的知识(架构、自举机制)
conference.md conference/ Agent 间异步会议记录

技术栈

  • 编辑器: Obsidian(Markdown + Wiki Links + Graph View)
  • AI 框架: OpenCode / Crush(Skills + Subagents + Multi-agent + Auto-commit)
  • 版本控制: Git(自动提交 via auto-commit 技能)
  • 格式标准: OKF v0.1(开放知识格式)

语言分层

层级 语言 说明
导航 / 身份 / 日志 中文 人类入口层
深层技术笔记 英文 AI 消费层
前置元数据 英文 机器解析

你的 Nova,你做主

  • 初次启动时 Nova 会自动引导你完成个性化
  • 之后随时编辑 _identity/personalize.md 深度定制
  • 换名字、改性格、加技能——随时可以
  • 把整个文件夹打包发给朋友,他们也能拥有自己的 Nova

"Obsidian 是 IDE,AI 是程序员,知识库是代码。" — Karpathy

About

A self-bootstrapping AI-maintained knowledge vault Obsidian + OpenCode + Zettelkasten

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors