Lifecycle v2 服务发现¶
简述: Lifecycle v2 是一份已接受的编写契约,用于描述服务、服务关系 和安全的用户操作。AgentSeek 将其投影为确定性的 JSON,供 Desktop 和其他 机器消费者使用。
规范性文档以 Desktop Service Discovery and Lifecycle v2 为准。AgentSeek 0.1.0 已实现该契约;AgentSeek 0.0.5 不提供这些编写 v2 和 JSON 行为。
契约范围¶
| 范围 | 提案规定的内容 |
|---|---|
| Lifecycle v2 编写格式 | 精简的服务标识、类型、展示提示、主服务、参考链接,以及显式的关系例外。 |
| 归一化项目模型 | 从相互独立的 lifecycle v1、v2 输入投影得到同一个安全内部模型。 |
agentseek info --json |
确定性的项目、服务、检查、任务、参考链接和操作元数据。 |
agentseek doctor [--live] --json |
带稳定标识和退出行为的类型化静态、实时诊断结果。 |
| 安全边界 | 公共 JSON 不包含命令、机密、环境变量值、不安全路径或不安全端点。 |
| 兼容性 | 现有 v1 项目仍可加载;v1 JSON 保持保守,并明确标记为不完整。 |
模板归属和发布兼容性另见 ADR 0001(英文)。
设计讨论¶
问题和设计历史请记录在 GitHub Discussion #133。 规范性变更必须同步到正式提案,不能只保留在讨论评论中。