本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

task-passport

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add task-passport

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 每个任务一个稳定短号，例如 TP-7K4M-9D2Q。
• list：只列身份与摘要，不误装载别的任务。
• open：读取目标、当前状态、验证过的事实、决策理由和下一步。
• checkpoint：工作完成后写回；带状态版本，过期写入直接冲突，不静默覆盖。
• pack / land：把任务装进一个文件发给别人、发给另一台机器，或者收下别人发来的。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件会复制上一位 AI 的聊天记录吗？

不会。护照只携带目标、当前状态、已验证事实、决策理由和下一步；不会继承上一位 AI 的对话记录，也不会自动把"刚改过的任务"猜成当前任务。

默认会把数据存在哪里？

Windows 上会自动发现 U-King 默认安装目录；其他平台优先读取 TASK_PASSPORT_UKING 或 UKING_EXECUTABLE 环境变量；如果都没有，再回落到目录存储 Provider（需在配置中指定 storeDirectory）。

如何把任务交给另一个 AI 工具？

使用 CLI 的 pack 子命令生成 TaskPack 文件（zip 或纯 JSON），发给对方后用 land 子命令落地；TaskPack 是纯数据格式，对方也可以丢给自己 AI 解析。

写入可以被关闭吗？

可以。把配置项 allowCheckpoint 设为 false 后，task_passport_new 和 task_passport_checkpoint 两个写工具会直接拒绝调用，避免误写入。

中国大陆网络装不上 npm 包怎么办？

在 npx / npm 命令前加 --registry https://registry.npmmirror.com 切换镜像；把护照交给同事时这一行要一起发过去，否则对方第一步可能就卡在安装阶段。

它和官方持久记忆功能冲突吗？

不冲突。它采用薄插件边界，状态保存在插件生命周期之外（U-King 或外部目录），DSH 插件可以随时装卸而数据不丢失。

同一个任务在 DSH 和 Claude Code 中会冲突吗？

会形成两本同名护照。必须让所有 Harness 指向同一个权威存储（同一份 U-King 或同一份 storeDirectory），否则会读到不同的状态。

离线能跑吗？

可以。本地目录 Provider 完全是文件系统操作，不依赖任何外部服务；只要 Node >= 20 就能运行。

— 源: plugin_wiki.faq_json

兼容性

• DSH: >=0.1.0-rc.5（基于 @deepseek-ai/dsh-tools peer）
• Node: >=20

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则