# 齐衡 QIHENG 支持策略

## 支持范围

齐衡公共分发包提供安装、检查、升级、卸载、项目画像、交付保障门禁、本体
证据和离线引导能力。支持的宿主包括 Codex、Claude Code、OpenCode、
MiMo Code、BitFun 以及兼容 Claude Code 文件协议的通用 Coding Agent。

正式支持以 npm `latest` 和当前文档声明为准。宿主未公开或频繁变化的目录
协议只能按兼容模式支持，企业部署应显式配置技能和子智能体目录。

## 支持层级

| 层级 | 适用场景 | 提供内容 |
| --- | --- | --- |
| 公共分发 | 功能了解和非生产验证 | README、FAQ、更新日志和公开问题跟踪 |
| 企业试点 | 有边界的内部验证 | 试点范围、基线配置、指标复盘和升级建议 |
| 企业生产 | 已签署商业协议 | 约定的维护窗口、响应目标、升级策略和私密渠道 |

公共分发和未签约试点不包含服务等级承诺。不要依据公开仓库文档推定生产
可用性、响应时间、赔偿或长期维护义务。

## 提交问题前

请先执行：

```text
qiheng doctor --json
qiheng catalog --json
qiheng harness-check --root . --json
node --version
npm --version
```

问题报告应包含：

- 齐衡版本、宿主名称和宿主版本。
- 请求能力包、依赖解析后的能力包，以及实际 Skills/SubAgents 数量。
- 操作系统、Node.js 版本、安装范围和实际安装目录。
- 已脱敏的命令、错误信息和最小复现步骤。
- 是否可以稳定复现，以及最近一次成功版本。
- 相关报告的结构和状态，但不要提交客户代码、密钥或个人信息。

## 兼容与升级

- Node.js 20 或更高版本是公共运行时基线。
- 两个 npm 包名必须保持相同版本和相同运行时载荷。
- 次版本可以增加向后兼容能力；破坏性契约变化必须提升主版本。
- 企业升级应先在基准仓库运行安装检查、画像、门禁和回滚演练。
- 能力包缩减只会自动移除未修改的受管组件；发现本地修改时会失败关闭，
  不得使用强制覆盖代替客户定制迁移。
- 不支持通过覆盖安装目录的方式维护本地定制；企业扩展应保存在独立适配器
  或策略层。

## 不在默认支持范围

- 第三方模型、编码智能体、代码托管平台或制品库自身的故障。
- 未经批准修改齐衡安装文件、运行时制品或证据格式造成的问题。
- 将模型结论直接作为合规认证、生产审批或法律意见。
- 未签约情况下的专属修复时限、驻场、数据恢复和灾难恢复承诺。