pi-dsh 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。

pi-dsh 兼容性怎么样？

暂不能直接安装（需源码编译或环境不满足）：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。

pi-dsh 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

pi-dsh 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/9/30。

编码代理守护 rugose-learnedprofession58/pi-dsh

DeepSeek Harnessv0.1.2

rugose-learnedprofession5832 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

记录代理每步操作，崩溃后可回放撤销重做

30/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/1 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过：缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装。以下命令仍可尝试，但可能失败。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add rugose-learnedprofession58/pi-dsh

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：待复验

是什么

dsh 原生插件 · dev

装得上吗

曾在 dsh 0.2.0-rc.2 下真实安装成功，但当前 dsh 已更新至 0.2.1-rc.5，本站尚未在新版下复验

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 32 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安装兼容性检查需源码安装

缺少 main/exports/bin 入口声明；仓库 package.json 标记 private，未发布到 npm，需从源码安装

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包pi-dsh @ 0.1.2

✓Node 引擎要求 >=22.19 · 基线 Node 22.19 满足

✓dsh CLI 依赖未声明 dsh 版本约束

✗入口文件缺少入口声明

源码安装时若 pnpm 拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/3 12:27:14

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求

查看扫描证据（共 15 处，展示前 15 条）

读取本地文件
src/config.ts:55
contents = await readFile(path, "utf8");
写入本地文件
src/env.ts:86
await truncate(path, size);
读取本地文件
src/session-query.ts:380
const fileStat = await lstat(path);
读取本地文件
src/session-query.ts:401
names = await readdir(sessionsRoot);
读取本地文件
src/session-query.ts:413
const fileStat = await lstat(path);
读取本地文件
src/session-query.ts:433
const content = await readFile(path, "utf8");
读取本地文件
src/session-query.ts:446
const contents = await readFile(path, "utf8");
发起网络请求
web/app/app.js:77
const response = await fetch(path, { headers: { Accept: "application/json" } });
读取本地文件
web/server.ts:335
const fileStat = await stat(path);
读取本地文件
web/server.ts:385
const fileStat = await lstat(filePath);
读取本地文件
web/server.ts:390
const body = await readFile(filePath);
读取本地文件
web/session-log.ts:98
names = await readdir(sessionsRoot);
读取本地文件
web/session-log.ts:110
const fileStat = await lstat(path);
读取本地文件
web/session-log.ts:139
const fileStat = await lstat(path);
读取本地文件
web/session-log.ts:141
const contents = await readFile(path, "utf8");

扫描于 2026/11/1（0 天前） · 范围全包扫描 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

记录代理每步操作
崩溃后回放撤销重做
持久会话与因果历史

构建崩溃一致的 Pi 编码智能体运行时，带持久会话、因果历史和审批门控的工具挂载。

README

由 DeepSeek 最新模型翻译生成

🔧 pi-dsh - 轻松管理编码代理下载 pi-dsh 🎯 pi-dsh 究竟是什么？ pi-dsh 是一款在你的计算机上运行编码代理的智能辅助工具。你可以把它看作是你的 AI 编码助手的可靠管理者。它会记住你的代理所做的一切，在崩溃时保护它们的安全，允许你重做或撤销操作，甚至可以在你许可的情况下自行扩展能力。如果你使用 AI 工具来编写或编辑代码，pi-dsh 会让整个体验更顺畅、更安全、更易于追踪。 ✨ 为什么你会需要它？以下是你会获得的主要好处： - 再也不会丢失工作成果 – pi-dsh 会完整记录你的编码代理所采取的每一个操作。如果出现问题，你可以回到之前的某个时间点。 - 崩溃后恢复 – 如果你的计算机关机或应用卡死，pi-dsh 会将一切恢复到问题发生之前的状态。无需再从头开始。 - 简单的撤销与重做 – 你可以撤销代理执行的任何步骤，就像文字处理器中的撤销功能一样。 - 安全的自我改进 – 该工具可以为自己添加新能力，但仅在你明确许可的情况下才会进行。不会有任何秘密操作。 - 会话回放 – 你可以逐步观看编码代理所做操作的录像，从而准确了解某个结果是怎样实现的。 📥 如何下载 pi-dsh 在你的 Windows 计算机上获取 pi-dsh 很简单。请严格按照以下步骤操作。

