# 齐衡 QIHENG 企业落地指南 ## 当前结论 齐衡已经具备企业受控试点所需的跨宿主安装、项目画像、候选版本约束门禁、 设计—实现一致性修复、内容寻址证据和终态报告能力。它仍需要企业现有的身份、 权限、密钥、制品、审批和可观测平台提供生产信任根。 它应被定位为“设计、开发、测试与准入的交付保障执行层”，而不是另一个 聊天机器人，也不应以智能体数量作为商用价值指标。 商用产品本体是 21 个 Skills、19 个 SubAgents 以及它们之间的编排、交接、 权限和门禁契约。命令行、治理与签名能力服务于这套能力资产的安全分发和可信 运行，不是另起一套通用基础设施产品。正式产品范围见 [商用能力目录](CAPABILITIES.md)。 ## 四层企业架构 | 层 | 齐衡职责 | 企业集成点 | | --- | --- | --- | | 执行面 | 画像、门禁图、技能、子智能体、修复和验证 | 编码智能体、持续集成、代码仓库 | | 控制面 | 项目画像、适用性、门禁依赖和准入规则 | 单点登录、角色权限、审批、策略中心 | | 可信面 | 候选版本、内容哈希、台账和内容寻址证明 | 企业密钥、可信构建、不可变存储、时间戳 | | 价值面 | 交付决定、覆盖率、阻断原因和数字主线 | 研发效能、质量平台、风险和成本仪表盘 | 齐衡只实现与 Skills/SubAgents 执行直接相关的项目级控制：项目画像、候选 版本冻结、门禁依赖、内容寻址证据、失效传播和仓库准入。单点登录、企业审批、 密钥签名、合规判定和不可变存储由现有企业平台负责，并以外部证据引用接入， 避免在套件内维护一套不完整的通用治理平台。 ## 推荐部署模式 ### 受控试点 - 仅选择两个至三个非核心但具有真实复杂度的仓库。 - 使用项目级安装，锁定 npm 精确版本并从企业私有制品库分发。 - 默认采用 `full`；若受宿主上下文、权限或成本约束，则使用 `--pack` 安装 依赖闭包明确的能力包，并保存 `qiheng catalog --json` 作为采购与验收物料表。 - 默认只读；代码写入、命令执行、豁免和提交分别保留人工确认。 - 不输入生产密钥、客户数据、个人信息或受监管材料。 - 将画像、门禁结果和最终报告作为持续集成制品保存。 ### 部门推广 - 建立统一策略模板、模型与工具白名单、证据保留周期和升级窗口。 - 将门禁状态接入拉取请求或合并请求，但先以建议模式运行。 - 建立基准仓库回归集，监测误报、漏报、耗时和模型成本。 - 将高风险写操作与最终准入绑定到真实企业身份。 ### 生产规模化 - 使用单点登录、角色权限、职责分离和组织级策略下发。 - 使用托管构建、软件物料清单、制品签名和可验证来源证明。 - 将证据复制到不可变存储，并使用企业密钥签发最终凭证。 - 为运行轨迹、指标和日志建立统一可观测出口。 - 通过合同明确许可、数据处理、维护窗口、响应目标和责任边界。 ## 正式生产准入清单 以下项目任一未完成，都不应把“技术试点通过”表述为“企业商用就绪”： - [ ] 商业许可、数据条款、支持范围和责任边界已经书面确认。 - [ ] 安装包来自批准的私有制品库，版本被锁定并完成安全扫描。 - [ ] 发布来源、提交、构建身份、软件物料清单和签名可以验证。 - [ ] 模型供应商、区域、数据保留、训练使用和网络出口策略已批准。 - [ ] 密钥、个人信息、客户数据和受监管内容具备脱敏与防泄漏控制。 - [ ] 写操作、门禁豁免、最终准入和生产发布具有独立审批人。 - [ ] 证据保存到不可变存储，并能关联真实操作者和候选版本。 - [ ] 已完成升级、回滚、故障处理、日志保留和灾难恢复演练。 - [ ] 基准仓库验证了误报率、漏报风险、性能、成本和兼容性。 - [ ] 业务负责人认可试点指标和规模推广的退出条件。 上述清单应进入企业现有的采购、安全、身份、审批和发布制度。齐衡只在仓库 策略明确要求时记录这些外部决定的当前引用，不复制其账户、密钥或审批状态。 ## 试点指标 不要只汇报“19 个子智能体、21 个技能”。企业决策应至少观察： | 维度 | 建议指标 | | --- | --- | | 效率 | 需求到合并周期、评审轮次、人工复核时长、重复检查节省时间 | | 质量 | 设计偏差发现数、修复闭环率、缺陷逃逸率、回归失败率 | | 可信 | 证据覆盖率、过期证据阻断率、候选版本绑定率、审计可追溯率 | | 体验 | 安装成功率、画像准确率、门禁误报率、人工推翻率 | | 成本 | 单次交付模型成本、门禁耗时、制品与日志存储成本 | ## 九十天推进建议 1. **第 1—30 天：可控。** 完成法务决策、安全基线、私有制品库、基准仓库 和只读试点。 2. **第 31—60 天：可信。** 接入持续集成、企业身份、审批、签名和不可变 证据存储。 3. **第 61—90 天：可度量。** 上线质量与效能仪表盘，形成试点对照数据、 客户案例和规模推广决策。 ## 能力扩展原则 不要为了演示数字从 19 个子智能体扩张到 38 个。新增角色必须同时满足： - 存在独立风险假设和明确权限边界。 - 产生可验证且被下游消费的独立制品。 - 不能由现有角色或技能以更低成本完成。 - 有误报率、发现率、时延或风险降低指标。 - 不破坏职责分离和最小适用评审组原则。 更适合企业推广的方式是按项目画像启用“能力包”，例如安全、性能、可靠性、 数据合规和发布保障，而不是让所有项目运行全部角色。当前内置能力包为 `foundation`、`design`、`implementation`、`assurance` 和 `full`；新增能力包 必须先进入机器可读目录，再由安装器、体检和发布门禁共同校验。