Skip to content

Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/dingtalk-skills/dws

【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/智能合同/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/HTML文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。

FileKindSize
LICENSEother9.9 KB
NOTICEother666 B
SKILL.mdskill md38.4 KB
references/best_practices/01-messaging.mdmarkdown3.2 KB
references/best_practices/02-task.mdmarkdown2.8 KB
references/best_practices/03-meeting.mdmarkdown11.6 KB
references/best_practices/04-document.mdmarkdown11.0 KB
references/best_practices/05-reporting.mdmarkdown6.2 KB
references/best_practices/06-data-analytics.mdmarkdown5.4 KB
references/best_practices/07-minutes.mdmarkdown8.3 KB
references/best_practices/08-directory.mdmarkdown8.0 KB
references/best_practices/09-mail.mdmarkdown5.2 KB
references/best_practices/10-minutes-speaker-match.mdmarkdown9.0 KB
references/best_practices/11-minutes-speaker-correct.mdmarkdown4.4 KB
references/best_practices/_common/conventions.mdmarkdown3.4 KB
references/best_practices/_common/recipe-conventions.mdmarkdown1.8 KB
references/best_practices/lite-recipes.mdmarkdown15.7 KB
references/capability-limits.mdmarkdown2.9 KB
references/error-codes.mdmarkdown4.0 KB
references/field-rules.mdmarkdown5.4 KB
references/global-reference.mdmarkdown5.1 KB
references/intent-guide.mdmarkdown47.8 KB
references/products/agoal.mdmarkdown12.1 KB
references/products/aisearch.mdmarkdown14.1 KB
references/products/aitable-record-ops.mdmarkdown4.8 KB
references/products/aitable.mdmarkdown30.1 KB
references/products/aitable/aitable-advperm.mdmarkdown10.2 KB
references/products/aitable/aitable-api-key.mdmarkdown1.7 KB
references/products/aitable/aitable-attachment.mdmarkdown3.5 KB
references/products/aitable/aitable-best-practices.mdmarkdown3.5 KB
references/products/aitable/aitable-cell-value.mdmarkdown9.1 KB
references/products/aitable/aitable-comment.mdmarkdown2.8 KB
references/products/aitable/aitable-dashboard-chart.mdmarkdown4.5 KB
references/products/aitable/aitable-data-analysis-sop.mdmarkdown5.6 KB
references/products/aitable/aitable-error-recovery.mdmarkdown6.9 KB
references/products/aitable/aitable-export-import.mdmarkdown9.8 KB
references/products/aitable/aitable-field-properties.mdmarkdown8.5 KB
references/products/aitable/aitable-field.mdmarkdown6.6 KB
references/products/aitable/aitable-filter-sort.mdmarkdown12.4 KB
references/products/aitable/aitable-form.mdmarkdown15.1 KB
references/products/aitable/aitable-formula-guide.mdmarkdown8.2 KB
references/products/aitable/aitable-primary-doc.mdmarkdown2.3 KB
references/products/aitable/aitable-psql.mdmarkdown14.7 KB
references/products/aitable/aitable-record-create.mdmarkdown2.2 KB
references/products/aitable/aitable-record-delete.mdmarkdown582 B
references/products/aitable/aitable-record-history.mdmarkdown4.0 KB
references/products/aitable/aitable-record-name-key.mdmarkdown2.4 KB
references/products/aitable/aitable-record-query.mdmarkdown15.0 KB
references/products/aitable/aitable-record-share.mdmarkdown1.6 KB
references/products/aitable/aitable-record-stats.mdmarkdown3.8 KB
references/products/aitable/aitable-record-update.mdmarkdown3.2 KB
references/products/aitable/aitable-record-upsert.mdmarkdown3.3 KB
references/products/aitable/aitable-view-config.mdmarkdown11.8 KB
references/products/aitable/aitable-view-extras.mdmarkdown8.0 KB
references/products/aitable/aitable-workflow.mdmarkdown14.4 KB
references/products/attendance-report.mdmarkdown29.9 KB
references/products/attendance-schedule.mdmarkdown27.5 KB
references/products/attendance-vacation.mdmarkdown9.4 KB
references/products/attendance.mdmarkdown102.0 KB
references/products/calendar.mdmarkdown50.3 KB
references/products/chat-emoji-list.mdmarkdown8.4 KB
references/products/chat.mdmarkdown158.3 KB
references/products/chat/a2ui.mdmarkdown4.2 KB
references/products/contact.mdmarkdown30.5 KB
references/products/contract.mdmarkdown15.2 KB
references/products/dev.mdmarkdown14.7 KB
references/products/devdoc.mdmarkdown1.8 KB
references/products/ding.mdmarkdown9.9 KB
references/products/dingtalk-tag/capability.mdmarkdown5.7 KB
references/products/dingtalk-tag/dingtalk-tag-index.mdmarkdown3.9 KB
references/products/dingtalk-tag/manage-and-connect.mdmarkdown8.2 KB
references/products/dingtalk-tag/manage.mdmarkdown9.7 KB
references/products/dingtalk-tag/run.mdmarkdown5.4 KB
references/products/doc.mdmarkdown65.2 KB
references/products/doc/doc-block.mdmarkdown14.6 KB
references/products/doc/doc-comment.mdmarkdown9.9 KB
references/products/doc/doc-create.mdmarkdown6.6 KB
references/products/doc/doc-export.mdmarkdown3.5 KB
references/products/doc/doc-file-ops.mdmarkdown9.4 KB
references/products/doc/doc-import.mdmarkdown2.8 KB
references/products/doc/doc-info.mdmarkdown9.9 KB
references/products/doc/doc-list.mdmarkdown1.3 KB
references/products/doc/doc-media.mdmarkdown4.7 KB
references/products/doc/doc-permission.mdmarkdown4.9 KB
references/products/doc/doc-read.mdmarkdown8.5 KB
references/products/doc/doc-search.mdmarkdown1.4 KB
references/products/doc/doc-update.mdmarkdown15.5 KB
references/products/doc/doc-whiteboard.mdmarkdown3.9 KB
references/products/doc/format/doc-jsonml-cookbook.mdmarkdown25.0 KB
references/products/doc/format/doc-jsonml-schema.jsonconfig16.5 KB
references/products/doc/format/doc-jsonml-schema.mdmarkdown29.1 KB
references/products/doc/style/doc-create-workflow.mdmarkdown23.1 KB
references/products/doc/style/doc-style-guideline.mdmarkdown21.1 KB
references/products/doc/style/doc-update-workflow.mdmarkdown16.4 KB
references/products/drive.mdmarkdown65.4 KB
references/products/drive/drive-export.mdmarkdown2.6 KB
references/products/drive/drive-storage.mdmarkdown2.1 KB
references/products/drive/drive-task.mdmarkdown2.4 KB
references/products/event.mdmarkdown29.7 KB
references/products/hrbrain.mdmarkdown7.5 KB
references/products/html.mdmarkdown6.4 KB
references/products/mail.mdmarkdown88.1 KB
references/products/markdown.mdmarkdown11.4 KB
references/products/minutes.mdmarkdown173.8 KB
references/products/oa-template-write.mdmarkdown8.1 KB
references/products/oa.mdmarkdown61.7 KB
references/products/oa/oa-form-components.mdmarkdown33.7 KB
references/products/oa/oa-goout.mdmarkdown7.5 KB
references/products/oa/oa-leave.mdmarkdown7.2 KB
references/products/oa/oa-overtime.mdmarkdown10.1 KB
references/products/oa/oa-process-nodes.mdmarkdown11.6 KB
references/products/oa/oa-supply.mdmarkdown6.2 KB
references/products/oa/template/components/AddressField.mdmarkdown718 B
references/products/oa/template/components/CalculateField.mdmarkdown2.0 KB
references/products/oa/template/components/CascadeField.mdmarkdown1.1 KB
references/products/oa/template/components/ColumnLayout.mdmarkdown746 B
references/products/oa/template/components/DDAttachment.mdmarkdown586 B
references/products/oa/template/components/DDDateField.mdmarkdown857 B
references/products/oa/template/components/DDDateRangeField.mdmarkdown1.6 KB
references/products/oa/template/components/DDMultiSelectField.mdmarkdown1.3 KB
references/products/oa/template/components/DDPhotoField.mdmarkdown699 B
references/products/oa/template/components/DDSelectField.mdmarkdown1.2 KB
references/products/oa/template/components/DepartmentField.mdmarkdown789 B
references/products/oa/template/components/ExternalContactField.mdmarkdown751 B
references/products/oa/template/components/FormRelateField.mdmarkdown2.1 KB
references/products/oa/template/components/IdCardField.mdmarkdown709 B
references/products/oa/template/components/InnerContactField.mdmarkdown819 B
references/products/oa/template/components/InvoiceField.mdmarkdown1.1 KB
references/products/oa/template/components/MoneyField.mdmarkdown811 B
references/products/oa/template/components/NumberField.mdmarkdown807 B
references/products/oa/template/components/OcrIdCardField.mdmarkdown1.7 KB
references/products/oa/template/components/OcrTextField.mdmarkdown900 B
references/products/oa/template/components/PhoneField.mdmarkdown760 B
references/products/oa/template/components/RecipientAccountField.mdmarkdown746 B
references/products/oa/template/components/RelateField.mdmarkdown804 B
references/products/oa/template/components/SeqNumberField.mdmarkdown1.1 KB
references/products/oa/template/components/SignatureField.mdmarkdown722 B
references/products/oa/template/components/StarRatingField.mdmarkdown774 B
references/products/oa/template/components/TableField.mdmarkdown1.2 KB
references/products/oa/template/components/TextField.mdmarkdown775 B
references/products/oa/template/components/TextNote.mdmarkdown675 B
references/products/oa/template/components/TextareaField.mdmarkdown754 B
references/products/oa/template/components/TimeAndLocationField.mdmarkdown719 B
references/products/oa/template/example/form_components.jsonconfig7.3 KB
references/products/oa/template/example/process_config.jsonconfig22.7 KB
references/products/oa/template/form-components.mdmarkdown11.5 KB
references/products/oa/template/nodes/approver.mdmarkdown3.7 KB
references/products/oa/template/nodes/cc.mdmarkdown2.6 KB
references/products/oa/template/nodes/condition.mdmarkdown10.8 KB
references/products/oa/template/nodes/handler.mdmarkdown2.4 KB
references/products/oa/template/nodes/originator.mdmarkdown941 B
references/products/oa/template/nodes/parallel.mdmarkdown2.7 KB
references/products/oa/template/nodes/payer.mdmarkdown1.6 KB
references/products/oa/template/process-nodes.mdmarkdown8.8 KB
references/products/oa/template/rules/target_approval.mdmarkdown3.3 KB
references/products/oa/template/rules/target_connect_approval.mdmarkdown3.2 KB
references/products/oa/template/rules/target_formcomponent_approval.mdmarkdown1.2 KB
references/products/oa/template/rules/target_formula_managerOfDept.mdmarkdown1.5 KB
references/products/oa/template/rules/target_formula_reportLineManager.mdmarkdown1.5 KB
references/products/oa/template/rules/target_label.mdmarkdown3.9 KB
references/products/oa/template/rules/target_management.mdmarkdown1.3 KB
references/products/oa/template/rules/target_managers_labels.mdmarkdown1.3 KB
references/products/oa/template/rules/target_matrix_approval.mdmarkdown2.4 KB
references/products/oa/template/rules/target_originator.mdmarkdown698 B
references/products/oa/template/rules/target_select.mdmarkdown1.6 KB
references/products/openapi-explorer.mdmarkdown3.9 KB
references/products/pat.mdmarkdown1.8 KB
references/products/report.mdmarkdown29.9 KB
references/products/sheet.mdmarkdown16.2 KB
references/products/sheet/sheet-batch-operations.mdmarkdown7.7 KB
references/products/sheet/sheet-chart.mdmarkdown3.9 KB
references/products/sheet/sheet-comment.mdmarkdown7.9 KB
references/products/sheet/sheet-conditional-format.mdmarkdown4.5 KB
references/products/sheet/sheet-dimension-operations.mdmarkdown3.7 KB
references/products/sheet/sheet-dropdown.mdmarkdown6.7 KB
references/products/sheet/sheet-export.mdmarkdown8.6 KB
references/products/sheet/sheet-filter-view.mdmarkdown3.7 KB
references/products/sheet/sheet-filter.mdmarkdown10.0 KB
references/products/sheet/sheet-formula.mdmarkdown10.0 KB
references/products/sheet/sheet-import.mdmarkdown2.6 KB
references/products/sheet/sheet-media-image.mdmarkdown13.9 KB
references/products/sheet/sheet-pivot-table.mdmarkdown12.6 KB
references/products/sheet/sheet-range-operations.mdmarkdown8.7 KB
references/products/sheet/sheet-read-data.mdmarkdown4.0 KB
references/products/sheet/sheet-revision-changeset.mdmarkdown3.2 KB
references/products/sheet/sheet-search-replace.mdmarkdown6.3 KB
references/products/sheet/sheet-style-format.mdmarkdown4.5 KB
references/products/sheet/sheet-version.mdmarkdown5.0 KB
references/products/sheet/sheet-workbook.mdmarkdown4.3 KB
references/products/sheet/sheet-write-data.mdmarkdown7.8 KB
references/products/simple.mdmarkdown2.6 KB
references/products/todo.mdmarkdown21.0 KB
references/products/whiteboard.mdmarkdown19.7 KB
references/products/whiteboard/compose.mdmarkdown5.7 KB
references/products/whiteboard/diff.mdmarkdown3.7 KB
references/products/whiteboard/open-nodes-v1.mdmarkdown4.0 KB
references/products/whiteboard/open-nodes-v1/01-overview.mdmarkdown3.3 KB
references/products/whiteboard/open-nodes-v1/02-query.mdmarkdown7.3 KB
references/products/whiteboard/open-nodes-v1/03-update.mdmarkdown8.6 KB
references/products/whiteboard/open-nodes-v1/04-text-style.mdmarkdown11.8 KB

