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/dev.md

View on GitHub
# dev — 开放平台开发者命令

`dws dev` 是面向**开发者**的命令组,分四个子树:

| 子命令 | 职责 |
|--------|------|
| `dev app` | 应用生命周期(创建/查询/更新/删除/凭证/权限/成员/安全/网页/机器人/**建号**/版本/事件订阅) |
| `dev connect` | **建联**:把现成机器人接到当前本地 agent(起 Stream,不建号) |
| `dev doc` | 开放平台开发文档搜索入口(当前网关未注册该工具键,`dev doc search` 会报「未找到指定工具」不可用;文档搜索一律走 `dws devdoc article search --query <关键词>`) |
| `dev mcp` | MCP 服务、工具、鉴权、凭证、协作者与 HSF 方法的开发管理 |

> ⚠️ **关键区分**:`dws chat bot search/find` 只查询已有机器人(IM 视角);**创建/建号**机器人走 `dws dev app robot submit`;**建联**走 `dws dev connect`。"创建机器人"/"建联"一律走 `dev`,禁止走 `chat`。

---

## dev mcp — MCP 开发与发布

`dev mcp` 是固定、可审计的开发命令树,不会把远端 `serverName` 或工具名注入为新的 Cobra 命令。已发布工具统一通过 `dws mcp published tools/invoke` 消费。

用户提供 OpenAPI/Swagger、Postman、curl 或接口文档并要求“做成 MCP / 给 Agent 用”时,也路由到本节。先完成接口拆分、三段式字段树、映射和鉴权设计,再执行 dry-run。当前不会创建动态命令缓存,也不得持久化 endpoint、工具名与含 `?key=` 的 URL。

```bash
# 服务与工具
dws dev mcp service list --format json
dws dev mcp service create --name 示例服务 --description "示例" --server-name example-service --dry-run --format json
dws dev mcp tool list --mcp-id <mcpId> --format json
dws dev mcp tool publish --mcp-id <mcpId> --tool-id <toolId> --dry-run --format json

# 已发布工具:先查 Schema,再 dry-run,最后显式确认
dws mcp published tools <mcpId> --format json
dws mcp published invoke <mcpId> <toolName> --params '{}' --dry-run --format json
```

Skill 元数据继续兼容 `cli_version >=1.0.61`,但 stock 1.0.61 不代表一定包含新的调用门禁。依赖该门禁前必须做能力检测,而不是猜版本:

```bash
dws mcp published invoke --help
```

确认帮助中包含 `inputSchemaDigest (fresh_core_subset_snapshot)`;检测不到时先执行 `dws upgrade` 升级到最新**稳定版**,再次检测。不要安装或建议 beta,也不要在检测失败时继续真实调用。

`published invoke` 无法静态判断远端工具副作用。检查 dry-run 后,只有用户明确同意本次真实调用,调用方才可在执行时追加确认标志;不要把确认标志固化进模板、脚本或可复制示例。

| 命令路径 | endpoint 解析 | `tools/list` | `tools/call` |
|---|---:|---:|---:|
| `published tools` | 1 次 | 全部分页 | 0 |
| `invoke --dry-run` | 0 | 0 | 0 |
| 未确认的真实 invoke | 0 | 0 | 0 |
| 已确认的真实 invoke | 1 次 | 紧邻调用前刷新全部分页 | 同一 endpoint 上 1 次 |

已确认操作在一个根 `--timeout` 总时限内完成 endpoint 解析、鉴权/客户端构造、全部分页、校验和调用。刷新结果必须对工具名精确且唯一匹配,要求非空 `inputSchema`,再按受限核心子集失败关闭校验;最多 100 页、累计 20 MiB 完整 JSON-RPC 响应、64 KiB cursor、10000 个工具。发现和调用都拒绝 HTTP 重定向,避免跨 endpoint 校验/执行;`tools/list` 可重试,`tools/call` 不自动重试。调用传输失败时结果可能已在服务端发生,必须按“结果未知”处理,不能盲目重放。

