From e36aec5843f56c47e9779e9aa6b00568050486b2 Mon Sep 17 00:00:00 2001 From: pikastech Date: Sun, 19 Jul 2026 18:38:33 +0200 Subject: [PATCH] docs: document native restart workflow --- .agents/skills/unidesk-sub2api/SKILL.md | 6 ++++++ .../PJ2026-01/specs/PJ2026-01050205-superapi.md | 2 +- 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/.agents/skills/unidesk-sub2api/SKILL.md b/.agents/skills/unidesk-sub2api/SKILL.md index fd7647c3..f118b190 100644 --- a/.agents/skills/unidesk-sub2api/SKILL.md +++ b/.agents/skills/unidesk-sub2api/SKILL.md @@ -111,6 +111,12 @@ bun scripts/cli.ts web-probe product-smoke \ ``` - `management l0-smoke` 一次覆盖 PostgreSQL、skill CRUD、API Key 单向保存、绑定启停、绑定级强制全文、历史导入和快照。 +- 修改 Native 组件后统一使用 + `native restart --component `： + - 命令按 YAML `runtime.native.stopTimeoutMs` 等待旧 PID 和固定端口释放； + - 启动后按 `runtime.native.startTimeoutMs` 等待组件恢复 `ready`； + - 禁止再手工紧接 `stop` 与 `start`，也不因退出延迟改用临时端口； + - 重启返回后只需一次 `native status` 完成就绪验收。 - 绑定级强制全文必须满足： - `forceEnabled` 默认关闭，并与普通 `enabled` 分别保存； - 关闭时保持 `name + description + SKILL.md URL` 注入； diff --git a/project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md b/project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md index 00f6f724..0787c8d8 100644 --- a/project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md +++ b/project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md @@ -254,7 +254,7 @@ owning YAML 应声明： - PostgreSQL configRef 与 Secret sourceRef； - Temporal serviceRef、namespace、task queue、超时和重试； -- gateway、API、worker 与 Web 的 native entrypoint、固定端口、PID、日志和状态目录； +- gateway、API、worker 与 Web 的 native entrypoint、固定端口、PID、日志、状态目录、停止等待上限和启动就绪等待上限； - 管理 API 的同源路径； - Web 固定 HTTPS origin； - gateway 快照路径与刷新策略；