TheChengXi/insert-intent

module-map-context

一个 DeepSeek Harness (DSH) 宿主插件，它在每个新会话开始时将你的工作区的模块映射——即 .intentflow/_packages/ 下的 YAML 文件——注入到模型的上下文中。模型可以预先了解项目的模块布局，而无需扫描整个目录树，从而节省 token 和解释时间。

功能说明

在每个新会话的第一步，module-map-context 会：

1. 定位项目根目录（从会话 cwd 向上查找 .git），
2. 读取每个顶层 .intentflow/_packages/.yml，
3. 逐字拼接这些文件（按文件名排序，不解析、不添加头部），
4. 将结果作为 user 角色的上下文快照追加到该步骤消息批次的末尾（位于用户消息、AGENTS.md 基线和运行时上下文之后）。

它的行为类似 AGENTS.md：该决策每个会话只做一次。如果会话开始时该文件夹中没有 YAML，则不会注入任何内容——而之后*创建的模块映射（例如由 report 创建）不会回填到已在运行的会话中。

重启安全。“每个会话一次”通过会话投影（ctx.sessionProjections）持久化地强制执行：该投影对会话已提交的事件进行折叠，并在模块映射被注入后将其标记，因此已注入的快照在宿主重启、会话恢复或上下文压缩后不会被重新注入。进程本地的 WeakSet 为没有投影注册表 / 存在预提交间隙的组合提供后备支持。跳过（会话开始时没有 _packages）在进程内会被记住，但重启后会重新检查——与官方 DSH 插件行为一致。

安装

将包复制到 DSH 配置文件的 node_modules 中（例如 web 配置文件），然后向该配置文件的 cordis.patch.yml 添加一条 insert 条目。

$src  = 'D:\path\to\module-map-context'
$web  = "$env:USERPROFILE\.dsh\profiles\web"
New-Item -ItemType Directory -Force -Path "$web\node_modules\module-map-context" | Out-Null
Copy-Item "$src\index.js"        "$web\node_modules\module-map-context\" -Force
Copy-Item "$src\lib"             "$web\node_modules\module-map-context\" -Recurse -Force
Copy-Item "$src\package.json"    "$web\node_modules\module-map-context\" -Force

追加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: module-map-context
name: 'module-map-context'

重启 dsh web（刷新页面不够——组合在启动时解析）。

配置

- id: module-map-context
name: 'module-map-context'
config:
projectRootMarkers: ['.git']   # optional; default ['.git']

包文件夹格式

每个模块是直接位于 .intentflow/_packages/ 下的单个 YAML 文件：

packageName:
summary: |
module responsibility, entry file, external dependencies.
groups:
- name: group name
summary: 为什么这些文件属于同一组 — 这个分组传达了何种能力
files:
-

文件布局

- index.js — 插件入口（{ name, inject, Config, apply }）、agent/pre-step 监听器、会话投影注册与快照追加
- lib/discover.js — 项目根目录发现（.git 标记遍历）+ ctx.fs 读取
- lib/render.js — 按文件名排序的逐字拼接（纯函数）
- lib/inject-decision.js — 持久的每会话一次决策：会话投影（createModuleMapProjection）+ 进程内 WeakSet 决策器
- test.mjs — 针对已安装插件的运行时验证（包括重启安全的去重）

许可证

MIT