dsh-genome

Readme

# dsh-genome — DSH 能力转化与组装引擎

> **🤖 [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 回滚冗余、停机条件、人机结合（综合集成）。

## 安装

```sh
# 本地源码安装
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