references/products/whiteboard.md

View on GitHub
# 钉钉白板内容操作

本页覆盖两个相互独立的目标,不能互相推断、转换或回退:

- 独立白板是 `.adraw` 白板文件,使用白板自身 `nodeId`,不存在文档 `partId`。
- 文档内嵌白板是文档中的一个 part。只有已知承载文档 `nodeId` 和非空 `partId` 后,
  才使用 `whiteboard query/+diff/+update` 读写该 part 的图形内容;卡片容器的插入、
  定位、删除始终属于 Doc。

CLI 未提供 `--part-id` 时会寻址独立白板,但 Agent 必须先确认用户目标本来就是独立
白板。文档内嵌目标缺少 `partId` 属于身份不完整,必须停止并补齐,不能因此改成独立
白板。接口失败后也不得切换目标类型。已知命令直接执行;仅真实 `unknown command` /
`unknown flag` 时读一次 leaf Help,契约不确定时读一次 compact leaf Schema。

根据本次操作只读取以下一份操作 Reference,不预加载完整协议或多个示例集:

- Shape、Connector、Frame、样式、Icon 或 Path:
  [compose.md](./whiteboard/compose.md)
- 已上传或本地 SVG/Vector 资源:[vector.md](./whiteboard/vector.md)
- 整页替换或清空:[replace.md](./whiteboard/replace.md)
- 写入前预览节点、媒体和删除风险:[diff.md](./whiteboard/diff.md)
- 创建前把 OpenNodes 本地预渲染为 SVG:[render.md](./whiteboard/render.md)

