用途:这是 awiki-cli 的消息(Messaging)技能,用于身份之间的私聊、向已有群组发送文本、查看收件箱或私聊历史、标记消息已读,并了解安全消息的契约与当前限制。资料要求先阅读 ../awiki-shared/SKILL.md。
当前实现状态:该技能在当前仓库中为部分实现。已实现:msg send、msg inbox、msg history、msg mark-read,适用于普通私聊和普通群组流程。预留但未实现:msg secure 子命令。--secure on 属于命令契约的一部分,但服务当前对安全私聊返回 unsupported。
核心概念:私聊为由 --to 选择的一对一消息;群组消息为由 --group 选择的向已有群组发送;inbox 是跨私聊与群组范围的聚合读取路径;history 是与某一目标的私聊线程历史;read state 为本地未读跟踪;secure messaging 为面向未来私聊端到端加密流程的预留命令族。资源模型为:身份 → 私聊线程 → 消息;身份 → 群组成员关系 → 群组消息。
支持矩阵:私聊+普通已实现;私聊+安全为计划中,--secure on 存在于契约但服务当前返回 unsupported;群组+普通已实现;群组+安全不支持,不属于当前仓库路径。
规范命令:awiki-cli msg send --to <target> --text "Hello";awiki-cli msg send --group <group_did> --text "Hello group";awiki-cli msg inbox [--scope all|direct|group] [--with <target>] [--group <group_did>] [--unread] [--limit <n>] [--mark-read];awiki-cli msg history --with <target> [--limit <n>] [--cursor <cursor>];awiki-cli msg mark-read <MESSAGE_ID...>。
决策规则:发给个人用 msg send --to;发到群组用 msg send --group;浏览最近状态用 msg inbox;查看单个私聊线程用 msg history --with;清除未读用 msg mark-read;群组生命周期变更参考 ../awiki-group/SKILL.md;传输设置参考 ../awiki-runtime/SKILL.md。
副作用与确认:msg send 会发送消息并写入本地状态,需显式确认;msg mark-read 会修改本地未读状态,需显式确认;msg inbox --mark-read 读取并同时修改,需显式确认。
错误处理:目标或正文混淆时查看 awiki-cli schema msg send;认证或设置错误需确认当前身份已注册;传输不可用参考 ../awiki-runtime/SKILL.md;请求安全路径时告知用户当前仓库为计划中。实现说明:运行时模式由 runtime 域决定,而非消息命令;msg secure 子命令已预留但未实现;当前仓库状态下不要承诺端到端安全私聊。资料未提供收费、价格、平台等信息。