docs: 说明文件重整(README 改使用导向,运维细节移入 docs/worker-management.md)

This commit is contained in:
2026-10-13 17:29:38 +08:00
parent 6d087fa4e3
commit fe96fc9b6c
7 changed files with 512 additions and 845 deletions
+9 -9
View File
@@ -281,28 +281,28 @@ unzip myplugin.zip -d /app && cd /app && ./start.sh
---
## 9. 本地验证
## 9. 本地联调
```bash
# Zenoh Router(替代 zenohd)
# 起一个本地 Zenoh Router(替代 zenohd)
.venv/bin/python utils/worker-rs/scripts/zenoh_router.py &
# 协议级 15 项断言(描述符/RPC/流式/错误/摘除/自愈)
# 协议级端到端自检(描述符 / RPC / 流式 / 错误 / 摘除 / 自愈)
.venv/bin/python utils/worker-rs/scripts/verify_e2e.py \
--type myplugin --bin workers/myplugin/target/debug/myplugin
```
---
## 10. 与 Python SDK 的差异(有意为之)
## 10. Rust 侧行为要点
| 差异 | 说明 |
| 要点 | 说明 |
| ---- | ---- |
| 契约校验 | Python 进程内三方校验(硬失败);Rust 为**发布前自检**:无 handler 端点告警跳过,不发布残缺路由 |
| 模型生成 | Rust 用 gen_models 生成强类型结构体 + **启动时指纹校验**(TOML 变更未重生成即告警,比 Python 更强) |
| 契约校验 | **发布前自检**:无 handler 的端点告警跳过,不发布残缺路由 |
| 模型生成 | `gen_models` 生成强类型结构体 + **启动时指纹校验**(TOML 变更未重生成即告警) |
| handler 注入 | worker_id 经 `Request.worker_id`、user_info 经 `Request.user_info` 注入(非函数参数) |
| 配置缓存后端 | Rust 支持 sqlite(`local-cache`,本机与 Python 共享同一 .db)+ Redis(`redis-cache`,跨主机);缺省无缓存回退 |
| 数据库 | Rust 走 sqlx(见 §7),配置键与 Python `chongming_database` 对齐 |
| 配置缓存后端 | `local-cache`(sqlite,与 Python 共享同一 .db)/ `redis-cache`(跨主机);缺省无缓存回退 |
| 数据库 | 走 sqlx(见 §7),配置键与 `chongming_database` 对齐 |
---