feat: add agent-guided issue reporting workflow and bug report template#43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
XXPermanentXX merged 3 commits into from
Jun 12, 2026
Merged

feat: add agent-guided issue reporting workflow and bug report template #43

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
f687175
docs: add comprehensive issue reporting documentation
hopelynd Jun 10, 2026
5137257
docs: move issue reporting documentation to assets folder
hopelynd Jun 10, 2026
6a0d39c
refactor(docs): clean up issue reporting guidelines formatting
hopelynd Jun 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
185 changes: 185 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
name: Bug Report
description: Report a bug in bailian-cli (bl)
title: "[bug]: "
labels:
- bug
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to report a bug.

**Before submitting:** search [open issues](https://github.com/modelstudioai/cli/issues?q=is%3Aissue+is%3Aopen) for duplicates.

**Security:** redact API keys (`sk-...`), console tokens, internal URLs, and business prompts before pasting output.

- type: markdown
attributes:
value: |
## Environment

- type: input
id: cli-version
attributes:
label: CLI version
description: "Output of bl --version (use only X.Y.Z, without the bl prefix)"
placeholder: "1.2.1"
validations:
required: true

- type: input
id: skill-version
attributes:
label: Skill version (optional)
description: "metadata.version from the installed bailian-cli skill, if applicable"
placeholder: "1.2.1"

- type: input
id: node-version
attributes:
label: Node version
description: "Output of node --version"
placeholder: "v22.12.0"
validations:
required: true

- type: input
id: os
attributes:
label: OS
description: "e.g. darwin 24.5.0, Ubuntu 22.04"
placeholder: "darwin 24.5.0"
validations:
required: true

- type: dropdown
id: region
attributes:
label: Region
description: "From bl auth status or bl config show"
options:
- cn
- us
- intl
- unknown
validations:
required: true

- type: markdown
attributes:
value: |
## Reproduction

- type: textarea
id: reproduce-command
attributes:
label: Command to reproduce
description: "Exact command that failed. Redact --api-key, sk-..., and sensitive prompts."
render: shell
placeholder: |
bl video generate --prompt "sunset" --download out.mp4 --verbose
validations:
required: true

- type: textarea
id: expected
attributes:
label: Expected behavior
description: What should have happened?
validations:
required: true

- type: textarea
id: actual
attributes:
label: Actual behavior
description: What happened instead?
validations:
required: true

- type: markdown
attributes:
value: |
## Error output

Paste stderr as printed by `bl`. Include `Request ID` when present — it helps us trace logs.

- type: textarea
id: full-output
attributes:
label: Full output
description: Error, Hint, Status, Request ID, Exit code, etc.
render: shell
placeholder: |
Error: Generation completed but no images returned.
Hint: ...
Status: HTTP 200 (...)
Request ID: ...
Exit code: 1
validations:
required: true

- type: textarea
id: json-error
attributes:
label: JSON error (optional)
description: "Re-run with --output json and paste the error object if available"
render: json
placeholder: |
{
"error": {
"code": 1,
"message": "...",
"http_status": 200,
"api_code": "...",
"request_id": "..."
}
}

- type: markdown
attributes:
value: |
## Troubleshooting already tried

- type: checkboxes
id: already-tried
attributes:
label: Already tried
options:
- label: "bl update and skill version aligned with CLI"
- label: "bl auth status OK for this command"
- label: "Different network / region — still reproduces"

- type: markdown
attributes:
value: |
## Additional context

- type: dropdown
id: frequency
attributes:
label: How often does this happen?
options:
- Always
- Intermittent
- Once
validations:
required: true

- type: dropdown
id: invoked-via
attributes:
label: How was bl invoked?
options:
- Terminal (manual)
- Agent (Cursor, Claude, etc.)
- CI / script
- Other
validations:
required: true

- type: textarea
id: notes
attributes:
label: Notes (optional)
description: Anything else that might help — related issues, screenshots, minimal repro repo, etc.
14 changes: 7 additions & 7 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -171,14 +171,14 @@ Config file location: `~/.bailian/config.json`

## Links

| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |

## Changelog

Expand Down
14 changes: 7 additions & 7 deletions README.zh.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -166,14 +166,14 @@ bl update

## 相关链接

| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |

## 更新日志

Expand Down
14 changes: 14 additions & 0 deletions skills/bailian-cli/SKILL.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -8,6 +8,7 @@ description: >-
vision, TTS/ASR, file upload, app call, memory, knowledge RAG, web search, model list.
**LOCAL FILES**: commands accepting URLs also accept local paths — auto-upload built-in; never ask for URLs.
Full command reference: `reference/index.md` + `reference/<group>.md` in this skill directory.
When `bl` fails with a likely CLI bug (not usage/auth/quota/model-not-found), ask whether to report — see `assets/issue-reporting.md`.
---

# Aliyun Model Studio CLI (`bl`)
Expand DownExpand Up@@ -211,6 +212,19 @@ bl config export-schema --command "image generate"

---

## CLI errors: report an issue

When a `bl` command **fails** and the cause is **not** a user/service-side error (usage, auth, quota, content filter, model not found, invalid parameters, obvious local env), ask the user **once** whether to report a bug to the Bailian CLI team.

1. Classify the failure using [`assets/issue-reporting.md`](assets/issue-reporting.md) (EXCLUDE vs INCLUDE tables).
2. If INCLUDE matches, ask the user (Chinese prompt in that doc). If they agree, collect environment info, redact secrets, fill the issue template, and submit to https://github.com/modelstudioai/cli/issues (browser or `gh issue create`).
3. Before offering: align skill/CLI versions and retry with `--verbose` / `--output json` when output is thin.
4. Do **not** ask in CI or when `--non-interactive` is set unless the user explicitly wants to report.

Full workflow, redaction rules, template, and exit-code reference: [`assets/issue-reporting.md`](assets/issue-reporting.md).

---

## Priority reminders

- Text → `bl text chat`, not other LLM APIs.
Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all 
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
feat: add agent-guided issue reporting workflow and bug report template#43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

XXPermanentXX
merged 3 commits into

from

Jun 12, 2026
 Merged


feat: add agent-guided issue reporting workflow and bug report template
#43
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
f687175

docs: add comprehensive issue reporting documentation


hopelynd Jun 10, 2026
5137257

docs: move issue reporting documentation to assets folder


hopelynd Jun 10, 2026
6a0d39c

refactor(docs): clean up issue reporting guidelines formatting


hopelynd Jun 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


185 changes: 185 additions & 0 deletions
.github/ISSUE_TEMPLATE/bug_report.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
name: Bug Report
description: Report a bug in bailian-cli (bl)
title: "[bug]: "
labels:
 - bug
body:
 - type: markdown
 attributes:
 value: |
 Thanks for taking the time to report a bug.

 **Before submitting:** search [open issues](https://github.com/modelstudioai/cli/issues?q=is%3Aissue+is%3Aopen) for duplicates.

 **Security:** redact API keys (`sk-...`), console tokens, internal URLs, and business prompts before pasting output.

 - type: markdown
 attributes:
 value: |
 ## Environment

 - type: input
 id: cli-version
 attributes:
 label: CLI version
 description: "Output of bl --version (use only X.Y.Z, without the bl prefix)"
 placeholder: "1.2.1"
 validations:
 required: true

 - type: input
 id: skill-version
 attributes:
 label: Skill version (optional)
 description: "metadata.version from the installed bailian-cli skill, if applicable"
 placeholder: "1.2.1"

 - type: input
 id: node-version
 attributes:
 label: Node version
 description: "Output of node --version"
 placeholder: "v22.12.0"
 validations:
 required: true

 - type: input
 id: os
 attributes:
 label: OS
 description: "e.g. darwin 24.5.0, Ubuntu 22.04"
 placeholder: "darwin 24.5.0"
 validations:
 required: true

 - type: dropdown
 id: region
 attributes:
 label: Region
 description: "From bl auth status or bl config show"
 options:
 - cn
 - us
 - intl
 - unknown
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Reproduction

 - type: textarea
 id: reproduce-command
 attributes:
 label: Command to reproduce
 description: "Exact command that failed. Redact --api-key, sk-..., and sensitive prompts."
 render: shell
 placeholder: |
 bl video generate --prompt "sunset" --download out.mp4 --verbose
 validations:
 required: true

 - type: textarea
 id: expected
 attributes:
 label: Expected behavior
 description: What should have happened?
 validations:
 required: true

 - type: textarea
 id: actual
 attributes:
 label: Actual behavior
 description: What happened instead?
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Error output

 Paste stderr as printed by `bl`. Include `Request ID` when present — it helps us trace logs.

 - type: textarea
 id: full-output
 attributes:
 label: Full output
 description: Error, Hint, Status, Request ID, Exit code, etc.
 render: shell
 placeholder: |
 Error: Generation completed but no images returned.
 Hint: ...
 Status: HTTP 200 (...)
 Request ID: ...
 Exit code: 1
 validations:
 required: true

 - type: textarea
 id: json-error
 attributes:
 label: JSON error (optional)
 description: "Re-run with --output json and paste the error object if available"
 render: json
 placeholder: |
 {
 "error": {
 "code": 1,
 "message": "...",
 "http_status": 200,
 "api_code": "...",
 "request_id": "..."
 }
 }

 - type: markdown
 attributes:
 value: |
 ## Troubleshooting already tried

 - type: checkboxes
 id: already-tried
 attributes:
 label: Already tried
 options:
 - label: "bl update and skill version aligned with CLI"
 - label: "bl auth status OK for this command"
 - label: "Different network / region — still reproduces"

 - type: markdown
 attributes:
 value: |
 ## Additional context

 - type: dropdown
 id: frequency
 attributes:
 label: How often does this happen?
 options:
 - Always
 - Intermittent
 - Once
 validations:
 required: true

 - type: dropdown
 id: invoked-via
 attributes:
 label: How was bl invoked?
 options:
 - Terminal (manual)
 - Agent (Cursor, Claude, etc.)
 - CI / script
 - Other
 validations:
 required: true

 - type: textarea
 id: notes
 attributes:
 label: Notes (optional)
 description: Anything else that might help — related issues, screenshots, minimal repro repo, etc.

14 changes: 7 additions & 7 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -171,14 +171,14 @@ Config file location: `~/.bailian/config.json`

## Links

| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |

## Changelog

Expand Down

14 changes: 7 additions & 7 deletions
README.zh.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -166,14 +166,14 @@ bl update

## 相关链接

| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |

## 更新日志

Expand Down

14 changes: 14 additions & 0 deletions
skills/bailian-cli/SKILL.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -8,6 +8,7 @@ description: >-
 vision, TTS/ASR, file upload, app call, memory, knowledge RAG, web search, model list.
 **LOCAL FILES**: commands accepting URLs also accept local paths — auto-upload built-in; never ask for URLs.
 Full command reference: `reference/index.md` + `reference/<group>.md` in this skill directory.
 When `bl` fails with a likely CLI bug (not usage/auth/quota/model-not-found), ask whether to report — see `assets/issue-reporting.md`.
---

# Aliyun Model Studio CLI (`bl`)
Expand DownExpand Up@@ -211,6 +212,19 @@ bl config export-schema --command "image generate"

---

## CLI errors: report an issue

When a `bl` command **fails** and the cause is **not** a user/service-side error (usage, auth, quota, content filter, model not found, invalid parameters, obvious local env), ask the user **once** whether to report a bug to the Bailian CLI team.

1. Classify the failure using [`assets/issue-reporting.md`](assets/issue-reporting.md) (EXCLUDE vs INCLUDE tables).
2. If INCLUDE matches, ask the user (Chinese prompt in that doc). If they agree, collect environment info, redact secrets, fill the issue template, and submit to https://github.com/modelstudioai/cli/issues (browser or `gh issue create`).
3. Before offering: align skill/CLI versions and retry with `--verbose` / `--output json` when output is thin.
4. Do **not** ask in CI or when `--non-interactive` is set unless the user explicitly wants to report.

Full workflow, redaction rules, template, and exit-code reference: [`assets/issue-reporting.md`](assets/issue-reporting.md).

---

## Priority reminders

- Text → `bl text chat`, not other LLM APIs.
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix");
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: add agent-guided issue reporting workflow and bug report template#43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

XXPermanentXX
merged 3 commits into

from

Jun 12, 2026
 Merged


feat: add agent-guided issue reporting workflow and bug report template
#43
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
f687175

docs: add comprehensive issue reporting documentation


hopelynd Jun 10, 2026
5137257

docs: move issue reporting documentation to assets folder


hopelynd Jun 10, 2026
6a0d39c

refactor(docs): clean up issue reporting guidelines formatting


hopelynd Jun 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


185 changes: 185 additions & 0 deletions
.github/ISSUE_TEMPLATE/bug_report.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
name: Bug Report
description: Report a bug in bailian-cli (bl)
title: "[bug]: "
labels:
 - bug
body:
 - type: markdown
 attributes:
 value: |
 Thanks for taking the time to report a bug.

 **Before submitting:** search [open issues](https://github.com/modelstudioai/cli/issues?q=is%3Aissue+is%3Aopen) for duplicates.

 **Security:** redact API keys (`sk-...`), console tokens, internal URLs, and business prompts before pasting output.

 - type: markdown
 attributes:
 value: |
 ## Environment

 - type: input
 id: cli-version
 attributes:
 label: CLI version
 description: "Output of bl --version (use only X.Y.Z, without the bl prefix)"
 placeholder: "1.2.1"
 validations:
 required: true

 - type: input
 id: skill-version
 attributes:
 label: Skill version (optional)
 description: "metadata.version from the installed bailian-cli skill, if applicable"
 placeholder: "1.2.1"

 - type: input
 id: node-version
 attributes:
 label: Node version
 description: "Output of node --version"
 placeholder: "v22.12.0"
 validations:
 required: true

 - type: input
 id: os
 attributes:
 label: OS
 description: "e.g. darwin 24.5.0, Ubuntu 22.04"
 placeholder: "darwin 24.5.0"
 validations:
 required: true

 - type: dropdown
 id: region
 attributes:
 label: Region
 description: "From bl auth status or bl config show"
 options:
 - cn
 - us
 - intl
 - unknown
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Reproduction

 - type: textarea
 id: reproduce-command
 attributes:
 label: Command to reproduce
 description: "Exact command that failed. Redact --api-key, sk-..., and sensitive prompts."
 render: shell
 placeholder: |
 bl video generate --prompt "sunset" --download out.mp4 --verbose
 validations:
 required: true

 - type: textarea
 id: expected
 attributes:
 label: Expected behavior
 description: What should have happened?
 validations:
 required: true

 - type: textarea
 id: actual
 attributes:
 label: Actual behavior
 description: What happened instead?
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Error output

 Paste stderr as printed by `bl`. Include `Request ID` when present — it helps us trace logs.

 - type: textarea
 id: full-output
 attributes:
 label: Full output
 description: Error, Hint, Status, Request ID, Exit code, etc.
 render: shell
 placeholder: |
 Error: Generation completed but no images returned.
 Hint: ...
 Status: HTTP 200 (...)
 Request ID: ...
 Exit code: 1
 validations:
 required: true

 - type: textarea
 id: json-error
 attributes:
 label: JSON error (optional)
 description: "Re-run with --output json and paste the error object if available"
 render: json
 placeholder: |
 {
 "error": {
 "code": 1,
 "message": "...",
 "http_status": 200,
 "api_code": "...",
 "request_id": "..."
 }
 }

 - type: markdown
 attributes:
 value: |
 ## Troubleshooting already tried

 - type: checkboxes
 id: already-tried
 attributes:
 label: Already tried
 options:
 - label: "bl update and skill version aligned with CLI"
 - label: "bl auth status OK for this command"
 - label: "Different network / region — still reproduces"

 - type: markdown
 attributes:
 value: |
 ## Additional context

 - type: dropdown
 id: frequency
 attributes:
 label: How often does this happen?
 options:
 - Always
 - Intermittent
 - Once
 validations:
 required: true

 - type: dropdown
 id: invoked-via
 attributes:
 label: How was bl invoked?
 options:
 - Terminal (manual)
 - Agent (Cursor, Claude, etc.)
 - CI / script
 - Other
 validations:
 required: true

 - type: textarea
 id: notes
 attributes:
 label: Notes (optional)
 description: Anything else that might help — related issues, screenshots, minimal repro repo, etc.

14 changes: 7 additions & 7 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -171,14 +171,14 @@ Config file location: `~/.bailian/config.json`

## Links

| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |

## Changelog

Expand Down

14 changes: 7 additions & 7 deletions
README.zh.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -166,14 +166,14 @@ bl update

## 相关链接

| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |

## 更新日志

Expand Down

14 changes: 14 additions & 0 deletions
skills/bailian-cli/SKILL.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -8,6 +8,7 @@ description: >-
 vision, TTS/ASR, file upload, app call, memory, knowledge RAG, web search, model list.
 **LOCAL FILES**: commands accepting URLs also accept local paths — auto-upload built-in; never ask for URLs.
 Full command reference: `reference/index.md` + `reference/<group>.md` in this skill directory.
 When `bl` fails with a likely CLI bug (not usage/auth/quota/model-not-found), ask whether to report — see `assets/issue-reporting.md`.
---

# Aliyun Model Studio CLI (`bl`)
Expand DownExpand Up@@ -211,6 +212,19 @@ bl config export-schema --command "image generate"

---

## CLI errors: report an issue

When a `bl` command **fails** and the cause is **not** a user/service-side error (usage, auth, quota, content filter, model not found, invalid parameters, obvious local env), ask the user **once** whether to report a bug to the Bailian CLI team.

1. Classify the failure using [`assets/issue-reporting.md`](assets/issue-reporting.md) (EXCLUDE vs INCLUDE tables).
2. If INCLUDE matches, ask the user (Chinese prompt in that doc). If they agree, collect environment info, redact secrets, fill the issue template, and submit to https://github.com/modelstudioai/cli/issues (browser or `gh issue create`).
3. Before offering: align skill/CLI versions and retry with `--verbose` / `--output json` when output is thin.
4. Do **not** ask in CI or when `--non-interactive` is set unless the user explicitly wants to report.

Full workflow, redaction rules, template, and exit-code reference: [`assets/issue-reporting.md`](assets/issue-reporting.md).

---

## Priority reminders

- Text → `bl text chat`, not other LLM APIs.
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms");
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: add agent-guided issue reporting workflow and bug report template#43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

XXPermanentXX
merged 3 commits into

from

Jun 12, 2026
 Merged


feat: add agent-guided issue reporting workflow and bug report template
#43
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
f687175

docs: add comprehensive issue reporting documentation


hopelynd Jun 10, 2026
5137257

docs: move issue reporting documentation to assets folder


hopelynd Jun 10, 2026
6a0d39c

refactor(docs): clean up issue reporting guidelines formatting


hopelynd Jun 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


185 changes: 185 additions & 0 deletions
.github/ISSUE_TEMPLATE/bug_report.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
name: Bug Report
description: Report a bug in bailian-cli (bl)
title: "[bug]: "
labels:
 - bug
body:
 - type: markdown
 attributes:
 value: |
 Thanks for taking the time to report a bug.

 **Before submitting:** search [open issues](https://github.com/modelstudioai/cli/issues?q=is%3Aissue+is%3Aopen) for duplicates.

 **Security:** redact API keys (`sk-...`), console tokens, internal URLs, and business prompts before pasting output.

 - type: markdown
 attributes:
 value: |
 ## Environment

 - type: input
 id: cli-version
 attributes:
 label: CLI version
 description: "Output of bl --version (use only X.Y.Z, without the bl prefix)"
 placeholder: "1.2.1"
 validations:
 required: true

 - type: input
 id: skill-version
 attributes:
 label: Skill version (optional)
 description: "metadata.version from the installed bailian-cli skill, if applicable"
 placeholder: "1.2.1"

 - type: input
 id: node-version
 attributes:
 label: Node version
 description: "Output of node --version"
 placeholder: "v22.12.0"
 validations:
 required: true

 - type: input
 id: os
 attributes:
 label: OS
 description: "e.g. darwin 24.5.0, Ubuntu 22.04"
 placeholder: "darwin 24.5.0"
 validations:
 required: true

 - type: dropdown
 id: region
 attributes:
 label: Region
 description: "From bl auth status or bl config show"
 options:
 - cn
 - us
 - intl
 - unknown
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Reproduction

 - type: textarea
 id: reproduce-command
 attributes:
 label: Command to reproduce
 description: "Exact command that failed. Redact --api-key, sk-..., and sensitive prompts."
 render: shell
 placeholder: |
 bl video generate --prompt "sunset" --download out.mp4 --verbose
 validations:
 required: true

 - type: textarea
 id: expected
 attributes:
 label: Expected behavior
 description: What should have happened?
 validations:
 required: true

 - type: textarea
 id: actual
 attributes:
 label: Actual behavior
 description: What happened instead?
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Error output

 Paste stderr as printed by `bl`. Include `Request ID` when present — it helps us trace logs.

 - type: textarea
 id: full-output
 attributes:
 label: Full output
 description: Error, Hint, Status, Request ID, Exit code, etc.
 render: shell
 placeholder: |
 Error: Generation completed but no images returned.
 Hint: ...
 Status: HTTP 200 (...)
 Request ID: ...
 Exit code: 1
 validations:
 required: true

 - type: textarea
 id: json-error
 attributes:
 label: JSON error (optional)
 description: "Re-run with --output json and paste the error object if available"
 render: json
 placeholder: |
 {
 "error": {
 "code": 1,
 "message": "...",
 "http_status": 200,
 "api_code": "...",
 "request_id": "..."
 }
 }

 - type: markdown
 attributes:
 value: |
 ## Troubleshooting already tried

 - type: checkboxes
 id: already-tried
 attributes:
 label: Already tried
 options:
 - label: "bl update and skill version aligned with CLI"
 - label: "bl auth status OK for this command"
 - label: "Different network / region — still reproduces"

 - type: markdown
 attributes:
 value: |
 ## Additional context

 - type: dropdown
 id: frequency
 attributes:
 label: How often does this happen?
 options:
 - Always
 - Intermittent
 - Once
 validations:
 required: true

 - type: dropdown
 id: invoked-via
 attributes:
 label: How was bl invoked?
 options:
 - Terminal (manual)
 - Agent (Cursor, Claude, etc.)
 - CI / script
 - Other
 validations:
 required: true

 - type: textarea
 id: notes
 attributes:
 label: Notes (optional)
 description: Anything else that might help — related issues, screenshots, minimal repro repo, etc.

14 changes: 7 additions & 7 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -171,14 +171,14 @@ Config file location: `~/.bailian/config.json`

## Links

| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |

## Changelog

Expand Down

14 changes: 7 additions & 7 deletions
README.zh.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -166,14 +166,14 @@ bl update

## 相关链接

| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |

## 更新日志

Expand Down

14 changes: 14 additions & 0 deletions
skills/bailian-cli/SKILL.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -8,6 +8,7 @@ description: >-
 vision, TTS/ASR, file upload, app call, memory, knowledge RAG, web search, model list.
 **LOCAL FILES**: commands accepting URLs also accept local paths — auto-upload built-in; never ask for URLs.
 Full command reference: `reference/index.md` + `reference/<group>.md` in this skill directory.
 When `bl` fails with a likely CLI bug (not usage/auth/quota/model-not-found), ask whether to report — see `assets/issue-reporting.md`.
---

# Aliyun Model Studio CLI (`bl`)
Expand DownExpand Up@@ -211,6 +212,19 @@ bl config export-schema --command "image generate"

---

## CLI errors: report an issue

When a `bl` command **fails** and the cause is **not** a user/service-side error (usage, auth, quota, content filter, model not found, invalid parameters, obvious local env), ask the user **once** whether to report a bug to the Bailian CLI team.

1. Classify the failure using [`assets/issue-reporting.md`](assets/issue-reporting.md) (EXCLUDE vs INCLUDE tables).
2. If INCLUDE matches, ask the user (Chinese prompt in that doc). If they agree, collect environment info, redact secrets, fill the issue template, and submit to https://github.com/modelstudioai/cli/issues (browser or `gh issue create`).
3. Before offering: align skill/CLI versions and retry with `--verbose` / `--output json` when output is thin.
4. Do **not** ask in CI or when `--non-interactive` is set unless the user explicitly wants to report.

Full workflow, redaction rules, template, and exit-code reference: [`assets/issue-reporting.md`](assets/issue-reporting.md).

---

## Priority reminders

- Text → `bl text chat`, not other LLM APIs.
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links");
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
feat: add agent-guided issue reporting workflow and bug report template#43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

XXPermanentXX
merged 3 commits into

from

Jun 12, 2026
 Merged


feat: add agent-guided issue reporting workflow and bug report template
#43
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
f687175

docs: add comprehensive issue reporting documentation


hopelynd Jun 10, 2026
5137257

docs: move issue reporting documentation to assets folder


hopelynd Jun 10, 2026
6a0d39c

refactor(docs): clean up issue reporting guidelines formatting


hopelynd Jun 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


185 changes: 185 additions & 0 deletions
.github/ISSUE_TEMPLATE/bug_report.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
name: Bug Report
description: Report a bug in bailian-cli (bl)
title: "[bug]: "
labels:
 - bug
body:
 - type: markdown
 attributes:
 value: |
 Thanks for taking the time to report a bug.

 **Before submitting:** search [open issues](https://github.com/modelstudioai/cli/issues?q=is%3Aissue+is%3Aopen) for duplicates.

 **Security:** redact API keys (`sk-...`), console tokens, internal URLs, and business prompts before pasting output.

 - type: markdown
 attributes:
 value: |
 ## Environment

 - type: input
 id: cli-version
 attributes:
 label: CLI version
 description: "Output of bl --version (use only X.Y.Z, without the bl prefix)"
 placeholder: "1.2.1"
 validations:
 required: true

 - type: input
 id: skill-version
 attributes:
 label: Skill version (optional)
 description: "metadata.version from the installed bailian-cli skill, if applicable"
 placeholder: "1.2.1"

 - type: input
 id: node-version
 attributes:
 label: Node version
 description: "Output of node --version"
 placeholder: "v22.12.0"
 validations:
 required: true

 - type: input
 id: os
 attributes:
 label: OS
 description: "e.g. darwin 24.5.0, Ubuntu 22.04"
 placeholder: "darwin 24.5.0"
 validations:
 required: true

 - type: dropdown
 id: region
 attributes:
 label: Region
 description: "From bl auth status or bl config show"
 options:
 - cn
 - us
 - intl
 - unknown
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Reproduction

 - type: textarea
 id: reproduce-command
 attributes:
 label: Command to reproduce
 description: "Exact command that failed. Redact --api-key, sk-..., and sensitive prompts."
 render: shell
 placeholder: |
 bl video generate --prompt "sunset" --download out.mp4 --verbose
 validations:
 required: true

 - type: textarea
 id: expected
 attributes:
 label: Expected behavior
 description: What should have happened?
 validations:
 required: true

 - type: textarea
 id: actual
 attributes:
 label: Actual behavior
 description: What happened instead?
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Error output

 Paste stderr as printed by `bl`. Include `Request ID` when present — it helps us trace logs.

 - type: textarea
 id: full-output
 attributes:
 label: Full output
 description: Error, Hint, Status, Request ID, Exit code, etc.
 render: shell
 placeholder: |
 Error: Generation completed but no images returned.
 Hint: ...
 Status: HTTP 200 (...)
 Request ID: ...
 Exit code: 1
 validations:
 required: true

 - type: textarea
 id: json-error
 attributes:
 label: JSON error (optional)
 description: "Re-run with --output json and paste the error object if available"
 render: json
 placeholder: |
 {
 "error": {
 "code": 1,
 "message": "...",
 "http_status": 200,
 "api_code": "...",
 "request_id": "..."
 }
 }

 - type: markdown
 attributes:
 value: |
 ## Troubleshooting already tried

 - type: checkboxes
 id: already-tried
 attributes:
 label: Already tried
 options:
 - label: "bl update and skill version aligned with CLI"
 - label: "bl auth status OK for this command"
 - label: "Different network / region — still reproduces"

 - type: markdown
 attributes:
 value: |
 ## Additional context

 - type: dropdown
 id: frequency
 attributes:
 label: How often does this happen?
 options:
 - Always
 - Intermittent
 - Once
 validations:
 required: true

 - type: dropdown
 id: invoked-via
 attributes:
 label: How was bl invoked?
 options:
 - Terminal (manual)
 - Agent (Cursor, Claude, etc.)
 - CI / script
 - Other
 validations:
 required: true

 - type: textarea
 id: notes
 attributes:
 label: Notes (optional)
 description: Anything else that might help — related issues, screenshots, minimal repro repo, etc.

14 changes: 7 additions & 7 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -171,14 +171,14 @@ Config file location: `~/.bailian/config.json`

## Links

| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |

## Changelog

Expand Down

14 changes: 7 additions & 7 deletions
README.zh.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -166,14 +166,14 @@ bl update

## 相关链接

| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |

## 更新日志

Expand Down

14 changes: 14 additions & 0 deletions
skills/bailian-cli/SKILL.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -8,6 +8,7 @@ description: >-
 vision, TTS/ASR, file upload, app call, memory, knowledge RAG, web search, model list.
 **LOCAL FILES**: commands accepting URLs also accept local paths — auto-upload built-in; never ask for URLs.
 Full command reference: `reference/index.md` + `reference/<group>.md` in this skill directory.
 When `bl` fails with a likely CLI bug (not usage/auth/quota/model-not-found), ask whether to report — see `assets/issue-reporting.md`.
---

# Aliyun Model Studio CLI (`bl`)
Expand DownExpand Up@@ -211,6 +212,19 @@ bl config export-schema --command "image generate"

---

## CLI errors: report an issue

When a `bl` command **fails** and the cause is **not** a user/service-side error (usage, auth, quota, content filter, model not found, invalid parameters, obvious local env), ask the user **once** whether to report a bug to the Bailian CLI team.

1. Classify the failure using [`assets/issue-reporting.md`](assets/issue-reporting.md) (EXCLUDE vs INCLUDE tables).
2. If INCLUDE matches, ask the user (Chinese prompt in that doc). If they agree, collect environment info, redact secrets, fill the issue template, and submit to https://github.com/modelstudioai/cli/issues (browser or `gh issue create`).
3. Before offering: align skill/CLI versions and retry with `--verbose` / `--output json` when output is thin.
4. Do **not** ask in CI or when `--non-interactive` is set unless the user explicitly wants to report.

Full workflow, redaction rules, template, and exit-code reference: [`assets/issue-reporting.md`](assets/issue-reporting.md).

---

## Priority reminders

- Text → `bl text chat`, not other LLM APIs.
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default");
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: add agent-guided issue reporting workflow and bug report template#43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

XXPermanentXX
merged 3 commits into

from

Jun 12, 2026
 Merged


feat: add agent-guided issue reporting workflow and bug report template
#43
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
f687175

docs: add comprehensive issue reporting documentation


hopelynd Jun 10, 2026
5137257

docs: move issue reporting documentation to assets folder


hopelynd Jun 10, 2026
6a0d39c

refactor(docs): clean up issue reporting guidelines formatting


hopelynd Jun 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


185 changes: 185 additions & 0 deletions
.github/ISSUE_TEMPLATE/bug_report.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
name: Bug Report
description: Report a bug in bailian-cli (bl)
title: "[bug]: "
labels:
 - bug
body:
 - type: markdown
 attributes:
 value: |
 Thanks for taking the time to report a bug.

 **Before submitting:** search [open issues](https://github.com/modelstudioai/cli/issues?q=is%3Aissue+is%3Aopen) for duplicates.

 **Security:** redact API keys (`sk-...`), console tokens, internal URLs, and business prompts before pasting output.

 - type: markdown
 attributes:
 value: |
 ## Environment

 - type: input
 id: cli-version
 attributes:
 label: CLI version
 description: "Output of bl --version (use only X.Y.Z, without the bl prefix)"
 placeholder: "1.2.1"
 validations:
 required: true

 - type: input
 id: skill-version
 attributes:
 label: Skill version (optional)
 description: "metadata.version from the installed bailian-cli skill, if applicable"
 placeholder: "1.2.1"

 - type: input
 id: node-version
 attributes:
 label: Node version
 description: "Output of node --version"
 placeholder: "v22.12.0"
 validations:
 required: true

 - type: input
 id: os
 attributes:
 label: OS
 description: "e.g. darwin 24.5.0, Ubuntu 22.04"
 placeholder: "darwin 24.5.0"
 validations:
 required: true

 - type: dropdown
 id: region
 attributes:
 label: Region
 description: "From bl auth status or bl config show"
 options:
 - cn
 - us
 - intl
 - unknown
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Reproduction

 - type: textarea
 id: reproduce-command
 attributes:
 label: Command to reproduce
 description: "Exact command that failed. Redact --api-key, sk-..., and sensitive prompts."
 render: shell
 placeholder: |
 bl video generate --prompt "sunset" --download out.mp4 --verbose
 validations:
 required: true

 - type: textarea
 id: expected
 attributes:
 label: Expected behavior
 description: What should have happened?
 validations:
 required: true

 - type: textarea
 id: actual
 attributes:
 label: Actual behavior
 description: What happened instead?
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Error output

 Paste stderr as printed by `bl`. Include `Request ID` when present — it helps us trace logs.

 - type: textarea
 id: full-output
 attributes:
 label: Full output
 description: Error, Hint, Status, Request ID, Exit code, etc.
 render: shell
 placeholder: |
 Error: Generation completed but no images returned.
 Hint: ...
 Status: HTTP 200 (...)
 Request ID: ...
 Exit code: 1
 validations:
 required: true

 - type: textarea
 id: json-error
 attributes:
 label: JSON error (optional)
 description: "Re-run with --output json and paste the error object if available"
 render: json
 placeholder: |
 {
 "error": {
 "code": 1,
 "message": "...",
 "http_status": 200,
 "api_code": "...",
 "request_id": "..."
 }
 }

 - type: markdown
 attributes:
 value: |
 ## Troubleshooting already tried

 - type: checkboxes
 id: already-tried
 attributes:
 label: Already tried
 options:
 - label: "bl update and skill version aligned with CLI"
 - label: "bl auth status OK for this command"
 - label: "Different network / region — still reproduces"

 - type: markdown
 attributes:
 value: |
 ## Additional context

 - type: dropdown
 id: frequency
 attributes:
 label: How often does this happen?
 options:
 - Always
 - Intermittent
 - Once
 validations:
 required: true

 - type: dropdown
 id: invoked-via
 attributes:
 label: How was bl invoked?
 options:
 - Terminal (manual)
 - Agent (Cursor, Claude, etc.)
 - CI / script
 - Other
 validations:
 required: true

 - type: textarea
 id: notes
 attributes:
 label: Notes (optional)
 description: Anything else that might help — related issues, screenshots, minimal repro repo, etc.

14 changes: 7 additions & 7 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -171,14 +171,14 @@ Config file location: `~/.bailian/config.json`

## Links

| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |

## Changelog

Expand Down

14 changes: 7 additions & 7 deletions
README.zh.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -166,14 +166,14 @@ bl update

## 相关链接

| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |

## 更新日志

Expand Down

14 changes: 14 additions & 0 deletions
skills/bailian-cli/SKILL.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -8,6 +8,7 @@ description: >-
 vision, TTS/ASR, file upload, app call, memory, knowledge RAG, web search, model list.
 **LOCAL FILES**: commands accepting URLs also accept local paths — auto-upload built-in; never ask for URLs.
 Full command reference: `reference/index.md` + `reference/<group>.md` in this skill directory.
 When `bl` fails with a likely CLI bug (not usage/auth/quota/model-not-found), ask whether to report — see `assets/issue-reporting.md`.
---

# Aliyun Model Studio CLI (`bl`)
Expand DownExpand Up@@ -211,6 +212,19 @@ bl config export-schema --command "image generate"

---

## CLI errors: report an issue

When a `bl` command **fails** and the cause is **not** a user/service-side error (usage, auth, quota, content filter, model not found, invalid parameters, obvious local env), ask the user **once** whether to report a bug to the Bailian CLI team.

1. Classify the failure using [`assets/issue-reporting.md`](assets/issue-reporting.md) (EXCLUDE vs INCLUDE tables).
2. If INCLUDE matches, ask the user (Chinese prompt in that doc). If they agree, collect environment info, redact secrets, fill the issue template, and submit to https://github.com/modelstudioai/cli/issues (browser or `gh issue create`).
3. Before offering: align skill/CLI versions and retry with `--verbose` / `--output json` when output is thin.
4. Do **not** ask in CI or when `--non-interactive` is set unless the user explicitly wants to report.

Full workflow, redaction rules, template, and exit-code reference: [`assets/issue-reporting.md`](assets/issue-reporting.md).

---

## Priority reminders

- Text → `bl text chat`, not other LLM APIs.
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers");
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
feat: add agent-guided issue reporting workflow and bug report template#43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

XXPermanentXX
merged 3 commits into

from

Jun 12, 2026
 Merged


feat: add agent-guided issue reporting workflow and bug report template
#43
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
f687175

docs: add comprehensive issue reporting documentation


hopelynd Jun 10, 2026
5137257

docs: move issue reporting documentation to assets folder


hopelynd Jun 10, 2026
6a0d39c

refactor(docs): clean up issue reporting guidelines formatting


hopelynd Jun 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


185 changes: 185 additions & 0 deletions
.github/ISSUE_TEMPLATE/bug_report.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
name: Bug Report
description: Report a bug in bailian-cli (bl)
title: "[bug]: "
labels:
 - bug
body:
 - type: markdown
 attributes:
 value: |
 Thanks for taking the time to report a bug.

 **Before submitting:** search [open issues](https://github.com/modelstudioai/cli/issues?q=is%3Aissue+is%3Aopen) for duplicates.

 **Security:** redact API keys (`sk-...`), console tokens, internal URLs, and business prompts before pasting output.

 - type: markdown
 attributes:
 value: |
 ## Environment

 - type: input
 id: cli-version
 attributes:
 label: CLI version
 description: "Output of bl --version (use only X.Y.Z, without the bl prefix)"
 placeholder: "1.2.1"
 validations:
 required: true

 - type: input
 id: skill-version
 attributes:
 label: Skill version (optional)
 description: "metadata.version from the installed bailian-cli skill, if applicable"
 placeholder: "1.2.1"

 - type: input
 id: node-version
 attributes:
 label: Node version
 description: "Output of node --version"
 placeholder: "v22.12.0"
 validations:
 required: true

 - type: input
 id: os
 attributes:
 label: OS
 description: "e.g. darwin 24.5.0, Ubuntu 22.04"
 placeholder: "darwin 24.5.0"
 validations:
 required: true

 - type: dropdown
 id: region
 attributes:
 label: Region
 description: "From bl auth status or bl config show"
 options:
 - cn
 - us
 - intl
 - unknown
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Reproduction

 - type: textarea
 id: reproduce-command
 attributes:
 label: Command to reproduce
 description: "Exact command that failed. Redact --api-key, sk-..., and sensitive prompts."
 render: shell
 placeholder: |
 bl video generate --prompt "sunset" --download out.mp4 --verbose
 validations:
 required: true

 - type: textarea
 id: expected
 attributes:
 label: Expected behavior
 description: What should have happened?
 validations:
 required: true

 - type: textarea
 id: actual
 attributes:
 label: Actual behavior
 description: What happened instead?
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Error output

 Paste stderr as printed by `bl`. Include `Request ID` when present — it helps us trace logs.

 - type: textarea
 id: full-output
 attributes:
 label: Full output
 description: Error, Hint, Status, Request ID, Exit code, etc.
 render: shell
 placeholder: |
 Error: Generation completed but no images returned.
 Hint: ...
 Status: HTTP 200 (...)
 Request ID: ...
 Exit code: 1
 validations:
 required: true

 - type: textarea
 id: json-error
 attributes:
 label: JSON error (optional)
 description: "Re-run with --output json and paste the error object if available"
 render: json
 placeholder: |
 {
 "error": {
 "code": 1,
 "message": "...",
 "http_status": 200,
 "api_code": "...",
 "request_id": "..."
 }
 }

 - type: markdown
 attributes:
 value: |
 ## Troubleshooting already tried

 - type: checkboxes
 id: already-tried
 attributes:
 label: Already tried
 options:
 - label: "bl update and skill version aligned with CLI"
 - label: "bl auth status OK for this command"
 - label: "Different network / region — still reproduces"

 - type: markdown
 attributes:
 value: |
 ## Additional context

 - type: dropdown
 id: frequency
 attributes:
 label: How often does this happen?
 options:
 - Always
 - Intermittent
 - Once
 validations:
 required: true

 - type: dropdown
 id: invoked-via
 attributes:
 label: How was bl invoked?
 options:
 - Terminal (manual)
 - Agent (Cursor, Claude, etc.)
 - CI / script
 - Other
 validations:
 required: true

 - type: textarea
 id: notes
 attributes:
 label: Notes (optional)
 description: Anything else that might help — related issues, screenshots, minimal repro repo, etc.

14 changes: 7 additions & 7 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -171,14 +171,14 @@ Config file location: `~/.bailian/config.json`

## Links

| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |

## Changelog

Expand Down

14 changes: 7 additions & 7 deletions
README.zh.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -166,14 +166,14 @@ bl update

## 相关链接

| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |

## 更新日志

Expand Down

14 changes: 14 additions & 0 deletions
skills/bailian-cli/SKILL.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -8,6 +8,7 @@ description: >-
 vision, TTS/ASR, file upload, app call, memory, knowledge RAG, web search, model list.
 **LOCAL FILES**: commands accepting URLs also accept local paths — auto-upload built-in; never ask for URLs.
 Full command reference: `reference/index.md` + `reference/<group>.md` in this skill directory.
 When `bl` fails with a likely CLI bug (not usage/auth/quota/model-not-found), ask whether to report — see `assets/issue-reporting.md`.
---

# Aliyun Model Studio CLI (`bl`)
Expand DownExpand Up@@ -211,6 +212,19 @@ bl config export-schema --command "image generate"

---

## CLI errors: report an issue

When a `bl` command **fails** and the cause is **not** a user/service-side error (usage, auth, quota, content filter, model not found, invalid parameters, obvious local env), ask the user **once** whether to report a bug to the Bailian CLI team.

1. Classify the failure using [`assets/issue-reporting.md`](assets/issue-reporting.md) (EXCLUDE vs INCLUDE tables).
2. If INCLUDE matches, ask the user (Chinese prompt in that doc). If they agree, collect environment info, redact secrets, fill the issue template, and submit to https://github.com/modelstudioai/cli/issues (browser or `gh issue create`).
3. Before offering: align skill/CLI versions and retry with `--verbose` / `--output json` when output is thin.
4. Do **not** ask in CI or when `--non-interactive` is set unless the user explicitly wants to report.

Full workflow, redaction rules, template, and exit-code reference: [`assets/issue-reporting.md`](assets/issue-reporting.md).

---

## Priority reminders

- Text → `bl text chat`, not other LLM APIs.
Expand Down
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode");
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
feat: add agent-guided issue reporting workflow and bug report template#43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

XXPermanentXX
merged 3 commits into

from

Jun 12, 2026
 Merged


feat: add agent-guided issue reporting workflow and bug report template
#43
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


3 commits


Select commit
Hold shift + click to select a range
f687175

docs: add comprehensive issue reporting documentation


hopelynd Jun 10, 2026
5137257

docs: move issue reporting documentation to assets folder


hopelynd Jun 10, 2026
6a0d39c

refactor(docs): clean up issue reporting guidelines formatting


hopelynd Jun 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


185 changes: 185 additions & 0 deletions
.github/ISSUE_TEMPLATE/bug_report.yml

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,185 @@
name: Bug Report
description: Report a bug in bailian-cli (bl)
title: "[bug]: "
labels:
 - bug
body:
 - type: markdown
 attributes:
 value: |
 Thanks for taking the time to report a bug.

 **Before submitting:** search [open issues](https://github.com/modelstudioai/cli/issues?q=is%3Aissue+is%3Aopen) for duplicates.

 **Security:** redact API keys (`sk-...`), console tokens, internal URLs, and business prompts before pasting output.

 - type: markdown
 attributes:
 value: |
 ## Environment

 - type: input
 id: cli-version
 attributes:
 label: CLI version
 description: "Output of bl --version (use only X.Y.Z, without the bl prefix)"
 placeholder: "1.2.1"
 validations:
 required: true

 - type: input
 id: skill-version
 attributes:
 label: Skill version (optional)
 description: "metadata.version from the installed bailian-cli skill, if applicable"
 placeholder: "1.2.1"

 - type: input
 id: node-version
 attributes:
 label: Node version
 description: "Output of node --version"
 placeholder: "v22.12.0"
 validations:
 required: true

 - type: input
 id: os
 attributes:
 label: OS
 description: "e.g. darwin 24.5.0, Ubuntu 22.04"
 placeholder: "darwin 24.5.0"
 validations:
 required: true

 - type: dropdown
 id: region
 attributes:
 label: Region
 description: "From bl auth status or bl config show"
 options:
 - cn
 - us
 - intl
 - unknown
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Reproduction

 - type: textarea
 id: reproduce-command
 attributes:
 label: Command to reproduce
 description: "Exact command that failed. Redact --api-key, sk-..., and sensitive prompts."
 render: shell
 placeholder: |
 bl video generate --prompt "sunset" --download out.mp4 --verbose
 validations:
 required: true

 - type: textarea
 id: expected
 attributes:
 label: Expected behavior
 description: What should have happened?
 validations:
 required: true

 - type: textarea
 id: actual
 attributes:
 label: Actual behavior
 description: What happened instead?
 validations:
 required: true

 - type: markdown
 attributes:
 value: |
 ## Error output

 Paste stderr as printed by `bl`. Include `Request ID` when present — it helps us trace logs.

 - type: textarea
 id: full-output
 attributes:
 label: Full output
 description: Error, Hint, Status, Request ID, Exit code, etc.
 render: shell
 placeholder: |
 Error: Generation completed but no images returned.
 Hint: ...
 Status: HTTP 200 (...)
 Request ID: ...
 Exit code: 1
 validations:
 required: true

 - type: textarea
 id: json-error
 attributes:
 label: JSON error (optional)
 description: "Re-run with --output json and paste the error object if available"
 render: json
 placeholder: |
 {
 "error": {
 "code": 1,
 "message": "...",
 "http_status": 200,
 "api_code": "...",
 "request_id": "..."
 }
 }

 - type: markdown
 attributes:
 value: |
 ## Troubleshooting already tried

 - type: checkboxes
 id: already-tried
 attributes:
 label: Already tried
 options:
 - label: "bl update and skill version aligned with CLI"
 - label: "bl auth status OK for this command"
 - label: "Different network / region — still reproduces"

 - type: markdown
 attributes:
 value: |
 ## Additional context

 - type: dropdown
 id: frequency
 attributes:
 label: How often does this happen?
 options:
 - Always
 - Intermittent
 - Once
 validations:
 required: true

 - type: dropdown
 id: invoked-via
 attributes:
 label: How was bl invoked?
 options:
 - Terminal (manual)
 - Agent (Cursor, Claude, etc.)
 - CI / script
 - Other
 validations:
 required: true

 - type: textarea
 id: notes
 attributes:
 label: Notes (optional)
 description: Anything else that might help — related issues, screenshots, minimal repro repo, etc.

14 changes: 7 additions & 7 deletions
README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -171,14 +171,14 @@ Config file location: `~/.bailian/config.json`

## Links

| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Resource | URL |
| :--------------------------- | :---------------------------------------------------------------------------------------- |
| Aliyun Model Studio CLI Site | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API Docs | https://help.aliyun.com/zh/model-studio/ |
| Qwen Model List | https://help.aliyun.com/zh/model-studio/getting-started/models |
| Aliyun Model Studio Console | https://bailian.console.aliyun.com/?source_channel=cli_github |
| Get API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |
| Get AccessKey | https://ram.console.aliyun.com/manage/ak |

## Changelog

Expand Down

14 changes: 7 additions & 7 deletions
README.zh.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -166,14 +166,14 @@ bl update

## 相关链接

| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 资源 | 地址 |
| :---------------------- | :---------------------------------------------------------------------------------------- |
| 阿里云百炼 CLI 官方主页 | https://bailian.console.aliyun.com/cli?source_channel=cli_github& |
| DashScope API 文档 | https://help.aliyun.com/zh/model-studio/ |
| 通义千问模型列表 | https://help.aliyun.com/zh/model-studio/getting-started/models |
| 阿里云百炼控制台 | https://bailian.console.aliyun.com/?source_channel=cli_github |
| 获取 API Key | https://bailian.console.aliyun.com/cn-beijing/?source_channel=key_github&tab=app#/api-key |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |
| 获取 AccessKey | https://ram.console.aliyun.com/manage/ak |

## 更新日志

Expand Down

14 changes: 14 additions & 0 deletions
skills/bailian-cli/SKILL.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -8,6 +8,7 @@ description: >-
 vision, TTS/ASR, file upload, app call, memory, knowledge RAG, web search, model list.
 **LOCAL FILES**: commands accepting URLs also accept local paths — auto-upload built-in; never ask for URLs.
 Full command reference: `reference/index.md` + `reference/<group>.md` in this skill directory.
 When `bl` fails with a likely CLI bug (not usage/auth/quota/model-not-found), ask whether to report — see `assets/issue-reporting.md`.
---

# Aliyun Model Studio CLI (`bl`)
Expand DownExpand Up@@ -211,6 +212,19 @@ bl config export-schema --command "image generate"

---

## CLI errors: report an issue

When a `bl` command **fails** and the cause is **not** a user/service-side error (usage, auth, quota, content filter, model not found, invalid parameters, obvious local env), ask the user **once** whether to report a bug to the Bailian CLI team.

1. Classify the failure using [`assets/issue-reporting.md`](assets/issue-reporting.md) (EXCLUDE vs INCLUDE tables).
2. If INCLUDE matches, ask the user (Chinese prompt in that doc). If they agree, collect environment info, redact secrets, fill the issue template, and submit to https://github.com/modelstudioai/cli/issues (browser or `gh issue create`).
3. Before offering: align skill/CLI versions and retry with `--verbose` / `--output json` when output is thin.
4. Do **not** ask in CI or when `--non-interactive` is set unless the user explicitly wants to report.

Full workflow, redaction rules, template, and exit-code reference: [`assets/issue-reporting.md`](assets/issue-reporting.md).

---

## Priority reminders

- Text → `bl text chat`, not other LLM APIs.
Expand Down
Loading