用途:inventory 是一套“携带、存储、转移对象”的通用协议,适用于任意容器,包括角色、背包、房间、箱子、载具与神器。其核心思想是物品可存为指针或值:指针是零重量、指向某处对象的引用;值是直接携带的文本、数字、数组或子树;对象是实际事物的深拷贝;可替代物按计数堆叠、不单独追踪。放下指针或值时,会被封装为独立存在的 YAML 文件。
主要能力:支持统一寻址,指针可指向 YAML 文件、文件内 #id 片段、Markdown 标题、JSON Pointer、搜索模式乃至源码行号或行范围;该语法同时用于物品栏(refs)、位置(location)与投递(to)。拾取分 TAKE REF(轻量引用)与 TAKE OBJECT(深拷贝);放下分 DROP AS BOX(创建继承自原指针目标的新文件并带元数据)、DROP AS BEAM(实际移动文件)与 DROP INTO(插入目标容器列表)。封装遵循“一旦封装,永远封装”,实例可累积来源历史并覆盖原型。还有可替代物的 FUNGIFY/UNFUNGIFY、分配器(dispenser)、印章垫(stamp pad)、重物运输的 BEAM/TRANSPORTER 与 FORKLIFT 模式。
使用方式:在容器 YAML 中通过 inventory: refs: / fungibles: / objects: 配置。指针语法如 path/to/file.yml、file.yml#id、file.yml#parent.child、file.md#heading、file.json#/json/path。结构化编辑命令包括 PEEK、POKE、SNIP、PULL、SPLICE、APPEND、SET、DELETE、CLEAR、DUPLICATE、MOVE,可跨 YAML 与 JSON 自动转换,并支持通配符、条件寻址与 BEGIN/COMMIT 原子编辑。
适用场景:物品管理、代码审查(角色可站在函数或行范围上讨论)、缺陷定位、结对编程、架构导览与文档标注。
限制:资料未提供收费、平台与性能数据;部分地址(如站在 package.json 的某键上)虽然有效但不一定有意义;FUNGIFY 会丢失个体属性;具体实现细节暂未提供。