pi-deepseek-anchor

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

pi-deepseek-anchor enables the full-powered DeepSeek V4 Pro to run at full strength in pi, with significantly improved results (Project2: 91–92 → 98–99).

Cause DeepSeek V4 Pro selects its trajectory based on the API-visible tool catalog. With the default full catalog, the first response typically starts with "Let me..." and follows the Standard trajectory (Project2: 91–92). With the official Minimal pair (bash + str_replace_editor), the first response starts with "We need..." and produces zero let me (Project2: 98–99). Staying on Minimal permanently loses the full toolset. This extension applies Minimal only to request #1 and restores the full catalog from request #2, so both are retained in one session.

Install

pi install npm:pi-deepseek-anchor

Or from GitHub:

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

Then /reload or restart pi. Works with the full-powered DeepSeek V4 Pro official release.

Manual fallback: copy index.ts to ~/.pi/agent/extensions/anchored-standard/index.ts (global) or <project>/.pi/extensions/anchored-standard/index.ts (project-local).

Behavior

Promotion fires on the first durable signal: the first assistant message or the first tool call, whichever comes first (promoteOn: "either" default). State is durable, so /resume and reload preserve the phase.

pi adaptation

Verification

End-to-end with official deepseek-v4-pro, reasoningEffort=max, --mode rpc:

REQ#1: tools=[bash, str_replace_editor]
       system='You are a helpful software engineer assistant.' (46 chars)
       first thinking: "We need answer briefly about repository. Need inspect. Use tools."
REQ#2: full tool catalog + normal pi context (delivered as a user message)

Configuration

Edit DEFAULT_CONFIG in index.ts, or override at runtime:

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

Keys: bootstrapTools (default ["bash","str_replace_editor"]), promoteOn (either | tool-call | assistant-message), bootstrapMaxTokens (optional; unset = no cap), minimalPersona (default true), personaScope (always | bootstrap, default always), personaText, stripContext, zeroAnchor (default false), zeroAnchorText, editorMaxOutputChars (default 16000).

Verify & debug

• /dsh-anchor prints the phase; /dsh-anchor promote promotes now; /dsh-anchor on|off re-arms/disables the bootstrap for the session.
• The TUI footer shows bootstrap: bash/str_replace_editor until promotion.
• PI_DSH_ANCHOR_DEBUG=1 dumps assembled payloads to PI_DSH_ANCHOR_DEBUG_FILE (default /tmp/dsh-anchor-debug.jsonl).

Type check

npx tsc -p tsconfig.check.json

Adjust the three paths entries in tsconfig.check.json to the installed pi type-definition locations.

Files

• package.json — pi package manifest
• index.ts — pi extension (single file, zero runtime deps)
• README.zh-CN.md — Chinese documentation
• tsconfig.check.json — type-check config
• LICENSE — MIT, including upstream copyright notices
• NOTICE — upstream derivation notice

License

MIT. index.ts is a port of the MIT-licensed upstream preset; original copyright notices are retained.

Upstream

This project is a pi port of xiaobright/dsh-anchored-standard. The upstream README and methodology are the basis for this port:

• Repository: https://github.com/xiaobright/dsh-anchored-standard
• README: English · 中文