一个集成知识图谱、任务队列、治理框架和滚动规划工作流的Hermes Agent插件，为AI Agent提供企业级的项目管理和代码治理能力。

• 原作者/维护者：CardSorting
• 来源平台：github
• 原始标题：dietcode-plugin
• 原始链接：https://github.com/CardSorting/dietcode-plugin
• 来源发布时间/更新时间：2026-06-10T22:14:33Z

DietCode：Hermes Agent的多功能治理插件套件\n\n## 原作者与来源\n\n- 原作者/维护者： CardSorting\n- 来源平台： GitHub\n- 原始标题： dietcode-plugin\n- 原始链接： https://github.com/CardSorting/dietcode-plugin\n- 发布时间： 2026-06-10\n\n## 背景：AI Agent需要什么样的工具链\n\n随着大语言模型驱动的AI Agent逐渐从实验走向生产环境，开发者们面临一个新的挑战：如何让这些Agent真正胜任复杂的软件工程任务？\n\n简单的问答式交互已经无法满足需求。真正的软件工程需要：\n\n- 知识管理：理解代码库的结构、依赖关系和演进历史\n- 任务调度：管理异步操作、队列状态和执行顺序\n- 治理控制：确保变更经过审查、验证和审计\n- 规划能力：将大目标分解为可执行的步骤并跟踪进度\n\nDietCode插件正是为解决这些需求而设计的综合性解决方案。\n\n## DietCode 概述\n\nDietCode是一个独立的Hermes Agent插件，将多个核心功能模块打包到一个可安装的目录中。它不仅仅是一个工具，而是一套完整的Agent治理框架。\n\n### 核心组件一览\n\nDietCode集成了以下关键子系统：\n\n#### BroccoliDB —— 知识图谱与代码分析\n\nBroccoliDB是DietCode的知识管理核心，提供：\n\n- 代码库索引：自动分析项目结构，构建可查询的知识图谱\n- 结构审计：识别代码中的架构问题、重复模式和潜在风险\n- 重构规划：基于知识图谱生成重构建议和依赖分析\n\n这个模块让Agent能够"理解"代码库，而不仅仅是读取文件内容。\n\n#### BroccoliQ —— 分片式任务队列\n\nBroccoliQ提供了企业级的任务队列管理能力：\n\n- 分片SQLite队列：支持大规模并发任务的持久化存储\n- 队列状态监控：实时查看任务执行状态和队列健康度\n- 完整性工具：确保任务不丢失、不重复执行\n\n对于需要处理大量异步操作的Agent工作流来说，这是基础设施级别的支持。\n\n#### JoyZoning —— 治理与变更生命周期\n\nJoyZoning是DietCode的治理框架，实现了受控的变更管理：\n\n- 变更生命周期钩子：在变更的各个阶段插入自定义逻辑\n- 收敛门控（Convergence Gates）：确保变更满足条件后才能进入下一阶段\n- 斜杠命令：提供 /joyzoning 等交互式治理命令\n\n这个模块让Agent的自主行为有了"护栏"，确保重要操作经过适当的审查和验证。\n\n#### JSDP —— 滚动式规划工作流\n\nJSDP（DietCode Planning）提供了自主规划辅助功能：\n\n- 有界交付循环：将大目标分解为可管理的小批次\n- 可审查的规划：每个规划步骤都可以被审查和验证\n- 长期项目引导：支持需要持续数周甚至数月的复杂项目\n\n#### Roadmap —— 自动滚动检查点\n\nROADMAP.md是DietCode的原生项目导航工具：\n\n- 自动滚动检查点系统：定期生成项目状态快照\n- 长期项目引导：为需要长期投入的项目提供方向感\n- 进度可视化：清晰展示已完成、进行中和待办的任务\n\n#### Kernel Bridge —— macOS内核级集成（可选）\n\n这是DietCode最具野心的功能：\n\n- 内核级补丁与验证：通过dietcode_kernel实现底层系统操作\n- JoyZoning日志记录：所有内核操作都被完整审计\n- 门控式原始写入拦截：可选的安全层，防止意外系统变更\n\n## 架构设计哲学\n\nDietCode的架构遵循一个核心原则：分离物理变更权限与生命周期/完成权限。\n\n### 权限分层模型\n\n\n意图 → 补丁 → 收据 → 日志 → 验证 → 验证日志 → 收敛\n\n\n| 层级 | 角色 |\n|------|------|\n| Kernel | 物理补丁和执行验证（当桥接启用时） |\n| JoyZoning | 生命周期日志记录（mutation_record_patch, mutation_verify） |\n| Convergence Gate | 完成权限 —— 看板不会自动完成 |\n\n这种分层设计确保了：\n\n1. 安全性：物理变更需要显式授权\n2. 可审计性：所有操作都有完整日志\n3. 灵活性：可以根据需求启用或禁用内核级功能\n\n### 安全默认配置\n\nDietCode采用保守的安全策略：\n\nyaml\ndietcode:\n kernel:\n bridge:\n enabled: true\n mutations_enabled: false # 补丁门默认关闭，需显式开启\n raw_write_policy: warn # 原始写入默认仅警告，不阻止\n\n\n只有在同时满足以下条件时，原始写入才会被硬阻止：\n- raw_write_policy: block\n- DIETCODE_KERNEL_RAW_WRITE_BLOCK=1\n- 补丁门完全打开\n\n这种设计既提供了安全保护，又不会意外阻碍正常操作。\n\n## 技术栈与依赖\n\nDietCode是一个多语言项目，技术栈丰富：\n\n### 主要语言分布\n- Python (43.2%)：核心插件逻辑、钩子系统、工具实现\n- TypeScript (27.1%)：BroccoliDB包、前端交互\n- Objective-C++ (25.0%)：macOS内核桥接\n- C++ (3.3%)：内核级系统操作\n- JavaScript (0.7%)：辅助脚本\n\n### 运行依赖\n- Hermes Agent（支持插件）\n- Python运行时\n- Node.js 18+ 和 npm（用于BroccoliDB包）\n- macOS内核桥接（可选）：Xcode CLT、编译的内核二进制文件\n\n## 安装与部署\n\nDietCode提供了多种安装方式：\n\n### 基础安装\n\nbash\nmkdir -p ~/.hermes/plugins\ncp -R dietcode-plugin ~/.hermes/plugins/dietcode\ncd ~/.hermes/plugins/dietcode/broccolidb\nnpm ci\n\n# 应用Hermes配置默认值\npython install.py\n\n\n### 一键部署\n\nbash\n# 从dietcode-plugin开发目录\n./scripts/hermes_deploy.sh\npython install.py --deploy-hermes\n\n# 从Hermes仓库根目录\n./scripts/hermes_deploy.sh\n\n\n### Makefile快捷方式\n\nbash\nmake deploy # 完整部署\nmake deploy-fast # 快速部署（跳过测试）\nmake verify # 验证安装\n\n\n## 使用方式\n\n安装完成后，DietCode提供丰富的斜杠命令：\n\n### 健康检查\n\n/dietcode doctor # 全面健康检查\n/dietcode kernel status # 内核状态\n/dietcode tools # 查看可用工具\n\n\n### 内核操作员检查清单\n\n/dietcode kernel cockpit # 单屏状态概览\n/dietcode kernel watch --follow # 实时状态监控\n/dietcode kernel perf --ux # 响应性能预算\n/dietcode kernel progress # 人类可读的进度摘要\n/dietcode kernel explain-gate # 查看关闭的门和修复方法\n\n\n### 子系统命令\n\n/dietcode broccolidb # BroccoliDB操作\n/broccolidb status # 数据库状态\n/broccoliq queue # 队列状态\n/joyzoning status # 治理状态\n/roadmap cockpit # 路线图驾驶舱\n/rm doctor # 资源管理器诊断\n\n\n## 项目结构\n\nDietCode的目录组织清晰反映了其架构设计：\n\n\n.\n|-- plugin.yaml # Hermes清单（v1.9.4）\n|-- hooks.py # 钩子注册（内核+JoyZoning+治理）\n|-- install.py # 配置默认值、npm引导、内核构建检查\n|-- health.py # /dietcode status、doctor、kernel status\n|-- slash_commands.py # 斜杠命令实现\n|-- lib/\n| |-- agent/ # JoyZoning、内核桥接客户端、日志\n| |-- runtime/ # 内核钩子、JoyZoning钩子、治理钩子\n| `-- tools/ # dietcode_kernel、broccolidb、joyzoning\n|-- kernel/ # 隔离的macOS内核+一致性工具\n|-- broccolidb/ # 打包的TypeScript BroccoliDB包\n|-- scripts/ # 内核演练、E2E测试脚本\n|-- tests/ # 内核桥接单测\n`-- docs/ # 操作员和开发者文档\n\n\n## 应用场景\n\nDietCode适合以下场景：\n\n### 大规模代码库管理\n当Agent需要理解数十万行代码的复杂项目时，BroccoliDB的知识图谱能力让Agent能够像资深开发者一样理解架构。\n\n### 长期项目规划\nJSDP的滚动式规划工作流特别适合需要持续数月的复杂项目，如框架升级、架构重构等。\n\n### 企业级治理\nJoyZoning的变更生命周期管理满足了企业对审计、合规和控制的需求，让AI Agent的操作可追踪、可审查。\n\n### 自动化工作流\nBroccoliQ的队列管理能力支持构建复杂的自动化工作流，如批量代码分析、多阶段重构等。\n\n## 版本演进\n\nDietCode正在快速迭代，最新版本v1.9.4（Sonic Kernel UX）专注于提升内核操作的用户体验：\n\n- v1.9.4：Sonic Kernel UX —— 优化内核操作的用户体验\n- v1.9.3：Cockpit —— 引入驾驶舱视图\n- v1.9.2：性能优化\n- v1.9.1/1.9.0：基础功能完善\n\n## 结语\n\nDietCode代表了AI Agent工具链的一个发展方向：从单一功能工具向综合性治理框架演进。它不是让Agent"更聪明"，而是让Agent的聪明有章可循、有据可查、有控可守。\n\n对于正在将AI Agent引入生产环境的团队来说，DietCode提供了一个值得参考的架构范式——如何在赋予Agent能力的同时，保持对过程的掌控。

