@xiaoso/dsh-tool-plus 0.1.9-beta.1 → 0.1.10-beta.1

package/README.en.md

@@ -18,7 +18,7 @@ Essential tools enhancement for DeepSeek Harness: persistent bash, structured re
 - **edit**: `replace` by default, with patch / hashline / apply-patch formats also supported; multi-hunk edits, uniqueness validation, fuzzy matching tolerant of whitespace differences
 - **grep / glob**: full-text search and filename matching; mtime sorting, context lines, and configurable ignore rules
 - **ast_grep / ast_edit** (optional): syntax-tree based structural code search and rewrite, enabled in settings
-- **agent presets**: two companion templates — Standard enhanced and PTC (Code Mode) — **installed automatically with the plugin** (written on first start when missing)
+- **agent presets**: two companion templates — Standard enhanced and PTC (Code Mode)
 
 Settings panel (Bash tab):
 
@@ -30,10 +30,7 @@ Settings panel (Bash tab):
 
 ## Installation
 
-Installing this one plugin is enough:
-
-- **Tool plugin**: provides the full toolset and takes over the official bash / pwsh / file / search tools;
-- **Agent presets**: the official presets contain no configuration for these tools, so the stock setup is missing capabilities — the Standard / PTC templates exist to fill exactly that gap. **Both templates ship with the plugin and are written automatically on first start if they are not present yet**, so there is nothing extra to install.
+- **Agent presets**: two companion templates — Standard enhanced and PTC (Code Mode)
 
 ### Install from npm (recommended)
 
@@ -52,15 +49,25 @@ dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus @xiaoso/dsh-too
 dsh plugin --profile web add link:<path to this repo>
 ```
 
-### Presets: installed automatically with the plugin
+### Presets
+
+| Preset | Base | What it is |
+|---|---|---|
+| **Tool Plus 标准增强版** | official standard | everything in standard mode, with the file/shell toolset swapped for this plugin |
+| **Tool Plus PTC 增强版** | official PTC (Code Mode) | same, but composing multi-step operations through Code Mode's `run_code` |
+
+Both presets are **declared by the plugin**: installing it (as a profile bundle) brings two `@deepseek-ai/dsh-agent-preset` declaration rows along in its patch layer, so they appear in the preset list immediately. There is no install step, and the plugin writes nothing at startup.
+
+**Tool Plus → Presets** in the settings page is where you change them. Since dsh 0.1.7 the official preset page is read-only and the `agent_preset` tool is gone, so this panel is the only graphical entry point:
 
-No extra step is needed. On first start the plugin checks `~/.dsh/.agent-presets/` and writes the bundled templates **only when the directory does not exist** (nothing is touched if it does, so your own edits are never overwritten). Restart dsh and select the preset in your session to activate it.
+- **Minimal update** — disables just the official tool rows still mounted, touching nothing else
+- **Align to template** — replaces this row's whole plugin list with the selected template
+- **Revert to bundled** — removes the override you wrote in the profile configuration (`<profile>/cordis.patch.yml`), falling back to the bundled declaration
+- **View differences** — shows which entries differ before you touch anything
 
-When you already have an older local copy and want it current, use the settings page under **Tool Plus → Presets**:
+Writes go through the harness's own `ctx.configEditor`, so they inherit the profile lock, concurrency protection, atomic write and rollback.
 
-- **Minimal update** — disables only the conflicting tool rows and keeps every other local change;
-- **Reset to compared template** — replaces the whole preset with the selected template, backing up to `agent.cordis.yml.bak-<version>` first;
-- **View differences** — shows exactly which lines differ before you touch anything.
+> Upgrading from 0.1.9 or earlier: `~/.dsh/.agent-presets/` is **read by nothing** any more (0.1.7 moved presets into the patch layer), so it is safe to delete; the panel tells you when it finds one.
 
 ## Configuration
 
@@ -71,7 +78,7 @@ Works out of the box, no configuration needed. Common tweaks: background thresho
 - **dsh CLI**: installed globally, `npm i -g @deepseek-ai/dsh`
 - **Node.js** ≥ 22.19 or ≥ 24
 - **Git Bash** (recommended): serves as the bash execution environment on Windows
-- Targets DeepSeek Harness `dsh` v0.1.5-rc.1 (pre-release; interfaces may change)
+- Targets DeepSeek Harness `dsh` v0.1.7-rc.2 (pre-release; interfaces may change)
 
 ## Notes
 

package/README.md

@@ -18,7 +18,7 @@ DeepSeek Harness 基础工具增强：持久 bash、结构化 read、多模式 e
 - **edit**：replace 默认，另支持 patch / hashline / apply-patch 三种补丁格式；多段编辑、唯一性校验、空白差异模糊匹配
 - **grep / glob**：全文搜索与文件名匹配；mtime 排序、上下文行、忽略规则可配置
 - **ast_grep / ast_edit**（可选）：基于语法树的结构化代码搜索与重写，可在设置中开启
-- **agent 预设**：标准增强版 / PTC（Code Mode）两套配套模板，**随插件自动装好**——首次启动插件时若目录不存在就整份写入
+- **agent 预设**：标准增强版 / PTC（Code Mode）两套配套模板
 
 设置面板（Bash 工具页）：
 
@@ -30,10 +30,7 @@ DeepSeek Harness 基础工具增强：持久 bash、结构化 read、多模式 e
 
 ## 安装
 
-装这一个插件就够了：
-
-- **工具插件**：提供全套工具，自动接管官方 bash / pwsh / 文件 / 搜索工具；
-- **agent 预设**：官方预设里没有这些工具的配置，直接用默认配置会缺能力——标准版 / PTC 两套模板就是来补齐这块的。**这两套模板随插件提供，插件首次启动时若本地还没有就自动写入**，不需要单独安装。
+- **agent 预设**：标准增强版 / PTC（Code Mode）两套配套模板
 
 ### 从 npm 安装（推荐）
 
@@ -52,15 +49,25 @@ dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus @xiaoso/dsh-too
 dsh plugin --profile web add link:<本仓库路径>
 ```
 
