Samouswolf / DSH-Plugins

⚠️ 安全声明：本仓库不含任何个人记忆数据、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 preset<br/>agent.cordis.yml] -->|挂载 file:///| DNA[DNA 记忆系统]
        A -->|挂载| FARM[Agent 农场]
        A -->|挂载| EVO[进化引擎]
    end

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

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

    EVO -->|复盘| MEM
    EVO -->|固化技能| SKILL[(技能库<br/>.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 · 作者保留署名权