读取已有白板或普通定位不需要额外 Reference。每个普通任务最多读取一份操作
Reference;只有操作页仍缺少具体字段时,才读取一份精确协议章节。

## Agent 带内容创建:先预览,再确认

用户要求新建日历、课表、流程图等需要 Agent 编排 OpenNodes 的白板时,
预渲染是默认必经步骤,不以用户是否提到“预览”为条件:

1. 准备 OpenNodes source,再执行 `dws whiteboard render`。进入此阶段必读
   [render.md](./whiteboard/render.md);即使此前读过 compose 等操作页,也不能因
   Reference 数量预算省略预览步骤。
2. 展示实际 SVG、近似渲染提示、fidelity 和全部 warnings,然后停止,等待用户
   明确确认当前版本。不能在首次创建请求的同一轮直接提交;Agent 自检、摘要匹配、
   dry-run 或创建后内容回读都不能代替用户看过预览后的确认。
3. 修改 source 后重新渲染、展示并再次确认。确认后使用同一 source 和
   `sourceDigest` 调用 `create-with-content --expected-source-digest`,
   此时才可添加 `--yes`,并按原有结果契约做写后验证。
4. render 不可用、渲染失败或无法向用户展示预览时,报告阻塞并保留草稿,
   不自动降级为直接创建或换写入入口绕过。