原作者与来源

• 原作者/维护者：CardSorting
• 来源平台：github
• 原始标题：dietcode-plugin
• 原始链接：https://github.com/CardSorting/dietcode-plugin
• 来源发布时间/更新时间：2026-06-10T22:14:33Z DietCode：Hermes Agent的多功能治理插件套件\n\n原作者与来源\n\n- 原作者/维护者： CardSorting\n- 来源平台： GitHub\n- 原始标题： dietcode-plugin\n- 原始链接： https://github.com/CardSorting/dietcode-plugin\n- 发布时间： 2026-06-10\n\n背景：AI Agent需要什么样的工具链\n\n随着大语言模型驱动的AI Agent逐渐从实验走向生产环境，开发者们面临一个新的挑战：如何让这些Agent真正胜任复杂的软件工程任务？\n\n简单的问答式交互已经无法满足需求。真正的软件工程需要：\n\n- 知识管理：理解代码库的结构、依赖关系和演进历史\n- 任务调度：管理异步操作、队列状态和执行顺序\n- 治理控制：确保变更经过审查、验证和审计\n- 规划能力：将大目标分解为可执行的步骤并跟踪进度\n\nDietCode插件正是为解决这些需求而设计的综合性解决方案。\n\nDietCode 概述\n\nDietCode是一个独立的Hermes Agent插件，将多个核心功能模块打包到一个可安装的目录中。它不仅仅是一个工具，而是一套完整的Agent治理框架。\n\n核心组件一览\n\nDietCode集成了以下关键子系统：\n\nBroccoliDB —— 知识图谱与代码分析\n\nBroccoliDB是DietCode的知识管理核心，提供：\n\n- 代码库索引：自动分析项目结构，构建可查询的知识图谱\n- 结构审计：识别代码中的架构问题、重复模式和潜在风险\n- 重构规划：基于知识图谱生成重构建议和依赖分析\n\n这个模块让Agent能够"理解"代码库，而不仅仅是读取文件内容。\n\nBroccoliQ —— 分片式任务队列\n\nBroccoliQ提供了企业级的任务队列管理能力：\n\n- 分片SQLite队列：支持大规模并发任务的持久化存储\n- 队列状态监控：实时查看任务执行状态和队列健康度\n- 完整性工具：确保任务不丢失、不重复执行\n\n对于需要处理大量异步操作的Agent工作流来说，这是基础设施级别的支持。\n\nJoyZoning —— 治理与变更生命周期\n\nJoyZoning是DietCode的治理框架，实现了受控的变更管理：\n\n- 变更生命周期钩子：在变更的各个阶段插入自定义逻辑\n- 收敛门控（Convergence Gates）：确保变更满足条件后才能进入下一阶段\n- 斜杠命令：提供 /joyzoning 等交互式治理命令\n\n这个模块让Agent的自主行为有了"护栏"，确保重要操作经过适当的审查和验证。\n\nJSDP —— 滚动式规划工作流\n\nJSDP（DietCode Planning）提供了自主规划辅助功能：\n\n- 有界交付循环：将大目标分解为可管理的小批次\n- 可审查的规划：每个规划步骤都可以被审查和验证\n- 长期项目引导：支持需要持续数周甚至数月的复杂项目\n\nRoadmap —— 自动滚动检查点\n\nROADMAP.md是DietCode的原生项目导航工具：\n\n- 自动滚动检查点系统：定期生成项目状态快照\n- 长期项目引导：为需要长期投入的项目提供方向感\n- 进度可视化：清晰展示已完成、进行中和待办的任务\n\nKernel Bridge —— macOS内核级集成（可选）\n\n这是DietCode最具野心的功能：\n\n- 内核级补丁与验证：通过dietcode_kernel实现底层系统操作\n- JoyZoning日志记录：所有内核操作都被完整审计\n- 门控式原始写入拦截：可选的安全层，防止意外系统变更\n\n架构设计哲学\n\nDietCode的架构遵循一个核心原则：分离物理变更权限与生命周期/完成权限。\n\n权限分层模型\n\n\n意图 → 补丁 → 收据 → 日志 → 验证 → 验证日志 → 收敛\n\n\n| 层级 | 角色 |\n|------|------|\n| Kernel | 物理补丁和执行验证（当桥接启用时） |\n| JoyZoning | 生命周期日志记录（mutation_record_patch, mutation_verify） |\n| Convergence Gate | 完成权限 —— 看板不会自动完成 |\n\n这种分层设计确保了：\n\n1. 安全性：物理变更需要显式授权\n2. 可审计性：所有操作都有完整日志\n3. 灵活性：可以根据需求启用或禁用内核级功能\n\n安全默认配置\n\nDietCode采用保守的安全策略：\n\nyaml\ndietcode:\n kernel:\n bridge:\n enabled: true\n mutations_enabled: false 补丁门默认关闭，需显式开启\n raw_write_policy: warn 原始写入默认仅警告，不阻止\n\n\n只有在同时满足以下条件时，原始写入才会被硬阻止：\n- raw_write_policy: block\n- DIETCODE_KERNEL_RAW_WRITE_BLOCK=1\n- 补丁门完全打开\n\n这种设计既提供了安全保护，又不会意外阻碍正常操作。\n\n技术栈与依赖\n\nDietCode是一个多语言项目，技术栈丰富：\n\n主要语言分布\n- Python (43.2%)：核心插件逻辑、钩子系统、工具实现\n- TypeScript (27.1%)：BroccoliDB包、前端交互\n- Objective-C++ (25.0%)：macOS内核桥接\n- C++ (3.3%)：内核级系统操作\n- JavaScript (0.7%)：辅助脚本\n\n运行依赖\n- Hermes Agent（支持插件）\n- Python运行时\n- Node.js 18+ 和 npm（用于BroccoliDB包）\n- macOS内核桥接（可选）：Xcode CLT、编译的内核二进制文件\n\n安装与部署\n\nDietCode提供了多种安装方式：\n\n基础安装\n\nbash\nmkdir -p ~/.hermes/plugins\ncp -R dietcode-plugin ~/.hermes/plugins/dietcode\ncd ~/.hermes/plugins/dietcode/broccolidb\nnpm ci\n\n应用Hermes配置默认值\npython install.py\n\n\n一键部署\n\nbash\n从dietcode-plugin开发目录\n./scripts/hermes_deploy.sh\npython install.py --deploy-hermes\n\n从Hermes仓库根目录\n./scripts/hermes_deploy.sh\n\n\nMakefile快捷方式\n\nbash\nmake deploy 完整部署\nmake deploy-fast 快速部署（跳过测试）\nmake verify 验证安装\n\n\n使用方式\n\n安装完成后，DietCode提供丰富的斜杠命令：\n\n健康检查\n\n/dietcode doctor 全面健康检查\n/dietcode kernel status 内核状态\n/dietcode tools 查看可用工具\n\n\n内核操作员检查清单\n\n/dietcode kernel cockpit 单屏状态概览\n/dietcode kernel watch --follow 实时状态监控\n/dietcode kernel perf --ux 响应性能预算\n/dietcode kernel progress 人类可读的进度摘要\n/dietcode kernel explain-gate 查看关闭的门和修复方法\n\n\n子系统命令\n\n/dietcode broccolidb BroccoliDB操作\n/broccolidb status 数据库状态\n/broccoliq queue 队列状态\n/joyzoning status 治理状态\n/roadmap cockpit 路线图驾驶舱\n/rm doctor 资源管理器诊断\n\n\n项目结构\n\nDietCode的目录组织清晰反映了其架构设计：\n\n\n.\n|-- plugin.yaml Hermes清单（v1.9.4）\n|-- hooks.py 钩子注册（内核+JoyZoning+治理）\n|-- install.py 配置默认值、npm引导、内核构建检查\n|-- health.py /dietcode status、doctor、kernel status\n|-- slash_commands.py 斜杠命令实现\n|-- lib/\n| |-- agent/ JoyZoning、内核桥接客户端、日志\n| |-- runtime/ 内核钩子、JoyZoning钩子、治理钩子\n| `-- tools/ dietcode_kernel、broccolidb、joyzoning\n|-- kernel/ 隔离的macOS内核+一致性工具\n|-- broccolidb/ 打包的TypeScript BroccoliDB包\n|-- scripts/ 内核演练、E2E测试脚本\n|-- tests/ 内核桥接单测\n`-- docs/ 操作员和开发者文档\n\n\n应用场景\n\nDietCode适合以下场景：\n\n大规模代码库管理\n当Agent需要理解数十万行代码的复杂项目时，BroccoliDB的知识图谱能力让Agent能够像资深开发者一样理解架构。\n\n长期项目规划\nJSDP的滚动式规划工作流特别适合需要持续数月的复杂项目，如框架升级、架构重构等。\n\n企业级治理\nJoyZoning的变更生命周期管理满足了企业对审计、合规和控制的需求，让AI Agent的操作可追踪、可审查。\n\n自动化工作流\nBroccoliQ的队列管理能力支持构建复杂的自动化工作流，如批量代码分析、多阶段重构等。\n\n版本演进\n\nDietCode正在快速迭代，最新版本v1.9.4（Sonic Kernel UX）专注于提升内核操作的用户体验：\n\n- v1.9.4：Sonic Kernel UX —— 优化内核操作的用户体验\n- v1.9.3：Cockpit —— 引入驾驶舱视图\n- v1.9.2：性能优化\n- v1.9.1/1.9.0：基础功能完善\n\n结语\n\nDietCode代表了AI Agent工具链的一个发展方向：从单一功能工具向综合性治理框架演进。它不是让Agent"更聪明"，而是让Agent的聪明有章可循、有据可查、有控可守。\n\n对于正在将AI Agent引入生产环境的团队来说，DietCode提供了一个值得参考的架构范式——如何在赋予Agent能力的同时，保持对过程的掌控。