ubik-dsh/deepseek-mods

Harness Mods

an agent harness 的插件——该 agent harness 的浏览器 UI 是 dsh web GUI。

仓库：

这里包含三个 mod：

| Mod | 功能 |
|---|---|
| system-prompt-mod | 聊天标题栏中的 Промпт / Prompt 按钮，可打开实时系统提示词、进行编辑，并在下一次模型请求时应用结果——无需重启。 |
| locale-ru | 整个 GUI 的俄语本地化：42 个命名空间、1257 条字符串，可在 Settings → General → Language 中选择。 |
| skill-manager | Settings → Plugins 中的 Skills 标签页，位于 Mods 之后：列出此 harness 解析到的每个 skill，包括模型用于匹配的描述以及供人阅读的一行摘要。暂停某个 skill 后，模型在下一次请求时便不再被提供该 skill——无需重启。 |
| mod-manager | Settings → Plugins 中的 Mods 标签页：已安装的内容、页面是否实际加载了它，以及关闭 / 开启 / 移除——无需重启。 |

本文件的俄语版本：README.ru.md。

会话标题栏中的 Prompt 控件

显示实时系统提示词的编辑器

Промпт 控件位于会话标题栏操作区；对话框显示模型实际接收到的提示词——在实时 agent 的作用域中组装，{{model}}、{{cwd}} 和预设层均已解析。

俄语界面中的语言选择

语言包将 Русский 添加到 Settings → General → Language。

列出已安装 mod 的 Mods 标签页

之前：每个 loader 行、此页面是否加载了它，以及每一行可以执行的操作。

关闭提示词 mod 后的同一标签页

之后：提示词 mod 已从此面板关闭。它的行从 patch 文件中移除，其 host 路由停止响应，徽章显示 "off"，按钮变为 "turn on"——无需重启。重新开启会以同样方式恢复该行。

这里有何不同

大多数集合只列出其中包含的内容。以下是本集合的不同之处，写出来是为了让人可以核实，而不是只能相信。

| | |
|---|---|
| 验证并公布证据 | 这些文档中的每一项声明都经过测量，docs/VERIFICATION.md 就是那张表：运行了什么、返回了什么，以及——大多数项目会省略的一列——哪些内容未被覆盖。 |
| 诚实的失败路径 | 无法安装的 mod 会说明哪项检查失败以及如何处理。镜像脚本拒绝推送为错误主机保存的 token。skills 检查器会将无法证明的内容报告为警告，而不是失败。 |
| 从一开始就是双语的 | 每个面向用户的文件都以 X.md 和 X.ru.md 的形式存在。俄语包是一个生成的捆绑包，包含 1257 个字符串，并带有自己的测试，而不是手工编辑的翻译。 |
| 允许失败的测试 | 这里的一个浏览器测试捕获了一个朴素桩无法看到的重新渲染循环；被修复的是桩，而不是测试。当某项检查断言了不方便的事情时，检查会被审视，而不是被降低标准。 |
| 无构建步骤 | 纯 JavaScript 包。没有编译器，没有打包器，安装时无需网络访问。 |

这个仓库并不声称其中任何一点是新想法。插件管理器在别处已经存在。不寻常的是验证纪律——以及俄语本地化，对主要测试框架目录的扫描发现这是一个空白领域。

要求

- 一个 agent 测试框架，已安装并能够运行 dsh web。已针对 0.1.5-rc.2 测试。
- Node.js —— 与测试框架本身运行所用的同一运行时。
- git，用于克隆（跳过它并改为下载 ZIP —— 安装程序不需要 git）。
- 无构建步骤，无编译器，安装时无需网络访问。

这些 mod 是纯 JavaScript 包。该测试框架处于 1.0 之前，其插件 API 变化很快，因此在升级测试框架之前，请阅读兼容性。

安装

git clone https://gitverse.ru/ubikon/dsh-mods.git dsh-mods
cd dsh-mods
node tools/install.mjs

该 URL 是仓库的主页。从任何镜像或 fork 克隆的效果相同——项目中没有任何内容依赖于它从何处克隆。

然后重新加载 Web GUI（F5）——浏览器名单是在页面加载时组成的。

这就是整个安装过程。该脚本将两个包复制到 $DSH_HOME/profiles/node_modules/@local/（默认为 ~/.dsh），并向 $DSH_HOME/profiles/web/cordis.patch.yml 为每个包添加一行加载器，同时保持该文件中任何现有内容不变。

重新运行是安全的，并且在没有任何变化时是真正的无操作：已安装副本与此检出匹配的包会被保留，行会被检查而不会重复，并且不会写入备份。当已安装的包不同时——你拉取了新版本——该包会被替换，并且先前的副本加上 mod 状态会被快照到 $DSH_HOME/mod-backups//，这正是使回滚成为可能的原因。