此规则限定 Agent 使用 OpenNodes 带内容创建;不新增 CLI 运行时强制拦截,
不改变 MCP 入参回参。空白创建、直接套用模板、已有白板更新仍遵循各自流程。

## Agent 更新:先 diff,再确认

更新只设一个用户确认点:先完成所需的 render 和必需的 +diff,再把视觉预览(如有)、差异与覆盖影响一起展示并一次确认;不要在 render 后先索要确认、获准后才补做 diff 再次询问。同一目标、revision、source 和模式已获确认后,直接提交;只有这些内容变化或出现未披露的实质风险才重新确认。

对已有白板追加、修改、删除或清空内容,必须在提交前执行 `+diff`:
先读取所需当前内容并准备 source,再按 [diff.md](./whiteboard/diff.md) 比较同一目标。
即使已读 compose、replace 等操作页,也必须读取 diff 指引;文档数量预算不能省略此步骤。

展示新增、修改、删除、媒体变化、warnings、blockers 和 overwrite 的实际影响,
然后停止,等待用户明确确认当前差异。最初的“删除这些内容”等请求、render、
dry-run、Agent 自检和写后回读都不替代差异确认。

确认后只提交同一目标和 source,将 `sourceDigest` 传给
`+update --expected-source-digest`;独立白板另传 diff 的 `target.revision`。
目标、revision、source 或写入模式变化时重新 diff、展示和确认。
diff 不可用、失败或存在 blocker 时停止,不换原子 update 绕过。
内嵌预览是尽力而为,须披露预览与提交间可能漂移,不承诺原子保证。

