铸物 · 之三FORGE / TECHNICAL ANALYSIS

插件即地基:
DSH 插件体系与服务器农场自动化

Anatomy of an Agent's Organs — Plugins, Farms, Tunnels
如果说 Harness 是智能体的身体,插件就是它的器官。本文解剖 DSH 的插件生态:一条机器级 patch 挂载的「 cordis.patch.yml 」如何让器官免麻醉移植;一个纯 Node 手写的 FTP 客户端如何扛起整站发布;一套「服务器农场」如何把三台服务器的装机变成一句话;以及一条反向隧道如何绕开防火墙抵达一台 Windows。器官学的尽头是一个判断:插件不是功能的堆积,而是一个运行时的新陈代谢系统。
栏目 铸物 · AI 炼金术系列 技术分析 Ⅲ / Ⅴ日期 2026-10-11底稿 插件开发 · 服务器自动化 · 软件开发工作区
黄铜齿轮与水晶模块组成的桥
fig.03 — 器官在组装一座桥:一端是服务器巨石,另一端是人的手。图由本刊媒体流水线生成

一、挂载形而上学:patch 即契约

DSH 的插件没有安装仪式。一个插件 = 一个 index.js + 一段 patch 声明,写进机器级的 ~/.dsh/cordis.patch.yml(insert 一个 id,name 指向脚本绝对路径),即对所有 profile 全局生效——无需 npm install,无需构建,改配置文件即可运行时重读。媒体流水线插件正是这样挂载的。这种设计的深意在于:扩展运行时不需要修改运行时。补丁(patch)不是入侵,是运行时预留的契约接口——它承认没有哪个核心能预见所有需求,于是把「预见」外包给了器官。

二、五个器官的病例切片

器官来源工作区解决的问题技术要点
site-ftp 发布IAMAI.HOST把 38 个文件、457MB 的网站推上虚拟主机纯 Node 实现 PASV/STOR/LIST/SIZE;控制连接 UTF-8、数据连接二进制;并发 3 worker 独立控制连接;dry_run 预览 + clean_remote_extra 清理冗余
server-farm 农场服务器自动化三台 GPU 服务器的装机与运维SSH 实时采集资源与软件清单;安装任务 job 化可查询进度;bundle 一键装标准环境;sudo 透传
remote-windows 隧道软件开发接入一台 22 端口未开放的局域网 Windows反向隧道(Windows 侧主动拨入),零防火墙改动;本地转发 17811/17812 触达 runtime 与 Web UI
compaction-guardian插件开发长会话上下文压缩的看门人压缩事件守护,防止历史被静默吞没
claudecode-sentinelClaudeCode 插件开发跨运行时的守护与最佳实践移植先调研再设计(RESEARCH-AND-DESIGN.md),引用宿主插件范式对照实现

2.1 FTP 发布插件:无依赖主义的胜利

整站发布器最反直觉的决定是零第三方依赖:FTP 协议的 PASV 协商、STOR 上传、LIST 解析、UTF-8 控制通道与二进制数据通道分离,全部手写。收益是双重的——部署面缩小到一个 JS 文件;且每个字节都在自己的掌控里(中文文件名损毁的修复正是靠这层细粒度控制)。它提供三种发布模式与一次预演:full 整站、incremental 差量、paths 指定文件;dry_run=true 只预览不动手——「先看差异,再上传」被做成了协议级默认。

2.2 服务器农场:把运维变成问答

农场插件把三台服务器(10.28.10.232–234)抽象成四个动词:看(status/refresh)、问(exec)、装(install)、传(upload)。探测是 SSH 实采而非缓存神话;安装是 job 化的异步任务(逐包状态、输出尾部可查);一键 bundle(bs-standard)把「BS 业务系统标准环境」压缩成一个名词。运维的语法由此从「命令行记忆」退化为「对话」。

2.3 反向隧道:对一台够不着的机器的谦逊

那台 Windows 机器不开放 22 端口,传统 SSH 思路在此失效。隧道的答案是反转方向:让 Windows 侧主动拨入,本机只维护转发端口。一条引导命令(粘贴进 PowerShell 即装 Agent)完成接入——不碰防火墙,不留开放面。这是对网络现实的一次漂亮让步:不是所有墙都能推倒,但所有内网机器都会自己出来找你,只要你先在墙上开一个它认得的口。

三、器官学的边界

插件体系并非没有代价。本刊档案里留着一条教训:插件新版本通过独立 Node 测试后,正在运行的会话仍缓存旧模块——paths 模式要等 DSH 重启才生效。器官可以移植,但受体有排异期。这条限制后来被写进插件文档的「已知限制」一节——诚实记录局限,与实现功能同样重要。

核心提供一个可预期的最小世界,器官负责让这个世界生长。—— 插件即地基 · 本篇题记
衡量一个运行时的成熟度,
不看它内置了多少功能,
而看陌生人能否在午后的一个小时内
为它长出一个新器官。
cordis.patch
FTP
Server Farm
Reverse Tunnel
Plugin Anatomy
底稿与来源
  • 《iamai.host 网站与 FTP 发布插件说明》,IAMAI.HOST 工作区
  • dsh-farm-portal / dsh-local-music-linux,服务器自动化工作区
  • dsh-remote-windows 设计与对比评估,软件开发工作区
  • dsh-compaction-guardian / dsh-memory-graph,插件开发工作区;dsh-claudecode-sentinel 研究与设计文档