# Anybackup V9 Architecture Charter

> Anybackup V9 Architecture Charter is an Agent Skill for documents published in the anybackup-ai/Anybackup repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

维护 AnyBackup V9 的纲领性架构对齐规则。用于在设计、实现、评审、打包、部署或文档修订时，对齐 `E:\Code\aa-feat\docs\05-技术架构` 的目标架构，特别是 Kubernetes/VKE 部署基线、Anybackup Agent 与 Foundation 的系统边界、Agent 侧中间件职责、Core Agent Service 与 KWeaver Core 的职责分层，以及 `E:\Code\kweaver-core\deploy` 中的 KWeaver Core 上游部署资产。

- Skill name: `anybackup-v9-architecture-charter`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/anybackup-ai/Anybackup/blob/HEAD/deploy/deploy_package/.skills/anybackup-v9-architecture-charter/SKILL.md
- Repository: anybackup-ai/Anybackup (263 GitHub stars when collected)

## SKILL.md

# Anybackup V9 Architecture Charter

## Overview

这个 skill 是 AnyBackup V9 的“总纲”，先回答“这次改动应该对齐成什么样”，再把具体实现交给细分 skill。它的目标不是替代部署细节，而是防止实现、文档和上游组件接入把长期架构边界写乱。

## First Reads

- 先读 `references/source-map.md`，按任务类型选择最小必要文档集合。
- 如果任务涉及服务代码仓、镜像构建、Helm Chart 归位、版本号或团队交付物收口，优先读：
  - `E:\Code\script\anybackup-agent-release\docs\00_设计文档\01_V9服务仓库交付规范.md`
- 如果任务涉及总体边界、组件归位或术语统一，优先读：
  - `E:\Code\aa-feat\docs\05-技术架构\架构总览.md`
  - `E:\Code\aa-feat\docs\05-技术架构\架构设计\部署架构设计.md`
- 如果任务涉及 AI 协作链路、Core Agent Service 或 KWeaver 接入，额外读：
  - `E:\Code\aa-feat\docs\05-技术架构\核心智能体服务\Core Agent Service-架构设计.md`
  - `E:\Code\aa-feat\docs\05-技术架构\核心智能体服务\KWeaver Core SDK能力说明.md`
- 如果任务涉及 KWeaver Core 的安装、裁剪或嵌入式部署，额外读：
  - `E:\Code\kweaver-core\deploy\README.zh.md`
  - `E:\Code\kweaver-core\deploy\deploy.sh`
  - `E:\Code\kweaver-core\deploy\scripts\services\core.sh`
  - `E:\Code\kweaver-core\deploy\scripts\services\k8s.sh`

## Charter

1. `E:\Code\aa-feat\docs\05-技术架构` 是目标架构事实来源。
   - 当前仓库实现如果与这些文档不一致，优先收敛实现。
   - 如果短期做不到，明确标成“版本差异”或“过渡方案”，不要把临时实现混成长期架构基线。
2. `AnyBackup V9` 的整体边界固定为三段：
   - `Anybackup Agent`：SaaS 侧决策、协作与治理运行时
   - `Anybackup Foundation`：用户数据中心内的执行链路
   - `Anybackup Client`：被保护资产侧采集层
3. `KWeaver Core` 是 `AnyBackup V9` 的一个组件，不是重定义系统边界的独立产品。
   - 在 V9 里，它属于 SaaS 侧 AI 能力面。
   - 对外口径上，`Core Agent Service + KWeaver Core` 共同构成统一 AI 能力面。
4. 默认部署基线是标准 `k8s` / `VKE`。
   - 不把 `k3s`、单节点集群或某个现场运维习惯写成产品默认前提。
5. `Redis`、`PostgreSQL`、`RabbitMQ`、`OpenSearch` 只属于 `Anybackup Agent` 侧。
   - 不把这四件套写成 `Foundation` 侧基础设施。
6. 运行期协作链路固定为：
   - 正向：`5 个业务 Service -> RabbitMQ -> Core Agent Service -> KWeaver Core`
   - 反向：`KWeaver Core / Decision Agent -> Skill / CLI -> 业务 Service 或 Foundation 执行链路`
