pi package · MIT License

RICEMIND · 禾智

Agricultural AI Research Agent

基于 pi-mono(⭐45k+)构建的农业领域 AI 智能体。 文献检索、BibTeX 管理、领域综述——一个 pi install 搞定。

↓ 向下滚动

生态 数据

pi-mono 是当前最活跃的 AI agent 工具包之一,RICEMIND 完全基于其扩展体系构建。

45k+
pi-mono GitHub Stars
8.6M
pi-coding-agent 月下载量
368k+
OpenClaw Stars(基于 pi-agent-core)
30+
内置 LLM Provider

核心 能力

纯 Extension + Skill + Theme 扩展,零核心代码修改。

🔍

三源文献搜索

Semantic Scholar、CrossRef、arXiv 同时检索,支持合并去重。自然语言驱动的搜索体验。

📄

BibTeX 智能导出

自动生成 citation key、DOI 去重、LaTeX 特殊字符转义。直接输出可用的 .bib 文件。

🌾

10 大农业模板

精准农业、作物模型、遥感、病虫害、IoT、大模型等预定义调研模板,一键启动领域综述。

🎨

农业绿主题

51 个 TUI 色彩 token 全覆盖,#4CAF50 主色调。热重载——改文件即刻生效。

🧠

领域系统提示

自动注入农业科研身份与原则:数据真实性、可溯源性、严谨性、可复现性。

🔌

标准 pi package

符合 pi manifest 规范,一行安装。可与任意其他 pi extension/skill 组合。

架构 全景

从底层 LLM API 到上层应用,pi-mono 生态的分层架构。

RICEMIND Extension
RICEMIND Skills
RICEMIND Theme
OpenClaw 🦞
pi CLI (npx pi)
pi SDK
pi-coding-agent
pi-agent-core
pi-tui
pi-ai
Anthropic
OpenAI
Google
DeepSeek
ZAI 智谱
30+ Providers

pi-mono 核心包

职责
pi-ai统一 LLM API,多 provider 抽象
pi-agent-coreAgent 框架(tool loop、session、compaction)
pi-coding-agent编码 agent CLI + 内置 tools
pi-tui终端 UI 组件库
pi-web-uiWeb UI 组件库

定制化 6 层体系

机制改代码?
1AGENTS.md / SYSTEM.md
2Prompt Templates
3Skills
4Themes
5Extensions
6Packages (打包分发)

真实 案例

谁在用 pi-mono 构建产品?

🦞 OpenClaw — 368k+ Stars 的个人 AI 助手

OpenClaw 是目前 GitHub 上最活跃的个人 AI 助手项目。它直接依赖 pi-mono 的全部核心包:

openclaw/package.json(摘录)
// OpenClaw 直接使用 pi-mono 的核心引擎
"dependencies": {
    "@mariozechner/pi-agent-core": "0.73.0",  // Agent 框架
    "@mariozechner/pi-ai":         "0.73.0",  // 统一 LLM API
    "@mariozechner/pi-coding-agent": "0.73.0",  // 编码 agent
    "@mariozechner/pi-tui":        "0.73.0",  // 终端 UI
}

OpenClaw 的做法:基于 pi-agent-core 的 Agent 循环 + pi-ai 的统一 provider 层, 构建 30+ 渠道(WhatsApp / Telegram / Discord / 微信 / Slack / Signal ...)的个人助手。 它证明了 pi-mono 的架构足以支撑百万级用户的产品。

🌾 RICEMIND — 我们的做法

与 OpenClaw 不同,RICEMIND 走的是纯 Extension + Skill + Theme路线——不写一行核心代码。

ricemind/package.json
// RICEMIND 零核心代码修改
{
    "name": "ricemind",
    "keywords": ["pi-package"],
    "pi": {
        "extensions": ["./extensions"],   // 3 tools + 3 commands
        "skills":     ["./skills"],       // 文献收集 skill
        "prompts":    ["./prompts"],      // /review 模板
        "themes":     ["./themes"]        // 农业绿主题
    }
}

一行 pi install 即可将通用 coding agent 变成农业科研助手。 这是 pi-mono 设计哲学的最佳实践:Adapt pi to your workflows, not the other way around.

快速 开始

5 分钟从安装到文献搜索。

