@gw/dsh-text-inject

在 dsh（DeepSeek Harness）官方设置页左侧栏添加一个「文字注入」分区：把文字注入到 系统提示词（每轮生效）或会话上下文；内容存于独立文件，支持热加载与历史备份。

不碰官方 inject-system-prompt 那种"在官方配置里塞字段"的做法——你的文字写在你自己的一份 inject.md 里，随手可改。

功能

能力	说明
提示词注入	`## [system] 名称` 块 → 追加进系统提示词，每轮对话生效
上下文注入	`## [context] 名称` 块 → 合成一条 user 消息注入会话；`kind` 去重、`trigger` 关键词门控
增删改	设置页以卡片列出所有块，支持新增 / 编辑 / 删除 / 启停
独立文件	内容全部写在你自己的一份 `inject.md`，与官方配置隔离
热加载	改文件保存即生效（`fs.watch`），或在设置页点保存；都不用重启 dsh
历史备份	每次保存自动把上一版存进 `history/`，可查看 / 一键恢复（保留最近 30 份）

安装

把本包放进对应 profile 的 node_modules（scope 目录 @gw）：

# web profile（桌面客户端则换成 profiles/desktop）
cp -r dsh-text-inject ~/.dsh/profiles/web/node_modules/@gw/

在 profile 的 cordis.patch.yml 追加 loader 入口：

- insert:
    - id: gw-text-inject
      name: '@gw/dsh-text-inject'

重启 dsh，打开设置页 → 左侧栏出现「文字注入」。

数据文件默认在 ~/.dsh/text-inject/inject.md，插件首次加载会自动创建（含示例块）。想换位置，在 loader 入口加 config.file：

- insert:
    - id: gw-text-inject
      name: '@gw/dsh-text-inject'
      config:
        file: 'C:/Users//Desktop/文字注入.md'

数据文件格式

# 任意标题（说明用，忽略）

## [system] 我的常驻规则
order: 40

这段会追加进系统提示词，每轮生效。

## [context] 项目背景
kind: gw-project
trigger: 项目,需求

当消息里出现「项目」或「需求」时，这段作为一条 user 消息注入会话。

块头：## [system] 名称 或 ## [context] 名称（大小写不敏感）。
元数据：紧跟在块头之后、正文之前，英文冒号，只认 order / kind / trigger / enabled。一旦出现非元数据、非空行，后面就全是正文——所以正文里的「中文：」不会被误解析。
[context] 块必须有 kind（唯一，用于去重）；trigger 留空 = 每轮注入。
enabled: false 可临时禁用某块。

设置页数据通道

前端无本地文件桥，读写经 host 的 webServer 路由（同源，无 CORS、不额外占端口）：

方法	路径	说明
GET	`/gw-text-inject/state`	`{ file, raw, blocks, history }`
POST	`/gw-text-inject/save`	body `{ blocks }` → 保存 + 自动备份
POST	`/gw-text-inject/restore`	body `{ name }` → 恢复某份备份
GET	`/gw-text-inject/raw?name=`	读某份备份原文

依赖与兼容

host 半依赖服务：systemPrompt（@deepseek-ai/dsh-base 提供）、webServer（@deepseek-ai/dsh-host-webserver 提供）。
client 半依赖服务：slots、locale；dsh.client.inject 声明 @deepseek-ai/dsh-client-locale、@deepseek-ai/dsh-client-ui-settings。
dsh.client.platform = "web"；exports 含 "." 与 "./client"。
兼容 dsh release：0.1.2-rc.1 / 0.1.5-rc.1 / 0.1.5-rc.2（最后验证 2026-09-26）。
官方 @deepseek-ai/* 包未列入 dependencies，由宿主 profile 提供。

卸载

删掉 profile cordis.patch.yml 里的 gw-text-inject insert 块。
删除 node_modules/@gw/dsh-text-inject/。
数据文件 ~/.dsh/text-inject/（含 history/）可按需保留或删除。
重启 dsh。

权限与数据

读写的只有一份文件：默认 ~/.dsh/text-inject/inject.md 及其 history/ 备份（可在 loader 配置里改到任意路径）。
不访问网络、不读凭据、不上报任何数据。
前端与 host 之间走 dsh 自己的 webServer 同源路由（/gw-text-inject/*），不额外开端口、无跨域。
注入的内容会进入每一轮请求，等于放大提示词体积——[context] 块建议配 trigger，别全量常驻，否则白白烧 token。

常见问题

现象	原因 / 处理
设置页左侧栏没有「文字注入」	包没进 `node_modules`，或 `cordis.patch.yml` 的 insert 块用了 `file://` 路径。带 `dsh.client` 的插件必须真装进 node_modules，绝对路径挂载会让整站前端 bundle 连坐失败
改了文件没生效	热加载靠 `fs.watch`；部分编辑器「原子保存」会丢事件，去设置页点一次保存即可
上下文块一直重复注入	`[context]` 块缺 `kind`（去重键），或 `trigger` 太宽泛
元数据行没被识别	必须用英文冒号，且要紧跟块头、在正文之前
整站前端报 `Failed to load plugins`	见第一条：摘掉本插件的 insert 块并重启，前端即恢复

回滚：按「卸载」四步走，数据文件可保留。插件自身不落盘日志，排障看 dsh 启动日志。

许可证与安全

MIT，见 LICENSE。本插件不接触密钥、不产生外发流量，安全问题直接在仓库提 issue。

结构

dsh-text-inject/
├─ package.json         # npm 元数据 + dsh.bundle.patch + dsh.client 声明
├─ cordis.patch.yml     # loader 入口（insert 块）
├─ inject.md            # 数据文件种子模板（首次加载复制到用户数据文件）
├─ lib/
│  ├─ index.js          # host 半：注入 + 热加载 + webServer 数据路由 + 备份
│  ├─ client.js         # client 半：设置页「文字注入」UI（lazy-CJS bundle）
│  └─ parser.js         # inject.md 的纯解析 / 序列化
└─ README.md

安装

说明文档