选项：

node tools/install.mjs --lang ru        # 俄语控制台输出
node tools/install.mjs --profile tui    # 使用 web 以外的配置文件
node tools/install.mjs --home-level     # 行也会写入 $DSH_HOME/cordis.patch.yml（所有配置文件）
node tools/install.mjs --dry-run        # 报告将发生的变化，不写入任何内容
node tools/install.mjs --backup-only    # 对重新安装将替换的内容进行快照，然后停止
node tools/install.mjs --uninstall      # 移除这些包及其行

--backup-only 仅在存在需要保留的内容时才写入快照。当
已安装的包已经与这个检出匹配，它自己这么说，并且完全不创建任何目录，而不是给出一个不存在的路径。

验证

在 dsh web 运行的情况下：

node tools/boot-check.mjs

GET / -> 200 (28171 bytes)
boot rows referencing /client.js: 168
OK   dsh-system-prompt-mod
OK   dsh-locale-ru

该探针从你自己的 harness home 读取浏览器会话签名密钥，铸造出与 GUI 使用的相同 cookie，并报告所提供的启动图携带了哪些客户端行。它从不打印该密钥。

使用这些 mod

系统提示词

打开一个会话，在会话头部点击 Промпт（提示词），就在其他头部操作旁边。该对话框显示模型实际接收到的提示词——在实时 agent 的作用域中组装，因此 {{model}}、{{cwd}} 和预设层都会被解析。

- Взять текущий / 加载当前 将实时提示词复制到编辑器中。
- Показать / 显示 以只读方式显示提示词。
- 该开关选择 append（你的文本被添加到部署提示词之后）或 replace（你的文本成为整个系统提示词）。
- Сохранить и применить / 保存并应用 写入更改；它会在下一次模型请求时生效。

该覆盖存储在 $DSH_HOME/system-prompt-mod.json 中，并应用于每个 agent。当该 mod 被禁用时——这是默认状态——提示词不受影响。

包含 {{variable}} 组的文本在保存时会被 拒绝：harness 会严格插值这些内容，并且不提供转义语法，因此这样的提示词会破坏之后的所有请求。编辑器会解释这一点，而不是接受它。

俄语

设置 → 通用 → 语言 → Русский。 切换是即时的，选择会持久化到 $DSH_HOME/settings.yaml 中。

请求俄语的浏览器（Accept-Language: ru）会立即获得俄语 UI，无需访问设置——在存储显式选择之前，harness 会从浏览器获取区域设置。

任何未翻译的内容都会按 key 回退到英语，因此部分或过时的语言包会优雅降级，而不是留下空白。

技能

技能不是 mod：无需安装、无需重启、没有插件行。技能是一个指令文件夹，当任务匹配时 agent 会读取它，并且多个 harness——这个和其他——读取相同的 SKILL.md 格式。

| 技能 | 作用 |
|---|---|
| create-a-skill | 教 agent 编写好的技能，并衡量它是否有效。汇集自一个拥有 5000+ stars 的仓库中发布的每一个关于技能编写的技能，然后扩展了它们都没有的内容：一个 捆绑的清单运行器（scripts/check-skill.py，仅使用标准库）和一个 经过衡量的评估协议。 |

将该文件夹复制到你的 harness 的技能根目录中，它就会生效——关于该 harness 的七个根目录以及其他 harness 的约定，请参见它放在哪里。
纯文本，无二进制文件，无需构建。唯一的 Python 文件是一个检查器，只读取标准库，不读取其他任何内容，因此即使你删除它，该技能在任何 harness 中仍然可用。

卸载

node tools/install.mjs --uninstall

移除这些包以及此安装器添加的行，并将补丁文件恢复为其发布时的空形式。之后重新加载页面。

这些 mod 是如何接线的

这对更新很重要，因此值得了解：

- 一个 harness profile 是 $DSH_HOME/profiles// 下的一个目录，其中包含一个
package.json（包列表）和 cordis.patch.yml（你自己的补丁层）。
- 一个 profile 插件是一个 npm 形式的包，放置在 profile 的
node_modules 中，并在补丁层中添加一行：

- insert:
- id: locale-ru
name: '@local/dsh-locale-ru'

- 一个包通过在其 package.json 中声明 dsh.client，并以 harness 的
客户端模块系统所提供服务的格式导出一个 ./client 包，从而成为一个 浏览器 插件：

