EmmanuelMartinez/tolten-aegis

🛡️ Tolten Aegis

CI

让 DeepSeek Harness 在任何项目上都万无一失的护盾。

规则被强制执行。知识已加载。控制权在你手中。

Tolten Aegis 是一个 DeepSeek Harness 的通用插件，它把你项目的
.agents/ 知识——规则、技能和 MCP 服务器——转化为被强制执行的上下文
以及一个高级控制中心。一个插件。任何项目。零配置漂移。

🇲🇽 Hecho en México（墨西哥制造）——由
Ing. Oscar Emmanuel Martínez Galán 倾心打造
· oe.martinez03@gmail.com

为什么选择 Aegis？

每个项目都已经有一个大脑：团队达成共识的规则、编码了如何构建的技能、
暴露应用工具的 MCP 服务器。但你的智能体在你提醒它之前会忽略它们。Aegis 永久地改变了这一点。

| 超能力 | 作用 |
|---|---|
| ⚖️ 宪法，始终有效 | 你项目的规则（rules/DEEPSEEK.md）会被注入到每一个模型步骤中。不再有“我不知道这些规则”。 |
| 📚 知识触手可及 | 用三个原生工具（agents_index、agents_read、agents_search）浏览、搜索和阅读 .agents/skills + .agents/rules。 |
| 🎛️ 控制中心面板 | 一个高级 M3 面板：实时状态、MCP 服务器管理、知识编辑——全局和按项目作用域。 |
| 🔌 MCP 就在项目所在之处 | 全局服务器位于 ~/.dsh/aegis-mcp.json，项目服务器位于 .agents/mcp.json——标准 MCP 格式。 |

📂 .agents 标准

Aegis 采用了新兴的全球标准，用于项目级智能体知识——
每个项目一个文件夹，任何工具都可读取：

.agents/
├── skills//SKILL.md     ← 技能：如何构建 X，每个技能一个文件夹
├── rules/DEEPSEEK.md           ← 你的项目宪法（最高法律）
└── mcp.json                    ← 项目 MCP 服务器（标准 mcpServers 格式）

宪法回退顺序（以下任意一个都有效，DEEPSEEK.md 优先）：
.agents/rules/DEEPSEEK.md → .agents/rules/CLAUDE.md → .agents/rules/AGENTS.md
→ .clinerules（根目录）→ AGENTS.md（根目录）→ 任意 .agents/rules/.md。

DEEPSEEK.md 是一个纯 Markdown 文件。写下你团队赖以生存的规则——
架构、代码质量、约定——Aegis 会让智能体在每一步都自动遵守它们。

🚀 安装

三种方式——选择适合你工作流的一种：

1. 智能体预设（推荐——持久且可共享）
git clone https://github.com//tolten-aegis.git
cp -r tolten-aegis/preset ~/.dsh/.agent-presets/tolten-aegis
重启 dsh，然后在预设选择器中选择 "Tolten Aegis"

2. 动态插件（快速演示）
打开一个 DSH 会话，将 plugin/host.js + plugin/client.js 作为动态
Cordis 插件（或将它们粘贴到 cordis_define 工具中）。批准运行。

3. 宿主组合（MCP 桥接）
将 template/.agents/mcp.json.example 中的 MCP 行添加到你的
cordis.patch.yml（全局），或将它们按项目保留在 .agents/mcp.json 中。

注意： 将 plugin/host.js 中的 DSH_HOME 设置为你的安装路径
（echo $DSH_HOME —— 通常为 ~/.dsh）。

🎮 使用方法

- 面板：设置（⚙️）→ Tolten Aegis —— 概览 / MCP 服务器 / 知识。
- 工具（原生，可由智能体调用）：
- agents_index —— 列出项目中的每个技能和规则。
- agents_read —— 读取 .agents/* 的任意文件或宪法。
- agents_search —— 查找哪个技能/规则涵盖某个主题。
- 宪法：创建 .agents/rules/DEEPSEEK.md，它将在每一步强制执行。

🗂️ 仓库结构

tolten-aegis/
├── README.md            ← 你在这里
├── LICENSE              ← MIT © Ing. Oscar Emmanuel Martínez Galán
├── plugin/
│   ├── host.js          ← 宿主部分（知识 + MCP 桥接 + 处理器）
│   └── client.js        ← 客户端部分（控制中心面板）
├── preset/              ← 可安装的智能体预设（持久）
│   ├── agent.cordis.yml
│   └── preset.yml
├── template/.agents/    ← 将此文件夹放入任意项目
│   ├── rules/DEEPSEEK.md
│   ├── skills/README.md
│   └── mcp.json.example
└── examples/            ← 实际使用示例

🤝 社区

Tolten Aegis 是开源且由社区驱动的。我们希望 DeepSeek Harness
社区帮助磨砺这面盾牌：

- 🐛 报告错误、💡 建议功能，或 🔧 提交 PR —— 参见
CONTRIBUTING.md。
- 🌱 将 .agents 标准带入你的项目，并告诉我们缺少什么。
- 🧪 需要帮助的已知领域：cordis.patch.yml HMR 桥接重载（参见 CONTRIBUTING）。

🤝 贡献与支持

| 位置 | 用途 |
| --- | --- |
| CONTRIBUTING.md | 标准、开发循环和 PR 期望。 |
| Issues | 错误报告和功能请求（提供模板）。 |
| Discussions | 问题、想法，以及展示你构建的内容。 |
| SECURITY.md | 私密漏洞报告。 |
| CHANGELOG.md | 每个版本的变更内容。 |
| CODE_OF_CONDUCT.md | 我们要求自己遵守的社区标准。 |

在本地运行与 CI 相同的检查：

node scripts/validate.js

🌎 Tolten 生态系统

共享相同标准的插件（MD3、双部分、诚实的诊断）：

| 仓库 | 它是什么 |
|---|---|
| tolten-aegis | 🛡️ 本仓库 —— .agents 宪法、知识工具、MCP 控制中心 |
| tolten-workspace-explore | 🗂️ 将聊天推到一旁的 Files & Git 停靠栏（树、源代码管理、只读分支历史、拖拽到聊天 @path） |
| tolten-image-attach | 🖼️ 附加一张图片，会话会自动切换到视觉模型 |

🧪 许可证与致谢

MIT — © Ing. Oscar Emmanuel Martínez Galán（🇲🇽）。
基于 DeepSeek Harness 构建。