dsh-minimal-ptc

Readme

# dsh-minimal-ptc

![npm](https://img.shields.io/npm/v/dsh-minimal-ptc) ![downloads](https://img.shields.io/npm/dm/dsh-minimal-ptc) ![license](https://img.shields.io/github/license/STARDUSTLC666/dsh-minimal-ptc) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-minimal-ptc?style=social)

> 极简提示词 × PTC 全能力 —— 一个更"干净"的编码 Agent。
> 安装即获得新的 Agent 模式：**极简 PTC 模式**；Windows 自动启用 Git Bash 与持久 PowerShell（对齐 dsh-v0.1.2-alpha.4）。

## 卖点

- **对齐 RL 训练**：系统提示词只有一句 `You are a helpful software engineer assistant.`，
  贴近 RL 微调时的简洁指令分布，没有长提示词带来的格式偏置与上下文噪音，
  让模型按训练时的节奏干活。
- **PTC 工具面完整**：提供 `run_code` SDK 多步编排、文件读写与检索、Shell、
  Skills、计划、目标、子代理、Ralph 与网页搜索/抓取；按 alpha.4 默认隐藏通用 workflow 工具。
- **We / Let's 思维链**：PTC SDK 把"想"和"做"装进一个 TypeScript 程序，
  多步操作先编排、再一次执行。这与 DeepSeek 官方跑分环境（Project2 V4.1b）中
  Minimal 高分轨迹一致：99/96 的两跑以 `we` / `let's` 为主，而不是
  Standard/PTC 常见的 `let me` / `I` 长块。
- **Windows 保持 bash**：预设内置 Git Bash executor（自动探测 GIT_BASH → Program Files\Git → LOCALAPPDATA\Git → PATH），`bash` 工具不再在 Windows 上被禁用。
- **Windows 持久 PowerShell**：对齐 `dsh-v0.1.2-alpha.4` 的 minimal 预设，`pwsh` 使用持久 PTY 会话，cwd、变量、函数跨调用保留。

## 兼容性

在 `@deepseek-ai/dsh@0.1.3-alpha.2` 源码模式下验证（2026-09-08；0.4.4 适配 0.1.3 的 persona `text`→`prefix` 字段改名，旧版 dsh 请用 0.4.3）。遵循 cordis 组合包补丁模型（`cordis.patch.yml` + `dsh.bundle.patch`），运行时不 import 任何 `@deepseek-ai/*` 内部模块。

## 安装

1. 把本包加入 web profile（`package.json`）：

   ```json
   "dependencies": { "dsh-minimal-ptc": "^0.4.0" },
   "dsh": { "profile": { "bundles": [..., "dsh-minimal-ptc"] } }
   ```

   本地开发也可以用 link：`"dsh-minimal-ptc": "link:E://deepseek//dsh-minimal-ptc"`。

2. 在 profile 目录执行 `pnpm install`。

3. 重启 web profile 进程：宿主行会把内置预设物化到
   `$DSH_HOME/.agent-presets/ptc-minimal`。

4. 新建会话时选择 **极简 PTC 模式**。

## 卸载

```bash
dsh plugin --profile web remove dsh-minimal-ptc
```

卸载后重启 Web 服务。如需彻底清理，可再手动删除自己 profile `cordis.patch.yml` 中覆盖的插件行。


## Windows Git Bash 配置

预设内置的 Git Bash executor 可在 `agent.cordis.yml` 的 `gitbash-executor` 行覆盖：

| 配置 | 默认 | 说明 |
| :-- | :-- | :-- |
| `shellPath` | 自动探测 | 固定 Git Bash 路径（如 `C:\\Program Files\\Git\\bin\\bash.exe`） |
| `timeoutMs` | 120000 | 单次命令超时（毫秒） |
| `maxTimeoutMs` | 600000 | 请求可要求的最大超时 |
| `maxOutputBytes` | 64000 | 单次输出上限 |
| `maxSpillBytes` | 67108864 | 输出溢出落盘上限 |
| `graceMs` | 3000 | 超时后的宽限时间 |

自动探测顺序：`GIT_BASH` → `Program Files\\Git` → `Program Files (x86)\\Git` → `LOCALAPPDATA\\Programs\\Git` → PATH。

## 目录结构

```
dsh-minimal-ptc/
├── cordis.patch.yml              # 插入宿主行（物化预设）
├── lib/index.js                  # 宿主插件：物化 ptc-minimal 预设到用户预设根目录
└── presets/ptc-minimal/          # 内置 Agent 模式（极简提示词 + PTC 全能力）
    ├── agent.cordis.yml
    ├── gitbash-executor.mjs      # Windows Git Bash 探测与执行器（零依赖）
    └── preset.yml
```

## 说明

- 物化策略：目标目录不存在 → 写入全部文件并留版本标记；版本标记低于当前
  版本 → 刷新；目录存在但无标记（用户自建）→ 不覆盖。
- 升级插件：改 `version` 并同步 `lib/index.js` 里的 `VERSION` 常量即可刷新
  用户根目录里的预设文件。

## 许可证

MIT