pi-cordis 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

pi-cordis 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

pi-cordis 有中文文档吗？

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

pi-cordis 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/8/21。

Pi 控制面 civaapple-alt/pi-cordis

DeepSeek 客户端

civaapple-alt74 天前有提交已提供中文文档扫描：含敏感能力兼容 / 相关生态

在 GitHub 查看 ↗

为终端编程智能体挂载可逆的策略与能力组合

26.4/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

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

相关生态插件（非 dsh 原生，按其对应运行时安装）

git clone https://github.com/civaapple-alt/pi-cordis.git

状态速览

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

信任档位：待复验

是什么

生态应用

桌面端 / Web 外壳，不以 dsh plugin add 安装

装得上吗

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

L4 · 真实安装等级说明 →

安全吗

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

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

还在维护吗

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

档位由哪些信号合成

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

验证判据与等级说明 →

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

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

v2.7.0

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

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

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

可执行外部命令读写/删除本地文件

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

执行外部命令来自配置/变量
bin/picds.js:10
const child = spawn(process.execPath, [tsxPath, cliTsPath, ...process.argv.slice(2)], {
读取本地文件
packages/core/src/cli.ts:16
fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"),

扫描于 2026/11/2（1 天前） · 范围入口闭包 + 全包扫描 · 来源 GitHub 仓库

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

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/cosmokit@deepseek-ai/schemastery

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

用户评分

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

广告精选好物

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

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

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

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

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

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

查 MCP 兼容性→

功能亮点

可逆策略与能力组合
一切皆插件架构
兼容Pi与插件市场

🥧 开发者优先的终端编码智能体，基于 Cordis（v4.0.1）微内核重写，奉行「一切皆插件」架构。100% 兼容 Pi，插件市场通用。

README

由 DeepSeek 最新模型翻译生成

Pi-Cordis Pi-Cordis 是 Pi 终端编程智能体之上的轻量 Cordis 控制面。它把 Pi 的 TUI、Agent Loop、模型适配、会话和基础工具保留为数据面，只在外围增加可逆的策略与组合接缝。 English · 架构决策 · 插件指南生态位 Pi-Cordis Profiles / Plugins 场景策略与能力组合 Pi-Cordis Cordis Control Plane 生命周期、事件、工具可见性、拦截 Pi Coding Agent TUI、提示词、会话、编程 Agent Loop Pi Agent Core 模型适配与工具执行原语 - Pi 仍是产品数据面。Pi-Cordis 不 Fork、不重写它的终端界面和智能体循环。 - Cordis 提供 IoC 容器、作用域 Fiber、类型事件与可逆 Effect。项目直接消费公开的 @deepseek-ai/cordis，不再内置源码。 - DeepSeek Harness（DSH）是架构思想来源，而不是运行时依赖。Pi-Cordis 吸收能力接缝、显式注入、作用域组合和副作用可逆等原则，但不引入 DSH 的完整应用栈。因此，Pi-Cordis 的本质不是“另一个 Pi”或“小型 DSH”，而是为 Pi 提供运行时策略与场景组合的薄控制面。设计准则 1. 数据面留在上游。

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

Pi-Cordis

Pi-Cordis 是 Pi 终端编程智能体之上的轻量 Cordis 控制面。它把 Pi 的 TUI、Agent Loop、模型适配、会话和基础工具保留为数据面，只在外围增加可逆的策略与组合接缝。

English · 架构决策 · 插件指南

生态位

Pi-Cordis Profiles / Plugins 场景策略与能力组合 Pi-Cordis Cordis Control Plane 生命周期、事件、工具可见性、拦截 Pi Coding Agent TUI、提示词、会话、编程 Agent Loop Pi Agent Core 模型适配与工具执行原语

- Pi 仍是产品数据面。Pi-Cordis 不 Fork、不重写它的终端界面和智能体循环。
- Cordis 提供 IoC 容器、作用域 Fiber、类型事件与可逆 Effect。项目直接消费公开的 @deepseek-ai/cordis，不再内置源码。
- DeepSeek Harness（DSH） 是架构思想来源，而不是运行时依赖。Pi-Cordis 吸收能力接缝、显式注入、作用域组合和副作用可逆等原则，但不引入 DSH 的完整应用栈。

因此，Pi-Cordis 的本质不是“另一个 Pi”或“小型 DSH”，而是为 Pi 提供运行时策略与场景组合的薄控制面。

设计准则

1. 数据面留在上游。 模型通信、编程循环、TUI 渲染和基础工具由 Pi 负责。
2. 注册即副作用，副作用必须可逆。 工具、命令、过滤器、提示词和监听器都返回 Disposer，并归属 Cordis Fiber。
3. Profile 只改变能力面，不改变产品身份。 切换时销毁上一 Profile 的精确 Fiber，并同步 Pi 可见工具。
4. 安全拦截必须串行。 包括 PTC 内部调用在内，所有工具执行都经过同一条 Cordis 安全管线。
5. 未实现的能力不得伪装成功。 Subagent、SSH 和 Compaction 原型已私有化，并从可发布 Profile 依赖图移除。
6. 从用户审阅时刻反推设计。 审批前可阅读完整产物，取消会终止工作流，危险变更需要可见确认，失败与降级始终明确呈现。

Profile 与 Plan 状态

default

默认 Profile 保留 Pi 的普通工具呈现，并挂载八项已核验增强：safety-gate、git-guard、rules-injector、todo-tracker、output-truncator、ask-question、btw 与 terminal-notifier。

ptc

PTC Profile 增加 code-mode，通过动态 pi SDK 与 run_code 呈现底层工具。Worker 只提供超时与故障隔离，不是权限沙箱；内部调用仍经过 Cordis 拦截。

Plan

Plan 是每 Session 协作状态，不是 Profile。根作用域稳定挂载的 plan-mode 插件在两个 Profile 中都提供 /plan、/plan <请求>、/plan off 与 exit_plan_mode。/plan <请求> 会进入 Plan，并立即在只读策略下提交该文本。进入或退出 Plan 不装卸插件，也不改变工具 Schema；激活期间的规划规则与修改护栏同时覆盖普通调用和 PTC 内部调用。

从源码启动

要求 Node.js 22.19 或更高版本，以及 pnpm。

pnpm install
pnpm picds
pnpm picds --plan
pnpm picds --profile ptc

命令名仅为 picds 和 picordis，不会抢占 pi。全局用户数据位于 ~/.picds/agent/。Pi-Cordis 控制面文件（Profile 与 Spill 输出）使用 .picds/，只在明确说明处回退 .pi/；Prompt Template 等 Pi 所有的项目资源继续遵循上游 Pi 路径。

包与插件状态

可发布依赖图由 13 个能力插件、@pi-cordis/profiles 和 @pi-cordis/core 组成。每个可发布包都会生成 dist/ ESM JavaScript 与类型声明，声明显式 exports，并通过 publint。

以下原型不会进入发布依赖图：

- plugin-subagent：只创建了会话，没有真正驱动子智能体执行任务；
- plugin-ssh-delegator：返回模拟输出，没有建立 SSH 传输；
- plugin-context-compactor：只广播事件，没有接入 Pi 原生压缩操作。

只有补齐真实驱动、失败语义、生命周期测试和端到端验证后，它们才可以重新公开。

开发与发布门禁

pnpm run check # TypeScript 严格检查
pnpm test # 单元与集成测试
pnpm run build # 为全部工作区生成 ESM 与类型声明
pnpm run publint # 核验打包后的入口与类型
pnpm run pack:check # 在全新临时项目安装全部 tarball 并运行 CLI
pnpm release:check # 上述全部门禁

CI 在 Ubuntu、Windows 和 macOS 的 Node 22.19 上执行 release:check。只有三平台矩阵真实通过，才视为完成跨平台核验。

仓库结构

presets/ default、ptc 能力组合 packages/core/ Cordis 服务、Pi 桥接与 picds CLI packages/plugins/ 原生 Cordis 插件工作区 .agents/notes/ 生效中的架构决策与历史记录 .github/workflows/ 跨平台发布门禁

服务接口文档位于 packages/core/docs/cordis/services。

当前成熟度

仓库已经具备可复现的构建与打包流水线，并完成 Windows 本地 tarball 安装验证。真实模型下的交互式 TUI 行为以及三平台 CI 矩阵仍应以实际运行结果为发布证据，不能由文档预先宣称。

许可证：MIT