AI 简明手册DeepSeek Harness 与 Pi：按约束选择，不按功能数量排名
先确定比较问题
DSH 与 Pi 都把能力放到可组合外围，但真源、扩展运行时和安全默认不同：DSH 以 append-only 事件日志与 Cordis 插件树为中心；Pi 以 JSONL 会话树、TypeScript Extension 和外部隔离为中心。
逐项对照
真源与会话结构不同
DSH 把 append-only 事件日志作为可重放真源，并由投影生成界面状态；Pi 把会话保存为 JSONL 树，分支条目带父节点关系，切换分支时从树路径重建当前上下文。两者都避免只保存最终聊天文本。
[repo] [pi-repo]
扩展边界不同
DSH 通过 Cordis 插件树、preset 与运行时装卸组合能力，并强调回滚副作用；Pi Extension 是与进程同权的 TypeScript 模块，可注册工具、命令、事件与 UI，Package 再把扩展、Skill、模板和主题打包分发。
[repo] [pi-repo]
安全取舍不同
DSH 在工具、Guard 和平台隔离层内建更多策略；Pi 官方文档明确默认无审批弹窗与内建沙箱，建议在容器或受控宿主中运行。选择时应比较团队愿意维护的治理层，而不是只比较默认工具数量。
[repo] [pi-repo] [pi-docs]
如何选择
从 DSH 迁移到 Pi，最先要补什么： 先盘点 DSH 原本承担的 Guard、审批、日志投影和隔离能力，再决定哪些由 Pi Extension 实现、哪些必须放到容器或宿主策略中。
从 Pi 迁移到 DSH，最先要改什么： 把 TypeScript Extension 与 Package 的动态行为映射到 DSH 的插件角色、preset 和事件真源，并确认装卸副作用能否回滚。
不可直接类推
对照基于 DeepSeek Harness revision
0a53fb55bea101816fa226bb964ae2bed71c343b与 Pi revision853a80d26c90a14c1886f0ebb8ffaae133ca2185。任一项目升级后，都应重新核对会话、扩展和安全边界。
来源与核验
- [repo] DeepSeek Harness 官方源码（固定 revision）
- [official] DeepSeek Harness 官方介绍
- [pi-repo] Pi 官方源码（固定 revision）
- [pi-docs] Pi 官方文档
Revision：0a53fb55bea101816fa226bb964ae2bed71c343b · 核验日期：2026-08-31