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

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

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

中文使用文档

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

这个 read / write / edit 文件系统工具套件 内置内部url路由:当 ctx.internalUrls 是安装好的,这些 工具解决 conflict://, pr://, issue:// url(和 <path>:conflicts 选择器)通过注册表而不是文件系统路径,并进行普通扫描 文件系统读取git冲突块-将它们注册到会话中 历史记录和附加决议通知。这是十字叉 dsh-tool-fs (与 src/internal-routing.ts + read.ts/write.ts 大帅哥)作为代理范围的影子发送,所以它可以工作 股票 DeepSeek 线束释放(dsh-v0.2.0-rc.2 后来)。

将其挂载到代理预设中(参见 examples/agent-preset/ 在 @hy-sde-org/dsh-internal-urls):代理作用域遮蔽使它们成为THE read/write/edit 对于该会话,而普通的文件系统行为是 与库存工具相同。没有安装 ctx.internalUrls 注册表 路由分支永远不会触发,工具与库存相同。

  • read -行号窗口(大写: readLimit 2000行, readMaxLineLength 2000字符, readMaxBytes 50kib,流阈值 10 MiB), fs/observed 发射,内部url虚拟读取,冲突 表面处理+通知。
  • write -创建/覆盖沙盒策略升级 (fs/write-intent 瀑布,错误补救)。Internal-URL写道 (conflict://<N> 解析)发送到会话处理程序 上下文和已解析的策略,以便备份文件拼接保持隔离状态。
  • edit -文字单匹配(或替换全部)编辑结束 ctx.fs 与 防护+补救,与挽具相同(此包保留 三人在一起)。
  • read_image -只在注册时注册 attachments 是挂载的,不变的。

安装

作为路由表面,这个包是无用的 @hy-sde-org/dsh-internal-urls;遵循该软件包的README -全部三个 包一起安装:

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

然后复制预设从 packages/internal-urls/examples/agent-preset/ 在 此repo(或已安装的包)到 ~/.dsh/.agent-presets/<id>/ ——它的 tool-fs-internal-urls 这就是这个包裹。

默认值和上限

关键默认的意义
readLimit2000行每 read 呼叫
readMaxLineLength2000每个返回行的字符数
readMaxBytes50 KiB所选输出字节数
readStreamMinSize10 MiB大于/等于此大小的流文件
enableEdittrue集 false 离开 edit 给另一个供应商

版本与发布记录

@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 和提交记录判断。