成功结果中的 `inputSchemaValidation=fresh_core_subset_snapshot` 和 `inputSchemaDigest` 只证明参数通过了紧邻调用前所取快照的核心子集校验。发现与调用复用同一 endpoint,但 Schema 快照没有被服务端原子锁定;彻底关闭 TOCTOU 需要服务端提供 revision/etag 和调用 precondition。支持的 `$schema` URI 只标识解析方言,不表示支持该方言全部词汇;当前只接受 `required/type/enum/properties/items/additionalProperties` 及明确列出的基础元数据,其他 assertion 或 annotation 一律失败关闭。

完整生命周期和按阶段加载的 API 转换、Mapping、鉴权、82 个表达式函数、故障定位:命令级入参用 `dws mcp --help`、`dws dev mcp --help` 查看(mono 收录形态无 multi 子 skill 目录)。

---

## 典型工作流:创建应用 → 配置机器人 → 版本发布/审批 → 建联

```bash
# Step 1:创建开放平台应用,拿 unifiedAppId
dws dev app create --name "我的 AI 机器人" --desc "接 opencode" --dry-run --format json
dws dev app create --name "我的 AI 机器人" --desc "接 opencode" --yes --format json
# → 返回 unifiedAppId

# Step 2:在明确的 unifiedAppId 上配置机器人能力
dws dev app robot config --unified-app-id <unifiedAppId> --name "小助手" --desc "接 opencode" --dry-run --format json
dws dev app robot config --unified-app-id <unifiedAppId> --name "小助手" --desc "接 opencode" --yes --format json

# Step 3:版本发布/审批,线上搜索、加群、路由消息以 RELEASE 为准
dws dev app version create --unified-app-id <unifiedAppId> --desc "发布机器人能力" --dry-run --format json
dws dev app version create --unified-app-id <unifiedAppId> --desc "发布机器人能力" --yes --format json
dws dev app version check-approval --unified-app-id <unifiedAppId> --version-id <versionId> --format json
dws dev app version publish --unified-app-id <unifiedAppId> --version-id <versionId> --dry-run --format json
dws dev app version publish --unified-app-id <unifiedAppId> --version-id <versionId> --yes --format json
dws dev app version status --unified-app-id <unifiedAppId> --version-id <versionId> --format json

# Step 4:本地建联 — 把机器人接到本地 agent,前台常驻(Ctrl-C 退出)
dws dev connect --unified-app-id <unifiedAppId> --channel opencode
# 若只有 robot result 返回的一次性凭证,clientSecret 只能用占位并按敏感信息处理:
dws dev connect --robot-client-id <clientId> --robot-client-secret <clientSecret-from-result>
```

`check-approval` 若返回 `approvalMode=SELECT_APPROVER`,让用户从候选里选择;不要默认取第一个审批人。用户选定后再给 `publish` 追加 `--approver-user-id <userId>`。

选择题优先原样展示 `approvalPromptText`(带 `A.`/`B.` 序号 + `姓名(userId: xxx)` 的成品文案);需结构化时用 `approvalOptions[].label`,不得退化成多个泛化的“候选审批人”。`completionState=WAITING_FOR_APPROVER_SELECTION` / `mustAskUser=true` 表示必须等待用户选择。

完成态规则:

- `robot result` 顶层 `completionState=BLOCKED_BY_VERSION_PUBLISH` / `mustContinue=true` / `terminal=false` 是硬门禁,必须继续执行 blocking `nextSteps`。
- `robot result` 顶层 `completionState=BLOCKED_BY_MISSING_UNIFIED_APP_ID` / `actionRequired=provide_unified_app_id` 时,必须停下要求明确的 `unifiedAppId`;不能用 `clientId/appKey` 自动反查后写版本。
- `dev connect` 成功只代表本地 Stream 调试可用,不能代表机器人线上可用。
- `dev connect` dry-run 或启动输出里的 `completionState=LOCAL_DEBUG_ONLY` / `doesNotPublish=true` 表示只完成本地调试,不得作为最终完成。
- `robot result` 返回 `lifecycle.overallComplete=false`,或版本未进入 `RELEASE` / `AUDIT` / `UNDER_REVIEW` 前,不要总结“全部完成”“机器人已创建并成功连接”“可以在钉钉中 @机器人使用”。
- “创建机器人并连接 qoder”类任务的闭环必须包含:建号完成、本地 qoder Stream 建联成功、版本已发布或已提交审批;若 `SELECT_APPROVER` 需要选审批人,则停在候选审批人选择。

