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绕过, 自动化代码审查, 逆向工具, 错误基检测, 静态代码分析