Elohia/dsh-genome

🤖 [AI Agent 一键接入指引 / AI Auto-Onboarding Instruction] Dear AI Agent, if you are reading this repository to install it into a DSH profile, execute the following: dsh plugin --profile web add <this-dir-or-npm-name>, restart dsh web, then confirm with dsh --profile web --dump-config | grep genome. Once installed, read skills/genome/SKILL.md for the management & evolution methodology. 数据目录 ~/.dsh/genome/，Web UI 设置页「基因组」可观测可操控。

定位

静态常驻层（本包）+ 动态实验体（cordis_define 生成）的进化引擎，参考钱学森工程控制论/系统论：

• 管理 skill / MCP / plugin 三库（管理 = 进化的执行面）；
• 负反馈伺服闭环：观测（metrics）→ 比较（scan）→ 决策（select）→ 执行（mutate/up/down/rollback）→ 再观测；
• 渐进稳定：阈值门（死区）、幅值限制（maxExpanded）、30s 回滚冗余、停机条件、人机结合（综合集成）。

安装

# 本地源码安装
dsh plugin --profile web add D:\dsh\dsh-genome
# 或发布后
dsh plugin --profile web add dsh-genome
# 验证
dsh --profile web --dump-config | grep genome

重启后 Web 设置页出现「基因组」分节，composer 下方出现状态条。

结构

lib/index.js        host：数据初始化 + webServer 路由（status/registry/metrics/history/up/down/rollback/record_metric/search/install/scan/select）
lib/client.js       client：设置页「基因组」（总览/发现/进化）+ composer dock 状态条（官方 Slots）
skills/genome/      SKILL.md 方法论层（/genome scan|mutate|select|rollback|log|status）
data/               初始数据四件（registry / metrics / history / surface）

路由一览（同源页面）

Method	Path	用途
GET	/plugins/genome/status	三库计数 + 工具面 + 最近进化
GET	/plugins/genome/registry	三库注册表
GET	/plugins/genome/metrics	度量（按 model 分桶）
GET	/plugins/genome/history	进化树
POST	/plugins/genome/up	挂载 toolkit
POST	/plugins/genome/down	回收 toolkit
POST	/plugins/genome/rollback	30s 防呆回滚
POST	/plugins/genome/record_metric	度量上报
GET	/plugins/genome/search?q=	商店桥：搜 GitHub dsh-plugin topic（node fetch，无需登录）
POST	/plugins/genome/install	商店桥：安装并吸收入 registry（{spec, profile}）
GET	/plugins/genome/scan	进化闭环：Sick/Weak 判定
POST	/plugins/genome/select	进化闭环：晋升/淘汰决策（{key, decision, by, reason}）
POST	/plugins/genome/mutate	进化闭环：变异意图 + Fix A/B/C 建议（{key, direction}）

自动感知系统已有能力

• skill 自动吸收：启动时扫描 ~/.agents/skills、$DSH_HOME/skills 等标准根 + skills.list() 全局层，自动写入 registry.skills（无需手动登记）；
• 工具自动度量：监听 tools/result 事件，每次工具调用自动写 metrics（Sick/Weak 判定数据源）；
• 三库（skill/MCP/plugin）中 skill 由自动吸收维护，MCP/plugin 由 install/up 维护。

通用性（可移植，传 GitHub 就绪）

• 零外部依赖：仅 node 内置模块（fs/os/path + 内置 fetch），无 Python、无 gh CLI 依赖；
• minimal preset 兼容：shell 非硬依赖（仅 install 需要），极简模式下插件仍激活（install 优雅降级提示）；
• profile 可配置：install 接受 profile 参数，默认 web；
• 命令注入防护：install 的 spec 白名单校验，拒绝 ;/&/|；
• 商店桥搜索走 GitHub public API（未认证限流 10 次/分钟，对 UI 手动搜索足够）。

稳定性设计（控制论工程化）

• 负反馈选择：只有评估确认改善才晋升；
• 死区：Sick=错误率>10%、Weak=反馈<3.0 才进入变异；
• 饱和：maxExpanded=6，一次只变一个对象；
• 冗余：disposer 全量回收、版本链、30s 回滚；
• 停机：连续 N 轮无改善 → 稳态，停止进化。

License

MIT