@hy-sde-org/dsh-tool-fs-internal-urls

中文文档
0.2.1-rc.5发布于 2026/11/01MITTypeScriptES Module

Agent-scope shadow of the DeepSeek Harness read/write/edit fs tools that also resolves conflict://, pr://, issue:// URLs through ctx.internalUrls — the routing surface that makes internal URLs work on stock harness releases.

原始使用文档

@hy-sde-org/dsh-tool-fs-internal-urls

The read / write / edit filesystem tool suite for DeepSeek Harness with internal-URL routing built in: when ctx.internalUrls is mounted, these tools resolve conflict://, pr://, issue:// URLs (and <path>:conflicts selectors) through the registry instead of a filesystem path, and scan plain filesystem reads for git conflict blocks — registering them with the session history and appending a resolution notice. This is the hy-sde fork's dsh-tool-fs (with src/internal-routing.ts + the read.ts/write.ts hunks) shipped as an agent-scope shadow so it works on stock DeepSeek Harness releases (dsh-v0.2.0-rc.2 and later).

Mount it in an agent preset (see examples/agent-preset/ in @hy-sde-org/dsh-internal-urls): agent-scope shadowing makes these THE read/write/edit for that session, while plain filesystem behavior is identical to the stock tools. Without a mounted ctx.internalUrls registry the routing branch never triggers and the tools are stock-equivalent.

  • read — line-numbered windows (caps: readLimit 2000 lines, readMaxLineLength 2000 chars, readMaxBytes 50 KiB, stream threshold 10 MiB), fs/observed emission, internal-URL virtual reads, conflict surfacing + notice.
  • write — create/overwrite with sandbox-policy escalation (fs/write-intent waterfall, error remediation). Internal-URL writes (conflict://<N> resolution) dispatch to the handler with the session context and the resolved policy so the backing-file splice stays fenced.
  • edit — literal single-match (or replace-all) edits over ctx.fs with guard + remediation, unchanged from the harness (this package keeps the trio together).
  • read_image — registers only while attachments is mounted, unchanged.

Install

As a routing surface this package is useless without @hy-sde-org/dsh-internal-urls; follow that package's README — all three packages install together:

dsh plugin --profile web add @hy-sde-org/dsh-internal-urls \
  @hy-sde-org/dsh-tool-fs-internal-urls \
  @hy-sde-org/dsh-tool-fs-search-internal-urls

Then copy the preset from packages/internal-urls/examples/agent-preset/ in this repo (or the installed package) to ~/.dsh/.agent-presets/<id>/ — its tool-fs-internal-urls row is this package.

Defaults & caps

KeyDefaultMeaning
readLimit2000lines per read call
readMaxLineLength2000chars per returned line
readMaxBytes50 KiBbytes of selected output
readStreamMinSize10 MiBstream files at/above this size
enableEdittrueset false to leave edit to another provider

版本与发布记录

@hy-sde-org/dsh-tool-fs-internal-urls 共发布 11 个版本,首次发布于 2026/08/26;过去 12 个月发布了 11 个版本。

版本发布日期距今
0.2.1-rc.5latest2026/11/012 天前
0.2.1-rc.32026/10/259 天前
0.2.1-alpha.42026/10/1618 天前
0.2.1-alpha.22026/10/1321 天前
0.2.0-rc.22026/10/031 个月前
0.1.7-rc.22026/09/291 个月前

关于 @hy-sde-org/dsh-tool-fs-internal-urls 的常见问题

@hy-sde-org/dsh-tool-fs-internal-urls 是什么?

代理范围的影子DeepSeek线束读/写/编辑fs工具,也解决冲突://,pr://, issue:// url通过ctx.internalUrls -路由表面,使内部url工作在库存线束发布。

如何安装 @hy-sde-org/dsh-tool-fs-internal-urls?

在项目目录运行 npm install @hy-sde-org/dsh-tool-fs-internal-urls,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(~4.0.5)、@deepseek-ai/dsh-fs(^0.2.1-rc.5)、@deepseek-ai/dsh-llm(^0.2.1-rc.5)、@deepseek-ai/dsh-tools(^0.2.1-rc.5)、@deepseek-ai/dsh-sandbox(^0.2.1-rc.5)、@deepseek-ai/dsh-session(^0.2.1-rc.5)、@deepseek-ai/dsh-attachment(^0.2.1-rc.5)、@hy-sde-org/dsh-internal-urls(^0.2.1-rc.5)、@deepseek-ai/dsh-system-prompt(^0.2.1-rc.5)、@deepseek-ai/dsh-user-approval(^0.2.1-rc.5)、@deepseek-ai/dsh-sandbox-policy(^0.2.1-rc.5)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@hy-sde-org/dsh-tool-fs-internal-urls 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@hy-sde-org/dsh-tool-fs-internal-urls 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@hy-sde-org/dsh-tool-fs-internal-urls 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@hy-sde-org/dsh-tool-fs-internal-urls 可以商用吗?

@hy-sde-org/dsh-tool-fs-internal-urls 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@hy-sde-org/dsh-tool-fs-internal-urls 还在维护吗?

最新版本 0.2.1-rc.5 发布于 2026/11/01(2 天前);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/08/26。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。