MeshLink 服务发布

通过 meshlink CLI 一键将本地服务安全发布到集团内网，支持端口检测和服务名管理，需用户确认后执行。

MeshLink 服务发布 Skill

使用 meshlink CLI 将服务发布到集团内网 Mesh

---

你拥有的能力

meshlink CLI 已安装，可直接用 Bash 执行：

meshlink <command> [flags]

所有命令输出 JSON 到 stdout，ok: true 表示成功，ok: false 包含 error 和 message。

环境变量（需提前设置）：

export ZTM_MESH_NAME=<你的mesh名>   # 例如 "mesh" 或 "company-mesh"

---

发布流程：严格按顺序执行，不得跳步

第 0 步：判断是否触发发布

只有用户明确表达"发布/分享/让某人访问我的服务"时才进入此流程。 询问"如何发布"只需解释，不要执行任何命令。

---

第 1 步：确认端口

• 如果上下文中端口已知且服务已启动 → 直接使用
• 否则询问用户："请告诉我服务运行的端口号"

---

第 2 步：检查 Agent 状态和端口（并行执行）

meshlink agent-status
meshlink check-port --port <port>

情况	处理
agent-status → ok: false 或 connected: false	告知用户 ZTM Agent 未运行，终止流程
check-port → listening: false	"端口 {port} 未检测到服务，需要我帮您启动吗？" 等待用户处理后重试
两者都 ok	继续第 3 步

---

第 3 步：生成服务名

规则：项目名 → kebab-case 英文（全小写，只含字母/数字/连字符）

示例：

• "客户反馈系统" → customer-feedback
• "AI 数据看板" → ai-dashboard
• "设计规范工具" → design-spec-tool

如果不确定，提供 2-3 个候选让用户选择，不要强行猜测。

---

第 4 步：展示发布预览（必须，绝对不可跳过）

在用户确认前，绝对不能执行 meshlink publish。

📋 发布预览
─────────────────────────────────────
服务名称  {service_name}
访问地址  http://127.0.0.1:{分配端口}（发布后本地可访问）
来源端口  :{port}（已检测到 {process_hint}）
发布范围  当前仅自己可访问（Phase 0 模式）
─────────────────────────────────────
确认发布？[y/n]

等待用户明确确认后再执行。

---

第 5 步：执行发布

用户确认后：

meshlink publish --name <service_name> --port <port>

解析输出：

• ok: true → 继续第 6 步
• ok: false, error: "NAME_CONFLICT" → 用 suggestion 字段的备选名询问用户，重试
• ok: false, error: "AGENT_ERROR" → "ZTM Agent 异常，请检查后重试"
• 其他失败 → 展示 message，告知用户无需额外操作（无脏数据）

---

第 6 步：输出发布结果

✅ 发布成功！

访问地址：http://127.0.0.1:{inbound_port}
服务名称：{name}
来源端口：:{target_port}

当前仅您自己可访问。需要分享给更多同事吗？（下一阶段功能）

---

其他命令使用时机

用户意图	执行命令
"我发布了哪些服务"	meshlink list
"帮我下线 {name}"	meshlink unpublish --name {name}
"ZTM 连接正常吗"	meshlink agent-status

---

你不能做的事

• 在用户确认前执行 meshlink publish
• 跳过 check-port 检查直接发布
• 自行构造 curl localhost:7777/...（用 meshlink CLI，不要绕过它）
• 修改其他用户的服务