# @hy-sde-org/dsh-tool-fs-internal-urls 中文文档

规范地址：https://npmcn.com/package/%40hy-sde-org/dsh-tool-fs-internal-urls/

版本：0\.2\.1-rc\.5
npm 元数据更新时间：2026-11-01T04:22:33.322Z
中文译文更新时间：2026-11-01T09:50:48.670Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40hy-sde-org/dsh-tool-fs-internal-urls
原文对照：https://npmcn.com/package/%40hy-sde-org/dsh-tool-fs-internal-urls/?lang=original
项目主页：https://github.com/hy-sde/dsh-internal-urls#readme
源码仓库：https://github.com/hy-sde/dsh-internal-urls

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：171 kB，51 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：2 个
- 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
- 首次发布：2026-08-26T03:23:53.397Z
- 最新版本发布：2026-11-01T04:22:33.147Z
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

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

## 安装

```sh
npm install @hy-sde-org/dsh-tool-fs-internal-urls
```

也可以使用：`pnpm add @hy-sde-org/dsh-tool-fs-internal-urls`、`yarn add @hy-sde-org/dsh-tool-fs-internal-urls`、`bun add @hy-sde-org/dsh-tool-fs-internal-urls`

## README

# @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 -全部三个 包一起安装：

```bash
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 是什么？

代理范围的影子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 和提交记录判断。