社区插件集 iia-arg/dsh-plugins

俄语版：README.ru.md · 英文版见下

dsh-plugins

DeepSeek Harness 的社区插件，由我们自己的智能体集群在生产环境中编写和使用。

harness 是一套能力扎实的底座，插件模型异常干净——但也有几处尖锐的棱角：失败看起来和成功一模一样。这里的东西之所以存在，都是因为产品本身没有提供；每一行不那么直观的代码都带了注释，说明在这一行出现之前踩过什么坑。

这里有什么：41 个包

- Autopilot（1）——把项目从计划推进到经过验证的结果。
- А — 记忆家族 dsh-pamyat（12）
- Б — 智能体插件：订阅路由、工具、通道（7）
- В — 宿主监视器与工具（6）
- Г — 自有服务——不是智能体插件（2）
- Д — sadik 的宿主服务——仅源码（13）

А 组是记忆家族部分；Б–Д 组是平台插件的子节。

Autopilot（1）

Autopilot 按需求、任务、实现、评审、完成这几个阶段协调一个项目。它是一套独立系统，由固定版本的技能、Unix 账号团队、邮件服务和仪表盘组成；只装一个 npm 插件并不能把它部署起来。

| 包 | 本仓库中的版本 | 交付方式 | 作用 |
| dsh-autopilot | 0.1.16 | 从本仓库安装 | 项目工作流、固定运行时、团队邮件、公开仪表盘，以及回合结束时的近似用量统计。安装与依赖。 |

先从包指南看起：里面列出了必需的组件，并说明了必须提供的宿主配置。记忆家族是另一套东西；指南会指出服务端配置档和模型路由方面的依赖。所有包的当前版本：包目录。

记忆家族 dsh-pamyat（12）

А 组。 一起构建、一起校验的记忆层；dsh-pamyat-vyvoz 和 -obsluzhivanie 不在这一套里，是独立的包。

| 包 | 本仓库中的版本 | npm | 作用 |
| dsh-pamyat | 3.1.11 | dsh-pamyat | 这一套的名字：没有代码，只声明哪九个包是一起构建、一起校验的，具体是哪些版本，由谁完成。版本写死，拒绝范围——一个名字在不同人那里解析出不同的包集合，还不如没有名字。 |
| dsh-pamyat-core | 3.1.4 | dsh-pamyat-core | 基于 node:sqlite 的存储、写入决策日志，以及哪些类别需要确认的策略。没人能确认的节点会直接说出来，而不是照样悄悄写入。 |
| dsh-pamyat-omega | 3.1.4 | dsh-pamyat-omega | 通过 MCP 在外部存储之上的可选长期层。没有它也不会坏；你只是失去了把知识带离节点的能力。 |
| dsh-pamyat-secretary | 3.1.4 | dsh-pamyat-secretary | 在压缩覆盖历史之前先取摘要。写入被拒会大声报出来，不会悄悄吞掉。 |
| dsh-pamyat-restore | 3.1.4 | dsh-pamyat-restore | 读取侧：压缩之后把摘要放回去，启动时给一份简报。信任与时效由显式分支在任何比较之前读取 —— 缺失的数字永远不会变成零。 |
| dsh-pamyat-byudzhet | 3.1.4 | dsh-pamyat-byudzhet | 传入的预算：要把多少过去的内容抬回上下文。它的缺席会被宣告 —— 「预算未生效」不能和「已生效但什么都没丢」分不出来。 |
| dsh-pamyat-nudzh | 3.1.4 | dsh-pamyat-nudzh | 开销记账：是不是该压缩了。统计的是窗口占用（最后一次调用的输入），不是所有调用的总和 —— 总和会无界增长，压缩永远减不下去。 |
| dsh-pamyat-storozha | 3.1.8 | dsh-pamyat-storozha | 智能体内部的记忆看守：压缩通知、填充阶段、会话覆盖；记忆维护程序。 |
| dsh-pamyat-kompakt | 3.1.2 | dsh-pamyat-kompakt | 共享压缩库：窗口占用、智能体阈值、用我们自己的模型生成摘要、原子重写会话日志。 |
| dsh-pamyat-kompakt-dsh | 3.1.4 | dsh-pamyat-kompakt-dsh | 平台原生压缩里的摘要引擎：摘要由 dsh-pamyat-kompakt 模型写，被拒时用原生模型。 |
| dsh-pamyat-vyvoz | 3.1.4 | dsh-pamyat-vyvoz | 记忆导出与导入：在数据库之间搬运语义。不属于 dsh-pamyat 套件。 |
| dsh-pamyat-obsluzhivanie | 3.1.5 | dsh-pamyat-obsluzhivanie | 夜间智能体记忆维护：经验迁移、清理、OMEGA 配对判定、一致性检查；结果汇总成一行告警。 |

平台插件（28）

分组 Б–Д。

Б — 智能体插件：订阅路由、工具、通道（7）

每个都能单独用，也能单独安装。