window.__ModuleLoader__.load({
id: "@local/dsh-locale-ru",
factory: (require) => { /* … / return module.exports }
})

- $DSH_HOME 不是 harness 安装的一部分。更新或
重新安装 harness 会替换安装；它会保留 home —— 你的
会话、设置、profiles 以及这些 mod —— 原样不动。

唯一可能丢弃这些 mod 的操作是安装 profile 依赖项
（dsh plugin --profile web …），因为这会运行 pnpm，而 pnpm 会移除
profile 清单中未列出的包。之后重新运行 node tools/install.mjs。

仓库布局

packages/
system-prompt-mod/   双面插件：宿主端 + 浏览器端
lib/index.js       宿主端：提示词部分 + /api/system-prompt.mod 路由
lib/client.js      浏览器端：头部按钮 + 编辑器对话框
locale-ru/           仅浏览器端插件
lib/client.js      由 tools/build-locale.mjs 生成
i18n/en|ru/        翻译源文件，每个语言命名空间一个文件
tools/
install.mjs          安装 / 卸载 / 备份
boot-check.mjs       验证所提供服务的启动图
build-locale.mjs     从 i18n/ 重新构建语言包
extract-locale.mjs   从 harness 安装中提取随附的词典
dev/                 开发与验证 harness（参见 tools/dev/README.md）
docs/
AI-INSTALL.md        供 AI 代理使用的安装运行手册
AI-PROMPT.md         让 AI 构建新 mod 的提示词 + 参考
VERIFICATION.md      已运行的每一项检查，以及未覆盖的内容
PUBLISH.md           如何发布此仓库（GitHub、GitVerse）
ROADMAP.md           尚未构建的 mod 想法
screenshots/         本文件使用的图片
.github/workflows/
ci.yaml              仅需 Node 的检查 —— 在 GitHub 和 GitVerse 上运行
AGENTS.md              在此工作的代理应了解的内容 —— 自动加载
向 packages/ 中放入一个目录即可添加一个 mod：
tools/install.mjs 在运行时发现该目录下的包，使用目录名
作为加载器行 id，并从其清单中读取包名。

面向 AI 代理

本仓库的设计目标是既可由人操作，也可由代理操作：

- AGENTS.md — 当代理在此目录中工作时由运行环境自动加载：
规则、目录结构以及命令速查表。
- docs/AI-INSTALL.md — 分步安装操作手册，每一步后都有
检查，并附有故障排除表。
- docs/AI-PROMPT.md — 一个可直接粘贴的提示词，用于让 AI
构建一个新的运行环境 mod：侦察流程、扩展点、确切的
客户端 bundle 格式、已验证的 API、陷阱以及交付物清单。

这两份文档也有俄语版本：docs/AI-INSTALL.ru.md、docs/AI-PROMPT.ru.md。

针对这些 mod 运行过的每一项检查——以及所有未
覆盖的内容——都记录在 docs/VERIFICATION.md 中。

兼容性

这些 mod 在特定版本上绑定到运行环境的插件 API：

| Mod | 依赖于 |
|---|---|
| system-prompt-mod | conversation.session.header.utilities 插槽、ctx.slots、ctx.systemPrompt.section、ctx.connection.fetch.register、ctx.agents.get，以及 Modal/Button/Switch/Tag 原语 |
| locale-ru | ctx.locale.addLanguage、ctx.locale.register(namespace, locale, dict)，以及随附的命名空间键集 |

该运行环境处于 1.0 之前的阶段，并在其自身的入门通知中声明核心插件
和基础 API 将持续变化。如果未来版本重命名了其中某一项，
mod 会停止加载——但会优雅地停止：语言包回退到英语，
而提示词 mod 只是不再注册其路由，因此 GUI 本身仍可
正常工作。修复通常只需一两行；安装程序也是任何运行环境升级后的恢复
途径。

由更新版运行环境添加的命名空间或键会保持英文，直到在用 tools/extract-locale.mjs 重新提取后
用 tools/build-locale.mjs 重新构建语言包。

开发

node tools/extract-locale.mjs              # shipped dictionaries -> locale-en.json
node tools/build-locale.mjs                # i18n/ru/.json -> lib/client.js
node tools/dev/test-host.mjs               # 11 unit checks on the prompt host half
node tools/dev/test-client.mjs             # 6 checks on the prompt browser bundle
node tools/dev/test-locale-ru.mjs          # language pack contract

单元测试需要能够从仓库解析运行环境包（@deepseek-ai/*），因此它们要在
已安装该运行环境的机器上运行；参见
tools/dev/README.md。

许可证

MIT。俄语词典是运行环境用户
界面的翻译，该界面采用 MIT 许可证；原始英文字符串仍为
其作者所有。