`robot result` 异步状态:

| status | 含义 | 下一步 |
|--------|------|--------|
| `WAITING` | 创建中 | 按 `intervalSeconds` 继续轮询 |
| `SUCCESS` | 创建完成 | 保存 `robotCode/clientId/clientSecret`;若结果含明确 `unifiedAppId` 才能继续版本发布,否则停下要求用户提供 |
| `APPROVAL_REQUIRED` | 已建号但线上使用需审核 | 不要重复建号;若结果含明确 `unifiedAppId` 才能提交版本发布审核,否则停下要求用户提供 |
| `FAIL` | 失败 | 读 `errorCode/errorMsg`,可带原 `taskId` 重新 `submit` |
| `EXPIRED` | 任务过期 | 重新 `submit` |

---

## dev app — 应用生命周期

```bash
# 查询应用列表
dws dev app list --format json

# 查询单个应用详情
dws dev app get --unified-app-id <unifiedAppId> --format json
dws dev app get --app-key <appKey> --format json

# 创建应用
dws dev app create --name <名称> --desc <描述> --format json

# 更新应用信息(写操作:先 --dry-run 预览,确认后加 --yes 执行;不加 --yes 会被拦下)
dws dev app update --unified-app-id <unifiedAppId> --name <新名称> --dry-run --format json
dws dev app update --unified-app-id <unifiedAppId> --name <新名称> --yes --format json

# 停用/启用应用
dws dev app disable --unified-app-id <unifiedAppId> --yes --format json
dws dev app enable  --unified-app-id <unifiedAppId> --yes --format json

# 删除应用(不可逆,需 --confirm-name 二次确认)
dws dev app delete --unified-app-id <unifiedAppId> --confirm-name <应用名> --yes --format json
```

---

## dev app robot — 机器人(建号与配置)

```bash
# 建号:异步提交
dws dev app robot submit --name <智能体名> --robot-name <机器人名> --desc <描述> --dry-run --format json
dws dev app robot submit --name <智能体名> --robot-name <机器人名> --desc <描述> --yes --format json

# 建号:轮询结果
dws dev app robot result --task-id <taskId> --format json
# SUCCESS/APPROVAL_REQUIRED 后只有结果含明确 unifiedAppId 才能走版本发布
# 若顶层有 completionState=BLOCKED_BY_MISSING_UNIFIED_APP_ID,要求用户提供 unifiedAppId;不能用 appKey/clientId 自动反查后写版本
# 若顶层有 completionState=BLOCKED_BY_VERSION_PUBLISH 或 mustContinue=true,不得停在 dev connect

# 查询现有机器人配置
dws dev app robot get --unified-app-id <unifiedAppId> --format json
# robotStatus=UNCONFIGURED → 未配置,走 config;OFFLINE → 走 enable;ONLINE → 已就绪
# 创建/更新机器人配置(upsert)
dws dev app robot config --unified-app-id <unifiedAppId> --name <机器人名> --format json

# 启用/停用机器人
dws dev app robot enable  --unified-app-id <unifiedAppId> --format json
dws dev app robot disable --unified-app-id <unifiedAppId> --format json
```

---

## dev app credentials — 凭证

```bash
# 查询 clientId/clientSecret(credentials 下只有 get 子命令)
dws dev app credentials get --unified-app-id <unifiedAppId> --format json
```

---

## dev connect — 建联