| 包 | 本树中的版本 | npm | 做什么 |
| dsh-subscription-gateway | 3.1.10 | dsh-subscription-gateway | 让 harness 跑在厂商订阅上，而不是按 token 计费。每个智能体一个 systemd 服务：token 只存在一个地方，模型循环走厂商自己的 SDK，回答流式返回。不是插件：是服务。 |
| dsh-subscription-adapter | 3.1.3 | dsh-subscription-adapter | 订阅路由的 DSH 侧：一个适配器，让 harness 能和订阅网关对话。 |
| dsh-tool-bridge | 3.1.9 | dsh-tool-bridge | 让外部引擎驱动的模型也能调用 harness 插件工具，不必依赖 harness 自己的循环。harness 自带 MCP 客户端，却没有服务端——这个包就是那个服务端。 |
| dsh-telegram-multiagent | 3.1.15 | dsh-telegram-multiagent | 在 Telegram 里和你的智能体对话。共用一个模块，每个智能体各自配置。支持文字和语音、白名单、按聊天划分会话，还可选开启基于文件的智能体间通道。 |
| dsh-schedule-guard | 3.1.3 | dsh-schedule-guard | 防止会自我调度的智能体失控：限制连续自唤醒次数和每日自唤醒次数，强制最小重复间隔，删除失控的重复唤醒，并告知所有者原因。这是行为约束，不是安全边界——它自己也明说了。 |
| a2a-bus | 3.1.7 | 仅源码 | 让同一台机器上的智能体直接互相写信，同时不放弃隔离。每个智能体拥有一个别人无法列出的信箱；以 root 身份运行的邮差负责转移信件的所有权，信件投递后发件人就失去访问权。不是插件：一个 spool、一个服务和一个定时器。 |
| voice-stack | 3.1.1 | 仅源码 | 在本机 GPU 上做本地语音识别——智能体能听懂语音消息，音频不必发到任何人的云上。不是插件：一个服务，配一条命令的契约。 |

dsh-subscription-gateway、dsh-tool-bridge 和 dsh-schedule-guard 讲的是同一个故事，但每个单独用也有价值。在订阅上运行 harness（dsh-subscription-gateway）；让这样驱动的模型仍能调用 harness 自己的工具（dsh-tool-bridge）；如果你接着允许智能体自己安排唤醒，就给它设个上限（dsh-schedule-guard）。三者的设计说明，包括其中的坑，都在 docs/DESIGN.md。

В — 宿主监视器与工具（6）

给智能体所在的宿主、以及智能体自己的 shell 用的程序。

| 包 | 本树中的版本 | npm | 作用 |
| dsh-pribory | 3.1.4 | dsh-pribory | 针对智能体自我欺骗的 shell 工具：没有管道的退出码、按 unit 停止、PATH 里的同名项、谁启动了某个服务、带语法检查的原子放置。 |
| dsh-reestr | 3.1.10 | dsh-reestr | 宿主干预登记册：平台上额外装了什么、装在哪，意图与磁盘的核对，带备份的登记册编辑，以及针对未提交改动、包接缝和锁文件的监视器；从本树安装——本树即生产，没有便携版。 |
| dsh-storozha-mashiny | 3.1.6 | dsh-storozha-mashiny | 给运行多个 AI 智能体的宿主用的看门狗：unit 和定时器、内核与 DKMS、更新、IPv6、包副本、临时目录残留、上下文溢出；通过一条命令告警。 |
| dsh-trevogi | 3.1.10 | dsh-trevogi | 共享告警发送器与日志监视器：所有看门狗共用一条告警命令；探针带标记，不会用误报吵醒主人。 |
| oom-watch | 3.1.4 | 仅源码 | 了解内存限制何时杀掉了你的智能体。读内核日志，不读重启就归零的 cgroup 计数器。不是插件：是 systemd 定时器。 |
| omega-memory | 3.1.1 | 仅源码 | 智能体的长期记忆，跑在你自己的机器上：服务账号模型、systemd 单元，以及真正能连到智能体的接线。 |

Г — 自有服务 —— 不是智能体插件（2）

带 package.json 的独立服务：按 npm 包安装，但作为宿主机服务运行，而不是作为插件跑在智能体的配置档里。

| 包 | 本仓库中的版本 | npm | 做什么 |
| dsh-socseti | 3.1.10 | dsh-socseti | 社交媒体应用：Telegram、草稿与审批（socseti 服务）。不是插件：是服务。 |
| dsh-vypusk-watch | 3.1.8 | dsh-vypusk-watch | 发布窗口监视器：拿已安装的包对照其版本对应的 git tag，生产环境偏离发布版本时告警。 |

Д — sadik 的宿主机服务 —— 仅源码（13）

没有 package.json：文件由注册表条目铺到宿主机上。以源码形式发布，作为配置示例，不是可安装的包。

