@xdxer/dingtalk-agent 0.1.4-beta.8 → 0.1.4

package/docs/architecture/provider-bound-development-workspace.svg

@@ -0,0 +1,141 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 820" width="1200" height="820" role="img" aria-labelledby="title desc">
+  <title id="title">dingtalk-agent Provider-bound Development Workspace 拓扑</title>
+  <desc id="desc">一个可移植 Agent Project 可以解析成多个开发 Workspace；每个 Workspace 只绑定一个 Host Provider，但可以独立绑定不同的语义 Storage。Session 和 Run 位于 Workspace 内，实际状态和回执与期望 Manifest 分开。</desc>
+  <style>
+    text { font-family: 'Helvetica Neue', Helvetica, Arial, 'PingFang SC', 'Microsoft YaHei', sans-serif; }
+    .title { font-size: 23px; font-weight: 700; fill: #111827; }
+    .subtitle { font-size: 13px; fill: #6b7280; }
+    .layer-title { font-size: 13px; font-weight: 700; fill: #374151; letter-spacing: .4px; }
+    .node-title { font-size: 15px; font-weight: 700; fill: #111827; }
+    .node-sub { font-size: 12px; fill: #6b7280; }
+    .tiny { font-size: 11px; fill: #6b7280; }
+    .edge-label { font-size: 11px; font-weight: 600; fill: #4b5563; }
+  </style>
+  <defs>
+    <marker id="arrow-blue" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#2563eb"/>
+    </marker>
+    <marker id="arrow-green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#16a34a"/>
+    </marker>
+    <marker id="arrow-purple" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto">
+      <polygon points="0 0, 10 3.5, 0 7" fill="#9333ea"/>
+    </marker>
+    <filter id="shadow" x="-10%" y="-10%" width="120%" height="130%">
+      <feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="#111827" flood-opacity="0.10"/>
+    </filter>
+  </defs>
+
+  <rect width="1200" height="820" fill="#ffffff"/>
+  <text x="40" y="43" class="title">Provider-bound Development Workspace</text>
+  <text x="40" y="67" class="subtitle">Project 定义“要开发成什么”；Workspace 定义“在哪里、以什么 Provider 状态开发”；Session / Run 定义“正在做哪件事”。</text>
+
+  <!-- Developer control plane -->
+  <rect x="40" y="92" width="1120" height="108" rx="12" fill="#f9fafb" stroke="#d1d5db" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <text x="58" y="116" class="layer-title">开发控制面</text>
+  <rect x="80" y="132" width="220" height="48" rx="9" fill="#eff6ff" stroke="#bfdbfe" stroke-width="1.5"/>
+  <text x="190" y="153" text-anchor="middle" class="node-title">Coding Agent / Developer</text>
+  <text x="190" y="170" text-anchor="middle" class="node-sub">Codex · OpenCode · 人</text>
+  <rect x="430" y="122" width="330" height="66" rx="10" fill="#fff7ed" stroke="#fed7aa" stroke-width="1.5" filter="url(#shadow)"/>
+  <text x="595" y="147" text-anchor="middle" class="node-title">dta Workflow Skills + CLI</text>
+  <text x="595" y="167" text-anchor="middle" class="node-sub">compose · info · eval · deploy · status</text>
+  <rect x="890" y="132" width="220" height="48" rx="9" fill="#faf5ff" stroke="#e9d5ff" stroke-width="1.5"/>
+  <text x="1000" y="153" text-anchor="middle" class="node-title">Plan / Receipt</text>
+  <text x="1000" y="170" text-anchor="middle" class="node-sub">稳定机器合同，无 Secret</text>
+  <path d="M 300 156 L 420 156" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 760 156 L 880 156" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+
+  <!-- Project -->
+  <rect x="40" y="224" width="800" height="138" rx="12" fill="#f9fafb" stroke="#d1d5db" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <text x="58" y="248" class="layer-title">可移植 Agent Project · 进入 Git</text>
+  <rect x="80" y="270" width="210" height="66" rx="9" fill="#eff6ff" stroke="#bfdbfe" stroke-width="1.5"/>
+  <text x="185" y="296" text-anchor="middle" class="node-title">dingtalk-agent.json</text>
+  <text x="185" y="317" text-anchor="middle" class="node-sub">Project + Workspace 期望状态</text>
+  <rect x="325" y="270" width="210" height="66" rx="9" fill="#f0fdf4" stroke="#bbf7d0" stroke-width="1.5"/>
+  <text x="430" y="296" text-anchor="middle" class="node-title">AGENTS.md + Skills</text>
+  <text x="430" y="317" text-anchor="middle" class="node-sub">本体、Basic、岗位能力</text>
+  <rect x="570" y="270" width="220" height="66" rx="9" fill="#faf5ff" stroke="#e9d5ff" stroke-width="1.5"/>
+  <text x="680" y="296" text-anchor="middle" class="node-title">Eval Suites</text>
+  <text x="680" y="317" text-anchor="middle" class="node-sub">成功标准与晋级门禁</text>
+  <path d="M 595 188 L 595 214 L 430 214 L 430 260" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+
+  <!-- Storage providers -->
+  <rect x="870" y="224" width="290" height="338" rx="12" fill="#f0fdf4" stroke="#bbf7d0" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <text x="890" y="248" class="layer-title">独立 Storage Providers</text>
+  <text x="890" y="269" class="tiny">只决定语义内容放哪里，不决定 Agent 在哪里运行</text>
+  <rect x="910" y="296" width="210" height="54" rx="9" fill="#ffffff" stroke="#86efac" stroke-width="1.5"/>
+  <text x="1015" y="319" text-anchor="middle" class="node-title">local-md / local-dir</text>
+  <text x="1015" y="337" text-anchor="middle" class="node-sub">本地本体、记忆、产物</text>
+  <rect x="910" y="374" width="210" height="54" rx="9" fill="#ffffff" stroke="#86efac" stroke-width="1.5"/>
+  <text x="1015" y="397" text-anchor="middle" class="node-title">dingtalk-doc</text>
+  <text x="1015" y="415" text-anchor="middle" class="node-sub">远端记忆与知识</text>
+  <rect x="910" y="452" width="210" height="54" rx="9" fill="#ffffff" stroke="#86efac" stroke-width="1.5"/>
+  <text x="1015" y="475" text-anchor="middle" class="node-title">Future typed stores</text>
+  <text x="1015" y="493" text-anchor="middle" class="node-sub">AI 表格 · Artifact store</text>
+  <text x="1015" y="538" text-anchor="middle" class="tiny">锁 / Wait / generation / Receipt 不进入这些介质</text>
+
+  <!-- Workspaces -->
+  <rect x="40" y="388" width="800" height="174" rx="12" fill="#f9fafb" stroke="#d1d5db" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <text x="58" y="412" class="layer-title">Development Workspaces · 一个 Workspace 只绑定一个 Host Provider</text>
+  <rect x="75" y="436" width="220" height="94" rx="10" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.8" filter="url(#shadow)"/>
+  <text x="185" y="462" text-anchor="middle" class="node-title">local-dev</text>
+  <text x="185" y="483" text-anchor="middle" class="node-sub">provider = opencode</text>
+  <text x="185" y="503" text-anchor="middle" class="node-sub">model · Basic load · local state</text>
+  <text x="185" y="519" text-anchor="middle" class="tiny">stage = dev</text>
+  <rect x="330" y="436" width="220" height="94" rx="10" fill="#fff7ed" stroke="#fdba74" stroke-width="1.8" filter="url(#shadow)"/>
+  <text x="440" y="462" text-anchor="middle" class="node-title">multica-dev</text>
+  <text x="440" y="483" text-anchor="middle" class="node-sub">provider = multica</text>
+  <text x="440" y="503" text-anchor="middle" class="node-sub">profile · scope · runtime · agentId</text>
+  <text x="440" y="519" text-anchor="middle" class="tiny">stage = dev</text>
+  <rect x="585" y="436" width="220" height="94" rx="10" fill="#faf5ff" stroke="#d8b4fe" stroke-width="1.8"/>
+  <text x="695" y="462" text-anchor="middle" class="node-title">future-workspace</text>
+  <text x="695" y="483" text-anchor="middle" class="node-sub">provider = future</text>
+  <text x="695" y="503" text-anchor="middle" class="node-sub">同一最小 Provider 合同</text>
+  <text x="695" y="519" text-anchor="middle" class="tiny">optional</text>
+  <path d="M 185 362 L 185 426" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 430 362 L 430 406 L 440 406 L 440 426" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 680 362 L 680 406 L 695 406 L 695 426" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <rect x="360" y="374" width="157" height="20" rx="4" fill="#ffffff" opacity="0.96"/>
+  <text x="438" y="388" text-anchor="middle" class="edge-label">Project + Workspace overlay</text>
+
+  <!-- Storage binding arrows -->
+  <path d="M 840 454 L 856 454 L 856 323 L 900 323" fill="none" stroke="#16a34a" stroke-width="1.8" stroke-dasharray="6 4" marker-end="url(#arrow-green)"/>
+  <path d="M 840 522 L 872 522 L 872 401 L 900 401" fill="none" stroke="#16a34a" stroke-width="1.8" stroke-dasharray="6 4" marker-end="url(#arrow-green)"/>
+  <rect x="752" y="418" width="98" height="20" rx="4" fill="#ffffff" opacity="0.96"/>
+  <text x="801" y="432" text-anchor="middle" class="edge-label">storage binding</text>
+
+  <!-- Runtime actual state -->
+  <rect x="40" y="588" width="1120" height="158" rx="12" fill="#f9fafb" stroke="#d1d5db" stroke-width="1.5" stroke-dasharray="6 4"/>
+  <text x="58" y="612" class="layer-title">Provider 实际状态 · 回读后写入 gitignored state / Receipt</text>
+  <rect x="75" y="634" width="220" height="84" rx="10" fill="#111827" stroke="#374151" stroke-width="1.5"/>
+  <text x="185" y="660" text-anchor="middle" font-size="15" font-weight="700" fill="#ffffff">OpenCode Sandbox</text>
+  <text x="185" y="681" text-anchor="middle" font-size="12" fill="#d1d5db">invoke · eval · files/artifacts</text>
+  <text x="185" y="700" text-anchor="middle" font-size="11" fill="#9ca3af">Sessions → Runs → Evidence</text>
+  <rect x="330" y="634" width="220" height="84" rx="10" fill="#fff7ed" stroke="#fdba74" stroke-width="1.5"/>
+  <text x="440" y="660" text-anchor="middle" class="node-title">Multica Managed Agent</text>
+  <text x="440" y="681" text-anchor="middle" class="node-sub">Boot → Basic → Role Skills</text>
+  <text x="440" y="700" text-anchor="middle" class="tiny">agent get · skills · status · smoke</text>
+  <rect x="585" y="634" width="220" height="84" rx="10" fill="#faf5ff" stroke="#d8b4fe" stroke-width="1.5"/>
+  <text x="695" y="660" text-anchor="middle" class="node-title">Future Provider</text>
+  <text x="695" y="681" text-anchor="middle" class="node-sub">doctor · plan · apply</text>
+  <text x="695" y="700" text-anchor="middle" class="tiny">inspect · invoke · status</text>
+  <rect x="890" y="634" width="230" height="84" rx="10" fill="#f0fdfa" stroke="#99f6e4" stroke-width="1.5"/>
+  <text x="1005" y="660" text-anchor="middle" class="node-title">Workspace State / Receipt</text>
+  <text x="1005" y="681" text-anchor="middle" class="node-sub">desiredHash · observedHash</text>
+  <text x="1005" y="700" text-anchor="middle" class="tiny">operationId · evalId · no secrets</text>
+  <path d="M 185 530 L 185 624" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 440 530 L 440 624" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 695 530 L 695 624" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <path d="M 805 676 L 880 676" fill="none" stroke="#9333ea" stroke-width="1.8" marker-end="url(#arrow-purple)"/>
+
+  <!-- Legend and invariant -->
+  <line x1="55" y1="780" x2="90" y2="780" stroke="#2563eb" stroke-width="2" marker-end="url(#arrow-blue)"/>
+  <text x="100" y="784" class="tiny">开发/解析/执行主路径</text>
+  <line x1="265" y1="780" x2="300" y2="780" stroke="#16a34a" stroke-width="1.8" stroke-dasharray="6 4" marker-end="url(#arrow-green)"/>
+  <text x="310" y="784" class="tiny">语义 Storage 绑定</text>
+  <line x1="455" y1="780" x2="490" y2="780" stroke="#9333ea" stroke-width="1.8" marker-end="url(#arrow-purple)"/>
+  <text x="500" y="784" class="tiny">Provider 回读与证据</text>
+  <rect x="760" y="759" width="400" height="38" rx="8" fill="#fef2f2" stroke="#fecaca"/>
+  <text x="960" y="775" text-anchor="middle" font-size="12" font-weight="700" fill="#991b1b">不变量：Provider 不从正文猜身份/目标，不拥有 Trigger</text>
+  <text x="960" y="790" text-anchor="middle" font-size="11" fill="#b91c1c">一个 Workspace 不原地改绑 Provider；新环境创建新 Workspace</text>
+</svg>

package/docs/architecture/task-completion-gate.svg

@@ -0,0 +1,191 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 840" role="img" aria-labelledby="title desc">
+  <title id="title">数字员工任务闭环与完成闸门</title>
+  <desc id="desc">展示任务从可信上下文、理解、条件澄清、计划、执行、验证到完成闸门的流程，以及运行时状态约束和四类证据。</desc>
+  <defs>
+    <style>
+      text { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif; fill: #0f172a; }
+      .title { font-size: 28px; font-weight: 750; }
+      .subtitle { font-size: 14px; fill: #475569; }
+      .section { font-size: 13px; font-weight: 700; letter-spacing: .8px; fill: #475569; }
+      .node-title { font-size: 15px; font-weight: 750; }
+      .node-sub { font-size: 12px; fill: #475569; }
+      .small { font-size: 11px; fill: #64748b; }
+      .label { font-size: 12px; font-weight: 650; }
+    </style>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="3" stdDeviation="5" flood-color="#0f172a" flood-opacity="0.10"/>
+    </filter>
+    <marker id="arrow-blue" markerWidth="10" markerHeight="8" refX="9" refY="4" orient="auto">
+      <path d="M0,0 L10,4 L0,8 Z" fill="#2563eb"/>
+    </marker>
+    <marker id="arrow-orange" markerWidth="10" markerHeight="8" refX="9" refY="4" orient="auto">
+      <path d="M0,0 L10,4 L0,8 Z" fill="#ea580c"/>
+    </marker>
+    <marker id="arrow-green" markerWidth="10" markerHeight="8" refX="9" refY="4" orient="auto">
+      <path d="M0,0 L10,4 L0,8 Z" fill="#059669"/>
+    </marker>
+    <marker id="arrow-stop" markerWidth="10" markerHeight="8" refX="9" refY="4" orient="auto">
+      <path d="M0,0 L10,4 L0,8 Z" fill="#dc2626"/>
+    </marker>
+  </defs>
+
+  <rect width="1200" height="840" fill="#f8fafc"/>
+  <text x="54" y="48" class="title">数字员工任务闭环与完成闸门</text>
+  <text x="54" y="76" class="subtitle">澄清是条件分支；完成是证据结论。Skill 引导语义判断，CLI 固定状态边界，DWS / 文件系统提供可回读事实。</text>
+
+  <rect x="50" y="104" width="1100" height="106" rx="18" fill="#ffffff" stroke="#cbd5e1" stroke-width="1.5" stroke-dasharray="7 5"/>
+  <text x="72" y="130" class="section">可信现场 · TRUSTED CONTEXT</text>
+
+  <rect x="72" y="146" width="304" height="46" rx="12" fill="#eff6ff" stroke="#93c5fd"/>
+  <circle cx="98" cy="169" r="10" fill="#2563eb"/>
+  <path d="M93 169 l4 4 l7 -8" fill="none" stroke="#ffffff" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <text x="118" y="166" class="node-title">Origin + Continuation</text>
+  <text x="118" y="182" class="small">当前消息、线程与明确续接</text>
+
+  <rect x="448" y="146" width="304" height="46" rx="12" fill="#fff7ed" stroke="#fdba74"/>
+  <path d="M470 160 h18 v18 h-18 z M474 156 h10 v5 h-10 z" fill="none" stroke="#ea580c" stroke-width="1.8"/>
+  <text x="502" y="166" class="node-title">Definition + Authority</text>
+  <text x="502" y="182" class="small">身份、职责、作用域与权限</text>
+
+  <rect x="824" y="146" width="304" height="46" rx="12" fill="#f0fdf4" stroke="#86efac"/>
+  <path d="M848 158 h17 l6 6 v14 h-23 z M865 158 v7 h7" fill="none" stroke="#059669" stroke-width="1.8" stroke-linejoin="round"/>
+  <text x="884" y="166" class="node-title">Workspace + Role Skills</text>
+  <text x="884" y="182" class="small">附件、知识、已有 checkpoint</text>
+
+  <path d="M600 210 V236" fill="none" stroke="#ea580c" stroke-width="2" marker-end="url(#arrow-orange)"/>
+
+  <text x="50" y="251" class="section">员工任务主流程 · EMPLOYEE LOOP</text>
+
+  <rect x="50" y="272" width="146" height="78" rx="16" fill="#ffffff" stroke="#60a5fa" stroke-width="2" filter="url(#shadow)"/>
+  <circle cx="78" cy="298" r="13" fill="#dbeafe"/>
+  <path d="M72 298 h12 M78 292 v12" stroke="#2563eb" stroke-width="2" stroke-linecap="round"/>
+  <text x="101" y="299" class="node-title">UNDERSTAND</text>
+  <text x="73" y="326" class="node-sub">形成内部任务合同</text>
+  <text x="73" y="342" class="small">goal · deliverable · doneWhen</text>
+
+  <path d="M196 311 H228" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#arrow-blue)"/>
+
+  <path d="M300 268 L370 311 L300 354 L230 311 Z" fill="#fff7ed" stroke="#fb923c" stroke-width="2" filter="url(#shadow)"/>
+  <text x="300" y="306" text-anchor="middle" class="node-title">存在阻塞缺口？</text>
+  <text x="300" y="326" text-anchor="middle" class="small">会改变结果 / 权限 / 副作用</text>
+
+  <path d="M370 311 H406" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#arrow-blue)"/>
+  <rect x="374" y="288" width="28" height="18" rx="5" fill="#f8fafc" opacity="0.96"/>
+  <text x="388" y="301" text-anchor="middle" class="label" fill="#2563eb">否</text>
+
+  <rect x="406" y="272" width="132" height="78" rx="16" fill="#ffffff" stroke="#60a5fa" stroke-width="2"/>
+  <text x="472" y="301" text-anchor="middle" class="node-title">PLAN</text>
+  <text x="472" y="324" text-anchor="middle" class="node-sub">2–5 个检查点</text>
+  <text x="472" y="341" text-anchor="middle" class="small">单步任务可省略</text>
+
+  <path d="M538 311 H570" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#arrow-blue)"/>
+
+  <rect x="570" y="272" width="132" height="78" rx="16" fill="#ffffff" stroke="#60a5fa" stroke-width="2"/>
+  <text x="636" y="301" text-anchor="middle" class="node-title">EXECUTE</text>
+  <text x="636" y="324" text-anchor="middle" class="node-sub">最小充分动作</text>
+  <text x="636" y="341" text-anchor="middle" class="small">副作用前重核对象</text>
+
+  <path d="M702 311 H734" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#arrow-blue)"/>
+
+  <rect x="734" y="272" width="132" height="78" rx="16" fill="#ffffff" stroke="#34d399" stroke-width="2"/>
+  <text x="800" y="301" text-anchor="middle" class="node-title">VERIFY</text>
+  <text x="800" y="324" text-anchor="middle" class="node-sub">检查真实状态</text>
+  <text x="800" y="341" text-anchor="middle" class="small">生成 ≠ 保存 ≠ 送达</text>
+
+  <path d="M866 311 H898" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#arrow-blue)"/>
+
+  <rect x="898" y="252" width="252" height="118" rx="18" fill="#fffbeb" stroke="#f59e0b" stroke-width="2.5" filter="url(#shadow)"/>
+  <rect x="918" y="270" width="52" height="24" rx="12" fill="#f59e0b"/>
+  <text x="944" y="287" text-anchor="middle" font-size="11" font-weight="750" fill="#ffffff">CLI GATE</text>
+  <text x="1024" y="289" class="node-title">COMPLETION GATE</text>
+  <text x="920" y="316" class="small">① status = verifying</text>
+  <text x="1038" y="316" class="small">② doneWhen 有证据</text>
+  <text x="920" y="337" class="small">③ waitingFor = null</text>
+  <text x="1038" y="337" class="small">④ nextAction 为空</text>
+  <text x="920" y="356" class="small">回复正文不能证明自己的完成声明</text>
+
+  <path d="M1024 370 V412" fill="none" stroke="#2563eb" stroke-width="2.4" marker-end="url(#arrow-blue)"/>
+  <rect x="1032" y="383" width="58" height="20" rx="6" fill="#f8fafc" opacity="0.96"/>
+  <text x="1061" y="398" text-anchor="middle" class="label" fill="#2563eb">全部通过</text>
+
+  <rect x="940" y="414" width="168" height="70" rx="18" fill="#ecfdf5" stroke="#10b981" stroke-width="2.5" filter="url(#shadow)"/>
+  <circle cx="972" cy="443" r="14" fill="#10b981"/>
+  <path d="M965 443 l5 5 l9 -11" fill="none" stroke="#ffffff" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"/>
+  <text x="1041" y="442" text-anchor="middle" class="node-title">COMPLETE</text>
+  <text x="1024" y="466" text-anchor="middle" class="node-sub">结果 · 证据 · 遗留 · owner</text>
+
+  <path d="M300 354 V396 H196" fill="none" stroke="#ea580c" stroke-width="2" marker-end="url(#arrow-orange)"/>
+  <rect x="306" y="366" width="28" height="18" rx="5" fill="#f8fafc" opacity="0.96"/>
+  <text x="320" y="379" text-anchor="middle" class="label" fill="#ea580c">是</text>
+
+  <rect x="50" y="396" width="146" height="72" rx="16" fill="#fff7ed" stroke="#fb923c" stroke-width="2"/>
+  <text x="123" y="425" text-anchor="middle" class="node-title">CLARIFY</text>
+  <text x="123" y="447" text-anchor="middle" class="node-sub">只问一个阻塞问题</text>
+  <text x="123" y="462" text-anchor="middle" class="small">信息足够时不出现</text>
+
+  <path d="M196 432 H230" fill="none" stroke="#ea580c" stroke-width="2" marker-end="url(#arrow-orange)"/>
+  <rect x="230" y="396" width="146" height="72" rx="16" fill="#fff7ed" stroke="#fb923c" stroke-width="2"/>
+  <text x="303" y="425" text-anchor="middle" class="node-title">WAIT</text>
+  <text x="303" y="447" text-anchor="middle" class="node-sub">记录恢复条件</text>
+  <text x="303" y="462" text-anchor="middle" class="small">释放沙箱，不轮询</text>
+
+  <path d="M303 468 V516 H78 V350" fill="none" stroke="#7c3aed" stroke-width="1.8" marker-end="url(#arrow-blue)"/>
+  <rect x="154" y="505" width="98" height="20" rx="6" fill="#f8fafc" opacity="0.96"/>
+  <text x="203" y="519" text-anchor="middle" class="small" fill="#7c3aed">新事件恢复原 Session</text>
+
+  <path d="M898 338 H884 V448 H836" fill="none" stroke="#dc2626" stroke-width="2" marker-end="url(#arrow-stop)"/>
+  <rect x="846" y="424" width="26" height="18" rx="5" fill="#f8fafc" opacity="0.96"/>
+  <text x="859" y="437" text-anchor="middle" class="label" fill="#dc2626">失败</text>
+  <rect x="646" y="414" width="190" height="70" rx="16" fill="#fef2f2" stroke="#f87171" stroke-width="2"/>
+  <text x="741" y="441" text-anchor="middle" class="node-title">返工 / 等待 / 阻塞</text>
+  <text x="741" y="463" text-anchor="middle" class="node-sub">准确报告，不说“已完成”</text>
+  <path d="M646 449 H620 V350" fill="none" stroke="#dc2626" stroke-width="1.8" marker-end="url(#arrow-stop)"/>
+
+  <rect x="50" y="550" width="1100" height="222" rx="20" fill="#ffffff" stroke="#bbf7d0" stroke-width="1.5" stroke-dasharray="7 5"/>
+  <text x="72" y="579" class="section">证据平面 · EVIDENCE PLANE</text>
+  <text x="72" y="600" class="small">每条 doneWhen 绑定至少一种可定位事实；质量分不能覆盖缺失证据。</text>
+
+  <rect x="72" y="624" width="230" height="104" rx="16" fill="#f0fdf4" stroke="#86efac"/>
+  <path d="M94 643 h24 l7 7 v24 h-31 z M118 643 v8 h8" fill="none" stroke="#059669" stroke-width="2" stroke-linejoin="round"/>
+  <text x="140" y="654" class="node-title">文件系统</text>
+  <text x="94" y="684" class="node-sub">路径存在 · 内容匹配</text>
+  <text x="94" y="705" class="node-sub">大小 / sha256 可核验</text>
+
+  <rect x="328" y="624" width="230" height="104" rx="16" fill="#f0fdf4" stroke="#86efac"/>
+  <rect x="350" y="643" width="32" height="25" rx="3" fill="none" stroke="#059669" stroke-width="2"/>
+  <path d="M350 651 h32 M357 647 h2 M363 647 h2" stroke="#059669" stroke-width="1.5" stroke-linecap="round"/>
+  <text x="396" y="654" class="node-title">Workspace / Artifact</text>
+  <text x="350" y="684" class="node-sub">Definition / manifest 有效</text>
+  <text x="350" y="705" class="node-sub">声明产物逐项存在</text>
+
+  <rect x="584" y="624" width="230" height="104" rx="16" fill="#f0fdf4" stroke="#86efac"/>
+  <circle cx="610" cy="656" r="14" fill="none" stroke="#059669" stroke-width="2"/>
+  <path d="M603 656 l5 5 l10 -12" fill="none" stroke="#059669" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
+  <text x="636" y="654" class="node-title">Receipt + Readback</text>
+  <text x="606" y="684" class="node-sub">Intent / Attempt / Verification</text>
+  <text x="606" y="705" class="node-sub">平台独立回读可见</text>
+
+  <rect x="840" y="624" width="230" height="104" rx="16" fill="#f0fdf4" stroke="#86efac"/>
+  <circle cx="866" cy="652" r="9" fill="none" stroke="#059669" stroke-width="2"/>
+  <path d="M850 672 c2 -11 30 -11 32 0" fill="none" stroke="#059669" stroke-width="2" stroke-linecap="round"/>
+  <text x="896" y="654" class="node-title">人工确认 / 审批</text>
+  <text x="862" y="684" class="node-sub">明确接受或业务状态变更</text>
+  <text x="862" y="705" class="node-sub">未确认时保持 verifying</text>
+
+  <path d="M187 624 V606 H1168 V325 H1150" fill="none" stroke="#059669" stroke-width="1.8" marker-end="url(#arrow-green)"/>
+  <path d="M443 624 V606" fill="none" stroke="#059669" stroke-width="1.8"/>
+  <path d="M699 624 V606" fill="none" stroke="#059669" stroke-width="1.8"/>
+  <path d="M955 624 V606" fill="none" stroke="#059669" stroke-width="1.8"/>
+  <rect x="1006" y="590" width="82" height="20" rx="6" fill="#ffffff" opacity="0.96"/>
+  <text x="1047" y="604" text-anchor="middle" class="small" fill="#059669">证据汇入 Gate</text>
+
+  <line x1="72" y1="805" x2="106" y2="805" stroke="#2563eb" stroke-width="2.2" marker-end="url(#arrow-blue)"/>
+  <text x="116" y="809" class="small">主流程</text>
+  <line x1="198" y1="805" x2="232" y2="805" stroke="#ea580c" stroke-width="2" marker-end="url(#arrow-orange)"/>
+  <text x="242" y="809" class="small">条件 / 控制</text>
+  <line x1="354" y1="805" x2="388" y2="805" stroke="#059669" stroke-width="2" marker-end="url(#arrow-green)"/>
+  <text x="398" y="809" class="small">独立证据</text>
+  <line x1="500" y1="805" x2="534" y2="805" stroke="#dc2626" stroke-width="2" marker-end="url(#arrow-stop)"/>
+  <text x="544" y="809" class="small">闸门失败 / 返回</text>
+  <text x="1128" y="809" text-anchor="end" class="small">Skill 劝 · CLI 拦 · DWS 做</text>
+</svg>

package/docs/assets/agent-delivery-lifecycle.svg

@@ -0,0 +1,103 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="520" viewBox="0 0 1200 520" role="img" aria-labelledby="title desc">
+  <title id="title">dingtalk-agent 从定义到交付的生命周期</title>
+  <desc id="desc">AGENTS.md、Basic Behavior 和 Role Skills 组成 Agent Project，经本地或云上 Harness 测试，通过 Gate 和 Receipt 后发布到 Managed Agent Platform，最终以数字员工账号或机器人身份交付。</desc>
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#0a1020"/>
+      <stop offset="1" stop-color="#111a31"/>
+    </linearGradient>
+    <linearGradient id="accent" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#39c6f4"/>
+      <stop offset="1" stop-color="#7777ff"/>
+    </linearGradient>
+    <filter id="shadow" x="-20%" y="-30%" width="140%" height="160%">
+      <feDropShadow dx="0" dy="8" stdDeviation="12" flood-color="#020617" flood-opacity=".34"/>
+    </filter>
+    <style>
+      .eyebrow { font: 600 13px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; letter-spacing: 1.6px; fill: #7dd3fc; }
+      .title { font: 700 22px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #f8fafc; }
+      .body { font: 500 15px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #cbd5e1; }
+      .small { font: 500 13px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #94a3b8; }
+      .chip { font: 600 12px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #dbeafe; }
+      .number { font: 700 14px -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #08111f; }
+    </style>
+  </defs>
+
+  <rect width="1200" height="520" rx="28" fill="url(#bg)"/>
+  <path d="M52 90H1148" stroke="#23304a"/>
+  <text x="52" y="55" class="eyebrow">ONE AGENT PROJECT · ONE VERIFIABLE CONTRACT</text>
+  <text x="52" y="82" class="title">同一份定义，完成创建、测试、发布和交付</text>
+
+  <!-- Step 1 -->
+  <g filter="url(#shadow)">
+    <rect x="52" y="132" width="272" height="232" rx="22" fill="#111c33" stroke="#2b3b59"/>
+    <circle cx="86" cy="168" r="16" fill="#67e8f9"/>
+    <text x="86" y="173" text-anchor="middle" class="number">1</text>
+    <text x="112" y="175" class="title">定义 Agent</text>
+    <rect x="76" y="208" width="224" height="38" rx="9" fill="#172643"/>
+    <text x="92" y="232" class="body">AGENTS.md</text>
+    <rect x="76" y="256" width="224" height="38" rx="9" fill="#172643"/>
+    <text x="92" y="280" class="body">Basic Behavior</text>
+    <rect x="76" y="304" width="224" height="38" rx="9" fill="#172643"/>
+    <text x="92" y="328" class="body">Role Skills</text>
+  </g>
+
+  <!-- Arrow 1 -->
+  <path d="M340 248H386" stroke="url(#accent)" stroke-width="3" stroke-linecap="round"/>
+  <path d="m378 240 10 8-10 8" fill="none" stroke="#7777ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- Step 2 -->
+  <g filter="url(#shadow)">
+    <rect x="404" y="132" width="292" height="232" rx="22" fill="#111c33" stroke="#2b3b59"/>
+    <circle cx="438" cy="168" r="16" fill="#67e8f9"/>
+    <text x="438" y="173" text-anchor="middle" class="number">2</text>
+    <text x="464" y="175" class="title">Harness 测试</text>
+    <text x="428" y="219" class="body">加载 · 隔离 · 执行 · 回读</text>
+    <rect x="428" y="246" width="112" height="30" rx="15" fill="#17314b" stroke="#275779"/>
+    <text x="484" y="266" text-anchor="middle" class="chip">本地 Runtime</text>
+    <rect x="552" y="246" width="120" height="30" rx="15" fill="#2a254f" stroke="#4f46a5"/>
+    <text x="612" y="266" text-anchor="middle" class="chip">云上 Runtime</text>
+    <path d="M428 304H672" stroke="#263956"/>
+    <circle cx="440" cy="329" r="7" fill="#4ade80"/>
+    <text x="456" y="334" class="small">Gate 通过，Receipt 可核验</text>
+  </g>
+
+  <!-- Arrow 2 -->
+  <path d="M712 248H758" stroke="url(#accent)" stroke-width="3" stroke-linecap="round"/>
+  <path d="m750 240 10 8-10 8" fill="none" stroke="#7777ff" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+
+  <!-- Step 3 -->
+  <g filter="url(#shadow)">
+    <rect x="776" y="132" width="228" height="232" rx="22" fill="#111c33" stroke="#2b3b59"/>
+    <circle cx="810" cy="168" r="16" fill="#67e8f9"/>
+    <text x="810" y="173" text-anchor="middle" class="number">3</text>
+    <text x="836" y="175" class="title">发布到平台</text>
+    <text x="800" y="219" class="body">Managed Agent Platform</text>
+    <rect x="800" y="246" width="180" height="38" rx="9" fill="#172643"/>
+    <text x="890" y="270" text-anchor="middle" class="body">Multica · 已支持</text>
+    <rect x="800" y="294" width="180" height="38" rx="9" fill="#172643"/>
+    <text x="890" y="318" text-anchor="middle" class="body">更多 Adapter</text>
+  </g>
+
+  <!-- Delivery branches -->
+  <path d="M1004 220H1030Q1048 220 1048 202V182Q1048 164 1066 164H1080" fill="none" stroke="#586985" stroke-width="2"/>
+  <path d="M1004 276H1030Q1048 276 1048 294V314Q1048 332 1066 332H1080" fill="none" stroke="#586985" stroke-width="2"/>
+  <g filter="url(#shadow)">
+    <rect x="1080" y="126" width="82" height="112" rx="18" fill="#14213b" stroke="#38678b"/>
+    <circle cx="1121" cy="159" r="13" fill="#7dd3fc"/>
+    <path d="M1099 200c2-19 10-28 22-28s20 9 22 28" fill="#7dd3fc" opacity=".9"/>
+    <text x="1121" y="223" text-anchor="middle" class="small">数字员工</text>
+  </g>
+  <g filter="url(#shadow)">
+    <rect x="1080" y="276" width="82" height="112" rx="18" fill="#14213b" stroke="#554fb0"/>
+    <rect x="1100" y="309" width="42" height="34" rx="10" fill="#a5b4fc"/>
+    <circle cx="1112" cy="325" r="4" fill="#14213b"/>
+    <circle cx="1130" cy="325" r="4" fill="#14213b"/>
+    <path d="M1121 298v11M1115 298h12" stroke="#a5b4fc" stroke-width="4" stroke-linecap="round"/>
+    <text x="1121" y="373" text-anchor="middle" class="small">机器人</text>
+  </g>
+
+  <text x="52" y="432" class="body">继承不靠自述：Definition / Skill hash、运行轨迹、平台回读与 Receipt 共同证明。</text>
+  <rect x="52" y="458" width="1096" height="1" fill="#23304a"/>
+  <text x="52" y="491" class="small">身份、目标、权限、预算和副作用始终由可信宿主与 Gate 固定。</text>
+</svg>

package/docs/schemas/agent-audit-load-evidence.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/agent-audit-load-evidence.schema.json",
+  "title": "dingtalk-agent Agent Audit Load Evidence",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "targetHash", "reportPath", "reportHash"],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/agent-audit-load-evidence@1" },
+    "targetHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "reportPath": { "type": "string", "minLength": 1 },
+    "reportHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+  }
+}

package/docs/schemas/agent-audit.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/D1-2004/dingtalk-agent/docs/schemas/agent-audit.schema.json",
+  "title": "dingtalk-agent Agent Audit Report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema", "status", "ready", "sideEffect", "dingtalkSideEffect", "root",
+    "bindings", "definition", "storageMode", "requiredSkills", "checks", "missing",
+    "repairs", "verification"
+  ],
+  "properties": {
+    "$schema": { "const": "dingtalk-agent/agent-audit@1" },
+    "status": { "enum": ["ready", "partial"] },
+    "ready": { "type": "boolean" },
+    "sideEffect": { "enum": [false, "local-opencode-eval"] },
+    "dingtalkSideEffect": { "const": false },
+    "root": { "type": "string", "minLength": 1 },
+    "bindings": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "hash"],
+          "properties": {
+            "path": { "type": "string" },
+            "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+          }
+        }
+      ]
+    },
+    "definition": { "type": "object" },
+    "storageMode": { "enum": ["local", "remote", "mixed"] },
+    "requiredSkills": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "checks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "surface", "level", "blocking", "summary", "evidence"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "surface": { "enum": ["definition", "skills", "storage", "authority", "host", "load"] },
+          "level": { "enum": ["pass", "warn", "fail"] },
+          "blocking": { "type": "boolean" },
+          "summary": { "type": "string", "minLength": 1 },
+          "evidence": { "type": "object" }
+        }
+      }
+    },
+    "missing": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "repairs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "why", "actions"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "why": { "type": "string", "minLength": 1 },
+          "actions": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["loadReport", "remoteReport", "commands"],
+      "properties": {
+        "loadReport": { "type": "string" },
+        "remoteReport": { "type": "string" },
+        "commands": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}