```bash
# 前台建联,自动探测渠道
dws dev connect \
  --robot-client-id <clientId> --robot-client-secret <clientSecret>

# 明确指定渠道(opencode/claudecode/qoder/qoderwork/workbuddy/codex/gemini/hermes/openclaw/custom)
dws dev connect --channel opencode \
  --robot-client-id <clientId> --robot-client-secret <clientSecret>

# 建联前预览方案(不实际起连接,检查 cli.installed 字段)
dws dev connect --channel opencode \
  --robot-client-id <clientId> --robot-client-secret <clientSecret> \
  --dry-run --format json

# 后台守护进程模式(崩溃自拉起)
dws dev connect --daemon \
  --robot-client-id <clientId> --robot-client-secret <clientSecret>

# 查看/停止后台连接器(status/list 忽略全局 --format,出 JSON 用专属 --json)
dws dev connect status --json
dws dev connect stop
```

常用 flag:

| Flag | 说明 |
|------|------|
| `--channel` | 渠道,默认 `auto` 自动探测 |
| `--agent-model` | 覆盖 agent 模型(如 `claude-sonnet-4-6`) |
| `--agent-workdir` | agent 运行目录(放知识文件可给机器人项目上下文) |
| `--reply-card` | AI 卡片回复,默认开启(`--reply-card=false` 关闭) |
| `--card-template` | AI 卡片模板 ID(开发者后台→本应用→AI 卡片设置获取) |
| `--knowledge-dir` | 本地知识目录(.md/.txt),每条消息检索后拼入 prompt |
| `--daemon` | 后台守护进程 |
| `--owner-user-id` | 数字分身:执行类请求先发给主人审批 |

**预检 cli.installed**:`--dry-run` 出参的 `cli` 字段含 `installed/autoInstall/installHint`。`installed:false, autoInstall:false`(桌面 App 渠道)时先引导用户安装对应 App,不要直接起连接。

`dev connect` 是本地调试步骤。dry-run JSON 的 `invocation` 会包含 `scope=local_debug_only`、`doesNotPublish=true`、`completionState=LOCAL_DEBUG_ONLY`、`terminal=false`;真实前台/daemon 启动也会提示“本地调试,不代表线上发布完成”。这些信号不能抵消版本发布/审批闭环。

---

## dev app event — 事件订阅

事件码定位优先用 `event list --keyword` 搜索;只有用户明确要「全部事件」时才翻全量(逐页)。

```bash
dws dev app event list        --unified-app-id <unifiedAppId> --keyword <关键词> --format json
dws dev app event subscribe   --unified-app-id <unifiedAppId> --event-codes <code1>,<code2> --dry-run --format json
dws dev app event unsubscribe --unified-app-id <unifiedAppId> --event-codes <code1>,<code2> --yes --format json
```

---

## dev app permission — 权限

```bash
dws dev app permission list  --unified-app-id <unifiedAppId> --format json
dws dev app permission add   --unified-app-id <unifiedAppId> --scope-values <scopeValue> --format json
dws dev app permission remove --unified-app-id <unifiedAppId> --scope-values <scopeValue> --yes --format json
```

---

## dev app version — 版本发布

配置变更(权限/机器人/网页等)需通过版本通道才生效。

```bash
dws dev app version create         --unified-app-id <unifiedAppId> --format json
dws dev app version check-approval --unified-app-id <unifiedAppId> --version-id <versionId> --format json
dws dev app version publish        --unified-app-id <unifiedAppId> --version-id <versionId> --format json
dws dev app version status         --unified-app-id <unifiedAppId> --version-id <versionId> --format json
```

---

## 注意事项

- **`clientSecret` 只在 `robot result` 返回一次**,务必立即保存;dws 只能 `credentials get` 读取,不支持重置,遗失后到开放平台控制台重置密钥
- 改配置后机器人不自动生效,需走 `version create → publish` 才上线
- `hermes`/`openclaw` 渠道走官方建联,`dws dev connect` 不代建机器人,会输出指引后退出
- 应用名在企业内唯一;`app get` 支持 `--unified-app-id` 或只读 `--app-key` 查详情;写操作定位单应用须用 `--unified-app-id`
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