chengfeng-report-bug

1# 上报 Bug
2 
3这是 `chengfeng-videocut` 的支持入口，不是第三条剪辑流程。默认只生成公开 Issue 草稿；外部写入必须经过脱敏预览与用户确认。
4 
5```text
6问题描述
7   |
8   v
9最小只读诊断 -> 脱敏 -> 展示仓库 / 标题 / 正文
10                                  |
11                           用户明确确认
12                                  |
13                                  v
14                     认证 + 标签检查 + 查重
15                                  |
16                                  v
17                         创建 GitHub Issue
18```
19 
20## 1. 确认这是可复现 Bug
21 
22先区分：
23 
24- Bug：实际行为偏离已有契约、界面、版本能力或确定性结果。
25- 功能建议：产品从未承诺该能力；不要伪装成 Bug。
26- 使用疑问：先回答或诊断，不自动上报。
27 
28只收集复现所需的最小事实。不得安装 Runtime、启动 Studio、改项目、重新剪片或上传媒体来“补证据”。Runtime 存在时，可从插件根目录执行 `node scripts/ensure-runtime.cjs --json` 做只读探测，只保留 `state / kind / version / healthy / error.code`；不要附完整 doctor 输出。`kind=desktop-managed` 只表示安装来源是桌面 App，不授权本 Skill 启动 App、服务或重新安装。不存在就写“未检测到”。
29 
30## 2. 选择固定仓库
31 
32工作区根目录不一定是 Git 仓库，禁止从当前目录猜 remote：
33 
34| 问题组件 | target | GitHub 仓库 |
35|---|---|---|
36| Runtime、Studio、UI、CLI、API、时间线、渲染 | `product` | `Agentchengfeng/chengfeng-videocut` |
37| Skill、Marketplace、安装编排、MCP App、工作流说明 | `skills` | `Agentchengfeng/chengfeng-videocut-skills` |
38 
39跨组件问题优先报最先违反契约的仓库，并在正文说明另一个组件；无法判断时先问用户。
40 
41## 3. 生成结构化输入
42 
43以 `umask 077` 把候选写入当前任务临时目录的 JSON，不写产品规范文件；提交结束后删除临时 JSON 与 Markdown：
44 
45```json
46{
47  "schemaVersion": 1,
48  "target": "product",
49  "component": "Studio",
50  "title": "Runtime 0.1.1 无法打开 HyperFrames 顶层剪口播视图",
51  "summary": "一句话说明影响",
52  "steps": ["第一步", "第二步"],
53  "expected": "预期行为",
54  "actual": "实际行为",
55  "environment": {
56    "Runtime": "0.1.1",
57…