---
name: huanxi-lookup
description: "寰汐人员与检索：查人、全局搜索、按标签反查、团队任务看板。当用户说「XX是谁」「搜一下」「有哪些人」「团队在忙什么」时使用。"
---

# 寰汐人员与检索

**前置：先读 `huanxi-shared`。**

本技能主要有两个职责：**把名字解析成 ID** 供其他技能使用，以及**维护缓存**。

---

## 解析 ID

几乎所有写操作都要 ID。顺序是：先读缓存，未命中再调工具，拿到后写回缓存。

```
user_search(q="冯普")            姓名模糊搜 → 拿 id
user_search(ids=[...])           已知 id 批量取详情
module_query(role?)              我参与的模块（带 my_role）
```

> 组织架构树（`org_tree`）已随 M16 身份体系替换下线——公司改用蚁熊通行证，
> 它不提供部门信息。要按「一组人」找人，用 `user_search` 按姓名搜，
> 或到网页后台看用户标签。

`user_search` 结果里标注了 `offboarding`（离职观察期，不宜再派新活）与 `inactive`
（已停用）——把人派给这两类之前先提醒用户。

---

## 全局检索

```
search(q="关键词")   一次返回六组：任务/模块/用户/标签/会议/议题，各组带总数
```

不确定某个东西叫什么、在哪个模块时先用它定位，拿到 id 再调对应的 `*_get`。
比逐个域去 query 快得多。

```
tag_related(tag_id)   按标签反查五个域的关联内容
```

标签是**平级横切索引**，同一个标签可以贴在用户/模块/任务/会议/议题任何一种上。
这个工具回答「打了这个标签的所有东西都有哪些」。

---

## 公告与报告

```
announcement_query(kind?, series_slug?, period_key?, ids?)
```

统一入口，覆盖系统周报、周度复盘、版本发布、运维简报、人工公告。
**只返回你有权看的**——报告按受众分档（全员/管理层/老板/本人），过滤在服务端完成，
查不到某条不代表它不存在。

想看某条内置报告的历次期次，传 `series_slug`；想要具体某期，加 `period_key`。

---

## 团队看板

```
people_board()   按人聚合的跨模块任务负载，**含 0 任务的人**
```

「我团队现在都在忙什么」「谁比较闲」用它，比逐个 `task_query` 高效得多。
含 0 任务的人是有意的——那正是「谁完全没有负载」这个问题的答案。

---

## 缓存维护

本技能负责的三份缓存（详见 `huanxi-shared`）：

| 文件 | 来源 | TTL |
|---|---|---|
| `personal/me.json` | `whoami` | 永久 |
| `personal/users.json` | `user_search` | 24h |
| `personal/my-modules.json` | `module_query` | 24h |

用户说「刷新一下」「组织变了」时，删掉对应文件重新拉取即可。