kxh4892636/pi-deepseek-anchor

pi-deepseek-anchor

English: README.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（全局）或 /.pi/extensions/anchored-standard/index.ts（项目级）。

行为

| | 请求 #1（bootstrap） | 请求 #2+（promote 后） |
| --- | --- | --- |
| 工具目录 | bash + str_replace_editor，与官方 Minimal 预设逐字节一致 | pi 完整工具目录 |
| 系统提示 | You are a helpful software engineer assistant.（46 字符） | persona 保持；被剥离的 pi 上下文以 user message 返回 |
| 输出预算 | adapter 默认（不封顶；bootstrapMaxTokens 为 opt-in） | adapter 默认 |

晋升条件：首次持久信号——首个 assistant message 或首个 tool call，先到者为准（默认 promoteOn: "either"）。状态持久化，/resume 与 reload 不会丢失阶段。

对 pi 的适配

| 上游（dsh preset） | pi 移植 |
| --- | --- |
| Minimal 工具行 | pi.registerTool 覆盖：bash 使用逐字节一致的 Minimal 描述、执行委托给 pi 内置 createBashTool；str_replace_editor 按官方 schema 实现并复刻上游文件语义（view / create / str_replace / insert、16000 字符截断、逐字错误文案） |
| tool-bootstrap pre-step 过滤器 | before_agent_start + before_provider_request：请求 #1 保持 Minimal-exact，晚追加内容（如 pi-memory）在请求 #1 丢弃、promote 后移入 user message |
| persona 行（complete: true） | minimalPersona + personaScope: "always"（默认）：persona 整个会话都是系统提示；被剥离的上下文从请求 #2 起以 user message 重新注入 |
| 持久事件扫描 | 基于 pi 持久 session branch + dsh-anchored-state custom entry 推导阶段 |
| 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 上下文（以 user message 注入）

配置

编辑 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

请按本机 pi 类型定义的实际位置调整 tsconfig.check.json 中的三个 paths。

文件

- package.json — pi 包 manifest
- index.ts — pi 扩展本体（单文件、零运行时依赖）
- README.md — 英文文档
- tsconfig.check.json — 类型检查配置
- LICENSE — MIT（保留上游版权声明）
- NOTICE — 上游衍生说明

许可证

MIT。index.ts 是对 MIT 许可的上游 preset 的移植，原始版权声明已保留。

上游项目

本项目是 xiaobright/dsh-anchored-standard 的 pi 移植，README 与方法论均以该上游为基准：

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