SuperAPI AI 工具集

serve

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:把评审页面放到用户面前。一个服务器、一个端口、覆盖每个里程碑。命令接受 stop 或不带参数。

地址:始终为 http://localhost:4399。页面默认打开仍有待回答问题的最新里程碑;若全部已答则打开最新一个;顶部标签可切换到其他里程碑。只把该地址交给用户,不要给命令行、文件路径或运行时算出的端口。

启动:先探测端口是否已有服务器:curl -s --max-time 2 http://localhost:4399/health。若返回 "signature":"product-loop/review" 表示已运行,给出地址,不重复启动(连续执行 /serve 与执行一次等价)。若无响应,从项目根目录以脱离本回合的方式启动:node <skill folder>/review-server/serve.mjs docs 4399,稍等后再探测,成功则给出地址;启动失败要如实说明并展示输出,不要换端口。若返回其他内容,说明 4399 被别的程序占用,指出是什么在应答并停止,不要改到别处启动。

停止:/serve stop 会 POST 到 http://localhost:4399/stop。端口上没有任何程序即表示已停止,应直说而非当作失败。页面上的按钮、终端 ctrl-c 或十五分钟无人访问也会自动停止;打开的页面会持续 ping 以保活,因此重启用 /serve 即可。

服务内容:docs/ 下每个形如 m<n>-<something> 的文件夹为一个里程碑,各自提供决策评审与最终检查页面,尚无页面时对应标签置灰。最终检查标签带有其图纸的状态:服务器读取图纸写入的戳记并与 decisions.md 中的答案比较,一致则标签正常,不一致显示 stale,无戳记则如实说明。过时或未盖章的图纸还会在标签下方列出发生变动的决策,看到该行要报告;重绘属于 /next 而非本技能。评审页面上的选择直接写入该里程碑的 decisions.md,与 /next 和 /status 读取同一文件,不存在第二份副本。

边界:提供服务不等于做工作,不要替用户回答决策、不要补写缺失页面、不要因标签为空而打开功能文档;只交出地址。缺少评审页面的里程碑应报告而非修复,由 /next 构建。若即将给用户 node 命令或文件路径而非地址、因 4399 被占而另起服务器、或打算自行回答决策或撰写评审页面,应停止并询问。