1. 安装 pi + RICEMIND
# 安装 pi(全局)
$ npm install -g @mariozechner/pi-coding-agent

# 设置 API key(任选一个 provider)
$ export ZAI_API_KEY="your-zhipu-key"
# 或 anthropic / openai / deepseek / gemini ... 30+ providers

# 安装 RICEMIND
$ pi install git:github.com/YuanyuanMa03/ricemind
2. 启动 & 搜索
$ pi

🌾 RICEMIND · 禾智 v0.2.0
Agricultural AI Research Assistant
Theme: ricemind | Model: glm-5.1
──────────────────────────────────

> 帮我在 CrossRef 上搜 precision agriculture UAV 的文献

📚 Found 10 papers from crossref:
  1. Precision agriculture using UAV-based remote sensing (2024)
  2. UAV-based phenotyping for crop improvement (2023)
  ...

> 导出 BibTeX

@article{zhang_2024_precision,
  author = {Zhang, Wei and Li, Ming},
  title = {Precision agriculture using UAV-based remote sensing},
  year = {2024},
  doi = {10.1234/pa-uav-2024},
}
3. 命令速查
# 文献搜索
> /literature "crop yield deep learning" crossref 10

# 领域调研
> /survey agri-llm 5

# 文献综述
> /review precision agriculture

# 品牌信息
> /ricemind

农业 模板

10 个预定义农业研究模板,覆盖主要研究方向。

模板 ID领域搜索关键词
precision-ag精准农业与智能种植precision agriculture, smart farming, variable rate
crop-yield作物产量预测crop yield prediction, machine learning
remote-sensing遥感(UAV/卫星)remote sensing, UAV, satellite agriculture
disease-det病虫害检测plant disease detection, computer vision
crop-model作物模型WOFOST, DSSAT, crop simulation model
iot-farmIoT 与传感器IoT agriculture, sensor network, smart irrigation
agri-llm农业大模型large language model agriculture, foundation model
climate-ag气候与农业climate change agriculture, crop adaptation
soil-health土壤健康soil health, soil organic carbon, precision
weed-det杂草检测weed detection, deep learning, herbicide

路线 对比

基于 pi-mono 构建应用的三种方式。

方式 代表 深度 门槛 适用
SDK 嵌入 OpenClaw 完全控制 独立产品
pi Package RICEMIND 🌾 Extension + Skill 领域定制
直接使用 npx pi 默认工具 通用编码

对比 实验

同一个人,同一个功能,两种方式——差距有多大?

📦 pi Package 方式

安装 & 使用
# 一行安装
$ pi install git:github.com/YuanyuanMa03/ricemind

# 直接用
$ pi
🌾 RICEMIND · 禾智 v0.2.0
> 搜 precision agriculture 文献
代码量
1,900 行 · 12 文件
  • ✅ 声明式:告诉 pi “注册这个工具”
  • ✅ 30+ provider 自动切换
  • ✅ 多轮对话、session 持久化
  • ✅ 主题、命令、prompt 模板
  • ⚠️ 受 pi 框架约束

🔧 SDK Embedding 方式

安装 & 使用
# 安装依赖
$ npm install

# 运行
$ tsx ricemind-sdk.ts "搜文献"
🌾 RICEMIND · 禾智 v0.2.0 (SDK)
我是 RICEMIND(禾智)...
代码量
450 行 · 2 文件
  • ✅ 命令式:自己管理 agent 生命周期
  • ✅ 完全控制,自有 UI/渠道
  • ✅ 全部 inline,无文件依赖
  • ⚠️ 手动处理 provider 切换
  • ⚠️ 需自行构建多轮/持久化

🎯 结论

差距不在“好坏”,在定位不同

你想做什么推荐原因
给 pi 加领域能力pi package一行安装,生态复用
个人定制 pipi package随时开关,不影响升级
独立 AI 产品SDK Embedding完全控制,自有 UI
多渠道 AI 助手SDK Embedding需要 WebSocket/REST
学术研究工具pi package够用,维护成本低
商业 SaaSSDK Embedding需要完整用户/认证体系

OpenClaw(⭐368k)选择 SDK Embedding——因为它要做 30+ 渠道的个人助手。
RICEMIND 选择 pi package——因为我们只是农业领域增强工具。

📦 pi Package 仓库 🔧 SDK Embedding 仓库