| 包 | 本仓库中的版本 | npm | 做什么 |
| dsh-compact-outcomes | 3.1.3 | 仅源码 | Codex 编码智能体的压缩结果观察器：token 掉了却没有 DSH 压缩事件时告警。不是插件：是那些智能体平台内部的传感器，外加一个 systemd 定时器。 |
| dsh-gateway-ingress | 3.1.2 | 仅源码 | 网关入口：启动时根据智能体注册表构建 nft 表，只允许 root、智能体账号和许可的调用方访问各网关端口。 |
| dsh-gosti | 3.1.3 | 仅源码 | 访客回路：网站聊天适配器、访客会话过期、员工名单写入 PII 掩码白名单、访客沙箱、访客 OMEGA 网关。 |
| dsh-kopiya-mashiny | 3.1.8 | 仅源码 | 每夜宿主机备份及其按动作验收；覆盖率、大小与空间监视器；OMEGA 数据库备份。 |
| dsh-limity | 3.1.8 | 仅源码 | 订阅限额服务：Claude、Codex 和 DeepSeek 的用量测量汇成一张表，输出 limity.json，阈值告警，自动切换共享网关。EN |
| dsh-montazh | 3.1.46 | 仅源码 | 部署到生产环境，带备份与校验；本地发布标签闸门会留下闸门痕迹（树外的根日志）；转入树内；主体校验和；部署监视器；以及针对越过闸门放置的标签的看门狗。 |
| dsh-obhod-stendov | 3.1.120 | 仅源码 | 按生产布局每晚和每周巡检主机的各套环境：运行器、清单、例外，以及环境本身。 |
| dsh-okno | 3.1.6 | 仅源码 | 升级窗口用的手动 root 工具：准入、SDK 层清单、会话日志重打包、OMEGA 服务密钥。 |
| dsh-pochta | 3.1.6 | 仅源码 | 协调信件与槽位：tell-komu、回执监视器与滞留信件监视器、邮件停止。 |
| dsh-podpiski | 3.1.6 | 仅源码 | Claude 与 Codex 订阅：切换器、token 访问、Codex 监视器与刷新器、/switch 接收端。EN |
| dsh-podyom | 3.1.4 | 仅源码 | 拉起智能体服务（podyom-uzla），以及拉起前后的检查。 |
| dsh-set-sadik | 3.1.5 | 仅源码 | 主机网络：分流路由、回程路由、VPN 故障切换、killswitch、网络检查。 |
| dsh-storozha-sadik | 3.1.28 | 仅源码 | 共享集合之外的主机监视器：sadik-watch、告警通道、压缩监视器、权限组监视器、外部观察、环境运行读取器。 |

文档

- docs/MEMORY-AND-A2A.md —— 把记忆流水线 dsh-pamyat 与智能体间邮件（A2A）当作一个系统来讲：接缝、服务、设置、拒绝、输入过滤器、发布与验收顺序、环境。俄文原文：docs/MEMORY-AND-A2A.ru.md。
- docs/DESIGN.md —— 工具桥、自唤醒和订阅路线的设计笔记。
- docs/SAMOPROBUZHDENIE.md（俄文）—— 这里的智能体自唤醒是怎么搭的：平台已有什么、我们加了什么、多个智能体共用一台机器时哪些会变。
- docs/SVERSHCHIK-PUBLIKACIJ.md（俄文）—— 发布协调器：运行系统 ↔ 仓库 ↔ 注册表。
- 两份验收结论记录（docs/OT--verdikty-0607-0709.md、docs/OT--verdikty-0909-1409.md，俄文）—— 审核员在 2026 年 09.06–07.09 和 09.09–14.09 给出的结论，作为历史留存；是否公开由所有者决定。
- DOGOVOR-OTNOSHENIJ-PAMYATI.md（俄文）—— 记忆记录之间关系的约定（dsh-pamyat-core 的 otnoshenie / otnositsya_k 字段）。
- SUMMY-PAKETOV-20260911.md（俄文）—— 2026 年 11.09 已验收的包校验和。
- tools/ — 仓库检查与金丝雀检查：check-readme-index.sh（本 README 里每个包目录都有名字，每个链接都指向其中一个）、check-readme-count.sh（标题里的计数与表格、packages/ 一致）；金丝雀检查在 packages/dsh-obhod-stendov/dorabotki/（B-N-1964、B-N-1995）：kanarejka-restarta（重启后智能体还会回来吗——重启前检查）和 kanarejka-shlyuza（网关同理）。

后续做出来的东西还会往这里放。一个仓库，多个包——每个插件单开一个仓库不值当。

检查

每个包都有检查台。没有可检查项的检查台以退出码 2（「盲」）退出，而不是 0：「检查没跑」不能看起来像「检查通过」。host-service 类包的部分检查台会碰到真实机器——包的 README 在检查那一节会写明。

安装

单个智能体插件，按它自己的包指南操作。Autopilot 有单独的安装流程。插件安装示例：

inside your profile directory ($DSH_HOME/profiles/<name>)
pnpm add dsh-telegram-multiagent

然后把插件行加进你的智能体预设——每个包的 README 都写明了加在哪、为什么。

为什么公开

两个原因。这套 harness 周围的插件生态还很薄，而一条能用的消息通道是大多数人最先需要的东西。另外，注释比代码更值钱：注释点出了那些坑，它们能产出绿色的对勾，却产不出能跑的系统。

如果这里的东西帮你省下一个晚上，那就值了。

MIT：协议文本在仓库根目录的 LICENSE 文件里；自带 LICENSE 的包，文本相同。