Agent Harness 工具体验与执行反馈问题汇总

[vastsa]

背景

记录自 Agent Harness + user-installable plugins 预览阶段的使用反馈。本 issue 聚焦工具发现、命令执行、文件读写和会话体验；不涉及插件功能设计。

问题归类

工具发现与反馈

• asktool 仅支持纯文本，无法呈现富格式选项。
• 原生 Grep / Glob 不在默认工具列表中，需先通过 ToolSearch 激活；改用 Bash 搜索时输出可能失控、缺少限制。
• 点击工具后只能看到执行结果，看不到实际执行的命令/输入，排查不便。

Bash 与路径

• 默认 60 秒超时缺少清楚提示，长任务容易让人误以为仍在运行或执行失败。
• Bash 调用 cmd 子进程时观察到编码不一致、输出乱码；具体触发条件和根因待确认。
• Windows 下提供的 $PI_SCRATCH_DIR 路径不能直接在 Bash 中使用；分支会话中的路径更新/提示不足，可能静默指向错误位置。
• 有反馈称长命令可能被静默截断、导致命令未完整执行；目前未能复现，需先验证。

Read / Write / Edit

• Read / Write 的行号区间与 tag 校验可能造成反复读取和重写，失败、写错位置或写入成功不易区分。
• 多个 PUT 操作时出现行号定位问题；展示的行号看似对应目标位置，实际内容却落在其他行。
• 写入成功响应不稳定，有时返回内容、有时为空，难以判断结果。
• 对不存在的文件返回权限错误，而非明确的文件不存在错误。

会话与长对话体验

• 长对话中思考/执行链会自动折叠，查看历史过程不够顺手。
• 曾遇到一次会话突然消失，原因不明，也不确定是否误操作；与已关闭的 #39 相似，需补充复现信息后再判断是否同一问题。
• 正向反馈：分支和修改历史信息有帮助，可保留现有能力。

期望

• 工具的输入、执行过程和结果清晰可见；输出有合理边界，成功与错误响应明确。
• 常用搜索工具容易发现，Bash 超时、编码和跨 shell 路径行为明确且一致。
• 文件操作的行号定位、写入结果和缺失文件错误可靠、可诊断。
• 对未复现的命令截断和会话消失问题，先建立可验证的复现或明确排除。

范围说明

截图中已划掉的模型切换/自动选模反馈不纳入本 issue；编码根因中的推测不作为已确认结论。