默认使用简体中文。先读 docs/00-product-baseline.md、docs/05-system-architecture.md、docs/17-monorepo-engineering.md 与 docs/21-roadmap-and-status.md,再按任务读取相关文档。
- 产品已有原生客户端与 Rust 运行时;实际范围见 docs/29-implementation-and-verification.md 与证据索引。构建、软件集成、原生窗口、真机与正式发行分别记录,不得把计划目录或上游测试当产品验收。
- 通用身份、命令账本、物模型、网关协议和平台 API 归
limecloud/iot;本仓库拥有产品客户端、协同体验与本机能力适配。 - 桌面用户客户端和桌面执行端拥有不同身份、权限及生命周期;手机后台不承担常驻网关职责。
docs/catalog.json管理文档导航,requirements.json管理需求,test-cases.json管理验收计划,status.json管理实际进度。示例与草案不得伪装为正式运行合同。- 参考仓库仅通过公开地址、明确 SDK 依赖或显式开发路径使用,不隐式读取
../iot等相邻目录;读取本地工作树须记录 HEAD、文件摘要及未提交差异。
- 仅创建当前任务需要的实现,不为未来硬件、插件市场或云后台预建空工程。
- KISS、DRY、YAGNI 和 SOLID 服务于实际职责,界面不承载授权与重试策略。
- 模型输出是数据;有副作用的操作沿当前授权、原请求和真实回执执行。
- 断线、超时和取消不等于未执行,恢复核实原任务,不隐式重发。
- 修改文档后运行
python3 "docs/scripts/verify_docs.py";图形变更同时更新 Mermaid 源码、SVG 及摘要记录。 - 运行、源码构建、模拟集成、目标系统与真实设备分别取证。失败或跳过不得记为通过。
- 长任务分阶段汇报;同一失败最多两轮针对修复,仍失败时记录原因和影响。
- 不触碰真实用户数据、系统服务或生产环境完成文档验证。未获明确指令不创建分支、不提交、不推送、不发布。