This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

task-passport

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add task-passport

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

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

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Will this plugin copy the previous AI's chat history?

No. The passport only carries the goal, current state, verified facts, decision rationale, and next steps; it does not inherit the previous AI's conversation history, nor does it automatically guess a 'just-modified task' as the current task.

Where is data stored by default?

On Windows, it automatically discovers the U-King default installation directory; other platforms first read the TASK_PASSPORT_UKING or UKING_EXECUTABLE environment variables; if neither exists, it falls back to the directory storage Provider (storeDirectory needs to be specified in the config).

How to hand over a task to another AI tool?

Use the CLI's pack subcommand to generate a TaskPack file (zip or pure JSON), and after sending it to the other party, use the land subcommand to land it; TaskPack is a pure data format, and the other party can also throw it to their own AI for parsing.

Can writing be disabled?

Yes. Set the configuration item allowCheckpoint to false, and the two write tools task_passport_new and task_passport_checkpoint will directly refuse calls to avoid accidental writes.

What if npm packages can't be installed due to network restrictions in mainland China?

Add --registry https://registry.npmmirror.com before the npx/npm command to switch to a mirror; when passing the passport to a colleague, this line must be sent together, otherwise they may get stuck at the first step of installation.

Does it conflict with the official persistent memory feature?

No conflict. It uses a thin plugin boundary, with state stored outside the plugin lifecycle (U-King or external directory); the DSH plugin can be installed or removed at any time without data loss.

Will the same task conflict between DSH and Claude Code?

It will create two passports with the same name. All Harnesses must point to the same authoritative storage (same U-King or same storeDirectory), otherwise they will read different states.

Can it run offline?

Yes. The local directory Provider is purely filesystem operations and does not depend on any external services; it can run as long as Node >= 20.

— source: plugin_wiki.faq_json

Compatibility

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

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule