---
title: Host 快速开始
description: 组合 Support Desk、启动已连接的本地环境，并检查精确状态。
---

本快速开始完整使用公开 Lenso 生命周期：创建唯一应用组合，在本地启动 Host、
Provider Service 与独立 Console，再连接精确拓扑并检查每个对象的直接状态。

## 前置条件

- Rust 与 Cargo
- Support Desk Provider 使用的 Node.js 与 pnpm
- 用于本地 Postgres 的 Docker
- `LioRael/lenso-console` checkout
- 能持续运行本地进程的终端

## 安装 CLI

安装任意一个提供 `lenso` 命令的软件包：

```sh
cargo install lenso-cli
# 或
npm install -g @lenso/cli
```

继续前确认版本：

```sh
lenso --version
```

## 1. Compose（组合）

```sh
lenso app compose ./support-desk --blueprint support-desk --apply
cd support-desk
```

Bare Blueprint 选择 `auth`、`notification-worker` 与 `support-api`。Pack-backed
Support Ticket 与 Story 组合由独立的[产品级验收](/docs/zh/examples)覆盖；该
Runner 还会在本地启动前注册 Service-backed Provider。

检查 `lenso.app.json`。它是精确的应用组合与锁：应用修订与内容摘要、不可变
Module Release 选择、已解析依赖、Implementation Binding 与 Provenance 必须
一致，System 才能启动。

## 2. Run locally（本地运行）

```sh
lenso dev up --console-root ../lenso-console
```

首次运行会安全提示输入本地 Console Operator 密码。自动化场景可通过
`--operator-password-file` 传入私有普通文件。

该命令已经发布：它会启动生成的 Host 与 `lenso.workspace.json` 中每个
auto-start Entry，准备并迁移本地 Host 与 Console Store，构建 Console，配置或
复用持久 Operator，协调 Module-owned UI Artifact，并连接精确拓扑。它把本地
连接材料写入 `.lenso/`；凭据与签名材料不会输出。

保持命令运行。按 Ctrl-C 只停止本次调用启动的 Host、Console 与 Service。

`lenso system dev` 仍是更底层的 System Sandbox 命令：

```sh
lenso system dev --system-file lenso.app.json --dry-run --json
lenso system dev --system-file lenso.app.json
lenso system dev --system-file lenso.app.json --cleanup
```

Sandbox 校验并运行其声明的 Sandbox Workload 与 Local Control Adapter，不能
替代上面的 Host、Provider 与 Console 已连接路径。

已连接命令面向已经组合的 Host 与现有 Console checkout。它本身不宣称已经
完成 [Lenso issue #540](https://github.com/LioRael/lenso/issues/540) 跟踪的更广泛
空目录浏览器验收。

## 3. Connect（连接）

使用 `--console-root` 时，`lenso dev up` 会创建只限 loopback 的已签名
Enrollment Receipt，组装 `.lenso/console-connect.json`，并通过公开连接入口
应用该精确 Bundle，最后才报告 System ready。

如需应用单独准备的本地 Bundle，请使用同一个幂等入口：

```sh
LENSO_CONSOLE_TOKEN='<operator-session-token>' \
  lenso console connect \
  --console-url http://127.0.0.1:3030 \
  --bundle .lenso/console-connect.json
```

非交互运行请通过 `--token-file` 使用私有普通文件。本地 Enrollment Path 只接受
loopback 目标，不是远程生产自助路径。CLI 自有
`lenso-local-control-adapter` 以 `workload-control:<system>` 绑定，不使用业务
Enrollment；其余每个拓扑 Service 都必须具备 active signed Enrollment。Bundle
绑定这些 Receipt、可选 Console Composition Effect、精确 `lenso.system.v2`
拓扑及其内容摘要与 Management Binding。浏览器代码不会获得 Service 或
Adapter 凭据。Console 只存储连接，不启动、部署、接管或修复应用。

## 4. Status（状态）

打开 Console 并选择 **Services**，或调用：

```text
GET /api/console/v1/system
```

System、Service、Module、Surface 与 Adapter Projection 分别报告连接状态与
原因：`connected`、`unavailable`、`incompatible` 或 `unmanaged`。Workload
Operational State 是独立维度。

对于本地受控 Workload，可执行受支持的 Suspend/Resume 或 Stop/Start 操作。
Console 返回异步 Operation Record，并轮询 Adapter 直到终态。Adapter 无法访问
时，Workload Observation 为 `unknown`，变更会立即被拒绝。

## 添加业务能力

无论 Module 链接到 Host，还是由 Service 提供，它都保持业务身份。先阅读
[Module 开发](/docs/zh/module-authoring)，再根据运维流程的需要，公开强类型
Business API 与回执绑定的 Console Surface。

TypeScript `@lenso/service-kit` 支持 Provider tier。其 `lenso.service.v1`
Manifest 携带兼容性与本地进程 Metadata；精确 Module Release 通过
`/lenso/provider/v1` 上锁定的 `lenso.provider.v1` Runtime 安装和调用。
Autonomous Service tier 使用 Rust。准确边界参见
[Service Capability Tiers](/docs/zh/autonomous-services)。

## 下一步

- [产品蓝图](/docs/zh/product-blueprints)说明应用组合锁。
- [Lenso Console](/docs/zh/runtime-console)说明连接、状态、Surface 和 Workload Control。
- [示例](/docs/zh/examples)说明 Support Desk 黑盒验收。
- [CLI 参考](/docs/zh/cli-reference)列出当前公开入口。