删除部分内容若需 overwrite,完整终态必须保留其余内容,并说明旧节点删除重建影响。
此规则是 Agent 工作流要求,不新增 CLI 强制拦截、不改变 MCP 接口。

## 执行契约

- 同一 profile,目标须有真实身份:独立白板使用 `nodeId`;内嵌白板使用承载文档
  `nodeId + whiteboardId/partId`。零/多目标、身份不明或 profile 不一致时停止,
  不能取第一个候选。
- 独立白板命令不传 `--part-id`;文档内嵌白板内容命令必须传真实非空 `--part-id`。
  Agent 先按用户目标确定类型,再构造参数;缺少身份、空值、权限、网络、Feature
  Switch 或 revision 冲突均须停止,不得切换或回退到另一目标。
- Runtime 确认后执行层才添加 `--yes`;存储示例不得预置确认。
- Agent 更新前必须执行 `+diff` 并等待差异确认。独立白板把 diff 返回的 `target.revision` 传给
  `+update --expected-revision`,两类白板都把 `sourceDigest` 传给
  `+update --expected-source-digest`;任一值或 source 变化都重新 diff 和确认。
- 成功须同时满足终态 receipt、请求节点映射和同板读回;`verified=false`、partial、
  commit-unknown 不得报成功或盲重试。
- `+update` 内部仍使用完整同板 query 校验:内嵌分支调用
  `read_whiteboard_content`,独立分支调用 `get_whiteboard_detail(view=page)`;成功结果只返回稳定目标、mode、验证节点
  数、summary 和精简 receipt,不返回 `source.pages[].nodes` 完整快照。用户明确要求
  更新后完整快照时,再执行一次 `+query`;否则不得为补输出重复查询。
- append 和 overwrite 的 `verified=true` 均包含独立读回证据,不再追加 query;
  额外 query 仅用于用户要求完整快照,或未验证/提交状态不明时的有界只读对账。

## 调用与上下文预算

- 每个已经明确的目标只建立一份 `{nodeId, partId(仅内嵌目标), payloadFile}` 上下文;
  禁止重复查询或搜索,且不得通过另一目标类型补全身份。
- 每阶段最多一次 update;提交前校验错误只修相关字段一次。相同 Payload、
  `--verbose` 或 commit-unknown 不重放;commit-unknown 按同一稳定目标 query 对账。
- 先用单次响应完整校验,再无损投影;ID、mode、verified、节点摘要和链接只是最小
  集合,用户要求及后续操作依赖的几何、样式、文本、关系必须保留。
- `get_whiteboard_detail` 的 `resultJson` 是 JSON 字符串,解析后的对象就是 OpenNodes
  `source`。原子 `whiteboard query --view all/page` 保留已解码的 `resultJson` 并提供
  等价的顶层 `source`;严格 `+query` 使用统一结果 envelope,路径是 `data.source`。页面 ID 必须从
  `source.pages[].id` 取得,不能因为读取错了 envelope 层级就猜测或硬编码 pageId。
- 投影只减少重复上下文,不删除业务信息:query/export/audit 需要完整快照时原样
  交付;写入 `source` 保留在 Payload 文件中,不得因丢字段而重发远端请求。

## 稳定 ID

