根页面只在你真正有内容要写时才创建

`brain init` 不再预置六个占位模板,新大脑从空的 `pages/` 目录开始;`brain update-root` 只在你真正写下内容时创建根页面。

亮点

根页面按需创建

新大脑从空的 pages/ 目录开始,没有任何根页面。brain init 不再预置六个占位模板。

只有当 stdin 以你自己写的 # 标题 开头、且标题之后有真实内容时,brain update-root <slug> 才会创建六个槽位之一(background、architecture、flow、mindmap、stack、roadmap)。展示用的标题就取自这个 H1。

printf '# System architecture\n\n## Overview\n\nRequests enter through the gateway.\n' | brain update-root architecture

后续写入的标题规则

  • 旧版根页面如果存储的正文中没有 H1,下一次写入时可以省略标题,系统会把 frontmatter 中的标题作为 H1 插入。
  • 如果页面已经以 H1 开头,之后每次写入都必须包含 H1。省略会导致写入失败,文件保持原样。
  • 已有内容的大脑不会被改动,brain init 依然不会覆盖它们。

安装说明

  • 想直接使用 brain 命令,建议全局安装;只用 npx 不会把 brain 加到 PATH。
  • 已有安装:升级到 @mindmux/[email protected],然后运行 brain setup -y。

相关链接

分享到