Samouswolf/DSH-Plugins

🧠 DSH 插件

把 Hermes 式的「DNA 记忆 + 多 Agent 农场 + 能力进化」带入 DeepSeek Harness

License-MIT
Language-JavaScript/Python
Zero-Sensitive
DSH-Ready

中文 · English

⚠️ 安全声明：本仓库不含任何个人记忆数据、API 密钥或本机私有路径。所有凭据均通过环境变量 / 配置文件注入。请勿提交 .env、任何 key 或 .dna/ 数据。详见 SECURITY.md。

📦 包含的插件

| 插件 | 入口目录 | 作用 |
|------|----------|------|
| DNA 记忆系统 | dna-plugin/ · dna_bridge/ · dna_system/ | 零模型依赖的「联想大脑」：召回/沉淀记忆、MOA 多模型辩证、双库同步、会话自动注入身份记忆 |
| Agent 农场 | agent-farm/ | 探测本机多种本地 Agent（Hermes/WorkBuddy/Claude/Codex/Agnes），状态看板 + 一键派活 |
| 进化引擎 | evolution-engine/ | 复盘记忆库与技能库，把 Agent 产出的经验持久化固化为可复用技能 |

📁 仓库结构

DSH-Plugins/
├── dna-plugin/        # DNA 记忆 DSH 插件入口 (.mjs)
├── dna_bridge/        # DNA 记忆 Python 桥接 (bridge/debate/sync)
├── dna_system/        # DNA 记忆核心 (Brain: 四层记忆池 + 坐标共振 + 虫洞)
├── agent-farm/        # Agent 农场 (Host 插件 + 桥接 + 前端看板)
├── evolution-engine/  # 进化引擎 (复盘 + 技能固化)
├── docs/              # 安装/注意事项 (中英双语)
├── .github/           # Issue / PR 模板
├── config.example     # 环境变量模板 (复制即用)
└── LICENSE            # MIT

🧭 架构总览

flowchart TB
subgraph DSH["DeepSeek Harness"]
A[Agent presetagent.cordis.yml] -->|挂载 file:///| DNA[DNA 记忆系统]
A -->|挂载| FARM[Agent 农场]
A -->|挂载| EVO[进化引擎]
end

DNA -->|召回/沉淀/辩证/同步| MEM[(本地记忆库~/.dna)]
DNA -->|调用桥接| PYBR[Python 桥接dna_bridge + dna_system]

FARM -->|探测/派活| LOCAL[本地 AgentHermes · WorkBuddy · Claude · Codex · Agnes]
FARM -->|HTTP 看板| WEB[浏览器/api/farm]

EVO -->|复盘| MEM
EVO -->|固化技能| SKILL[(技能库.skills/SKILL.md)]

style DSH fill:#6d28d9,color:#fff
style DNA fill:#f59e0b,color:#000
style FARM fill:#2563eb,color:#fff
style EVO fill:#059669,color:#fff

🚀 快速开始

1. 把插件目录拷入你的 DSH 工作区（保持目录名一致）
/dna-plugin、/dna_bridge、/dna_system、/agent-farm ...

2. 在 agent preset（agent.cordis.yml）里按需挂载
- id: dsh-dna
name: 'file:////dna-plugin/index.mjs'

- id: agent-farm
name: 'file:////agent-farm/index.mjs'

- id: evolution-engine
name: 'file:////evolution-engine/index.mjs'

3. 配置环境变量（key 由你自己填）
复制 config.example 并填写，每个变量的含义见 docs/INSTALL.md

完整步骤见 安装与配置。

🔑 需要你自己准备的 Key

| 能力 | 需要的 Key |
|------|-----------|
| MOA 辩证 / DNA 系统 | DeepSeek API key（DEEPSEEK_API_KEY） |
| Agent 农场 · Agnes 生图/生视频 | Agnes API key（AGNES_API_KEY） |
| Agent 农场 · Claude/Codex 走中转 | Opencode 中转 key（OPENCODE_API_KEY） |
没有 key 时对应功能自动降级为「不可用 / 跳过」，不会阻止其他插件启动。

🎯 示例 / Examples

看实际用法最快的方式：

| 示例 | 内容 |
|------|------|
| agent-preset-snippet.yml | 最小挂载片段（复制即用） |
| dna-quick-usage.md | DNA 记忆工具对话用法 |
| agent-farm-usage.md | Agent 农场对话用法 + Key 依赖 |
| evolution-skill-example.md | 记忆 → 技能固化完整流程 |

📚 文档

| 文档 | 内容 |
|------|------|
| 安装与配置 | 前置条件、分插件安装、环境变量全表、验证方法 |
| 注意事项 | 安全边界、隐私、常见坑、故障排查 |
| 安全问题报告 | 报告漏洞 / key 泄露的处理方式 |

🤝 贡献

欢迎提交 Bug 报告 与 功能建议，也欢迎 PR。请先阅读 贡献指南。

🛡️ 隐私 / Security

- 本仓库零敏感内容：无个人记忆、无业务数据、无本机路径、无硬编码 Key。
- 记忆数据写在你本地的 DNA_MEMORY_DIR（默认 ~/.dna），不会进入仓库。
- 查阅 SECURITY.md 与 注意事项。

License

MIT © 2026 · 作者保留署名权