# pi-deepseek-anchor

> English: [README.md](./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 起恢复全量目录，两者在一个会话中兼得。

## 安装

```bash
pi install npm:pi-deepseek-anchor
```

或从 GitHub 安装：

```bash
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（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` 端到端验证：

```text
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`，或运行时通过环境变量覆盖：

```json
{"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`）。

## 类型检查

```bash
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`](https://github.com/xiaobright/dsh-anchored-standard) 的 pi 移植，README 与方法论均以该上游为基准：

- 仓库：https://github.com/xiaobright/dsh-anchored-standard
- README：[English](https://github.com/xiaobright/dsh-anchored-standard/blob/main/README.md) · [中文](https://github.com/xiaobright/dsh-anchored-standard/blob/main/README.zh-CN.md)