SuperAPI AI 工具集

port-daddy-cli

智能体与模型

查看项目

更新于 10-16 05:04

技能介绍

用途:Port Daddy 用于多智能体开发时的端口分配、会话协调与冲突预防,避免端口碰撞、重复修改文件与上下文丢失。

主要能力:以 project:stack:context 形式的语义身份哈希出稳定端口(如 myapp:api:main 对应固定端口),同一身份每次得到同一端口;提供会话生命周期(开始、笔记、结束)与只追加、不可编辑删除的笔记记录;文件声明为建议性,其他智能体可见冲突并协调;锁用于部署、迁移等临界区,可设 TTL 并自动过期;支持抢救(salvage)中途死亡智能体的会话状态与笔记;另有本地 DNS(实验性)、集成信号、变更日志分级汇总、看板(http://localhost:9876)等。

使用方式:常用命令包括 pd begin "描述" 注册并开始会话、pd note "进度" 记录笔记、pd done 结束并注销;pd claim myapp:api:main 获取端口、pd claim myapp -q 只输出端口号、pd find "myapp:*" 查找服务、pd release 释放;pd session start/note/done 管理会话,pd session files add 声明文件,pd sessions --files 查看;pd lock deployment --owner agent-1 --ttl 300 与 pd unlock 管理锁。MCP 服务默认仅暴露 9 个核心工具,可用 pd_discover 按类别(如 dns)加载更多工具模式,或传 --full / 设 PORT_DADDY_MCP_FULL=1 加载全部 45 个工具。启动开发服务器可写 PORT=$(pd claim myproject:api -q) 后 npm run dev -- --port $PORT。

适用场景:启动任何开发服务器、多文件重构、智能体交接、部署等临界操作、排查“发生了什么”、端口冲突排查。

限制与注意:Tier 1 操作(claim、release、find、lock、unlock、session、note、notes、status)无需守护进程;pub/sub、SSE、webhooks、编排等 Tier 2 功能需守护进程。文件声明仅为建议锁定,不强制。本地 DNS 需 macOS(mDNS/Bonjour)或带 avahi-daemon 的 Linux。守护进程默认运行在 9876 端口。其他收费、平台或更多细节暂未提供。