@tita-agent/dsh-session-taskpath
在 DSH 的“对话”“轨迹”旁增加“路径”页，把冗长的 Agent 执行记录整理成可回查证据的任务路径。
要解决的问题
一个问题可能跨多轮对话，包含几十次 Bash、知识检索和 SQL 调用。逐条看轨迹，很难判断 Agent 在解决什么、执行方向是否偏离、结果是否有依据。
解决方案
按 任务 → 主阶段 → 子节点 展示，同一子目标的多次调用合并到一个节点，例如把 12 次 Bash 聚合为“定位退款计算差异”。
- 精简 / 详细：精简模式收起子节点，快速看关键进展；详细模式展开具体行动。同一会话的多个任务放在一起。
- 点击看证据：右侧展示子目标、主要操作、可观察结果和调用证据，可跳到原始轨迹；失败、重试和转向仍会保留。
- 只整理实际记录：没有可靠归属的证据汇总为一行“未归类”。路径是辅助复盘的模型摘要，可通过证据核对。
实际组件渲染，使用演示数据。
请求策略
| 触发方式 | 模型如何调用 |
|---|---|
| 每轮 Agent 结束 | 开启自动总结后，增量整理检查点之后的已结束记录；默认关闭 |
| 手动“补齐路径” | 合并全部待处理轮次和缺失分组，不按轮次拆输入 |
| “全量重生成” | 重新分析全部已结束记录，成功后替换旧路径 |
| 打开页面、切换视图、查看证据 | 只读已保存结果，不调用模型 |
输入先压缩：本地提取命令、查询、状态、错误和少量结果样例，再提交新增证据、相关旧任务摘要及已有分析上下文。尽量复用分析请求前缀缓存；不保证命中 Agent 原对话的缓存。
历史按段复用：同一段保留原分析消息，只在尾部追加新增证据与相关任务摘要。输入估算达到约 32K tokens 时，从已保存路径生成本地快照后开始新段，不再按字符数或消息条数清空。使用模型公布的上下文容量，扣除输出额度和安全余量；未公布时按 128K 估算。原始证据与完整路径继续保存在本地。
输出可续写：默认每段上限 16,384 tokens，可选最高 100,000 tokens，每次整理最多 8 段。实际输出受所选模型支持限制；已知上下文容量时，单段输出最多预留其一半，为输入留空间。上限会告知模型；未输出完时携带原证据和此前回复继续。进度暂存，达到段数上限、上下文预算或调用失败后可继续；输入与模型配置相同才复用进度。全部输出校验通过后一次保存，失败保留旧路径。每段调用和临时网络重试均可能计费。
坏行定点补发：模型遗漏字段或返回非法序号时，保留好行并记录全部坏行；对类型和 ID 可识别、且不与好行冲突的记录，自动请求模型只重发坏行。每次最多自动启动一轮补发，补发可使用同样的段数预算，每次调用均可能计费。补发不能覆盖好行，合并后重新校验证据与分组。仍失败时保留进度，手动继续只补发原坏行；身份不明、ID 冲突或分组关系错误仍需重新整理。
用量详情可展开查看换段原因、历史与本批输入估算、已完成整理的累计用量和平均每轮用量。估算采用本地 BPE 加安全余量，计费以模型实际返回为准；累计从本版本开始记录，不包含尚未完成的整理及无法恢复的失败调用。
在 设置 → 任务路径 中，还可选择生效的 Workspace（全部、仅选中、排除选中）、独立总结模型和思考强度。关闭自动总结后仍可手动整理；范围外只查看旧路径。
安装
DSH 桌面端：打开侧边栏“插件”→“添加插件”，输入以下包名，安装并启用，按提示重启：
@tita-agent/dsh-session-taskpath@latest
Web / CLI：安装到对应 profile，例如：
dsh plugin --profile web add @tita-agent/dsh-session-taskpath@latest
需要 DSH >=0.2.0-rc.1、Node.js >=22.5。加载后进入“设置 → 任务路径”选择模型。旧会话没有路径时，手动点击“整理路径 → 补齐路径”。