dsh-copy-tool

中文说明

An enhanced line-selection copy plugin for DeepSeek Harness.

It addresses omissions and oversimplification when using the write tool to refactor large projects by speeding up refactoring calls, saving substantial tokens, and migrating modules while preserving their source-line content.

Features

• Copy individual 1-based lines or ranges to corresponding target lines
• Replace targets with target_lines, or insert before a target line with insert_at
• Append directly with insert_at: "end" without placeholder lines
• Use arrays such as [[633, 889]] or [633, [640, 645], 700] for lines and target_lines
• Strip common indentation from non-empty source lines and add an explicit four-space indent level
• Preview a bounded unified diff with required dry_run
• Atomically update existing targets and create missing replacement targets
• Preserve untouched content and calculated line endings, including mixed-ending targets
• Resolve paths relative to the current session workspace and respect its sandbox policy

Install

npm (recommended)

cd $env:USERPROFILE\.dsh\profiles\web
npm install dsh-copy-tool

Then add dsh-copy-tool to the dsh.profile.bundles array in package.json, and restart DSH Web.

dsh plugin command

dsh plugin --profile web add dsh-copy-tool

If the bundle list is not updated automatically, add dsh-copy-tool to dsh.profile.bundles in the profile's package.json manually, then restart DSH Web.

Usage

The base parameters are required. Provide exactly one of target_lines and insert_at.

Replace corresponding target lines

Expanded lines and target_lines must select the same number of lines; each source line maps to the target line at the same position:

{
  "source_file": "source.py",
  "target_file": "module.py",
  "lines": [[633, 644]],
  "target_lines": [[1, 12]],
  "indent": 0,
  "dry_run": true
}

A line list can mix individual numbers and ranges:

{
  "source_file": "source.py",
  "target_file": "module.py",
  "lines": [633, [640, 645], 700],
  "target_lines": [1, [2, 7], 8],
  "indent": 1,
  "dry_run": false
}

Insert or append source lines

insert_at is a 1-based target line number and inserts before that line. Use "end" to append after the final target line:

{
  "source_file": "MOD.md",
  "target_file": "回复格式.md",
  "lines": [[1, 254]],
  "insert_at": "end",
  "indent": 0,
  "dry_run": true
}

Line numbers are 1-based. Source indentation common to selected non-empty lines is removed, then indent * 4 spaces are added; whitespace-only lines keep their original content. target_lines and insert_at are mutually exclusive. Insertion requires an existing target file, while a missing target is created only by replacement with continuous target_lines beginning at 1. Use dry_run: true to inspect the diff before writing, then repeat with dry_run: false after approval.

License

MIT