🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

ciskonc/dsh-context-imports

DeepSeek Harnessspec-screened扫描:中风险在 GitHub 查看 ↗
✓ 可直接安装

在会话启动时,把 AGENTS.md 里引用的文件注入模型上下文。

自动检查通过:npm 包已发布且 engines 声明满足基线;该结论来自程序自动检查,未经人工实机验证。 · 最近上游提交 2026/9/23 · 已提供中文文档

为DeepSeek Harness实现Claude Code风格的@path导入:在会话开始时展开AGENTS.md/CLAUDE.md中的@imports,并将引用的文件注入上下文

综合分
34.2
GitHub 分
34.2
用户评分
—
★ Stars
6
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add dsh-context-imports
npm 包 dsh-context-imports 已校验归属本仓库,走 npm 安装最省事
信任档位:已验证本站已于 4 天前真实安装成功(L4 · 真实安装)
是什么
dsh 原生插件 · chat
装得上吗
本站已真实安装成功(L4 · 真实安装,非静态推断)
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 2 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

🟢实装验证通过· 2026/9/22
由本站实装验证器在真实 dsh 环境安装成功,非静态推断。
数据截至 2026/9/24(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查✓ 自动检查通过

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-context-imports @ 0.1.1
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 11:27:54

依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-llm@deepseek-ai/schemastery
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
dsh-context-imports

在会话启动时,把 AGENTS.md 里引用的文件注入模型上下文。

DSH 自带的 agent-instructions 插件会注入 AGENTS.md 本体,但里面的 @路径 引用只是普通文本,模型看不到。这个插件按 Claude Code 的方式处理这些引用:把每个被引用的文件读出来,加进会话上下文。

解决什么问题

| | 没有这个插件 | 装上之后 |
|---|---|---|
| AGENTS.md 本体 | 由官方 agent-instructions 注入 | 仍由它注入,不重复 |
| @docs/architecture.md 这类引用 | 普通文本,被忽略 | 文件全文进入上下文 |
| 引用里还有引用 | 没人处理 | 递归展开,深度可控 |
| 上下文压缩之后 | 被引用的文件随历史一起消失 | 自动重新注入 |
| 恢复旧会话 | 可能叠出第二份 | 检测到已有注入就跳过 |

工作原理

agent/session-start(新会话 / 恢复 / 清空 / 压缩后)记录场景
agent/pre-step(每一步)决定是否注入
├─ 扫描指令文件(默认 AGENTS.md、CLAUDE.md)里的 @路径 引用
│    ├─ 跳过围栏代码块;路径必须带文件扩展名
│    ├─ 相对路径按引用者所在目录解析
│    └─ 按解析后的路径去重,循环引用不会死循环
├─ 合并显式配置的 files 列表(这些文件注入全文;指令文件只扫描,不会重复注入)
├─ 预算限制:单文件 64 KB(超出就截断并标注),总量 128 KB(放不下的跳过并标注);
│    文件不存在只记一行提示,不报错
├─ 活跃历史里最多保留一份注入:全量事件日志按指纹扫描,
│    压缩真的把旧块压掉之后,下一次会话启动会重新注入
└─ 注入内容追加在整条消息序列的末尾,排在 AGENTS.md 和其他上下文之后

注入的消息是一个 ,里面只有  块,没有别的说明文字。想自定义包装格式就配置 template。

特性

- 递归展开 @路径 引用。默认深度 3 层,循环引用和重复路径会自动合并。
- 四种场景都会触发:新会话、恢复、清空、压缩后。每种场景都可以单独关掉。
- 活跃历史里最多一份注入。压缩把它压掉之后,下次会话启动会重新注入。
- 设置卡片支持六种语言(中、英、日、法、俄、韩),在 Settings 的 Plugins 页。所有配置都能在卡片上改,改完立即生效,不用重启。
- 单文件和总量都有字节上限。文件缺失只是提示,不会导致失败。
- 只用官方公开 API:cordis 事件、dsh-llm 的 createUserMessage、schemastery 配置校验、可选的 dsh-settings 命名空间。不依赖其他功能插件。

配置

| 字段 | 默认值 | 说明 |
|---|---|---|
| files | [] | 额外注入的文件,相对会话工作目录或绝对路径 |
| scanImports | true | 扫描 AGENTS.md 等指令文件里的 @import |
| instructionFiles | ["AGENTS.md", "CLAUDE.md"] | 参与扫描的文件。它们本身不会被重复注入 |
| maxDepth | 3 | 嵌套引用最多跟几层 |
| maxFileBytes | 65536 | 单文件字节上限,超出截断 |
| maxTotalBytes | 131072 | 总字节预算,放不下的文件跳过并标注 |
| injectOn | 全部四项 | 哪些会话启动场景触发注入 |
| template | "" | 自定义包装文本。{{content}} 标记文件内容的位置;留空用默认格式 |

安装

dsh plugin --profile web add dsh-context-imports

装完不用配置就能用:默认扫描 AGENTS.md 和 CLAUDE.md,并把引用到的文件注入会话。想从源码构建:

git clone https://github.com/ciskonc/dsh-context-imports.git
cd dsh-context-imports
npm install
DSH_CHECKOUT= npm run build
npm run build:client

版本适配:在 DeepSeek Harness 0.1.5-rc.2 上测试(插件 v0.1.1)。包声明 engines: dsh >= 0.1.5-rc.1,支持 dsh.bundle 的版本理论上都可用。每个 Release 的说明里会注明当时测试所用的 DSH 版本。

开发

| 文件 | 职责 |
|---|---|
| src/index.ts | Host 端:会话场景记账、引用展开、预算、pre-step 注入、设置命名空间 |
| src/client/index.ts | 浏览器端:六语言字典和设置卡片 |
| src/client/form.ts | 卡片背后的暂存表单模型 |
| src/client/ContextImportsCard.tsx | 卡片组件 |

许可

MIT

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群