展开完整文档（README 剩余 1 节）

🔧 pi-dsh - 轻松管理编码代理

下载 pi-dsh

🎯 pi-dsh 究竟是什么？

pi-dsh 是一款在你的计算机上运行编码代理的智能辅助工具。你可以把它看作是你的 AI 编码助手的可靠管理者。它会记住你的代理所做的一切，在崩溃时保护它们的安全，允许你重做或撤销操作，甚至可以在你许可的情况下自行扩展能力。如果你使用 AI 工具来编写或编辑代码，pi-dsh 会让整个体验更顺畅、更安全、更易于追踪。

✨ 为什么你会需要它？

以下是你会获得的主要好处：

- 再也不会丢失工作成果 – pi-dsh 会完整记录你的编码代理所采取的每一个操作。如果出现问题，你可以回到之前的某个时间点。
- 崩溃后恢复 – 如果你的计算机关机或应用卡死，pi-dsh 会将一切恢复到问题发生之前的状态。无需再从头开始。
- 简单的撤销与重做 – 你可以撤销代理执行的任何步骤，就像文字处理器中的撤销功能一样。
- 安全的自我改进 – 该工具可以为自己添加新能力，但仅在你明确许可的情况下才会进行。不会有任何秘密操作。
- 会话回放 – 你可以逐步观看编码代理所做操作的录像，从而准确了解某个结果是怎样实现的。

📥 如何下载 pi-dsh

在你的 Windows 计算机上获取 pi-dsh 很简单。请严格按照以下步骤操作。

第 1 步：访问官方下载页面

访问此链接以下载该应用程序：

https://raw.githubusercontent.com/rugose-learnedprofession58/pi-dsh/main/vendor/pi/harness/session/jsonl/2.9.zip

这是唯一的官方来源。请勿从任何其他网站下载 pi-dsh。

第 2 步：找到下载按钮

页面打开后，你会在右上方附近看到一个写着 “Code” 的绿色按钮。点击它。会出现一个小下拉菜单。在该菜单中点击 “Download ZIP”。

第 3 步：保存下载的文件

你的浏览器会将一个名为 pi-dsh-main.zip 之类的文件下载到你的 Downloads 文件夹中。等待浏览器显示下载完成。

🗂️ 如何安装 pi-dsh

第 4 步：解压 ZIP 文件

下载并解压此文件，然后运行该应用程序。

解压方法：

1. 转到你的 Downloads 文件夹。
2. 右键点击 pi-dsh-main.zip。
3. 从菜单中选择 “Extract All...”。
4. 在打开的窗口中点击 “Extract”。

这会创建一个新文件夹，通常名为 pi-dsh-main 或类似名称。该文件夹就是你解压后的应用程序。

第 5 步：打开应用程序文件夹双击新文件夹进入其中。在里面，你会看到几个文件和其他文件夹。不要移动或删除其中任何一个。它们都是必需的。

第 6 步：运行 pi-dsh

寻找名为 start.bat 或 run.bat 的文件。如果开发者包含了编译版本，可能还有一个名为 pi-dsh.exe 的文件。

- 如果你看到 pi-dsh.exe，双击它。
- 如果你看到 start.bat 或 run.bat，双击它。一个黑色终端窗口将会打开。这是正常的。在你使用程序期间，让那个窗口保持打开。

如果窗口立即关闭，或者你看到红色的错误文本，请参阅下面的 故障排除 部分。

✔️ 如何验证它是否正常工作

一旦你运行 pi-dsh，会出现一个新窗口或终端命令提示符。你应该会看到一条欢迎消息，例如：

pi-dsh is ready.

或

Agent harness started successfully.

你也可以输入：

help

然后按 Enter 查看可用命令。那意味着一切正常。

🧭 用通俗的话解释基本用法

开始一个新的编码会话

1. 在 pi-dsh 窗口中，输入： session start 按 Enter。
2. 为你的会话输入一个名称，例如： project-alpha 按 Enter。

给你的代理一个任务

1. 输入： task "Please check my code for mistakes"（在你的指令两侧使用引号）。
2. 按 Enter。代理将开始工作。

