blong-dev/otter-docs

GitHub: blong-dev/otter-docs

面向 AI 代理的多语言代码库检查库,结合静态分析与 LLM 增强能力,自动发现代码冗余、死代码和架构异味并输出可执行的结构化建议。

Stars: 0 | Forks: 0

# otter 文档 一个用于代理驱动开发的多语言代码库检查库。 ## 未来愿景 otter-docs 构建了一个可查询的代码库模型——包括模块、函数、类、调用和导入——并通过 LLM 生成的描述 embedding 进行增强,然后发出结构化的**发现**(findings,包括冗余、漂移、死代码、架构异味),供代理执行操作。每项发现都可以附带包含理由的建议以及可直接应用的 diff。 该库专为供代理使用而设计,而非供人类直接阅读。人类负责操作代理。 ## 当前内容 本版本(`0.0.0`)保留了 PyPI 命名空间。目前尚未包含功能性代码。 ## v0.1 预告 - 通过 tree-sitter 实现多语言 AST(首日支持 Python、Go、TypeScript) - 通过 tree-sitter-stack-graphs 实现精确的名称解析 - 每个符号的三向量索引(描述、代码、docstring) - 封装了 `similarity-py`、`vulture`、`pydeps`、`radon` 的静态层检测器 - 基于 embedding 增强的冗余与漂移检测器 - 代理套件(MCP 风格的工具、提示、模式、运行器) - SQLite + sqlite-vec 图后端;用于重型图的 Neo4j 适配器 - Git hook + systemd timer 集成 一旦公开,路线图和设计说明将驻留在代码库中(见下方链接)。 ## 为什么需要它 AI 辅助开发在快速生成可用代码的同时,也会快速产生冗余。otter-docs 是切片检查层——在可能的情况下采用确定性方法,在必要的地方使用 LLM 增强,并确保所有内容均对代理可读。 ## 许可证 MIT。 ## 链接 - 代码库: - 问题: ## 持续关注 关注 PyPI 页面或 GitHub 代码库,以获取 v0.1 的发布说明。
标签:Agent驱动开发, AI, AI辅助开发, DLL 劫持, Git Hook, Go, LLM, MCP, Neo4j, odt, Python, Ruby工具, SQLite, Tree-sitter, TypeScript, Unmanaged PE, WebSocket, 人工智能, 代码冗余检测, 代码分析, 代码向量化, 代码图谱, 代码库管理, 代码异味, 依赖分析, 凭证管理, 向量检索, 多语言代码解析, 多语言支持, 大语言模型, 威胁情报, 安全插件, 安全测试框架, 开发者工具, 抽象语法树, 文本嵌入, 无后门, 架构坏味道, 死代码检测, 用户模式Hook绕过, 自动化代码审查, 逆向工具, 错误基检测, 静态代码分析