用途:为 Web 应用生成 _FEATURES.md 行为/功能文档,记录用户所见、交互、不变量与代码引用,作为行为层面的真实来源,与 tree-sitting(代码结构)互补。
主要能力:v0.3.0 采用代码优先架构,代码即事实,截图仅作补充验证。流程分四阶段:DISCOVER 从代码结构发现页面(扫描 HTML、识别 Next.js/SvelteKit 等路由约定、扫描页面引用,可用 --routes 手动补充,无需浏览器);ANALYZE 读取源码并用 Claude API(文本)生成行为描述;VERIFY 可选,用 webctl 截图与无障碍树做选择性视觉验证,跳过错误页、受限页与重定向;ASSEMBLE 汇总为 _FEATURES.md,标注来源徽章与状态摘要。支持环境自适应批处理(Claude.ai 容器 4 页、Claude Code on Web 12 页、本地 CLI 不分批),每批通过 _FEATURES_MANIFEST.json 检查点。增量模式跳过已有描述与未变截图。受限页面标记 GATED 并生成 GATED_PAGES.md 手动采集说明。
使用方式:需先安装 tree-sitting,并具备 Claude API key(api-credentials 技能或 ANTHROPIC_API_KEY 环境变量);视觉验证需 webctl。命令示例:python /mnt/skills/user/mapping-webapp/scripts/featuremap.py --app-url https://example.com --codebase /path/to/repo --code-only;完整流程去掉 --code-only;增量加 --incremental。常用参数:--output、--max-pages(默认 100)、--verify-only、--batch-size、--viewport(默认 1280x720)、--routes、--screenshots-dir、--model(默认值以 scripts/featuremap.py 为准)、--dry-run。
适用场景:需要从源码生成 Web 应用功能清单、行为文档并合并进 CLAUDE.md 架构/概念章节的团队。
限制:代码分析消耗 Claude API token;视觉验证需 webctl 与运行中的应用实例;客户端路由 SPA 可能需 --routes;受限页面视觉验证需人工介入;分析质量取决于源码可读性。收费、价格与平台支持等资料暂未提供。