返回目录

pi2dsh

编辑精选维护状态: 活跃

weijiafu14/pi2dsh

Bridge the Pi and DeepSeek Harness ecosystems: one Pi Host ABI runs unmodified Pi extensions as native DSH plugins. 打通 Pi 与 DSH 生态。

前往 GitHub
$ dsh plugin --profile web add pi2dsh

185

星标

32

Fork

TypeScript

语言

MIT

许可证

2026-08-13

创建于

2026-08-30

最近推送

原生 DSH 兼容层,通过一个桥接把未修改的 Pi 生态插件当作 DSH 插件运行。通过 `dsh plugin --profile web add pi2dsh` 安装;重启 dsh 以挂载。需要 Node.js 22.19+。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-23

许可证

MIT

01它能帮你完成什么?

  • Run Pi ecosystem plugins on DeepSeek Harness, unmodified

    Pi npm packages mounted as native DSH plugins through a single bridge instance (one model directory, one login, one credential store)

    DeepSeek Harness users who want Pi's mature plugin ecosystem (web search, memory, code nav, subagents, vision) without per-package adapters

02如何接入 DeepSeek Harness?

前置条件

  • Node.js 22.19+
  • DeepSeek Harness installed with the `dsh plugin` command

安装步骤

  1. 01

    Run `dsh plugin --profile web add pi2dsh` (and `dsh plugin --profile web add pi-mcp-adapter` for the MCP adapter)

    $ dsh plugin --profile web add pi2dsh

  2. 02

    Restart `dsh` — plugins mount at startup

    $ dsh

验证接入成功

作者未说明

回滚

  • Remove a plugin with `dsh plugin remove <pkg>` before removing the engine; upgrade the engine with `dsh plugin add pi2dsh@latest`. The README gives no explicit full-uninstall command beyond `dsh plugin remove`.

03DSH 适配与能力边界

DSH 适配原生运行时

Native DSH compatibility layer: implements Pi's public extension ABI on top of DSH's native services so unmodified Pi packages run as DSH plugins.

  • Pi → DSH bridge (host + browser)

    Unmodified Pi npm packagesPi plugins surfaced through DSH's tool registry, models/llm config, skills, and user questions

    One ABI gap fixed unlocks every package that hits it; the bridge keeps no per-package special casesTools go to DSH's tool registry; questions go to DSH's user questions — no second bridge-owned implementation of a DSH-native capability
  • MCP adapter (pi-mcp-adapter)

    Host-configured MCP server definitionsFull-screen MCP server manager with stdio/Streamable HTTP/SSE, discovery, proxy tools, resources, prompts

    The Pi adapter's `/pi-mcp` runs beside DSH's native `/mcp`; both stay available
  • Compatibility CLI helpers

    Package names / versions`npx pi2dsh inspect <pkg>@<version>` (pre-upgrade report), `npx pi2dsh matrix --json` (capability matrix), `npx pi2dsh mcp-config` (Pi → DSH MCP entries)

    `npx pi2dsh mcp-config` translates Pi mcpServers config into @deepseek-ai/dsh-mcp-client patch entries; plaintext keys trigger a warning

04适合谁?何时不该用?

适合

  • DeepSeek Harness users who want Pi's mature plugin ecosystem (web search, memory, code nav, subagents, vision) without per-package adapters

不适合

  • pnpm blocks dependency build scripts by default; if an add fails with ERR_PNPM_IGNORED_BUILDS, run `pnpm approve-builds` inside $DSH_HOME/profiles/web or allow them in pnpm-workspace.yaml.
  • Where the bridge must bypass, degrade, or cannot express a Pi capability, it reports a known architectural gap rather than faking success; some Pi capabilities have no safe DSH mapping and are marked unusable with a removal hint.

05兼容性、维护与安全提示

  • Plugins mount only at DSH startup, so you must restart `dsh` after adding pi2dsh or any Pi plugin for it to take effect.
  • pnpm blocks dependency build scripts by default; if an add fails with ERR_PNPM_IGNORED_BUILDS, run `pnpm approve-builds` inside $DSH_HOME/profiles/web or allow them in pnpm-workspace.yaml.
  • Where the bridge must bypass, degrade, or cannot express a Pi capability, it reports a known architectural gap rather than faking success; some Pi capabilities have no safe DSH mapping and are marked unusable with a removal hint.
2026-08-132026-08-22v0.12.4

MIT · 由 facts pack 抓取(README 分支 main)

06常见问题

怎么安装 pi2dsh?

执行 `dsh plugin --profile web add pi2dsh`(想要 MCP 管理器则再加 `dsh plugin --profile web add pi-mcp-adapter`),然后重启 `dsh`。插件在启动时挂载。

需要修改 Pi 插件吗?

不需要。pi2dsh 在 DSH 原生服务之上实现 Pi 的公开扩展 ABI,Pi 包以原样发布方式运行——不分叉、不打补丁、无需逐包适配器。

为什么添加时出现 ERR_PNPM_IGNORED_BUILDS?

pnpm 默认拦截依赖的构建脚本。在 $DSH_HOME/profiles/web 内运行 `pnpm approve-builds`(或在该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下放行这些包),再重新执行添加。

MCP 适配器有什么用?

`pi-mcp-adapter` 提供全屏 MCP 服务器管理器(stdio / Streamable HTTP / SSE、发现、代理工具、资源、提示),作为 `/pi-mcp` 与 DSH 原生的 `/mcp` 并存。

08数据与来源

  • 作者声明github.com13543a929b13…

    pi2dsh is one compatibility layer that implements Pi's public extension ABI on

  • 作者声明github.com13543a929b13…

    dsh plugin --profile web add pi2dsh

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-23。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。