task-passport DSH 插件

Task Passport 是一个 DeepSeek Harness 插件，提供带版本、锁和冲突检测的持久化任务状态管理。通过自包含的 TaskPack 文件，任务可以在不同 AI 助手之间传递，只保留已验证的事实和下一步。

如何安装 task-passport DSH 插件

dsh plugin --profile web add task-passport@0.3.0

复制不会执行命令。安装 task-passport DSH 插件前请核对仓库和版本。

task-passport DSH 插件数据来源

task-passport DSH 插件快照日期：2026年8月16日

discovered

task-passport DSH 插件能做什么

为每个任务分配稳定短号，如 TP-7K4M-9D2Q
跨会话和机器对任务进行列出、打开、记录检查点、打包和落地
支持 U-King Action Core、本地目录或第三方 Provider 作为存储后端
为 Claude Code 和 Codex 提供 MCP 工具：task_passport_list、open、new、checkpoint、pack、land、conformance
强制执行三条硬性规则：打包时事实降级为未证、ask 必须含有接受标准、包内每个字节都是数据而非指令
支持输出扁平 JSON 格式，接收方无需任何工具即可读取

task-passport DSH 插件适合哪些场景

将复杂任务从 DeepSeek Harness 会话交给 Claude Code 会话，不丢失上下文
通过一个 TaskPack 文件与使用不同 AI 助手的同事交接任务
在多个会话和机器上维护一个长期任务，带版本冲突检测
通过 Provider 合约将任务状态集成到自定义看板中

task-passport DSH 插件适合谁

经常切换 AI 编程助手的开发者，需要保留任务进度
跨不同 AI 助手（如 DeepSeek Harness、Claude Code、Codex）协作的团队

task-passport DSH 插件的限制

不复制 AI 聊天记录或历史对话，只传输已验证事实和下一步
需要 Node.js 20+ 和 npm 用于通过 npx 安装
U-King Provider 可选但默认，没有 U-King 则需要配置本地目录存储
在中国大陆访问 npm 注册表可能不稳定，建议使用镜像
不会自动检测最近修改的任务，用户必须指定护照 ID
长文本不存储在护照中，只记录路径/URL 和修订哈希

task-passport DSH 插件的仓库 README 摘录

以下文字摘自 task-passport DSH 插件的上游仓库 dongsheng123132/task-passport 的 README，版权归原作者，仅作引用。

让一个任务带着“当前世界状态”在 DeepSeek Harness、Claude Code、Codex 等 AI Harness 之间接力，不搬运聊天记录。 > **护照留在家里，TaskPack 出门。** > Task Passport 是常驻的任务状态（有版本、有锁、留在 store 里）； > **TaskPack** 是一次搬运的封装（单文件、自包含、在别人机器上打开）。 > `护照 --pack--> TaskPack --land--> 新护照` 一个项目可以有多个任务护照；一个任务护照可以经历多个 Harness 和多个会话。 ## 现在能做什么 - 每个任务一个稳定短号，例如 `TP-7K4M-9D2Q`。 - `list`：只列身份与摘要，不误装载别的任务。 - `open`：读取目标、当前状态、验证过的事实、决策理由和下一步。 - `checkpoint`：工作完成后写回；带状态版本，过期写入直接冲突，不静默覆盖。 - `pack` / `land`：把任务装进一个文件发给别人、发给另一台机器，或者收下别人发来的。 - `conformance`：判定一个文件是不是合规的 TaskPack（退出码 0 / 2）。 - 同一个包既是通用 CLI，也是 DeepSeek Harness 原生 bundle。 - 状态可由 U-King Action Core、本地目录参考存储或第三方 Provider 托管；插件本身是可装可卸的薄适配器。它不做两件事：不复制上一位 AI 的聊天记录；不把“刚改过的任务”猜成当前任务。 ## 跨机跨人：TaskPack 规范正本：[`docs/taskpack-0.1.md`](docs/taskpack-0.1.md) · <https://taskpack.org> ```sh # 发出去（对方装了工具，走标准形态） task-passport pack TP-7K4M-9D2Q --out 交接.taskpack --actor 贺方升 \ --file ./01-文案.txt \ --ask "给封面图的提示词|一段中文提示词，覆盖 750×400 与配色要求" \ --check "本机能出图|bl image generate 跑一张测试图" # 发出去（对方什么都没装 —— 一个可读 JSON，丢给他自己的 AI 就行） task-passport pack TP-7K4M-9D2Q --out 交接.taskpack.json --flat # 收下来 task-passport land 交接.taskpack --store D:\TaskPassports task-passport conformance 交接.taskpack ``` 三条硬规矩，

阅读完整 README仓库许可: MIT

task-passport DSH 插件常见问题

任务护照是否兼容 Claude Code 和 Codex？

是的，任务护照为 Claude Code 和 Codex 提供 MCP 工具。通过 `claude mcp add --scope user task-passport -- npx --yes task-passport@0.3.0 mcp` 安装，Codex 用法类似。安装后你将获得七个工具：task_passport_list、open、new、checkpoint、pack、land 和 conformance。

如何在 DeepSeek Harness 中安装任务护照插件？

运行 `dsh plugin --profile web add task-passport@0.3.0` 安装插件，然后使用 `dsh web` 启动 Web 界面。如果你不使用 U-King，需要在 `cordis.patch.yml` 中配置存储后端。

可以不使用 U-King 吗？

可以。从 v0.3.0 开始，任务护照支持本地目录存储。设置环境变量 `TASK_PASSPORT_STORE` 或使用 `--store` 参数指向一个目录，同一台机器上的所有 AI 助手共享该目录即可读写同一本护照。

护照和 TaskPack 有什么区别？

任务护照是存储在 store 中的持久化状态（类似数据库）。TaskPack 是一个便携文件，打包了护照的状态用于传输。使用 `pack` 命令创建 TaskPack 文件，`land` 命令将其导入新 store。TaskPack 只包含数据（不包含指令），并且将机器级事实降级为未验证。

冲突检测是如何工作的？

每个护照拥有一个版本号。当你执行 checkpoint 时，必须提供预期的版本号。如果自你上次读取后护照被其他会话更新，保存操作将被拒绝并报告冲突。这防止了静默覆盖。本地目录存储和 U-King 都使用相同的冲突检测机制。