| ID | 来源 | 用途 |
|---|---|---|
| `nodeId`(独立目标) | 独立白板文件创建或定位结果 | 独立 `.adraw` 白板文件自身 ID |
| `nodeId`(内嵌目标) | 已知的承载文档身份 | 承载该白板 part 的文档 ID |
| `partId`(仅内嵌目标) | 已知的文档 part 身份 | 白板内容命令的 `--part-id`;不能用于独立白板文件 |
| 请求节点 `id` | 本地 OpenNodes 文件 | 同一请求的 parent/connector 引用 |
| 真实节点 ID | `+query` / `+update` 读回 | 读回身份;不能直接做局部 update |

<!-- VISIBLE_SHORTCUTS_START -->
## Shortcuts(无专用脚本/recipe 时优先)

以下 shortcut 同时进入公开 catalog 与 Runtime Schema。按本 skill/recipe 路由,命中时 Shortcut 优先于原子命令。参数只查 `dws schema --cli-path "whiteboard +<shortcut>" --compact --jq '{cli_path,parameters,constraints,confirmation}' -f json`;仅需且已发布 `result` 时查 `--jq '{cli_path,outcomes:.result.outcomes,pagination}'`,字段级再查 `data_schema`;缺失不以 Help/样例推断。Schema 不可用才读一次已知 leaf Help;`unknown flag` 用同 leaf Help 修正一次。`unknown command` 禁 Help:错误 suggestion → 已加载 Skill/reference 明确入口;均无则报漂移。禁全 Catalog/root/parent/product Help;仅映射、接口或 provenance 审计省略 `--compact`。现有路由和 reference 均无法定位低频能力时,才用 `dws shortcut list --service whiteboard --format json` 发现。

| Shortcut | 风险 | 适用场景 |
|---|---|---|
| `dws whiteboard +diff` | read | 读取当前白板并预览 proposed OpenNodes 更新的节点、媒体与风险变化 |
| `dws whiteboard +query` | read | 严格读取文档内嵌或独立白板的 OpenNodes 快照 |
| `dws whiteboard +update` | high-risk-write | 确认后更新文档内嵌或独立白板并精确读回 |
<!-- VISIBLE_SHORTCUTS_END -->

## 定位与调用

文档内嵌白板和独立白板文件分别寻址。以下两组命令只展示各自已经明确的目标,
不能把其中一组当作另一组的创建、发现或失败回退流程。

### 文档内嵌白板 part 的图形内容

必须已经取得承载文档 `nodeId` 和该 part 的 `partId`。文档中白板卡片容器的插入、
定位和删除由 `dingtalk-doc` 处理,不在本 Reference 中编排。

```bash
# 对身份已知的内嵌白板 part 读取与更新图形内容
dws whiteboard +query --node <DOC_ID> --part-id <PART_ID> --format json
dws whiteboard +diff --node <DOC_ID> --part-id <PART_ID> \
  --source @whiteboard.json --format json
dws whiteboard +update --node <DOC_ID> --part-id <PART_ID> \
  --expected-source-digest <DIFF_SOURCE_DIGEST> \
  --source @whiteboard.json --format json
```

### 独立白板文件

这里的 `nodeId` 是独立 `.adraw` 白板文件自身的 ID;该目标不属于任何文档 part。

