@xdxer/dingtalk-agent 0.1.4-beta.1 → 0.1.4-beta.11

package/docs/architecture/general-agent-kernel-topology.svg

@@ -0,0 +1,149 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1440 920" width="1440" height="920" role="img" aria-labelledby="title desc">
+  <title id="title">dingtalk-agent 通用 Agent 行为内核拓扑</title>
+  <desc id="desc">外部触发器提供标准化 Invocation；Agent Definition、基础 Skill 与岗位 Skill 定义具体员工；dingtalk-agent 内核补齐感知、判断响应资格、维护 Session Run Wait 并约束 Action；DWS 负责执行钉钉产品能力。</desc>
+  <style>
+    text { font-family:'Helvetica Neue',Helvetica,Arial,'PingFang SC','Microsoft YaHei',sans-serif; }
+    .title { fill:#111827;font-size:28px;font-weight:700; }
+    .subtitle { fill:#6b7280;font-size:14px; }
+    .lane { fill:#475569;font-size:12px;font-weight:700;letter-spacing:.08em; }
+    .node-title { fill:#111827;font-size:16px;font-weight:700; }
+    .node-sub { fill:#4b5563;font-size:12px; }
+    .small { fill:#64748b;font-size:11px; }
+    .label { fill:#475569;font-size:11px;font-weight:600; }
+  </style>
+  <defs>
+    <marker id="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="orange" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0,10 3.5,0 7" fill="#ea580c"/></marker>
+    <marker id="green" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0,10 3.5,0 7" fill="#059669"/></marker>
+    <marker id="purple" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0,10 3.5,0 7" fill="#7c3aed"/></marker>
+    <marker id="gray" markerWidth="10" markerHeight="7" refX="9" refY="3.5" orient="auto"><polygon points="0 0,10 3.5,0 7" fill="#64748b"/></marker>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%"><feDropShadow dx="0" dy="2" stdDeviation="3" flood-color="#0f172a" flood-opacity=".10"/></filter>
+  </defs>
+
+  <rect width="1440" height="920" fill="#ffffff"/>
+  <text x="40" y="48" class="title">dingtalk-agent · 从一个 Agent 泛化到所有 Agent</text>
+  <text x="40" y="75" class="subtitle">触发端可替换，模型与沙箱可替换，岗位能力可叠加；不变的是定义、上下文、状态、闸门与效果证据。</text>
+
+  <rect x="30" y="100" width="1380" height="130" rx="12" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.2" stroke-dasharray="7 5"/>
+  <text x="48" y="124" class="lane">EXTERNAL INVOCATION · 触发不属于 dta</text>
+
+  <rect x="55" y="145" width="245" height="62" rx="9" fill="#fff7ed" stroke="#fdba74" stroke-width="1.6"/>
+  <text x="177" y="171" text-anchor="middle" class="node-title">任意触发 Adapter</text>
+  <text x="177" y="192" text-anchor="middle" class="node-sub">DM · @ · ambient · heartbeat · API</text>
+
+  <rect x="385" y="137" width="300" height="78" rx="10" fill="#eff6ff" stroke="#60a5fa" stroke-width="2" filter="url(#shadow)"/>
+  <text x="535" y="166" text-anchor="middle" class="node-title">Invocation Context</text>
+  <text x="535" y="189" text-anchor="middle" class="node-sub">mode · actor · target · conversation · sessionKey</text>
+  <text x="535" y="207" text-anchor="middle" class="small">无可信事件时默认 direct；外发仍 fail closed</text>
+
+  <rect x="770" y="137" width="590" height="78" rx="10" fill="#faf5ff" stroke="#c084fc" stroke-width="1.6"/>
+  <text x="1065" y="164" text-anchor="middle" class="node-title">同一内核的不同员工实例</text>
+  <text x="1065" y="190" text-anchor="middle" class="node-sub">FDE 教练　·　招聘助理　·　运维助手　·　项目经理　·　下一位 Agent</text>
+
+  <path d="M300 176 L385 176" fill="none" stroke="#ea580c" stroke-width="1.8" stroke-dasharray="6 4" marker-end="url(#orange)"/>
+  <rect x="314" y="153" width="57" height="20" rx="5" fill="#ffffff" opacity=".96"/><text x="342" y="168" text-anchor="middle" class="label">normalize</text>
+
+  <rect x="30" y="255" width="1380" height="165" rx="12" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1.2" stroke-dasharray="7 5"/>
+  <text x="48" y="280" class="lane">AGENT DEFINITION · 差异在这里叠加</text>
+
+  <rect x="55" y="305" width="345" height="86" rx="10" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.7" filter="url(#shadow)"/>
+  <text x="227" y="334" text-anchor="middle" class="node-title">Agent Definition</text>
+  <text x="227" y="357" text-anchor="middle" class="node-sub">身份 · 职责 · 服务对象 · 权限 · 存储绑定</text>
+  <text x="227" y="377" text-anchor="middle" class="small">一个可版本化、可审查、可冻结的员工合同</text>
+
+  <rect x="460" y="305" width="260" height="86" rx="10" fill="#f0fdfa" stroke="#5eead4" stroke-width="1.7"/>
+  <text x="590" y="334" text-anchor="middle" class="node-title">Basic Behavior Skill</text>
+  <text x="590" y="358" text-anchor="middle" class="node-sub">所有员工共享</text>
+  <text x="590" y="378" text-anchor="middle" class="small">响应资格 · 追问 · 静默 · 验证</text>
+
+  <rect x="780" y="305" width="260" height="86" rx="10" fill="#f0fdf4" stroke="#86efac" stroke-width="1.7"/>
+  <text x="910" y="334" text-anchor="middle" class="node-title">Role / Workflow Skills</text>
+  <text x="910" y="358" text-anchor="middle" class="node-sub">按岗位叠加</text>
+  <text x="910" y="378" text-anchor="middle" class="small">FDE · 招聘 · 周报 · 事故处理</text>
+
+  <rect x="1100" y="305" width="260" height="86" rx="10" fill="#faf5ff" stroke="#c084fc" stroke-width="1.7"/>
+  <text x="1230" y="334" text-anchor="middle" class="node-title">Agent Host / Sandbox</text>
+  <text x="1230" y="358" text-anchor="middle" class="node-sub">Claude Code · Codex · 其它 Runtime</text>
+  <text x="1230" y="378" text-anchor="middle" class="small">模型与执行体可替换</text>
+
+  <rect x="30" y="445" width="1160" height="315" rx="14" fill="#f8fafc" stroke="#0f766e" stroke-width="2"/>
+  <text x="50" y="473" fill="#0f766e" font-size="13" font-weight="700" letter-spacing=".08em">DINGTALK-AGENT KERNEL · Skill 劝，CLI 拦，本体与状态各归其位</text>
+
+  <rect x="60" y="500" width="420" height="205" rx="12" fill="#f0fdfa" stroke="#5eead4" stroke-width="1.4" stroke-dasharray="6 4"/>
+  <text x="78" y="525" fill="#0f766e" font-size="12" font-weight="700">贴心半闸门 · 让 Agent 看见完整现场</text>
+
+  <rect x="85" y="550" width="165" height="112" rx="9" fill="#ffffff" stroke="#5eead4" stroke-width="1.6"/>
+  <text x="167" y="580" text-anchor="middle" class="node-title">感知预处理</text>
+  <text x="167" y="604" text-anchor="middle" class="node-sub">引用 · 群上下文 · 附件</text>
+  <text x="167" y="625" text-anchor="middle" class="node-sub">身份解析 · 连发合并</text>
+  <text x="167" y="646" text-anchor="middle" class="small">统一 Enriched Event</text>
+
+  <rect x="290" y="550" width="165" height="112" rx="9" fill="#ffffff" stroke="#5eead4" stroke-width="1.6"/>
+  <text x="372" y="580" text-anchor="middle" class="node-title">行为策略</text>
+  <text x="372" y="604" text-anchor="middle" class="node-sub">中期回执 · 安静时段</text>
+  <text x="372" y="625" text-anchor="middle" class="node-sub">会议免打扰 · 收口快照</text>
+  <text x="372" y="646" text-anchor="middle" class="small">给 Skill 可判断的提示</text>
+
+  <rect x="510" y="500" width="650" height="205" rx="12" fill="#fff7ed" stroke="#fdba74" stroke-width="1.4" stroke-dasharray="6 4"/>
+  <text x="528" y="525" fill="#c2410c" font-size="12" font-weight="700">安全半闸门 · 必须成立的约束进入代码</text>
+
+  <rect x="535" y="550" width="170" height="112" rx="9" fill="#ffffff" stroke="#fdba74" stroke-width="1.6"/>
+  <text x="620" y="580" text-anchor="middle" class="node-title">Response Gate</text>
+  <text x="620" y="604" text-anchor="middle" class="node-sub">先判断能否响应</text>
+  <text x="620" y="625" text-anchor="middle" class="node-sub">@ · DM · ambient · scope</text>
+  <text x="620" y="646" text-anchor="middle" class="small">内容生成之前</text>
+
+  <rect x="745" y="540" width="180" height="132" rx="10" fill="#eff6ff" stroke="#60a5fa" stroke-width="1.8" filter="url(#shadow)"/>
+  <text x="835" y="574" text-anchor="middle" class="node-title">Session Runtime</text>
+  <text x="835" y="598" text-anchor="middle" class="node-sub">Session · Run · Wait</text>
+  <text x="835" y="619" text-anchor="middle" class="node-sub">Skill snapshot · budget</text>
+  <text x="835" y="640" text-anchor="middle" class="node-sub">checkpoint · resume</text>
+  <text x="835" y="660" text-anchor="middle" class="small">一件事跨多次唤醒</text>
+
+  <rect x="965" y="550" width="170" height="112" rx="9" fill="#ffffff" stroke="#f87171" stroke-width="1.8"/>
+  <text x="1050" y="580" text-anchor="middle" class="node-title">Action Gate</text>
+  <text x="1050" y="604" text-anchor="middle" class="node-sub">目标 · 身份 · 权限</text>
+  <text x="1050" y="625" text-anchor="middle" class="node-sub">幂等 · 回读 · Receipt</text>
+  <text x="1050" y="646" text-anchor="middle" class="small">副作用之前</text>
+
+  <path d="M535 215 L535 238 L42 238 L42 606 L85 606" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#blue)"/>
+  <path d="M250 606 L290 606" fill="none" stroke="#059669" stroke-width="1.8" marker-end="url(#green)"/>
+  <path d="M455 606 L535 606" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#blue)"/>
+  <path d="M705 606 L745 606" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#blue)"/>
+  <path d="M925 606 L965 606" fill="none" stroke="#2563eb" stroke-width="2" marker-end="url(#blue)"/>
+
+  <path d="M227 391 L227 430 L780 430 L780 540" fill="none" stroke="#7c3aed" stroke-width="1.7" marker-end="url(#purple)"/>
+  <path d="M590 391 L590 440 L810 440 L810 540" fill="none" stroke="#7c3aed" stroke-width="1.7" marker-end="url(#purple)"/>
+  <path d="M910 391 L910 440 L850 440 L850 540" fill="none" stroke="#7c3aed" stroke-width="1.7" marker-end="url(#purple)"/>
+  <path d="M1230 391 L1230 430 L895 430 L895 540" fill="none" stroke="#7c3aed" stroke-width="1.7" marker-end="url(#purple)"/>
+
+  <rect x="355" y="720" width="510" height="24" rx="6" fill="#ffffff" stroke="#d1d5db" stroke-width="1"/>
+  <text x="610" y="737" text-anchor="middle" class="small">三层语义记忆按需读取；Wait / 锁 / 幂等 / Receipt 进入独立控制状态</text>
+
+  <rect x="1230" y="520" width="160" height="92" rx="10" fill="#f0fdfa" stroke="#2dd4bf" stroke-width="2" filter="url(#shadow)"/>
+  <circle cx="1262" cy="550" r="18" fill="#1677ff"/><text x="1262" y="555" text-anchor="middle" fill="#ffffff" font-size="10" font-weight="700">DWS</text>
+  <text x="1310" y="551" text-anchor="middle" class="node-title">驱动层</text>
+  <text x="1310" y="579" text-anchor="middle" class="node-sub">标准产品能力</text>
+  <text x="1310" y="598" text-anchor="middle" class="small">CLI / 未来 SDK</text>
+
+  <rect x="1230" y="660" width="160" height="92" rx="10" fill="#eff6ff" stroke="#93c5fd" stroke-width="1.7"/>
+  <text x="1310" y="689" text-anchor="middle" class="node-title">钉钉产品</text>
+  <text x="1310" y="713" text-anchor="middle" class="node-sub">消息 · 文档 · 待办</text>
+  <text x="1310" y="734" text-anchor="middle" class="node-sub">日历 · 表格 · 审批</text>
+
+  <path d="M1135 606 L1185 606 L1185 566 L1230 566" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#blue)"/>
+  <path d="M1310 612 L1310 660" fill="none" stroke="#2563eb" stroke-width="2.2" marker-end="url(#blue)"/>
+  <path d="M1230 706 L1188 706 L1188 688 L1050 688 L1050 662" fill="none" stroke="#64748b" stroke-width="1.6" stroke-dasharray="5 4" marker-end="url(#gray)"/>
+  <rect x="1082" y="676" width="82" height="20" rx="5" fill="#ffffff" opacity=".96"/><text x="1123" y="691" text-anchor="middle" class="label">平台回读</text>
+
+  <rect x="30" y="790" width="1380" height="76" rx="10" fill="#f8fafc" stroke="#cbd5e1" stroke-width="1"/>
+  <text x="50" y="816" fill="#111827" font-size="13" font-weight="700">可叠加公式</text>
+  <text x="50" y="844" fill="#334155" font-size="15">Agent Host + dta Kernel + Agent Definition + Basic Behavior + Role Skills + DWS = 一个可工作的钉钉数字员工</text>
+  <text x="940" y="844" class="small">触发、模型、沙箱、岗位与存储 Provider 均可替换</text>
+
+  <line x1="40" y1="892" x2="76" y2="892" stroke="#2563eb" stroke-width="2" marker-end="url(#blue)"/><text x="84" y="896" class="small">主处理流</text>
+  <line x1="210" y1="892" x2="246" y2="892" stroke="#ea580c" stroke-width="1.8" stroke-dasharray="6 4" marker-end="url(#orange)"/><text x="254" y="896" class="small">外部触发</text>
+  <line x1="370" y1="892" x2="406" y2="892" stroke="#059669" stroke-width="1.8" marker-end="url(#green)"/><text x="414" y="896" class="small">感知补齐</text>
+  <line x1="530" y1="892" x2="566" y2="892" stroke="#7c3aed" stroke-width="1.8" marker-end="url(#purple)"/><text x="574" y="896" class="small">定义 / Skill 注入</text>
+  <line x1="735" y1="892" x2="771" y2="892" stroke="#64748b" stroke-width="1.6" stroke-dasharray="5 4" marker-end="url(#gray)"/><text x="779" y="896" class="small">回读 / 控制反馈</text>
+</svg>

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/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}$" }
+  }
+}