用途：在 Tuckmark 之外解析私有订单导出，识别物料与数量，必要时在允许范围内研究产品页，再通过 tuckmark CLI 提交并完成导入。Tuckmark 本身不解析订单文件、不调用 LLM、不自动化浏览器。
隐私边界：原始订单导出与产品页正文保留在本地，不得提交、上传、附加、记录或写入提案。只能使用用户批准的简短来源备注，且不得包含账号数据、地址、订单号或会话密钥。仅在用户已授权的浏览器上下文中打开产品页；遇到登录、CAPTCHA、2FA、支付或其它身份验证挑战即停止。
前置条件：需指定 DEVD 实例，使用 --instance <name> 或设置 TUCKMARK_DEVD_INSTANCE，否则命令失败。CLI 通过本地 Unix socket / Named Pipe IPC 通信，不接受 DEVD URL 或数据目录。
工作流：先读取代理推荐目录与当前库存： tuckmark agent-import catalog --instance "$DEVD_INSTANCE" tuckmark agent-import inventory --instance "$DEVD_INSTANCE" --query "<model or keyword>" 目录结果仅含系统与共享目录模板。recommendedUse 为可选的人类可读建议用途；新物料需依据物料证据选择并排序最多三个合适模板，缺少建议时模板仍可用但非默认推荐。
解析订单在 Tuckmark 之外完成。自行判断物料身份，不要运行会把新物料静默转为补货的名称匹配。仅当使用 inventory 返回的确切 targetMaterialId 时才用 kind: "restock"，并附上该物料的 updatedAt 作为 targetMaterialUpdatedAt。当身份、数量、后缀、包装或其它事实证据不确定时添加 needsAttention，该标记不阻塞流程。
构建本地临时 tuckmark.agent-import.v1 提案：新物料必须有一个默认模板、最多两个有序备选、正数库存数量、正数 labelPrintQuantity 与物料字段。description 是简洁概览；deviceDetails 是一个 Markdown 字符串用于事实性设备细节，不要转成键值对象或凭不完整证据制造属性。标签数量应依据存储包装或独立标签单位推导，不要直接复制库存数量。补货项必须不含 template。
创建会话（除非传 --no-open，CLI 会打开确认页），会打印会话 ID 与权限受限的凭据文件路径，绝不打印密钥： tuckmark agent-import create --file /tmp/proposal.json --instance "$DEVD_INSTANCE"
等待用户更改：若用户切换新物料模板，DEVD 会创建字段契约事件并冻结该标签面板。轮询并完成确切事件修订： tuckmark agent-import wait --session <session-id> --instance "$DEVD_INSTANCE" tuckmark agent-import fulfill --session <session-id> --event <event-id> --revision <revision> --input '{"field":"value"}' --instance "$DEVD_INSTANCE" 不要用猜测字段完成事件。过期修订会被拒绝；用 wait 刷新，按新字段契约重新生成值并继续等待。
不得代替用户确认。用户在 Web App 中复核、编辑、选择并确认。会话 30 分钟后过期。限制：未提供网址访问凭证、具体错误处理细节与模板字段定义。