pi-deepseek-web

Pi extension: DeepSeek Search & Fetch tools for real-time web search and page extraction, reusing your existing DeepSeek API key

Packages

Package details

extension

Install pi-deepseek-web from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-deepseek-web
Package
pi-deepseek-web
Version
0.1.0
Published
Oct 20, 2026
Downloads
243/mo · 164/wk
Author
xydarcher
License
MIT
Types
extension
Size
15.5 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/deepseek-web/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-deepseek-web

为 Pi 生态接入 DeepSeek 官方 Search / Fetch API 的扩展：让 agent 具备实时联网搜索与网页正文提取能力。自动复用你已有的 DeepSeek 密钥，无需额外维护任何 key。

提供的资源

资源 用途
deepseek_search 工具 联网搜索，返回标题 / URL / 摘要（最多 10 条，可选附带全文）
deepseek_fetch 工具 对指定 URL 提取干净的可读正文（对 JS 重度页面优于朴素抓取）
/search <查询> 命令 手动发起搜索并以通知展示结果
/deepseek-key 命令 查看当前生效的密钥来源（脱敏显示）

工具的详细行为说明由扩展自身向模型声明，此处不重复。

安装

pi 终端（pi CLI）

# 发布到 npm 之后
pi install npm:pi-deepseek-web

# 开发期：从本地路径安装
pi install ./pi-deepseek-web

验证：pi list 中出现 npm:pi-deepseek-web。重启会话后工具即生效。

PI-Desktop

PI-Desktop 不加载 ~/.pi/agent 下的扩展，需经插件体系导入：

  1. 打开 PI-Desktop 的 插件（Plugins） 页
  2. 点击 「导入 pi 扩展」，选择本包所在目录（如 C:\...\pi-deepseek-web）
  3. 导入成功后以插件形式出现在列表中（ID 形如 imported.pi-deepseek-web），启用即可

注意：PI-Desktop 的模型注册表不提供密钥访问，此时密钥走下文密钥解析顺序的第 2 / 3 级回退。

密钥解析顺序

  1. 宿主模型注册表 — pi CLI 中即你为 DeepSeek 聊天模型配置的那个 key
  2. 环境变量 DEEPSEEK_API_KEY — 面向 headless / CI 场景
  3. 本地凭据文件 ~/.pi/agent/auth.json 中的 deepseek.key — pi CLI 登录时落盘的同一份密钥，供 PI-Desktop 等无法访问注册表的宿主使用

本扩展只读不写这份文件，也不把密钥包含在任何输出或日志中（/deepseek-key 仅显示 前5位…后4位）。

费用与限流（DeepSeek 官方口径）

  • 计费：Search ¥5 / 千次成功请求；Fetch ¥5 / 千次成功请求（失败不计费）
  • 限流：各接口 5 QPS
  • 本扩展对 429 / 5xx / 网络抖动做指数退避重试（最多 3 次），401 不重试
  • 输出截断保护：搜索总量 ≤ 24k 字符（单条 ≤ 3k），抓取 ≤ 20k 字符，防止撑爆上下文

开发与发布

唯一源文件：extensions/deepseek-web/index.ts，由宿主的 jiti 加载器直接执行，无构建步骤。

# 类型检查（需本地安装 pi 系列包作为 devDependency）
npx tsc --noEmit

# 打包预览（核对 tarball 内容）
npm pack --dry-run

# 发布
npm publish