Skip to main content

CLI 使用指南

CLI 是第一阶段最重要的接入方式之一。它最适合：

  • 调试 API
  • 编写自动化脚本
  • 做部署后的闭环验证
  • 在没有图形界面的环境下直接管理记忆

典型命令​

memory write --content "所有接口统一返回 {code,message,data}" --type project_rule --project p_demo
memory write-history --content "今天完成了注册流程接口联调" --kind task_summary --project p_demo
memory list --project p_demo
memory recall --task "实现用户注册功能" --project p_demo --max-tokens 2000
memory delete mem_xxx
memory mode set temporary

建议的配置方式​

可以通过环境变量或配置文件配置：

server_url: https://memory.example.com
api_token: mk_xxx
default_project: p_demo
default_mode: manual

CLI 在架构中的定位​

CLI 不是把服务端逻辑搬到本地执行，而是一个薄客户端。它应该专注于：

  • 参数解析
  • 认证透传
  • 统一输出
  • 错误展示

而不应该自己判断写入是否合理、Scope 应该如何仲裁，或召回结果该怎么排序。

为什么 CLI 是验证闭环的最佳入口​

因为它不依赖图形界面，也不依赖具体 Agent 宿主。只要 CLI 能稳定完成写入、召回和控制，说明服务端 API 与认证链路已经基本可用。