-### 预设：随插件自动安装
+### 预设
+
+| 预设 | 底座 | 说明 |
+|---|---|---|
+| **Tool Plus 标准增强版** | 官方 standard | 官方标准模式全部能力 + 文件/Shell 工具集换成本插件 |
+| **Tool Plus PTC 增强版** | 官方 PTC（Code Mode） | 同上，但经 Code Mode 以 `run_code` 组合多步操作 |
+
+两个预设**随插件声明**：安装插件（作为 profile bundle）时，插件的补丁层里就带着两条 `@deepseek-ai/dsh-agent-preset` 声明行，装上即可在预设列表里选。没有安装步骤，插件启动时也不写任何文件。
+
+设置页「Tool Plus → 预设」是改它们的地方（dsh 0.1.7 起官方的预设页只读、也没有 `agent_preset` 工具，所以这里是唯一的图形入口）：
 
-装好插件后**不需要任何额外步骤**：插件首次启动时会检查 `~/.dsh/.agent-presets/`，只在对应目录**不存在**时把随包模板整份写入（存在则一个字节都不碰，所以你自己改过的预设不会被覆盖）。重启 dsh 后在会话里选用预设即生效。
+- **最小更新**：只把这几个仍挂着的官方工具行关掉，其他内容一个字节都不动
+- **对齐模板**：用所选模板整份替换这一行的插件列表
+- **恢复随包**：删掉你写在 profile 配置（`<profile>/cordis.patch.yml`）里的覆盖，回落到随包声明
+- **查看差异**：先看差在哪几行，再决定动不动手
 
-本地已有旧版预设、想跟上当前版本时，用设置页的「Tool Plus → 预设」：
+写入通过宿主自己的 `ctx.configEditor` 完成，因此自带 profile 锁、并发保护、原子写与失败回滚。
 
-- **最小更新**：只把冲突的工具行禁用掉，其余本地改动一律保留；
-- **重置为对比模板**：整份覆盖成所选模板（写前自动备份到 `agent.cordis.yml.bak-<版本>`）；
-- **查看差异**：先看清这份预设与模板差在哪几行，再决定动不动手。
+> 从 0.1.9 或更早升级过来的话：`~/.dsh/.agent-presets/` 目录**已经没有任何代码读它**（0.1.7 起预设改为补丁层声明），可以安全删除；设置页检测到它会给出提示。
 
 ## 配置
 
@@ -71,7 +78,7 @@ dsh plugin --profile web add link:<本仓库路径>
 - **dsh CLI**：需全局安装，`npm i -g @deepseek-ai/dsh`
 - **Node.js** ≥ 22.19 或 ≥ 24
 - **Git Bash**（推荐）：Windows 上作为 bash 执行环境
-- 适用于 DeepSeek Harness `dsh` v0.1.5-rc.1（pre-release，接口可能变动）
+- 适用于 DeepSeek Harness `dsh` v0.1.7-rc.2（pre-release，接口可能变动）
 
 ## 注意事项
 

package/THIRD_PARTY_NOTICES.md

@@ -17,6 +17,16 @@ Scope of ported upstream code:
   `src/tools/hashline/test/fixtures/` (copied from
   `crates/pi-edit/tests/fixtures/hashline/`), MIT, same notice below.
 
+It also contains a verbatim copy of one upstream file set from the project
+[deepseek-harness](https://github.com/deepseek-ai/deepseek-harness):
+
+- `presets/baseline/standard.patch.yml` and `presets/baseline/ptc.patch.yml` are
+  byte-for-byte copies of `packages/bundle/web-app/presets/standard.patch.yml`
+  and `ptc.patch.yml` from the dsh release this plugin pins. They are vendored
+  as the **input** to `scripts/build-preset-patches.mjs`, which derives this
+  plugin's own two agent-preset declarations from them; the generated files are
+  `presets/tool-plus-{standard,ptc}.patch.yml`. MIT, notice below.
+
 ---
 
 oh-my-pi - MIT
@@ -46,3 +56,29 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
+---
+
+deepseek-harness - MIT
+
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+