dreamina-canvas-cli-auth
Skill4 starsChanged 58 days agoApache-2.0View on GitHub
当用户需要登录即梦画布、等待设备授权、检查账户、刷新凭据或退出时使用;统一维护 auth 命令、服务端身份验证和 profile 隔离,不执行生成或安装。
In this repository36 other files it gives its agents.
- openspec-apply-changeSkill
- openspec-archive-changeSkill
- openspec-exploreSkill
- openspec-proposeSkill
- dreamina-3d-auto-seedanceSkill
- dreamina-3d-from-blenderSkill
- dreamina-3d-from-mayaSkill
- dreamina-3d-jimeng-webSkill
- dreamina-3d-resumeSkill
- dreamina-3d-useSkill
- dreamina-canvas-cli-image2imageSkill
- dreamina-canvas-cli-ref2videoSkill
- dreamina-canvas-cli-setupSkill
- dreamina-canvas-cliSkill
- dreamina-canvas-cli-text2audioSkill
- dreamina-canvas-cli-text2imageSkill
- dreamina-canvas-cli-text2videoSkill
- dreamina-canvas-cli-text2voiceSkill
- dreamina-canvas-useSkill
- dreamina-cli-image2imageSkill
- dreamina-cli-image2videoSkill
- dreamina-cliSkill
- dreamina-cli-text2imageSkill
- dreamina-cli-text2videoSkill
- dreamina-design-useSkill
- dreamina-opencli-image2imageSkill
- dreamina-opencli-image2videoSkill
- dreamina-opencli-text2imageSkill
- dreamina-opencli-text2videoSkill
- dreamina-prompt-image2imageSkill
- dreamina-prompt-image2videoSkill
- dreamina-prompt-text2imageSkill
- dreamina-prompt-text2videoSkill
- dreamina-shot-annotatorSkill
- dreamina-video-evaluatorSkill
- dreamina-video-productionSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 1 is distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 33
All handoffs stay inside this package.
- Distinctive: line 124
Run any paid command from this Skill.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Dreamina Canvas CLI Auth Task
This Skill owns the user-facing authorization workflow of the Dreamina
Canvas CLI (official guide §3): the standard five-step login flow, the
six auth subcommands and when each applies, and the account
self-check that closes the loop.
Credential-security internals — local vs server identity semantics,
token handling red lines, profile isolation mechanics, refresh-window
rules — are owned by dreamina-canvas-cli-auth. This Skill applies that
workflow through the local auth-state reference.
When to use
- The user asks to 登录即梦 / 授权 / 重新登录 / 退出登录 / 检查账号.
- An agent/script environment needs the non-interactive login + device code + wait flow.
- A later command returned exit 11 (login required or session expired).
When not to use
- For credential-security details (token red lines, profile mechanics) — read 认证状态规范.
- For installing the CLI — that is
dreamina-canvas-cli-setup. - For any generation task — the task skills, after auth succeeds.
All handoffs stay inside this package; install any missing skill with
npx skills add full-aigc-skills/dreamina-skills --skill <skill-name>.
Standard login flow(指南 §3 五步)
- 运行
dreamina-canvas auth login。 - 在浏览器中打开终端或 Agent 提供的授权入口。
- 按页面提示完成登录和授权。
- 回到终端等待命令完成。
- 运行
dreamina-canvas auth account做登录自检。
Command selection
| 命令 | 用途 | 何时用 |
auth login | 启动浏览器授权流程 | TTY 交互环境 |
auth login --force | 清除当前登录态后重新授权 | 换账号或登录态损坏 |
--non-interactive auth login | 返回授权信息后立即结束 | Agent / 脚本环境 |
auth wait --device-code <code> | 继续等待已发起的授权(默认最长 10 分钟) | 配合非交互登录的续等 |
auth account | 服务端账号自检 | 每次登录后的闭环;唯一可信的"已登录"证据 |
auth status | 本地登录态 | 仅排障;不可单独作为登录证据 |
auth refresh | 刷新登录凭据 | 凭据需要续期时(仅在 refresh window 内) |
auth logout | 退出登录 | 清除当前 profile 本地登录态 |
Agent 环境要点(细节见 认证状态规范):
- 非交互登录返回 device code 后不要原地轮询 login;把授权入口
交给用户,用
auth wait --device-code <code>续等。 --timeout默认 10 分钟;--timeout 0只轮询一次。
操作契约
| 项目 | 标准 |
| 输入与前置 | profile 与用户要求的认证操作 |
| 副作用 | login/refresh/logout 改变认证态;account/status 只读 |
| 输出交接 | 账户查询结果或待完成 challenge;凭据不进入交接 |
| 恢复规则 | 续等同一设备授权,权限拒绝不自动循环登录 |
Workflow
(装好后) → login(按环境选子命令)→ 用户浏览器授权 → wait 续等
→ auth account 自检 → 报告账号 → 交接后续任务技能1. Select and run the login command
TTY:auth login。Agent:--non-interactive auth login → 取 device
code → 把授权 URL 呈现给用户。
2. Wait for authorization
auth wait --device-code <code>;超时后再次调用同一 code 续等
(未完成的授权仍有效范围内)。
3. Verify with the server
dreamina-canvas --format json auth account只有 auth account(服务端视角)能证明"已登录";auth status
只读本地文件,可能与服务端不符。
4. Report and hand off
报告服务端识别的账号(按 认证状态规范 的隐私规则处理 用户标识),然后交接后续任务技能。
Re-authentication & logout
- 登录态失效(exit 11)→
auth login或--force重登,用同一 身份重试原命令。 - 换账号 →
auth login --force(清当前态再授权)。 - 退出 →
auth logout;凭据续期只在 refresh window 内做auth refresh,不投机调用。
Failure → recovery
| 现象 | 下一步 |
| exit 11 | 重新授权后同身份重试。 |
auth account 与预期账号不符 | 先确认 --profile;换账号用 --force。 |
| 授权页面打不开 | 把完整授权 URL 交给用户手动打开;仍失败按四件套反馈。 |
| wait 超时 | 同一 device code 再 wait;授权过期则重新 login。 |
What this Skill will not do
- Persist, print, or log tokens, cookies, signed URLs, or device codes beyond the active flow (red lines in the local 认证状态规范).
- Run any paid command from this Skill.
- Duplicate the credential-security contract.
Policy
Invocation requires:
- Confirmed installation of dreamina-canvas
- The login/re-login/logout intent is explicit
Forbids:
- Persisting OAuth tokens, cookies, signed URLs, or credentials
- Running paid generation from this Skill
- Treating auth status alone as proof of login
Default prompt:
Guide §3 flow: pick the login subcommand for the environment (non-interactive + auth wait for agents), never loop on login, verify with auth account (server truth, not auth status), --force to switch accounts. Token red lines live in the local 认证状态规范.
认证状态、--profile 隔离与恢复见 认证状态规范。Never persist or echo tokens; auth status is local, auth account is server-recognized proof of login.
Progressive disclosure(按需读取)
- 需要认证状态机、profile 隔离与 token 红线细节时,读取 认证状态规范; 需要状态机展开时读取 认证状态机。
- 需要在七个子命令之间按环境(TTY / Agent)选择时,读取 命令指南。
- 需要确定输入/输出、状态与授权点时,读取 工作流契约。
- 遇到 exit 11、账号不符或 wait 超时时,读取 错误恢复。
- 交付前自检时,读取 验收清单。
不适用与边界
不适用于安装、创建画布或生成媒体。已有有效账户且只需执行任务时不重复登录;权限拒绝应报告业务限制,不以重新登录绕过。
只读取当前操作必要的账户与素材信息;不存储、记录或输出访问令牌、cookie 和临时签名链接。
Gotchas
- 检查退出码和结构化错误,不凭终端提示推断阶段完成。
- 用户授权完成后明确报告结果,失败时保留原错误与下一步。
- 本地可用、服务端认证和业务权限分别验证。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

