---
description: 引导配置 Pi DeepSeek Search（web_search）；检查凭证并说明最佳实践入口
argument-hint: "[可选：status|help]"
---

> Pi 包 `@suwenguang/pi-kb`：运行时包根为环境变量 `PI_KB_ROOT`（由 `extensions/kb-root.ts` 注入）。
> 工种子 Agent 通过 **pi-subagents** 派发（已 bundled）；agent 定义见本包 `agents/`。
> 脚本调用示例：`node "$PI_KB_ROOT/scripts/<name>.mjs"`。

## 用户输入

${@:-（未附带参数；结合当前对话上下文执行，缺信息时向用户澄清。）}

---
引导用户完成 **DeepSeek Search** 配置，使会话可用工具 `web_search`。本包已 bundled `pi-deepseek-search`，**无需**再 `pi install npm:pi-deepseek-search`。

细则 SSOT：[kb-deepseek-search.md](../skills/kb-workflow/references/kb-deepseek-search.md)。

## Bootstrap

本命令**豁免**业务仓 bootstrap 门禁（与反馈/进化类类似）：未 `/kb-init` 也可执行。

## 执行步骤

### 1. 探测工具是否已注册

- 若当前会话**已有** `web_search`：告知「已就绪」，简述何时该用（仓外/时效；不替代 CodeGraph/知识库），并指向最佳实践 §3；结束。
- 若**没有** `web_search`：进入步骤 2，**不要**臆造搜索结果。

### 2. 引导配置凭证

按优先级请用户完成**其一**（本步只引导，Agent **禁止**索要或回显完整 API Key）：

1. Pi 执行 `/login` → 选择 **DeepSeek** 完成登录  
2. 或本机：`export DEEPSEEK_API_KEY=sk-...`（申请：https://platform.deepseek.com/api_keys）

可选：`DEEPSEEK_SEARCH_MODEL`（默认 `deepseek-v4-flash`；可改 `deepseek-v4-pro`）。

### 3. 生效

请用户：

```text
/reload
```

或新开会话后，再确认工具列表出现 `web_search`。若仍无：确认已 `pi update`/`pi install … -l` 到含 bundled `pi-deepseek-search` 的版本，并查看扩展是否加载失败。

### 4. 最佳实践摘要（配置成功后口头交代）

1. **分工**：代码 → CodeGraph；业务 → knowledge；仓外/时效 → `web_search`。  
2. **query**：具体（产品+主题+版本/年份）；可 `allowed_domains` 锁官方站。  
3. **引用**：转述必须带 Sources markdown 链接。  
4. **子 Agent**：scribe/inspector/builder 等已允许 `web_search`；派发时写明上述约束。  
5. **失败**：声明「未完成外网核对」，不阻断 CodeGraph 硬门禁。

完整条文读 `skills/kb-workflow/references/kb-deepseek-search.md`。

## 输出结构

1. **状态**：已就绪 / 缺 Key / 需 reload  
2. **用户下一步**：1～3 条可执行动作  
3. **实践入口**：`kb-deepseek-search.md` 路径

始终使用简体中文。