stark-L-1/dsh-peer-mailbox

README 摘要

@dsh-external/dsh-peer-mailbox 对话间信箱通信（toolkit + daemon-loop，host-only）：让 DSH 的不同会话之间一问一答， 全程不切换会话、不互相占用（绕开 live 会话锁）、不落 skill 文件。 工作用途约束（防闲聊烧 token） - 工具描述标注 ：peer ask / peer reply / peer read mailbox 的描述均声明 「工作用通信通道，不是闲聊工具：只用于传达任务、问事、交付结果，不要寒暄、不回复问候/闲聊内容」。 - 轮数上限（硬约束） ：同一「发送方→接收方」有向对在滑动时间窗口内最多 workLimitMax 条（默认 4，建议 3 5）。超限时 peer ask/peer reply 拒绝投递 （不落盘）， 返回 {ok:false, limited:true, reason:"已达通信轮数上限…"} 。 - 自动重置 ：滑动窗口（默认 1 小时）——窗口过期旧消息自动不计入，无需手动清零； 也可由管理员调整 workLimitMax / workLimitWindowMs 配置。 - 手动重置（管理员） ： peer reset limit(from, to, scope?) ——给指定对（或 scope=all 整个目录）的 现有消息打 limit reset 标记，统计时忽略它们，该对可立即继续投递、计数从 0 开始。 工具描述带醒目标注「管理员工具，除非接到明确命令否则不许使用」。 - 计数与投递在同一 per-file 锁内原子完成（并发投递不会超发）；不同 (from,to) 对独立计数。 工具 - peer ask(target, message, from?) ：向目标会话的信箱投递一条消息（只投递），返回 {ok,id,from,to,file} ；超限返回 {ok:false,limited:true,reason,…} 。 - peer read mailbox(from?, mark read?, who?) ：读当前会话信箱； mark read 缺省 true = 只看未读并标记已读，false = 看全部不动标记。 - peer reply(target, reply to, message, from?) ：回复某条消息（写 reply to 字段），本质同 peer ask（同样受轮数限制）。 - peer reset limit(from, to, scope?) ： 管理员工具，除非接到明确命令否则不许使用 。重置指定「发送方→接收方」的轮数计数（scope=pair 默认 / scope=all 整个目录），返回 {ok,scope,from,to,reset count} 。 唤醒层（daemon-loop） -…

分类