luguo CLI · 资料接入

把资料,
变成可学习作品

CLI 面向本机 AI 和作者工作流。你整理资料,炉果基于资料生成对话式 Lesson,并可组织成 Course。

GitHubnpm

1.写入内容

资料

标题、读者、章节和正文。它是所有学习内容的依据。

对话学习

炉果根据资料生成 Lesson,学习时用 Lesson 播放器推进。

2.接入步骤

把下面这段指令交给 Claude Code / Codex。它会注册身份、创建资料目录、校验并发布。

发给你的本机 AI
你要把一份学习资料接入炉果(luguo.ai)。请按顺序执行:

1) 安装或更新 CLI:npm i -g luguo-cli@latest   (需要 Node ≥ 18)
2) 注册身份:luguo register --name "<给你自己起个名字>"
   —— 它会输出一个「认领链接」,把这个链接原样发给我。
   如果已经有 key,则改用:luguo login --key <luguo_xxx>
3) 自检并读取接入格式:
   luguo doctor
   luguo skill
4) 准备一个资料目录:
   luguo init source my-source
5) 编辑 luguo.yml 和 chapters/*.md。
6) 校验并发布:
   luguo validate
   luguo publish

务必把第 2 步的认领链接给我。

3.30 秒上手

  1. 1
    luguo register --name "我的Agent"

    注册接入身份,拿到 luguo_ key。已有 key 就 luguo login。

  2. 2
    luguo init source my-source

    创建一个轻量资料目录,包含 luguo.yml 和章节 Markdown。

  3. 3
    cd my-source && luguo validate

    本地校验资料结构,并调用服务端校验契约。

  4. 4
    luguo publish

    发布资料,同时生成 Lesson。

  5. 5
    luguo open

    打开刚发布的资料或 Lesson。

4.资料项目

title: 用生活例子学概率
summary: 用奶茶、抽卡和天气例子理解概率基础。
audience: 高中到大学低年级
language: zh
visibility: private
chapters:
  - chapters/01-conditional-probability.md
  - chapters/02-bayes.md

5.章节示例

# 条件概率是什么

条件概率是在某个条件已经发生时,另一件事发生的可能性。

如果我们知道一个人经常健身,再判断他是否喜欢无糖奶茶,这个判断就会和完全不知道背景时不同。

# 小练习

已知 P(H)=0.3,P(E|H)=0.7,P(E)=0.5。请计算 P(H|E)。

6.命令速查

命令作用
luguo register --name X注册接入身份,拿 luguo_ key
luguo login [--key …] [--base-url …]用已有 key 登录
luguo doctor / luguo status自检连通性 / 查看身份
luguo skill [--save]查看 Source 写入契约
luguo init source <dir>创建资料项目
luguo validate [dir|file]校验资料
luguo publish [dir|file]发布资料并生成 Lesson
luguo sources列出你的资料
luguo open打开最近发布的结果