senior-architect

🏗️ 零依赖架构设计与分析套件

🥥8总安装量 3评分人数 2
100% 的用户推荐

基于纯静态分析的架构设计工具集,零依赖、零网络交互,为开发团队提供安全可靠的架构可视化、依赖检测与模式识别能力。

A

基本安全,请在特定环境下使用

  • 来自可信来源(Github / Microsoft / 官方仓库)
  • ✅ 零网络交互:不执行任何 HTTP 请求,完全离线运行
  • ✅ 零第三方依赖:仅使用 Python 标准库,供应链风险为零
  • ✅ 只读文件访问:仅读取用户指定项目目录,不修改源代码
  • ⚠️ 可选文件写入:仅在用户显式指定 `-o/--save` 参数时输出报告文件
  • ✅ 完整输入验证:使用 `pathlib.Path` 规范化路径,有效防止路径遍历攻击

使用说明

核心用法

Senior Architect 是一套面向软件架构设计的静态分析工具集,包含三大核心组件:

1. 架构图生成器:自动扫描项目结构,生成 Mermaid、PlantUML 或 ASCII 格式的架构图,支持组件图、分层图和部署图三种类型,解决团队文档化与沟通需求。

2. 依赖分析器:深度解析 npm、Python、Go、Rust 等主流包管理文件,识别循环依赖、计算耦合度分数、标记过期包,输出 JSON 或可读报告供 CI/CD 集成。

3. 项目架构师:智能识别 MVC、分层、六边形等架构模式,检测上帝类、混合关注点、层违规等代码异味,提供可操作的改进建议。

工具通过命令行调用,支持 --verbose 详细模式、、--output json 结构化输出,以及 -o 指定报告保存路径。

显著优点

  • 零依赖安全:仅使用 Python 标准库,彻底消除供应链攻击风险
  • 多格式输出:Mermaid/PlantUML 可直接嵌入文档,ASCII 适合终端快速查看
  • 决策工作流内置:提供数据库选型、架构模式选择、单体 vs 微服务的完整决策框架
  • 广泛技术栈覆盖:支持 TypeScript、Python、Go、Rust 等语言及主流前后端框架
  • 离线可用:纯本地执行,无需网络连接,适合内网环境

潜在缺点与局限性

  • 静态分析局限:无法识别运行时架构特征,如实际服务调用关系、性能瓶颈
  • 语言支持边界:对 C++、Java 等语言的包管理文件支持有限
  • 模式识别精度:基于启发式规则,复杂架构可能误判或置信度不足
  • 无自动修复:仅提供诊断报告,不直接修改代码
  • 大型项目性能:扫描超大规模代码库时可能耗时较长

适合的目标群体

  • 技术负责人/架构师:进行技术选型、架构评审、制定演进路线
  • 全栈开发团队:快速理解遗留项目结构,制定重构计划
  • DevOps 工程师:集成依赖检查到 CI 流水线,预防供应链风险
  • 技术写作者:自动生成架构文档配图,保持文档与代码同步
  • 初创公司技术团队:在 MVP 阶段建立合理的架构基线

使用风险

  • 输出文件管理:使用 -o 参数时注意指定安全路径,避免覆盖重要文件
  • 分析结果解读:静态分析可能产生误报,建议结合人工判断
  • 大型项目超时:极端规模项目可能出现分析时间过长,建议分模块扫描
  • 模式识别依赖:架构模式检测基于文件命名和结构启发式,非 100% 准确

senior-architect 内容

文件夹图标references文件夹
文件夹图标scripts文件夹
手动下载zip · 34.8 kB
architecture_patterns.mdtext/markdown
请选择文件