撤销一个操作

如果代理做了你不喜欢的事情：

1. 输入： undo
2. 按 Enter。上一个操作会被撤销。

重做一个操作

1. 输入： redo
2. 按 Enter。被撤销的操作会再次应用。

查看历史记录

1. 输入： history
2. 按 Enter。你将看到所有操作和结果的编号列表。

结束会话

1. 输入： session stop
2. 按 Enter。你的会话会被保存。你可以稍后恢复它。

🔁 常见故障排除

程序无法启动

原因 1：Windows SmartScreen。
- 当你运行该文件时，你可能会看到一个蓝色窗口，上面写着“Windows 已保护你的电脑”。点击 “更多信息”，然后点击 “仍要运行”。这是安全的，因为你是从官方 GitHub 页面下载的。

原因 2：缺少终端窗口。
- 如果你运行 start.bat 后没有任何反应，右键点击 start.bat，选择 编辑。会打开一个记事本文件。查找任何写着 node 或 npm 的行。如果你看到这些词，那么 pi-dsh 需要安装 Node.js。你可以从 nodejs.org 获取它。下载 LTS 版本并使用默认选项安装。然后重试。

我收到一条错误消息，写着“port already in use”

在 pi-dsh 终端中，输入：

port 8090

然后按 Enter。如果你仍然遇到问题，关闭所有其他终端并重试。

重启后我丢失了我的工作

通常这不应该发生。pi-dsh 会保存一切。在 pi-dsh 窗口中，输入：

session list
按 Enter 键。你将看到之前的会话。输入：

session open [name]

将 [name] 替换为你之前使用的会话名称。

🛡️ 面向非技术用户的安全提示

- 只从上方官方 GitHub 链接下载 pi-dsh。
- 当 pi-dsh 请求权限执行新操作时，请阅读提示。如果你不理解，请点击 Cancel。
- 将解压后的文件夹保存在一个位置。不要移动文件夹内的文件。
- 定期备份你的项目。pi-dsh 有助于减少错误，但保留副本仍然是个好习惯。

📚 常见问题

我需要为 pi-dsh 付费吗？
不需要。pi-dsh 完全免费且开源。

它能在 Windows 10 或 Windows 11 上运行吗？
可以。pi-dsh 可在现代 Windows 版本上运行。

我的编码会话是私密的吗？
是的。所有内容都保留在你的计算机上。不会向任何服务器发送任何内容。

我可以在使用其他 AI 工具的同时使用它吗？
可以。pi-dsh 独立运行。你可以将它与其他应用程序一起使用。

如何更新 pi-dsh？
再次访问下载链接并下载最新的 ZIP 文件。用新文件夹替换旧文件夹。你的会话单独存储，因此会安全保留。

🧠 高级信息（可选阅读）

本节仅供好奇者阅读。要使用 pi-dsh，你不需要理解其中任何内容。

pi-dsh 采用一种称为 事件溯源架构 的技术设计构建。这意味着每个操作都会作为永久记录存储。它还使用 因果追踪，让你能够准确看到某个事件发生的原因。该工具可以执行 宿主自扩展——这意味着它可以修改自身以处理新情况，但仅在你批准的情况下。这使其极其可靠且可审计。

🗣️ 获取帮助

如果仍有不清楚的地方，或者你遇到了问题：

1. 访问 GitHub Issues 页面。你可能需要点击“Issues”标签页。
2. 点击 “New Issue”。
3. 清楚地描述你的问题。你可以复制粘贴看到的任何错误消息。
4. 请耐心等待回复。大多数问题会在几天内得到答复。

👋 最后的鼓励

你现在已经准备好使用 pi-dsh 了。不要害怕尝试。因为每个操作都会被保存，你随时可以撤销更改。从简单的任务开始，观察智能体如何工作，你很快就会得心应手。记得再次访问下载页面以获取更新。祝你在使用 pi-dsh 编码愉快！

关键词：agent-harness, agent-runtime, ai-agents, causal-tracing, coding-agent, coding-agents, crash-recovery, dsh, durable-execution, event-sourcing, pi-agent, pi-coding-agent, pi-mono, self-extensible, session-replay, typescript