# Quick start

一个端到端的最小上手路径：本机两个 dsh 会话之间互发消息。跨机器配置见
[README](../README.md#configuration) 的 `remote` 一节。

## 前置

- 一个 DeepSeek Harness 源码 checkout（下称 `$HARNESS_ROOT`）
- `DEEPSEEK_API_KEY`（真实模型）
- 本插件已安装进 harness（见 [README Installation](../README.md#installation)）

## Web 界面（推荐：人类真实使用方式）

启动带插件的 web server：

```sh
cd "$HARNESS_ROOT"
DEEPSEEK_API_KEY=... node --import tsx/esm apps/cli/src/bin.ts \
  --profile web \
  --patch <plugin>/cordis.patch.yml \
  --no-open --port 0
```

启动成功后终端会打印 `dsh web: http://127.0.0.1:<port>`。

浏览器打开该地址：

1. 左侧边栏点两次「New Session / 新会话」，创建两个会话。
2. 在其中一个会话里用自然语言说：「帮我看看当前还有哪些其他会话，给其中一个发条消息：你好」。
3. 模型会自己调用 `cross_session_list_agents` 发现对端，再调用 `cross_session_send_message` 发送。
4. 切到另一个会话，可以看到它以 `form: 'relay'` 收到了这条消息。

这就是插件的工作方式：模型主动发起跨会话，传输对双方无感。

## headless 快速验证

命令行一次性验证（非交互）见 `tests/e2e/acp-e2e.mjs` 与 [testing](testing.md)。

## 跨机器

点对点、静态配置。接收方配 `remote.listen`，发起方配 `remote.peers`，双方约定
`host` / `port` / `secret` 以及 `tlsCa` 或 `tlsFingerprint`。完整字段见
[README Configuration](../README.md#configuration)。