dingtalk-workspace-cli/skills/multi/dingtalk-misc/references/dev/recipes.md

端到端链路（recipes）

dev 的端到端任务都是「定ä½�应用，改容器æŸ�节点，按审批需è¦�走版本生效，最å�Žå›žè¯»éªŒè¯�ã€�。æ¯�步先 --dry-run 确认å†� --yes，å�‚数用对应命令的 --help 查询，¼Œç»†èŠ‚进对应 reference。

建一个钉钉里打开的网页应用

1. dev app create --name <�> 建应用，拿 unifiedAppId
2. dev app webapp config é…�移动端/PC 首页（è§� webapp.md）
3. dev app version create 建版本
4. dev app version check-approval 预检是å�¦éœ€å®¡æ‰¹
5. dev app version publish å�‘布（需审批时让用户选审批人）
6. 回读 dev app version status 到 RELEASE æ‰�算生效

��从申请到生效

1. dev app permission list 选 scopeValue（选择顺åº�è§� permission.md）
2. dev app permission add --scope-values <值> 申请
3. 若是 requiredApproval çš„æ�ƒé™�，走版本：version create，å†� check-approval，å†� publish --approver-user-id <用户选的>，最å�Ž version status
4. �审��直接开通，�必�版本

�一个答疑机器人并接到本地调试

1. dev app create --name <�> 创建应用，拿明确 unifiedAppId
2. dev app robot config --unified-app-id <unifiedAppId> é…�置机器人能力；需è¦�å�¯ç”¨æ—¶å†� robot enable
3. 线上使用闭环：version create → check-approval → publish → version statusï¼›SELECT_APPROVER 时必须等用户选择审批人，ä¸�默认å�–第一个
4. 本地调试/值守：dev connect --unified-app-id <unifiedAppId> 把机器人接到本地 agent（è§� connect.md）；注æ„�订阅事件å‰�è¦�先建è�”长连（è§� event.md）
5. 若走无绑定的 robot submit/result，å�ªæœ‰ç»“果返回明确 unifiedAppId æ‰�能继续版本å�‘布
6. 完æˆ�æ€�与缺 unifiedAppIdã€�SELECT_APPROVER 等门ç¦�判定è§� devapp.md「核心规则ã€�：建è�”æˆ�功 + 版本进入 RELEASE/AUDIT/UNDER_REVIEW æ‰�算完æˆ�

��守护进程连接器（�存密钥）

守护进程被 stop / kill / 崩溃å�Žï¼Œé€šè¿‡æŒ�久化的 unifiedAppId é‡�新拉å�–密钥并é‡�å�¯ï¼Œæ— éœ€æœ¬åœ°ä¿�å­˜ AppSecret。

1. dev connect --daemon --unified-app-id <id> --channel <channel> 首次å�¯åŠ¨ï¼ˆunifiedAppId å’Œ channel 会写入 ~/.dws/connect/<key>/daemon.pid）
2. dev connect restart --unified-app-id <id> é‡�å�¯ï¼šè‡ªåŠ¨ stop 旧进程 → 从 dev å¹³å�°æ‹‰å�– AppKey/Secret → é‡�新建è�”
3. dev connect status --unified-app-id <id> 确认æ�¢å¤� healthy
4. è‹¥ daemon.pid 未æŒ�久化 unifiedAppId（如用 --robot-client-id 直接å�¯åŠ¨çš„），restart 会æ��示改用 --unified-app-id å�¯åŠ¨

注æ„�：密钥ä¸�è�½ç›˜ï¼Œæ¯�次 restart 动æ€�从开å�‘者平å�°èŽ·å�–ï¼›daemon.pid å�ªå­˜ unifiedAppIdã€�channelã€�clientId（公开值）。

上传图片拿 mediaId（应用图标 / 机器人图标）

应用图标�机器人图标都� mediaId 指定，但 dev 命令集��上传——mediaId �调钉钉 OpenAPI 拿到：

1. 拿凭è¯�：dev app credentials get --unified-app-id <id> å�– appKey/appSecret（secret 按æ•�感处ç�†ï¼Œä¸�写进回答）

2. æ�¢ access_token：GET https://oapi.dingtalk.com/gettoken?appkey=<appKey>&appsecret=<appSecret>，å�–返回的 access_token（有效期约 7200 秒ã€�gettoken 有频控，缓存å¤�用别æ¯�次上传都æ�¢ï¼‰

3. 上传图片：POST https://oapi.dingtalk.com/media/upload?access_token=<token>&type=image，multipart 表å�•å­—段å�� media，返回 media_id（形如 @lA...）。图标用方形图（如 256×256 çš„ jpg/png）

   curl -F "media=@/path/to/img.png;type=image/png" \
     "https://oapi.dingtalk.com/media/upload?access_token=<token>&type=image"
   

4. 用 mediaId 更新：机器人图标 dev app robot config --unified-app-id <id> --icon-media-id <media_id>；应用图标 dev app update --unified-app-id <id> --icon-media-id <media_id>。写æ“�作先 --dry-run å†� --yes

5. 回读：dev app robot get 看 iconMediaId å�˜ä¸ºæ–°å€¼ï¼ˆåº”用图标看 app get çš„ icon）

查「为什么没生效 / 机器人��到 / ��加了还报错�

å…ˆ dev app version status——改é…�ç½®ä¸�等于生效，未å�‘到 RELEASE å°±ä¸�生效。