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 把它固化成「组合」。
目录结构
project-understanding/
├── README.md # 本文件
├── harness-plugin/ # 版本一：harness 动态插件
│ ├── project-understanding.host.js # 插件宿主代码（自包含，内嵌 Python）
│ └── README.md
├── skill/ # 版本二：寻常 skill
│ ├── SKILL.md
│ ├── scripts/axure_extract.py
│ └── README.md
└── preset/ # 版本三：常驻 preset
├── project-understanding.cjs # preset 插件（自包含，内嵌 Python）
├── agent.cordis.yml # preset 组合（standard + 本插件）
├── preset.yml # 显示元数据
└── README.md核心产物
axure_extract.py —— 唯一的 Python 依赖，支持两种 .rp 格式：
- ZIP（RP8 / 旧版 9）：读
document.json/document.js。 - 二进制（RP9/10）：解压 gzip/zlib 数据块，还原中文文本。
用法：python axure_extract.py <input.rp> <output.json> [--stdout] [--dump-raw]