这个 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 这就是这个包裹。
默认值和上限
| 关键 | 默认的 | 意义 |
readLimit | 2000 | 行每 read 呼叫 |
readMaxLineLength | 2000 | 每个返回行的字符数 |
readMaxBytes | 50 KiB | 所选输出字节数 |
readStreamMinSize | 10 MiB | 大于/等于此大小的流文件 |
enableEdit | true | 集 false 离开 edit 给另一个供应商 |
关于 @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 和提交记录判断。