Agentation 是什么
agentation 是一款开源的 ai 编程协同工具，专为提升开发者与 ai 编程助手之间的协作效率而设计。它通过允许用户在网页界面中直接进行视觉化标注，将直观的问题反馈自动转化为机器可解析的结构化信息，并输出为标准 markdown 文本，供 ai 模型高效理解与执行。该工具大幅降低了传统文字描述带来的歧义与信息损耗，使 ai 能更准确、快速地完成代码定位与修改任务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
git-staged-commit-message
下载
仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用；切勿代表用户执行提交操作。
Agentation 的核心功能
- 可视化问题标注：用户可在任意网页上点击目标元素并添加说明性备注，实现所见即所得的问题定位。
- 智能上下文捕获：自动提取被标注元素的 CSS 选择器、class 名称、DOM 层级路径、屏幕坐标及周边 HTML 结构，保障定位高精度。
- 结构化反馈生成：将所有标注数据整合为语义清晰、格式统一的 Markdown 内容，便于人工复核与 AI 解析。
- AI 友好型输入支持：生成的 Markdown 包含明确的元素标识与上下文线索，显著提升 AI 对前端代码的识别与修改能力。
-
轻量级开发集成：以 React Hook + UI 组件形式嵌入项目，仅在
process.env.NODE_ENV === 'development'下激活，零侵入生产环境。
如何使用 Agentation
- 安装依赖：在现有 React 工程中，使用 npm / yarn / pnpm / bun 安装 Agentation 官方包。
-
引入组件：将
<agentation></agentation>插入应用根组件（如App.tsx），并通过环境变量控制其仅在开发阶段启用。 -
启动本地服务：运行
npm start或对应命令，打开浏览器访问本地开发地址（例如http://localhost:3000）。 - 开启标注模式：点击页面右下角悬浮的 Agentation 图标，进入交互式标注界面。
- 标记问题区域：鼠标悬停于需反馈的 UI 元素上并单击，填写具体问题描述（如“按钮颜色错误”“响应式断点失效”等）。
- 获取结构化输出：系统即时生成包含元素路径、样式特征与用户说明的 Markdown 文本。
- 交付 AI 处理：复制该 Markdown 内容，粘贴至支持代码理解的 AI 工具（如 Claude Code、Cursor、GitHub Copilot Workspace 等）。
- 自动修复执行：AI 基于 Markdown 中提供的精准定位信息，定位源码位置并完成修复建议或直接生成补丁代码。
Agentation 的项目资源
- GitHub 开源仓库：https://www.php.cn/link/b28056072ee588a30755fd0cbdc821c0
- 在线演示站点：https://www.php.cn/link/37728c9dbe50970fd5c4ec0c106d825b
Agentation 的典型应用场景
- 前端调试提效：开发者在本地开发过程中实时标注异常表现，无需手动截图+文字说明，即可驱动 AI 快速修正对应组件逻辑或样式。
- 设计-开发对齐：UI/UX 设计师基于预览页直接标注视觉偏差（如间距不符、字体不一致），生成标准化反馈，减少沟通损耗。
- 质量保障协作：测试工程师在测试环境中发现 Bug 或体验缺陷后，用 Agentation 标注并导出可复现的结构化报告，加速研发响应。
- 多端适配优化：在不同视口尺寸下标注布局错位、交互异常等问题，辅助 AI 分析媒体查询逻辑或 Flex/Grid 配置问题。
- 跨职能协同提效：产品、设计、前端、测试等角色均使用同一标注语言输出反馈，形成统一的问题表达范式，降低协作成本与返工率。
