---
type: 流程复现
category: 20-开发与调试
project: 智能体知识库
created: 2026-11-14
updated: 2026-11-14 16:37
tags: [流程复现]
---
# 安装并验证session-handoff

## 什么时候用

需要安装或复核 session-handoff，并验证单元测试、空项目回归、Codex Export/Import 与 DSH 触发时使用。

## 前提

- 安装目标为 `/vol1/ai/home/.agents/skills/session-handoff`，原共享目录备份为 `/vol1/ai/agents/shared/session-handoff.backup-20261114-1634`。
- 测试目录、回归脚本和客户端会话已确认；测试允许读取技能目录，但只写临时项目目录。
- 偏好判断必须有用户原话来源；DSH 派单后必须用 `result` 轮询到 `done`，并核验实际文件。

## 可直接复制的命令

```bash
cd /vol1/ai/home/.agents/skills/session-handoff
python3 -m unittest discover -s tests -v
python3 /vol1/ai/home/session-handoff-validation-20261114/regression.py
codex exec --skip-git-repo-check --json -C 测试目录 "继续上个对话"
```

DSH 通过 MCP `dispatch` 派单后，使用 `result` 持续轮询到 `done`，再检查 Export/Import 结果及 `resumed.txt` 等实际文件。

## 关键参数与坑

| 项 | 值 / 说明 |
|---|---|
| 跨盘备份 | 跨文件系统 `rename` 会报 `Errno18`；原共享目录备份必须使用同盘路径。 |
| 测试写入范围 | 测试可读取技能目录，但只应写入临时目录，避免污染安装源。 |
| 偏好来源 | 只能依据用户原话判断偏好，不能从上下文臆测。 |
| DSH 验收 | `dispatch` 返回 run ID 不等于完成；必须 `result` 轮询到 `done` 并核验文件。 |
| 知识库追加 | `kb.py add` 必须显式带 `--project session-handoff`。 |
| 回滚语义 | 回滚到无偏好版本时不得错误继承活动偏好；历史快照应保留。 |

## 验证（怎么算做成了）

- 原 12 项测试通过；新增回滚无偏好测试先失败后修复，现 13 项测试通过。
- 空项目全回归通过；Codex 旧会话 `01a1d92d-f733-7d40-be27-53881db7872e` 与新会话 `01a1d92f-adb7-7f81-87e5-8b21a3af79fe` 的 Export/Import 及 `resumed.txt` 创建已核验成功。
- Codex和DSH均真实发现并触发，分别独立新会话Import并创建 `resumed.txt`，由主验收读取校验；6份历史完整verify通过。DSH新session为 `acb55aca-86f7-428a-88c7-06505ae17d67`，run为 `20261114-163530-33d616`，done退出0；未读历史正文，未重复交接。
- 源码v1.0.1 ZIP `/vol1/ai/home/session-handoff-validation-20261114/session-handoff-v1.0.1.zip` 大小20521字节，SHA256 `04901316e3e43397b015a4457fe3f285858d5ce714e8272675958da4e5b6cbc3`；验收报告为同目录 `validation-report.md`。
- 限制：未验证GUI触发、Windows、Python3.9、长对话token节约比例和故障注入；DSH偏好曾需人工纠正，收紧规则后通过不代表未来保证。

## 相关

- 
