guchengyouzi12138/project-understanding

README 摘要

Project Understanding（项目理解工具） 一键「读懂项目并生成理解报告」的能力，支持四种输入： 路径 输入 处理方式 路径 1 Axure .rp 原型 Python 转结构化 JSON（自动识别 ZIP / 二进制两种格式）→ 报告 路径 2 前端代码 递归读取代码文件 → 报告 路径 3 后端代码 递归读取代码文件 → 报告 路径 4 网站链接 抓取网页内容 → 分析 → 报告 多种输入一次给入时，逐条处理，最终 合并输出一篇统一报告 。 本仓库提供同一能力的三种交付形态： 版本 目录 说明 适用场景 harness 动态插件 harness-plugin/ 动态 Cordis 插件，注册 rp extract / code ingest / url fetch 三个模型工具 当前 harness 会话内即装即用 寻常 skill skill/ 一份 SKILL.md 指令 + 自带 Python 脚本 任何支持 skill 的环境，用内置工具完成同样的事 常驻 preset preset/ 一个 agent preset（Cordis 组合），把三个工具固化成常驻能力 每次会话自动加载，无需手动安装 三者共享同一套 Axure 解析逻辑（ axure extract.py ），只是封装方式不同：动态插件把逻辑编成「工具」，skill 把逻辑写成「指令」，preset 把它固化成「组合」。 目录结构 核心产物 axure extract.py —— 唯一的 Python 依赖，支持两种 .rp 格式： - ZIP （RP8 / 旧版 9）：读 document.json / document.js 。 - 二进制 （RP9/10）：解压 gzip/zlib 数据块，还原中文文本。 用法： python axure extract.py [--stdout] [--dump-raw]

分类