跳转至

新人复习（10 分钟）

这个教程是一个“安装后自检流程”，帮你确认 RexOS 的核心链路都跑通：

  • 本地模型（Ollama）可用
  • 工具调用被沙盒限制在 workspace 内
  • 同一个 session_id 可以多次续跑（记忆持久化）
  • harness workspace 会产出持久化文件 + git checkpoint

0) 前置条件

  • rexos 已安装并在 PATH 中
  • Ollama 正在运行：ollama serve
  • Ollama 里至少有一个 对话模型：
1
ollama list

如果默认模型（llama3.2）没有拉取，你可以：

1
ollama pull llama3.2

或者编辑 ~/.rexos/config.toml，把默认模型切到你已有的模型，例如：

1
2
[providers.ollama]
default_model = "qwen3:4b" # 示例：换成你本机已有的模型

1) 初始化 RexOS

1
rexos init

预期产物：

  • ~/.rexos/config.toml
  • ~/.rexos/rexos.db

2) 跑一次 one-shot session（workspace 沙盒）

1
2
3
mkdir -p rexos-demo
rexos agent run --workspace rexos-demo --prompt "Create hello.txt with the word hi"
cat rexos-demo/hello.txt

1
2
3
mkdir rexos-demo
rexos agent run --workspace rexos-demo --prompt "Create hello.txt with the word hi"
Get-Content .\rexos-demo\hello.txt

预期：

  • workspace 里生成 hello.txt，内容为 hi
  • stderr 会打印 session_id（下一步要用到）

3) 用同一个 session id 续跑（记忆）

把 <SESSION_ID> 替换成上一步 RexOS 输出的 id：

1
rexos agent run --workspace rexos-demo --session <SESSION_ID> --prompt "Append a newline + bye to hello.txt"

验证文件已更新：

1
cat rexos-demo/hello.txt

1
Get-Content .\rexos-demo\hello.txt

4) 创建 harness workspace（持久化产物 + git）

1
2
mkdir -p rexos-harness-demo
rexos harness init rexos-harness-demo

1
2
mkdir rexos-harness-demo
rexos harness init rexos-harness-demo

在 rexos-harness-demo/ 里你应该能看到：

  • features.json
  • rexos-progress.md
  • init.sh 和 init.ps1
  • .git/（且已经有一条初始化 commit）

运行一次 preflight（不带 prompt）：

1
rexos harness run rexos-harness-demo

5) 文档按钮（可复现性）

文档站点的每个页面都应该有：

  • 编辑此页 → 跳转到 GitHub 的 docs-site/...
  • 查看源文件 → 打开 raw Markdown

如果按钮不见了或不可用，检查 docs workflow 以及 mkdocs.yml（repo_url + edit_uri）。