qing
ce3fb7fc74
- parse_args 新增 --once/--quiet/--once-timeout 参数 - 新增 handle_once_mode：stdout chunk 流式、stderr 过程行、SIGINT 三层取消、超时 Timer - 退出码：0 成功 / 2 API 失败 / 3 中断 / 4 超时；与 WebSocket 零回归 - 配套开发文档：docs/reports/aibox_cli_once_mode_dev_doc.md - 附带修复：memdb/test_memdb.py 并发测试硬编码端口
memdb — 内存缓存数据库
基于 libmemdb 模板库的 JSON RPC 缓存服务，提供键值存储、TTL 过期、并发安全的内存缓存能力。
架构
Memdb<std::string, std::string> (libmemdb 模板：LRU 链表 + 哈希索引 + TTL 过期)
└── MemdbServer (RPC 服务端：路由注册 + 互斥锁线程安全)
└── pmc::net::RpcServer (libmsg JSON RPC 服务端：多客户端 select + 线程池)
路由
| 路由 | 参数 | 返回 | 说明 |
|---|---|---|---|
ping |
— | "pong" |
健康检查 |
set |
key, value |
true/false |
插入键值对（key 已存在返回 false） |
get |
key |
"value" / null |
查询键值 |
del |
key |
true/false |
删除键 |
update |
key, value, refresh_ttl? |
true/false |
更新值，可选刷新 TTL |
exists |
key |
true/false |
键是否存在 |
size |
— | int |
当前条目数 |
expire |
key, value |
true/false |
更新值并重置 TTL（del + set） |
show |
— | [{key,value},...] |
导出所有条目 |
配置
ServerConfig 结构体（src/memdb.cpp）：
| 字段 | 默认值 | 说明 |
|---|---|---|
listen_host |
127.0.0.1 |
监听地址 |
listen_port |
8011 |
监听端口 |
workers |
4 |
线程池大小 |
max_time |
600 |
默认 TTL（秒），10 分钟 |
构建与运行
前置依赖：g++（C++20）、libmsg、libmemdb、boost::json
# 构建
bash _set.sh
# 运行
bash _run.sh
客户端示例
#include <us/RpcClient.hpp>
pmc::net::RpcClient rpc("127.0.0.1", 8011, "memdb-client");
// 插入
json::object params;
params["key"] = "session:abc123";
params["value"] = R"({"user":"admin","role":"root"})";
rpc.call("set", params); // → true
// 查询
rpc.call("get", {{"key", "session:abc123"}}); // → "{\"user\":\"admin\",...}"
// 检查存在
rpc.call("exists", {{"key", "session:abc123"}}); // → true
// 查看大小
rpc.call("size"); // → 1
项目结构
memdb/
├── src/
│ └── memdb.cpp # MemdbServer + main()
├── Makefile
├── _set.sh
├── _run.sh
└── README.md