锚定启动器 kxh4892636/pi-deepseek-anchor

pi-deepseek-anchor

中文说明：README.zh-CN.md

pi-deepseek-anchor 让满血版 DeepSeek V4 Pro 在 pi 里满血运行，效果提升明显（Project2：91–92 → 98–99）。

原因 DeepSeek V4 Pro 会根据 API 可见的工具目录选择轨迹。用默认的完整目录时，第一条回复通常以「Let me...」开头，走 Standard 轨迹（Project2：91–92）。换成官方 Minimal 组合（bash + str_replace_editor）后，第一条回复以「We need...」开头，let me 出现次数为零（Project2：98–99）。一直用 Minimal 会丢掉完整工具集。这个扩展只对第 1 次请求套用 Minimal，从第 2 次请求起恢复完整目录，这样一次会话里两者都保住了。

安装

pi install npm:pi-deepseek-anchor

或者从 GitHub 安装：

pi install git:github.com/kxh4892636/pi-deepseek-anchor@v1.0.0

然后 /reload 或重启 pi。满血版 DeepSeek V4 Pro 官方发布版可用。

手动兜底：把 index.ts 复制到 ~/.pi/agent/extensions/anchored-standard/index.ts（全局）或 <project>/.pi/extensions/anchored-standard/index.ts（项目本地）。

行为

| | 第 1 次请求（引导） | 第 2 次请求起（提升后） |
| 工具 | bash + str_replace_editor，与官方 Minimal 预设逐字节一致 | pi 完整工具目录 |
| 系统提示词 | You are a helpful software engineer assistant.（46 字符） | persona 保留；剥离的 pi 上下文以用户消息形式返回 |
| 输出预算 | 适配器默认值（不设上限；bootstrapMaxTokens 需手动开启） | 适配器默认值 |

提升在第一个持久信号出现时触发：第一条助手消息或第一次工具调用，谁先到算谁（默认 promoteOn: "either"）。状态是持久的，所以 /resume 和重新加载都会保留当前阶段。

pi 适配

| 上游（dsh 预设） | pi 移植 |
| Minimal 工具行 | pi.registerTool 覆盖：bash 用逐字节一致的 Minimal 描述，并委托给 pi 内置的 createBashTool；str_replace_editor 实现官方 schema 和上游文件系统语义（view / create / str_replace / insert，16000 字符截断，精确的错误消息） |
| tool-bootstrap 前置步骤过滤 | before_agent_start + before_provider_request：第 1 次请求严格 Minimal；后追加的内容（如 pi-memory）在第 1 次请求时丢弃，提升后移到用户消息里 |
| Persona 行（complete: true） | minimalPersona + personaScope: "always"（默认）：persona 在整个会话里始终是系统提示词；剥离的上下文从第 2 次请求起以用户消息形式重新投递 |
| 持久事件扫描 | 阶段由 pi 的持久会话分支加上 dsh-anchored-state 自定义条目推导 |
| Zero-Anchored Standard 模式 | PI_DSH_ANCHOR_CONFIG 里的 zeroAnchor: true |

验证

用官方 deepseek-v4-pro、reasoningEffort=max、--mode rpc 做端到端验证：

REQ#1：tools=[bash, str_replace_editor]
system='You are a helpful software engineer assistant.'（46 字符）
首次思考："We need answer briefly about repository. Need inspect. Use tools." REQ#2：完整工具目录 + 常规 pi 上下文（以用户消息形式投递）

配置

编辑 index.ts 里的 DEFAULT_CONFIG，或在运行时覆盖：

{"promoteOn": "tool-call", "bootstrapMaxTokens": 1024, "personaScope": "always"}

配置项：bootstrapTools（默认 ["bash","str_replace_editor"]）、promoteOn（either | tool-call | assistant-message）、bootstrapMaxTokens（可选；不设置 = 不限制）、minimalPersona（默认 true）、personaScope（always | bootstrap，默认 always）、personaText、stripContext、zeroAnchor（默认 false）、zeroAnchorText、editorMaxOutputChars（默认 16000）。

验证与调试

- /dsh-anchor 打印当前阶段；/dsh-anchor promote 立即提升；/dsh-anchor on|off 为会话重新启用/禁用 bootstrap。
- 提升之前，TUI 页脚显示 bootstrap: bash/str_replace_editor。
- PI_DSH_ANCHOR_DEBUG=1 会把组装好的 payload 转储到 PI_DSH_ANCHOR_DEBUG_FILE（默认 /tmp/dsh-anchor-debug.jsonl）。

类型检查

npx tsc -p tsconfig.check.json

把 tsconfig.check.json 里的三个 paths 条目改成已安装的 pi 类型定义位置。

文件

- package.json — pi 包清单
- index.ts — pi 扩展（单文件，零运行时依赖）
- README.zh-CN.md — 中文文档
- tsconfig.check.json — 类型检查配置
- LICENSE — MIT，含上游版权声明
- NOTICE — 上游衍生说明

许可证

MIT。index.ts 是 MIT 许可上游预设的移植版；原始版权声明已保留。

上游

本项目是 xiaobright/dsh-anchored-standard 的 pi 移植版。上游 README 与方法论是本次移植的基础：

- 仓库：https://github.com/xiaobright/dsh-anchored-standard
- README：English ·