Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/dingtalk-skills/dws
dws
Unverified【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/智能合同/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/HTML文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。
references/products/whiteboard/diff.md
View on GitHub# 白板写入前 Diff 预览
Agent 对已有白板追加、修改、删除或清空内容时必读本页,不能因用户未要求预览而跳过。
`+diff` 是 CLI-only 只读 Shortcut:它读取一个完整页面,在本地比较 proposed
OpenNodes source,不调用任何白板写 Tool。
## 必经闭环
更新只设一个用户确认点:先完成所需的 render 和必需的 +diff,再把视觉预览(如有)、差异与覆盖影响一起展示并一次确认;不要在 render 后先索要确认、获准后才补做 diff 再次询问。同一目标、revision、source 和模式已获确认后,直接提交;只有这些内容变化或出现未披露的实质风险才重新确认。
准备 source 后执行 +diff,展示实际变化和全部风险提示,然后停止等待用户明确确认
当前差异。确认后才执行 +update 并添加 --yes。最初的更新请求、render、dry-run
及写后读回不能替代此确认;不得换原子 update 绕过。目标、revision、source 或模式
变化须重新 diff 和确认。diff 失败或有 blocker 时停止,不提交。
下面的 diff 与 update 示例分属确认前后两个阶段,不得连续自动执行。独立白板
使用 diff 的 target.revision 和 sourceDigest;内嵌白板只绑定 sourceDigest,
并披露非原子限制。CLI 参数仍保留脚本兼容性,这里要求的是 Agent 工作流。
独立白板:
```bash
dws whiteboard +diff --node <WHITEBOARD_NODE_ID> --page-id <PAGE_ID> \
--source @whiteboard.json --identity-map @identity-map.json --format json
dws whiteboard +update --node <WHITEBOARD_NODE_ID> --page-id <PAGE_ID> \
--expected-revision <DIFF_TARGET_REVISION> \
--expected-source-digest <DIFF_SOURCE_DIGEST> \
--request-id <STABLE_REQUEST_ID> --source @whiteboard.json --format json
```
内嵌白板:
```bash
dws whiteboard +diff --node <DOC_ID> --part-id <PART_ID> \
--source @whiteboard.json --identity-map @identity-map.json --format json
```
内嵌 diff 固定返回 `embedded_preview_not_atomic` warning:当前没有公开 revision
条件写,必须向用户披露预览至写入间可能漂移。`sourceDigest` 只保证本地 source
未变化,`snapshotDigest` 只用于本次快照审计,都不构成远端原子保证。
## 解释结果
- `executionDiff` 是现有 Tool 的真实语义:append 全部新增并保留旧节点;overwrite
删除 page-owned 旧节点并重建 proposed 节点,母版只计入 `preservedCount`。
- `logicalDiff.modified` 只有在 `--identity-map` 明确把 proposed 逻辑 ID 绑定到当前
真实 ID 时才发布。没有映射时返回 `unmatched`,不得猜测修改。
- `logicalDiff.unchangedCount` 和 `executionDiff.preservedCount` 只返回计数。
- `blockerSummary`、`warningSummary` 和全部 summary 计数不受明细预算影响。存在
blocker 时不得继续 update,即使对应逐节点明细被裁剪。
- `--detail-limit` 默认 100,范围 1..1000,是全局明细预算;business data 另有
2 MiB 硬上限。`detailsTruncated=true` 时查看 `detailCounts` 和
`truncationReasons`,不得把未返回明细理解为没有变化。
- 独立 Query 仅返回 `resultDownloadUrl` 时,首版以
`snapshot_download_required` 失败关闭,不返回部分 diff,也不得继续 update。
Identity map 格式:
```json
{
"version": 1,
"target": {"nodeId": "WHITEBOARD_NODE_ID", "pageId": "PAGE_ID", "revision": 12},
"nodes": {"title": "real-node-101", "body": "real-node-102"}
}
```
内嵌目标改为 `{"nodeId":"DOC_ID","partId":"PART_ID"}`。映射必须是一一对应,
真实 ID 必须仍存在。revision 过期会告警并重新校验身份;目标不一致或真实 ID 已消失
会失败。不要把 Query 真实 ID 直接填进 proposed source 冒充局部 patch。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |