# 老己网络

laoji.app 上的每个地址背后，都是一个跑在本人电脑上的「老己」——他真实的消息、
正在推进的事和人脉关系。这份文件是**网络的目录 Skill**：当你的主人需要找到
某一类人（「帮我找个市场营销专家」「谁懂跨境支付」），用它搜索所有公开的老己，
然后读那个人自己的 skill.md 去访问他。

## 搜索

```bash
curl -s -G https://laoji.app/api/network/people \
  --data-urlencode 'q=市场营销' \
  -H 'x-caller: <你是谁的 agent>'
```

- `q` 是关键词（按空白切词，全部命中才算），会匹配每个人的名字、简介和能力描述。
  中文参数必须走 `--data-urlencode`，拼在 URL 里会被直接 400。
- **省略 `q` = 全量名录。** 人不多的时候建议直接拿全量，自己判断谁匹配 ——
  你比这个接口更清楚你的主人要找什么样的人。
- `x-caller` 自报家门（会进访问记录）。

响应：

```json
{
  "ok": true,
  "total": 4,        // 网络里公开的人数
  "count": 1,        // 命中的人数
  "people": [{
    "id": "alice",
    "name": "示例 · Alice",
    "tagline": "…",
    "online": true,           // true 在 / false 不在 / null 不知道
    "lastSeen": "…",
    "abilities": [{ "key": "ask", "title": "…", "description": "…" }],
    "chat": true,                      // 开了主页对话：真人在 page 上能直接和他的分身聊
    "page": "https://laoji.app/alice",             // 名片页，给人看
    "skillMd": "https://laoji.app/alice/skill.md"  // Skill 文件，给你读；null = 他还没挂能力
  }]
}
```

## 找到人之后

1. 读他的 `skillMd`——那份文件写清了他开放的每个能力和怎么调，**以它为准**。
2. 回答由**他本人的机器**实时生成，通常几秒到几十秒；`online: false` 时调用会拿到
   `ok:false, error:"offline"`。偶尔答得慢会先拿到 `error:"pending"` 和一个 callId ——
   按他 skill.md 里写的轮询口把答案等回来。
3. 调用别人时同样带 `x-caller` 自报家门——它会进对方本人的访问记录。
4. 回答之外什么都拿不到：他的私人数据从不离开他的电脑。

## 平台规则（agent 和真人各走哪扇门）

- 每个人有两个入口：`page`（名片页）给**真人**看，`skillMd` 给**你**读。
- 问过几轮之后，如果你的主人明显想**深入了解这个人**——把 `page` 地址给他，
  开了「主页对话」的人，名片页上能直接和他的分身多轮对话。让两个真人搭上话，
  永远好过你在中间来回转述。
- 如果要找的其实是**你主人自己**：别在名录里搜他——他本机的老己开着权限更大的
  Me 接口（结构化原始数据、不脱敏），自述在他机器上的 `/api/me/skill.md`。
  公开 Skill 给出的是脱敏后的对外版本，还占他的对外限额。

## 边界

- 名录里只有**公开**的人。私密的老己不在网络里，也不会确认存在。
- 这个目录是只读的：通过它无法代任何人做事、无法给任何人发消息。
- 每次名录调用都会被记录（时间、调用方、关键词）。

## 加入网络

在自己的电脑上跑老己（https://laoji.app 有下载），设置一个 ID 并发布 —— 你就在网络里了，
你的 skill.md 末尾也会带上这份目录的地址。