7. `Core Agent Service` 是内部事件消费、能力映射与 SDK 转发层。
   - 不是北向业务 Web API。
   - 不是 5 个业务 Service 之一。
   - 运行期不应让业务 Service 直接依赖 KWeaver SDK。
8. 最终收包交付必须遵守 `docs/00_设计文档/01_V9服务仓库交付规范.md`。
   - 一个可部署服务必须同时交付代码、`Dockerfile`、仓内 Helm Chart 和统一健康检查约定。
   - 只有 Chart、没有代码和 Dockerfile 的仓库，不视为可收货的最终服务仓。

## KWeaver Deployment Position

- `E:\Code\kweaver-core\deploy` 是 `KWeaver Core` 的上游部署入口，要把它当作组件部署事实来源。
- 上游 deploy 默认会处理：
  - 单节点 Kubernetes
  - `local-path`
  - `ingress-nginx`
  - MariaDB、Redis、Kafka、ZooKeeper、OpenSearch 等依赖
- 集成到 AnyBackup V9 时，不要无意识照搬这些默认值。
  - 先判断哪些能力由 V9 集群统一提供。
  - 再决定哪些安装步骤需要关闭、绕开、保留还是延后。
- 优先采用“渲染配置 + 调用上游入口”的方式对接 KWeaver 部署，不要随意 fork `E:\Code\kweaver-core\deploy` 的脚本逻辑，除非用户明确要求。
- 如果上游 deploy 的默认行为会覆盖 V9 的集群、存储、Ingress 或中间件边界，先收口边界，再落实现。

## Working Mode

1. 先判断任务类型：
   - 架构对齐
   - 部署/打包落地
   - KWeaver 集成
   - 文档回写
2. 按最小必要集合读取架构文档、ADR 和上游 deploy 资产。
3. 先检查是否触碰以下硬边界：
   - SaaS 与 Foundation 的部署边界
   - AI 决策与业务执行边界
   - Agent 侧中间件职责边界
   - `Core Agent Service` 与 `KWeaver Core` 的分层
   - KWeaver 上游 deploy 默认值与 V9 所有权边界
4. 再决定具体工作由谁承接：
   - 中间件：`v9-middleware-deployer`
   - KWeaver 集成：`kweaver-core-integrator`
   - 发布包：`v9-release-packager`
   - 验收：`v9-deployment-verifier`

## Conflict Handling

- 默认冲突优先级：
  1. 已确认 ADR
  2. 专项架构设计文档
  3. `架构总览.md`
  4. 当前仓库实现
- 如果 `E:\Code\kweaver-core\deploy` 与 V9 目标架构冲突，不要直接把上游实现当最终答案。
  - 先保留上游作为组件部署事实。
  - 再通过配置、编排顺序和边界裁剪把它纳入 V9。
- 只有当用户明确说“实现现状就是新基线”时，才把文档对齐方向反过来。

## Guardrails

- 不要把临时 MVP 做法写成长期架构原则。
- 不要把平台外运维工具链当成产品运行时组件。
- 不要把 Foundation 设备认证混进 `Auth Service`；Foundation 控制面与接入链路应按架构文档走 `Platform Governance` 与网关链路。
- 不要把 KWeaver 本地 CLI、TUI 或 SKILL 入口误写成 `Core Agent Service` 的运行期主依赖；服务内主依赖应保持在 SDK 与资源能力层。
- 不要只因为上游 deploy 自带某项依赖，就自动认定它属于 V9 的正式边界。

## Done Criteria

- 改动后的设计、脚本、chart、Ansible 或文档，与 `E:\Code\aa-feat\docs\05-技术架构` 一致，或者差异被明确标记为版本差异。
- `KWeaver Core` 被清晰表述为 `AnyBackup V9` 的组成组件，并有明确的部署归位方式。
- 系统边界、调用边界、中间件边界和部署边界没有互相打架。
- 实现说明、部署入口和文档术语使用的是同一套口径。

---

Source: https://www.openparable.com/skill/documents/anybackup-v9-architecture-charter (OpenParable). Cite the canonical URL above.