Zodchiy

这是什么？适合谁？

Zodchiy（Socialpranker/zodchiy）是一个成本可证明的架构审计：架构审计 Agent：一条发现只有在成本可证明（从 git 历史度量）时才被采纳，附纯标准库的度量 CLI。

核心价值：一个架构审计 Agent：它的核心原则是——一条架构发现只有在成本可证明（从 git 历史度量）时才会被采纳，配套一个仅用 Python 标准库的度量 CLI，把「架构审计」做成可复现的 Agent 流程。

适合人群：

• 做代码架构审计的工程师
• 想让 Agent 做审计的团队
• 关注技术债成本的人

使用前提：Python 环境与 git 仓库

准备工作

1. 安装：获取仓库（纯标准库 CLI）
2. 环境：Python + 目标 git 仓库
3. 准备：待审计的代码仓库
4. 成本：MIT 开源免费
5. 时间：跑通一次审计约 30 分钟

快速上手（3 步）

第一步：获取 CLI

git clone https://github.com/Socialpranker/zodchiy

获取 zodchiy

第二步：度量成本

# 从 git 历史度量架构发现的成本

度量发现成本

第三步：采纳结论

# 仅采纳成本可证明的发现

得到可复现的审计结论

成功判定：对目标仓库跑通一次成本可证明的架构审计。

初级用法

架构审计

审计代码架构问题

成本度量

从 git 历史度量成本

可复现结论

结论可追溯可复现

高级玩法

集成 coding agent

把 doctrine 用于 Claude Code/Codex

批量审计

审计多个仓库

自定义度量

扩展成本度量规则

小技巧

1. 先理解「成本可证明」原则
2. 用真实 git 历史验证
3. 区分成本与主观偏好
4. 结合人工复核
5. 反馈度量精度问题

常见踩坑

踩坑 1：概念难懂

• 现象：概念难懂
• 原因：审计原则抽象
• 解决：先读 README 的 doctrine

踩坑 2：git 历史脏

• 现象：git 历史脏
• 原因：度量偏差
• 解决：用规范提交的仓库

踩坑 3：误判成本

• 现象：误判成本
• 原因：成本度量不准
• 解决：人工校准阈值

踩坑 4：项目很新

• 现象：项目很新
• 原因：文档有限
• 解决：以 README 为准

踩坑 5：适用范围

• 现象：适用范围
• 原因：非 git 项目受限
• 解决：需 git 历史

常见问题 FAQ

Q: 它是什么？

A: 成本可证明的架构审计 Agent。

Q: 免费吗？

A: MIT 开源免费。

Q: 如何工作？

A: 从 git 历史度量发现成本，仅采纳可证明的。

Q: 需要什么？

A: Python + git 仓库。

Q: 适合谁？

A: 架构审计工程师。

进阶学习建议

掌握基础后，建议深入：

1. 深入研究「成本可证明」审计原则
2. 对比 Archify/CodeScene 的架构分析
3. 探索技术债的量化度量

参考链接

• 官方仓库

最后更新：2026-09-03 · 作者：MagicNetWorld · 基于公开资料整理，关键数据经 GitHub API 独立实测核验，AI 辅助生成