AgentInterface.

项目概览

把代码定位、只读分析、确认式修改和测试反馈连接起来，让一次对话可以承接完整的本地开发操作。

• 源码公开，可在本地配置运行。
• 不是在线 Demo；真实 Agent 依赖使用者自己的环境。

要解决的问题

用户不总是知道问题对应的文件；模型给出的建议，也不应该直接变成文件修改。

• 从自然语言问题找到相关源码。
• 将建议、批准与执行结果明确区分。

我的职责 / 具体实现

围绕真实使用流程，实现产品界面与后端能力之间的衔接。

• 会话工作区、持久化、搜索、归档和界面呈现。
• 项目搜索到可信读取，再到修改确认卡的完整衔接。
• 执行后的测试反馈与后续对话上下文。

核心能力

能力围绕实际任务组织，而不是把所有工具都交给模型。

• 有边界的项目搜索、文件读取和代码导航。
• 同一会话承接修改建议，预览目标文件与差异。
• 批准后执行受控修改，并记录测试反馈。

架构

产品层管理业务状态；读取、权限与执行分别承担明确职责。

1. Web UI
2. Product API / Facade
3. ConversationCoordinator
4. Trusted Reader / 已批准执行
5. 结果与会话状态

• Web UI 通过 Product API / Facade 进入会话协调层。
• 读取与批准后的执行使用不同路径。

安全设计

把边界落到操作前后的校验，而不只依赖提示词。

• 没有证据，不作确定性结论。
• 修改需要明确批准，并校验文件是否已变化；拒绝不执行。
• 不提供通用 shell、任意测试命令或 Git 写入能力。
• 重启不重放已完成操作。

工程挑战

困难不只在模型回答，而在产品状态是否保持一致。

• 避免跨会话引用错误的文件证据。
• 把测试结果持久化为可信操作记录，供后续对话使用。
• 在保持真实结果的同时，避免界面泄漏内部技术字段。

如何验证

核心流程经过自动验收与真人操作验证，两者不能互相替代。

• 自动验收使用隔离会话与确定性回答，默认不调用真实 Agent。
• 验证搜索、读取、批准后的 fixture 修改、受控测试与结果恢复。
• 验收结束恢复 fixture；界面体验仍需真人确认。

技术栈与当前边界

Python、标准库 HTTP 服务、JavaScript Web UI、pytest，以及外部 OpenClaw / Agent 集成。

• 不是 FastAPI 服务。
• 当前定位是本地单用户工具，不宣称多租户或生产安全保证。