```bash
# 读取与更新已经明确的独立白板文件
dws whiteboard +query --node <WHITEBOARD_NODE_ID> --view all --format json
dws whiteboard +diff --node <WHITEBOARD_NODE_ID> --page-id <PAGE_ID> \
  --source @whiteboard.json --format json
dws whiteboard +update --node <WHITEBOARD_NODE_ID> \
  --expected-revision <REVISION> --request-id <STABLE_REQUEST_ID> \
  --expected-source-digest <DIFF_SOURCE_DIGEST> \
  --source @whiteboard.json --format json

# 使用 OpenNodes V1 初始内容创建独立白板
dws whiteboard render --source @whiteboard.json \
  --output ./whiteboard-preview.svg --format json
dws whiteboard create-with-content --name "<白板名称>" \
  --source ./whiteboard.json --request-id <STABLE_REQUEST_ID> \
  --expected-source-digest <RENDER_SOURCE_DIGEST> --format json

# 个人模板:保存、查询、从模板创建
dws whiteboard template personal save --node <WHITEBOARD_NODE_ID> \
  --name "<模板名称>" --request-id <STABLE_REQUEST_ID> --format json
dws whiteboard template personal list --query "<关键词>" --limit 20 --format json
dws whiteboard template personal create --template-id <TEMPLATE_ID> \
  --name "<新白板名称>" --request-id <STABLE_REQUEST_ID> --format json

# 团队模板:保存可用 --template-workspace 指定目标,未传默认源白板所属知识库;需源白板及目标知识库编辑权限。查询和创建必须显式指定模板 Workspace
dws whiteboard template team save --node <WHITEBOARD_NODE_ID> \
  --name "<模板名称>" --request-id <STABLE_REQUEST_ID> --format json
dws whiteboard template team list --template-workspace <TEAM_WORKSPACE_ID> \
  --query "<关键词>" --limit 20 --format json
dws whiteboard template team create --template-workspace <TEAM_WORKSPACE_ID> \
  --template-id <TEMPLATE_ID> --name "<新白板名称>" \
  --request-id <STABLE_REQUEST_ID> --format json

# 公共模板:仅支持查询和从模板创建,不支持保存
dws whiteboard template public list --query "<关键词>" --limit 20 --format json
dws whiteboard template public create --template-id <TEMPLATE_ID> \
  --name "<新白板名称>" --request-id <STABLE_REQUEST_ID> --format json

# 导出独立白板;--output 是目录,文件名自动使用白板名称
dws whiteboard export --node <WHITEBOARD_NODE_ID> \
  --export-format png --output ./exports --format json

# 轮询中断后用已有 jobId 恢复查询和下载
dws whiteboard export-get --job-id <JOB_ID> \
  --export-format png --output ./exports --format json
```

模板能力只接受独立 `.adraw` 白板,服务端类型固定为 `DRAW(9)`。个人、团队和公共模板是
严格隔离的 scope:个人请求不携带 orgId,团队模板不得跨 `template-workspace` 查询或
创建,公共模板固定从模板中心公共库查询;找不到模板时不能自动回退到另一 scope。保存模板需要用户确认,执行
前可用全局 `--dry-run` 做远端只读预检。模板名称允许重复,网络重试必须复用原
`request-id`;若服务端返回 commit-unknown,禁止换新 request-id 盲目重试。

模板 scope 按模板来源选择,不能按新白板的保存位置推断:

| 用户意图或已有证据 | 命中 scope | 选择规则 |
|---|---|---|
| “我的模板”“个人模板”“我保存的模板” | `personal` | 查询使用 personal list;创建必须使用来自 personal list 或已明确为个人模板的 templateId |
| “团队模板”“知识库模板”“团队共享模板” | `team` | 查询和创建都必须确定模板所属 `template-workspace`;创建沿用查询模板时的同一个 Workspace |
| “模板中心”“公共模板”“官方/推荐模板” | `public` | 公共模板来自模板中心,仅支持查询和创建,不支持保存 |
| 只说“找一个白板模板”,没有个人或团队来源限定 | `public` | 按模板发现诉求查询模板中心公共库 |
| 只说“保存为白板模板”,没有团队共享要求 | `personal` | 默认保存为个人模板;明确要求团队共享时才使用 team save |
| 只有一个来源不明的 templateId | 暂不调用 create | templateId 本身不能判断 scope,先确认它来自 personal/team/public;不得逐个 scope 试探 |

把白板创建到某个知识库只决定 `--workspace`,不会让个人或公共模板变成团队模板。反过来,
团队模板也可以把新白板创建到“我的文档”或普通文件夹;`--template-workspace` 表示模板来源,
`--workspace` / `--folder` 表示新白板去向,两者不能混用。

导出下载仅接受 HTTPS/443 公网地址,每次重定向及实际连接都会校验目标地址;最大文件大小为 512 MiB,超限下载会清理临时文件。

导出支持 `--dry-run`,只预览请求,不轮询或写文件。`--output` 必须是目录;同名文件已存在时不会覆盖,请改用其他目录或先处理已有文件。下载内容会在临时文件中检查 PNG/PDF 文件头,通过后再落到最终路径;无效下载不会占用目标文件名。恢复 PDF 任务时须传 `--export-format pdf`;任务后续出错时会保留 jobId,并给出包含格式及目录的恢复命令(POSIX shell)。

