# @tita-agent/dsh-session-taskpath 中文文档

规范地址：https://npmcn.com/package/%40tita-agent/dsh-session-taskpath/

版本：0\.1\.8
npm 元数据更新时间：2026-11-02T15:23:37.791Z
中文译文更新时间：2026-11-02T16:55:17.161Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40tita-agent/dsh-session-taskpath
原文对照：https://npmcn.com/package/%40tita-agent/dsh-session-taskpath/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.8 MB，142 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.5
- 运行依赖：1 个
- peer 依赖：@deepseek-ai/cordis ~4\.0\.4，@deepseek-ai/dsh-session \>=0\.2\.0-rc\.1，@deepseek-ai/schemastery ~3\.18\.4，@deepseek-ai/dsh-client-ui-slots \>=0\.2\.0-rc\.1，@deepseek-ai/dsh-client-ui-session \>=0\.2\.0-rc\.1，@deepseek-ai/dsh-client-ui-renderer \>=0\.2\.0-rc\.1，@deepseek-ai/dsh-client-ui-settings \>=0\.2\.0-rc\.1，@deepseek-ai/dsh-client-ui-conversation \>=0\.2\.0-rc\.1
- 首次发布：2026-10-25T06:59:36.570Z
- 最新版本发布：2026-11-02T15:23:37.588Z
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

将冗长的 DSH 会话轨迹按任务和子目标聚合为执行路径；每轮结束增量提取详细节点与精简主阶段，支持证据回查和 Token 用量查看。

## 安装

```sh
npm install @tita-agent/dsh-session-taskpath
```

也可以使用：`pnpm add @tita-agent/dsh-session-taskpath`、`yarn add @tita-agent/dsh-session-taskpath`、`bun add @tita-agent/dsh-session-taskpath`

## README

# @tita-agent/dsh-session-taskpath

在 DSH 的“对话”“轨迹”旁增加“路径”页，把冗长的 Agent 执行记录整理成可回查证据的任务路径。

## 要解决的问题

一个问题可能跨多轮对话，包含几十次 Bash、知识检索和 SQL 调用。逐条看轨迹，很难判断 Agent 在解决什么、执行方向是否偏离、结果是否有依据。

## 解决方案

按 **任务 → 主阶段 → 子节点** 展示，同一子目标的多次调用合并到一个节点，例如把 12 次 Bash 聚合为“定位退款计算差异”。

-   **精简 / 详细**：精简模式收起子节点，快速看关键进展；详细模式展开具体行动。同一会话的多个任务放在一起。
-   **点击看证据**：右侧展示子目标、主要操作、可观察结果和调用证据，可跳到原始轨迹；失败、重试和转向仍会保留。
-   **只整理实际记录**：没有可靠归属的证据汇总为一行“未归类”。路径是辅助复盘的模型摘要，可通过证据核对。

![任务路径界面：左侧按任务、主阶段和子节点展示，右侧查看操作、结果与执行证据](https://cdn.jsdelivr.net/npm/@tita-agent/dsh-session-taskpath@0.1.8/docs/task-path.png)

实际组件渲染，使用演示数据。

## 请求策略

| 触发方式 | 模型如何调用 |
| --- | --- |
| 每轮 Agent 结束 | 开启自动总结后，增量整理检查点之后的已结束记录；默认关闭 |
| 手动“补齐路径” | 合并全部待处理轮次和缺失分组，不按轮次拆输入 |
| “全量重生成” | 重新分析全部已结束记录，成功后替换旧路径 |
| 打开页面、切换视图、查看证据 | 只读已保存结果，不调用模型 |

**输入先压缩**：本地提取命令、查询、状态、错误和少量结果样例，再提交新增证据、相关旧任务摘要及已有分析上下文。尽量复用分析请求前缀缓存；不保证命中 Agent 原对话的缓存。

**历史按段复用**：同一段保留原分析消息，只在尾部追加新增证据与相关任务摘要。输入估算达到约 32K tokens 时，从已保存路径生成本地快照后开始新段，不再按字符数或消息条数清空。使用模型公布的上下文容量，扣除输出额度和安全余量；未公布时按 128K 估算。原始证据与完整路径继续保存在本地。

**输出可续写**：默认每段上限 **16,384 tokens**，可选最高 **100,000 tokens**，每次整理最多 **8 段**。实际输出受所选模型支持限制；已知上下文容量时，单段输出最多预留其一半，为输入留空间。上限会告知模型；未输出完时携带原证据和此前回复继续。进度暂存，达到段数上限、上下文预算或调用失败后可继续；输入与模型配置相同才复用进度。全部输出校验通过后一次保存，失败保留旧路径。每段调用和临时网络重试均可能计费。

**坏行定点补发**：模型遗漏字段或返回非法序号时，保留好行并记录全部坏行；对类型和 ID 可识别、且不与好行冲突的记录，自动请求模型只重发坏行。每次最多自动启动一轮补发，补发可使用同样的段数预算，每次调用均可能计费。补发不能覆盖好行，合并后重新校验证据与分组。仍失败时保留进度，手动继续只补发原坏行；身份不明、ID 冲突或分组关系错误仍需重新整理。

用量详情可展开查看换段原因、历史与本批输入估算、已完成整理的累计用量和平均每轮用量。估算采用本地 BPE 加安全余量，计费以模型实际返回为准；累计从本版本开始记录，不包含尚未完成的整理及无法恢复的失败调用。

在 **设置 → 任务路径** 中，还可选择生效的 Workspace（全部、仅选中、排除选中）、独立总结模型和思考强度。关闭自动总结后仍可手动整理；范围外只查看旧路径。

## 安装

**DSH 桌面端**：打开侧边栏“插件”→“添加插件”，输入以下包名，安装并启用，按提示重启：

```text
@tita-agent/dsh-session-taskpath@latest
```

**Web / CLI**：安装到对应 profile，例如：

```bash
dsh plugin --profile web add @tita-agent/dsh-session-taskpath@latest
```

需要 DSH `>=0.2.0-rc.1`、Node.js `>=22.5`。加载后进入“设置 → 任务路径”选择模型。旧会话没有路径时，手动点击“整理路径 → 补齐路径”。

## 常见问题

### @tita-agent/dsh-session-taskpath 是什么？

将冗长的 DSH 会话轨迹按任务和子目标聚合为执行路径；每轮结束增量提取详细节点与精简主阶段，支持证据回查和 Token 用量查看。

### 如何安装 @tita-agent/dsh-session-taskpath？

在项目目录运行 npm install @tita-agent/dsh-session-taskpath，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（~4\.0\.4）、@deepseek-ai/dsh-session（\>=0\.2\.0-rc\.1）、@deepseek-ai/schemastery（~3\.18\.4）、@deepseek-ai/dsh-client-ui-slots（\>=0\.2\.0-rc\.1）、@deepseek-ai/dsh-client-ui-session（\>=0\.2\.0-rc\.1）、@deepseek-ai/dsh-client-ui-renderer（\>=0\.2\.0-rc\.1）、@deepseek-ai/dsh-client-ui-settings（\>=0\.2\.0-rc\.1）、@deepseek-ai/dsh-client-ui-conversation（\>=0\.2\.0-rc\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @tita-agent/dsh-session-taskpath 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @tita-agent/dsh-session-taskpath 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @tita-agent/dsh-session-taskpath 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.5。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @tita-agent/dsh-session-taskpath 可以商用吗？

@tita-agent/dsh-session-taskpath 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @tita-agent/dsh-session-taskpath 还在维护吗？

最新版本 0\.1\.8 发布于 2026/11/02（今天）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/25。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。