dsh-pathfix
用于在宿主层规范化工具路径和模式参数中的空白字符及末尾换行符的 DeepSeek Harness 插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-pathfix@0.1.0Pathfix 以 dsh-pathfix 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Host-layer DeepSeek Harness (DSH) plugin that automatically detects and repairs whitespace and trailing newlines in tool path and pattern parameters before dispatch.
Due to model tokenization and sampling variance, LLMs occasionally emit tool parameters with unexpected trailing newlines or edge whitespace (e.g. "file_path": "C:\\images\\_shot.png\n"). Because standard filesystem tools take parameters verbatim, this causes recurring, misleading tool failures:
| Tool | Error when a trailing \n is in the parameter | What dsh-pathfix does |
|---|---|---|
write | EINVAL: invalid argument, mkdir '...<filename>\n.<id>.tmpdir' | Trims whitespace; directory and file creation succeed. |
glob | IO error / The filename, directory name, or volume label syntax is incorrect (os error 123) | Trims path whitespace; search succeeds. |
grep | rg: the literal "\n" is not allowed in a regex | Strips \r/\n while preserving regex edge spaces. |
read_image | Misleading read_image only accepts PNG/JPEG/WebP/GIF paths | Trims path; image extension check passes. |
read | Misleading not found (file exists) | Trims path; file resolves and reads normally. |
dsh-pathfix operates transparently at the host layer before tool dispatch. The model does not need to learn any replacement tool, and tool result prose is never modified.
fix(clean) === clean). If no repair is required, the original argument object reference is returned and no telemetry is emitted.fix(fix(x)) === fix(x). Applying normalization multiple times yields the exact same state.pattern arguments (for grep and glob), only \r and \n characters are stripped. Spaces and tabs at pattern boundaries are preserved because they can be semantically significant in regular expressions.@deepseek-ai/dsh-tools, @deepseek-ai/schemastery).Install into your target DSH profile (e.g. web):
dsh plugin --profile web add file:/absolute/path/to/plugins/dsh-pathfix
Verify that the bundle is mounted in your profile:
dsh web --dump-config | Select-String -Pattern "pathfix" -Context 1,2
Expected output includes the patch layer:
# == dsh-pathfix
- id: pathfix
name: dsh-pathfix
dsh-pathfix is configurable via your profile's cordis.patch.yml or cordis configuration:
- id: pathfix
name: dsh-pathfix
config:
enabled: true # Enable or disable parameter normalization (default: true)
tools: # List of tool names to inspect (default: fs tools)
- read
- read_image
- write
- edit
- glob
- grep
stripLeading: true # Strip leading whitespace in paths (default: true)
logFixes: true # Log repairs to session/console (default: true)
When a parameter is repaired, dsh-pathfix records the event in an internal telemetry tracker and emits an informational log message (if logFixes: true):
[dsh-pathfix] Repaired parameter "file_path" on tool "read_image": stripped trailing "\n" (value: "C:\\images\\_shot.png\n" -> "C:\\images\\_shot.png")
The repair event is also emitted as pathfix/repair on the Cordis context and tracked in ctx.pathfix.telemetry.
In Windows CMD (Command Prompt):
dsh web --dump-config | findstr /i "pathfix"
In PowerShell:
dsh web --dump-config | Select-String -Pattern "pathfix" -Context 1,2
Expected output:
# == dsh-pathfix
- id: pathfix
name: dsh-pathfix
Verify that the profile dependencies, bundle patch, and live Cordis normalization hook are fully active:
node acceptance/mount_check.mjs C:\Users\marti\.dsh\profiles\web
Or via npm:
npm run mount-check C:\Users\marti\.dsh\profiles\web
Run unit and E2E tests using Node.js built-in test runner:
# Run all tests (unit + E2E)
npm test
# Run unit tests covering the 5 real-world error fixtures
npm run test:unit
# Run E2E test with real @deepseek-ai/dsh-tool-fs suite
npm run test:e2e
Or directly with Node:
node --test test/unit.test.mjs test/e2e.test.mjs
We welcome contributions! Please see our Contributing Guidelines for details on code invariants, test fixtures, and commit standards.
MIT © loonylabs-dev
Maintained by loonylabs-dev