iia-arg/dsh-plugins

dsh-plugins

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

该 harness 是一个能力出众的底盘，拥有异常干净的插件模型——同时也有一些尖锐的边缘，
在这些地方，失败看起来和成功一模一样。这里的一切之所以被写出来，都是因为产品本身没有
提供它，而每一行不那么显而易见的代码都带有注释，解释在这一行存在之前出过什么问题。

这里有什么：15 个包，两种类型

平台插件（8 个） —— 彼此独立的组件，每个解决 harness 留下的一个
问题。其中任何一个都可以单独安装。

记忆家族 dsh-pamyat（7 个） —— 一套一起构建和检查的
组件：这些层让 agent 的记忆能够在一次压缩和一次重启后存活下来。按名称安装整套：
npm i dsh-pamyat。

两种类型，而不是一个列表：平台插件单独就有用，记忆层则要与其同类一起才有用。把它们
算作一个数字会掩盖这种差异。

平台插件（8 个）

| 包 | 它做什么 |
|---|---|
| telegram-multiagent | 从 Telegram 与你的 agent 对话。一个共享模块，按 agent 配置。支持文本和语音、白名单、按聊天划分的会话，以及可选的基于文件的 agent 间通道。 |
| subscription-gateway | 在厂商订阅上运行 harness，而不是按 token 计费。每个 agent 一个 systemd 服务：token 只存在于一个地方，模型循环通过厂商自己的 SDK 运行，回答流式返回。不是插件：而是一个服务。 |
| tool-bridge | 让 harness 插件工具能够被由外部引擎驱动、而非 harness 自身循环驱动的模型访问。harness 自带 MCP 客户端但没有服务端——这就是那个服务端。 |
| schedule-guard | 防止自我调度的 agent 失控：限制连续和每日自我唤醒次数，强制最小重复间隔，删除失控的重复项，并告知所有者原因。这是行为层面的，不是安全边界——而且它明确这么说。 |
| voice-stack | 在本机 GPU 上进行本地语音识别——agent 无需将音频发送到任何人的云端就能听到语音消息。不是插件：而是一个带一行命令契约的服务。 |
| omega-memory | 在你的机器上为 agent 提供长期记忆：服务账户模型、systemd 单元，以及真正能到达 agent 的接线。 |
| oom-watch | 了解内存限制何时杀死了你的 agent。读取内核日志，而不是重启后会重置的 cgroup 计数器。不是插件：而是一个 systemd 定时器。 |
| a2a-bus | 让同一台机器上的智能体直接互相写入，而无需放弃隔离。每个智能体拥有一个其他任何人都无法列出的邮箱；一个以 root 身份运行的邮差负责转移信件的所有权，因此发送方在信件送达后便失去访问权限。这不是插件：而是一个假脱机、一个服务和一个定时器。 |

记忆家族 dsh-pamyat (7)

测试框架通过摘要来压缩一段长对话——而摘要会在进程重启的那一刻消失。这些包为智能体提供能够在此之后存活的记忆，并拆分为多个层，每一层只做一件事，并明确说出自己做不到什么。

| 包 | 作用 |
|---|---|
| dsh-pamyat | 这一集合的名称：没有代码，只是声明哪六个包是在一起构建和检查的，具体是哪些版本，以及由什么完成。版本是精确的，拒绝范围——一个对不同人解析为不同集合的名称，比没有名称更糟。 |
| dsh-pamyat-core | 基于 node:sqlite 的存储、写入决策日志，以及哪些类别需要确认的策略。一个没有人可以确认的节点会大声说出来，而不是默默照写不误。 |
| dsh-pamyat-secretary | 在压缩覆盖历史之前取走摘要。被拒绝的写入会被大声喊出，而不是被吞掉。 |
| dsh-pamyat-restore | 读取侧：在压缩之后把摘要放回去，并在启动时提供简报。信任度和年龄在任何比较之前通过一个显式分支读取——缺失的数字永远不会变成零。 |
| dsh-pamyat-byudzhet | 传入预算：要把多少过去重新提升到上下文中。它的缺失会被宣告——“预算未应用”绝不能与“已应用且没有丢弃任何内容”无法区分。 |
| dsh-pamyat-nudzh | 开销核算：是否到了该压缩的时候。统计的是窗口占用率（最后一次调用的输入），而不是所有调用的总和——总和会无界增长，而压缩永远不会减少它。 |
| dsh-pamyat-omega | 通过 MCP 在外部存储之上的可选长期层。没有它也不会出问题；你只是失去了把知识带离节点的能力。 |

按名称安装这一集合——npm i dsh-pamyat 会拉取这六个包的精确版本。每一层也可以单独使用。每个包都带有一个 stand 套件；一个无法检查任何内容的 stand 会以 2（“没有可检查的内容”）退出，而绝不会是 0，因为“没有运行任何检查”绝不能看起来像“检查已通过”。

subscription-gateway、tool-bridge 和 schedule-guard 是同一个故事，而每一个单独使用也都有用。在订阅上运行测试框架（subscription-gateway）；让以这种方式驱动的模型仍然能够访问测试框架自己的工具（tool-bridge）；而如果你随后让智能体安排它的
自己的唤醒，给它设个上限（schedule-guard）。三者的设计说明，包括陷阱，
都在 docs/DESIGN.md 里。

文档

- docs/MEMORY-AND-A2A.md — 记忆流水线 dsh-pamyat 和
智能体间邮件（A2A）作为一个系统：接缝、服务、设置、拒绝、输入过滤器、
发布与验收顺序、试验台。俄文原文：docs/MEMORY-AND-A2A.ru.md。
- docs/DESIGN.md — 工具桥、自唤醒和
订阅路线的设计说明。

随着我们继续构建，这里会有更多内容。一个仓库，多个包——每个插件单独一个仓库
不值得那份额外开销。

安装

每个包都是独立的：

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

然后把插件行添加到你的智能体预设中——每个包的 README 都准确说明了位置和原因。

为什么要发布这个

两个原因。围绕这个 harness 的插件生态很单薄，而一个能用的信使通道
是大多数人最先需要的东西。而且注释比代码更有价值：它们点出了那些
产生绿色对勾却没有可用系统的陷阱。

如果这里的某些东西能帮你省下一个晚上，那就达到目的了。

MIT。