用途:awiki-runtime 是 awiki-cli 的运行时技能,用于查看运行时模式、在 http 与 websocket 之间切换、控制实时监听器,并理解当前的心跳契约与限制。使用前需先阅读 ../awiki-shared/SKILL.md。
主要能力:已实现 runtime status、runtime setup、runtime mode get/set、runtime listener status/start/stop/restart。listener install 目前复用 start 路径,uninstall 复用 stop 路径,不应把它们当作完整的服务管理流程。runtime heartbeat status/install/run-once 已规划但尚未实现。
核心概念:runtime mode 是仅在 runtime 域暴露的传输选择;listener 是 websocket 侧长期运行进程;daemon bridge 是 websocket 模式使用的本地进程边界;heartbeat 是契约中保留的定时可靠性路径,尚未实现。业务命令不应直接选择传输方式。
常用命令:awiki-cli runtime status;awiki-cli runtime setup --mode http|websocket;awiki-cli runtime mode get;awiki-cli runtime mode set <http|websocket>;awiki-cli runtime listener status/start/stop/restart。启动 websocket 模式可先执行 awiki-cli runtime status,再执行 awiki-cli runtime setup --mode websocket --dry-run 与正式 setup,然后执行 listener start --dry-run、listener start、listener status。
副作用与确认:runtime setup 会写入配置并初始化运行时前置条件;runtime mode set 改变传输行为;listener install 当前委托给 start;listener start/stop/restart/uninstall 会变更监听器服务状态,以上均需显式确认。runtime.listener.run 为内部前台运行器,仅内部使用。
排错:模式不清时查看 awiki-cli schema runtime mode set;监听器状态不清时执行 awiki-cli runtime listener status;配置或路径问题执行 awiki-cli config show;更广泛运行时故障执行 awiki-cli doctor。若收到 transport-unavailable 错误,可检查监听器状态或切回 http。
限制:当前仓库未实现心跳自动化;install/uninstall 语义比名称更窄,仅为 start/stop 别名;隐藏的 runtime listener run 不是面向用户的工作流。参考资料:docs/architecture/awiki-v2-architecture.md、docs/architecture/awiki-command-v2.md。