`create-with-content --source` 本质是 OpenNodes JSON String 参数。较短内容可直接传
`'{"schemaVersion":"1.0","catalogVersion":"dml-v1","nodes":[...]}'`;内容较长时可传
本地文件路径。文件既可直接保存 OpenNodes,也可使用 `{"source":{...}}` 包装结构。
创建时 `source.nodes` 允许 `[]`,表示创建空白独立白板;字段仍必填,不接受 null。
这不改变更新规则:append 仍要求至少一个节点。普通空白创建仍优先使用文档创建能力。
CLI 校验后只向 `create_whiteboard` 发送 `source` JSON 字符串,不接受或暴露 checkpoint。

创建前视觉确认使用纯本地 `whiteboard render`。它不访问网络、不创建白板,只写入
SVG artifact,并返回规范化 `sourceDigest`、`fidelity` 和逐节点 warnings。Agent 必须
展示 SVG、“近似预览”提示和 warnings 后停止执行,等待用户明确确认当前版本,不能在同一轮自动创建。最初的创建请求、Agent 自检和摘要匹配都不代表看过预览后的确认。用户要求修改时重新渲染、展示并再次等待确认;只有确认后才可添加 --yes,并把同一摘要传给
`create-with-content --expected-source-digest`。摘要不一致时停止创建并重新渲染,不能
绕过。图片、Vector 和未知节点使用占位框,不会在预览阶段拉取外链资源。

`render`、`+diff` 和 `+update` 的 `--source` 接受 JSON、`@relative-file.json` 或 stdin;这些命令的本地文件必须加 `@`,裸路径会被当作 JSON。`create-with-content` 使用 JSON 或裸文件路径,不接受 `@文件` 或 stdin,不能套用 shortcut 的写法。白板 shortcut 不支持 `--jq` / `--fields`。

## 坐标读回与稳定结构

坐标读回采用统一数值语义:整数、浮点数和 JSON Number 等价,并允许最多 0.5 像素
的服务端规范化偏差。超过容差返回 `readback_field_mismatch`,不能声明成功:

1. **已提交**:已有成功回执或已读到真实节点时,停止重提并只读对账。
   append 会创建新节点,不会修正已有节点;改成 frame 再 append 仍会重复创建。
   Runtime 保留 `error.details` 中的 `nodeId/partId或pageId/mode`、`commitState=committed`、
   `verified=false` 和 `receipt.createdNodeIds/idMap/deletedNodeCount`,标记
   `execution_started=true` 且不可重试。保留原始 Payload 和当前差异;如需核实,
   最多再 query 同一白板一次,按回执真实 ID 对账,不循环轮询。
2. **提交状态不明**:连接中断、缺少回执或暂未读到节点,都不能证明未提交;
   停止写入,按同一稳定目标只读对账,仍不明确则报告阻塞,不重放。
3. **明确未提交**:仅本地预检未发请求,或服务端明确保证未提交/无副作用,才可
   修正相关字段后至多重试一次;`retryable=false` 的服务错误仍须先解决阻塞条件。

已提交但未验证不能报告完整成功,也不得自动 overwrite、删除节点或重新 append。
布局修复属于新操作,须先对账并另行确认范围和授权,不能作为校验失败的自动重试。
有边界的分区、泳道和卡片组在提交前优先使用 frame 和容器内相对坐标;frame 是布局
设计选择,不是已落库节点的修复手段。临时逻辑组合才使用 group。

## 精确协议补充

| 仅当操作 Reference 未覆盖时 | 读取 |
|---|---|
| 富文本、列表、链接、主题色、罕见样式 | [04-text-style.md](./whiteboard/open-nodes-v1/04-text-style.md) |
| 罕见 shape/frame/group/connector 约束 | [05-shape-frame-group-connector.md](./whiteboard/open-nodes-v1/05-shape-frame-group-connector.md) |
| 非托管 Vector、Icon、Path | [06-vector-icon-path.md](./whiteboard/open-nodes-v1/06-vector-icon-path.md) |
| query 快照转换和错误语义 | [07-examples-errors-write-support.md](./whiteboard/open-nodes-v1/07-examples-errors-write-support.md) |
| 新 geometry / icon catalog 值 | [08-catalogs.md](./whiteboard/open-nodes-v1/08-catalogs.md) |

独立查询兼容服务省略 `view` 回显:page/all 必须有通过身份、版本、页数/节点数和目标页面校验的完整内联快照;summary 必须是完整摘要。明确返回错误 view、错误页面或仅下载链接而未回显 view 时仍拒绝,不能据此绕过失败的 Diff 改用普通更新写入。
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall