HHostingByteSoftware
Ctrl K
ComunidadGuías…

docs/README.md

Rama main · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
# 文档地图

本目录只放开源项目需要公开维护的文档。官网内容、内部运维记录、临时调研报告不放进开源仓。

英文文档地图见 [README.en.md](README.en.md)。公开仓库中的中文主文档都应有英文 companion；内部说明和不进入开源包的运营材料不在此约束内。

## 开始使用

| 文档 | 用途 |
|---|---|
| [RELEASE_NOTES_v0.10.1.md](RELEASE_NOTES_v0.10.1.md) · [English](RELEASE_NOTES_v0.10.1.en.md) | v0.10.1：声明显式值保留、Core 优先级与实际配套包校验。 |
| [UPGRADE_v0.10.1.md](UPGRADE_v0.10.1.md) · [English](UPGRADE_v0.10.1.en.md) | 无新增 SQL；生成器/消费者配套、全量声明差异及回退边界。 |
| [RELEASE_NOTES_v0.10.0.md](RELEASE_NOTES_v0.10.0.md) · [English](RELEASE_NOTES_v0.10.0.en.md) | v0.10.0：知识按需读取、后台交互、大参数与模型预算。 |
| [UPGRADE_v0.10.0.md](UPGRADE_v0.10.0.md) · [English](UPGRADE_v0.10.0.en.md) | 相对 0.9.4 无新 SQL；readiness、配套客户端、显式策略与回退边界。 |
| [AGENT_KNOWLEDGE_API.md](AGENT_KNOWLEDGE_API.md) · [English](AGENT_KNOWLEDGE_API.en.md) | 智能体专用的知识提示、搜索、受授权引用与有界分页读取。 |
| [MODEL_OUTPUT_BUDGET.md](MODEL_OUTPUT_BUDGET.md) · [English](MODEL_OUTPUT_BUDGET.en.md) | 默认预算、服务上限、供应商参数与思考语义。 |
| [MODEL_CONTINUATION.md](MODEL_CONTINUATION.md) · [English](MODEL_CONTINUATION.en.md) | 宿主续段、原 operation 恢复和工具防重的责任边界。 |
| [IMPLEMENTATION_STATUS.md](IMPLEMENTATION_STATUS.md) · [English](IMPLEMENTATION_STATUS.en.md) | Core 能力归属、正式发行与主分支状态、公开证据和未覆盖范围。 |
| [RELEASE_NOTES_v0.9.4.md](RELEASE_NOTES_v0.9.4.md) · [English](RELEASE_NOTES_v0.9.4.en.md) | v0.9.4：DOCX 依赖处置、通知持久化与控制台补发。 |
| [UPGRADE_v0.9.4.md](UPGRADE_v0.9.4.md) · [English](UPGRADE_v0.9.4.en.md) | 068 显式迁移、状态/配置库、事件去重和回退限制。 |
| [NOTIFICATION_DURABILITY.md](NOTIFICATION_DURABILITY.md) · [English](NOTIFICATION_DURABILITY.en.md) | 通知保存、恢复、人工处置、持久指标和外部送达边界。 |
| [DOCX_DEPENDENCY.md](DOCX_DEPENDENCY.md) · [English](DOCX_DEPENDENCY.en.md) | 固定 Mammoth 库来源、CLI 链移除和严格审计。 |
| [RELEASE_NOTES_v0.9.3.md](RELEASE_NOTES_v0.9.3.md) · [English](RELEASE_NOTES_v0.9.3.en.md) | v0.9.3：有限收包、通知关闭与原通知死信重投，含维护指标。 |
| [UPGRADE_v0.9.3.md](UPGRADE_v0.9.3.md) · [English](UPGRADE_v0.9.3.en.md) | 067 显式迁移、配套 DLQ/state 仓储、回退 manifest 与标记保留。 |
| [RELEASE_NOTES_v0.9.2.md](RELEASE_NOTES_v0.9.2.md) · [English](RELEASE_NOTES_v0.9.2.en.md) | v0.9.2：安全安装、自动结算与原审批补续，含部署诊断与进程回归。 |
| [UPGRADE_v0.9.2.md](UPGRADE_v0.9.2.md) · [English](UPGRADE_v0.9.2.en.md) | 065/066显式迁移、配套仓储、原记录核对及回退限制。 |
| [CORE_RELIABILITY.md](CORE_RELIABILITY.md) · [English](CORE_RELIABILITY.en.md) | 安装凭据、结算/审批补续、有限收包、通知关闭/重投与合成验收边界。 |
| [RELEASE_NOTES_v0.9.1.md](RELEASE_NOTES_v0.9.1.md) · [English](RELEASE_NOTES_v0.9.1.en.md) | v0.9.1：异步 usage 关闭修复、公开能力索引与通用安全治理。 |
| [UPGRADE_v0.9.1.md](UPGRADE_v0.9.1.md) · [English](UPGRADE_v0.9.1.en.md) | 0.9.0 补丁升级、原请求核对、制品 manifest 与关闭验收；无新增 SQL/API。 |
| [RELEASE_NOTES_v0.9.0.md](RELEASE_NOTES_v0.9.0.md) · [English](RELEASE_NOTES_v0.9.0.en.md) | v0.9.0：可选模型计费、统一套餐额度与文生图工具。 |
| [UPGRADE_v0.9.0.md](UPGRADE_v0.9.0.md) · [English](UPGRADE_v0.9.0.en.md) | 从公开 0.8.0 升级、063/064 迁移及宿主按需接入。 |
| [MODEL_BILLING.md](MODEL_BILLING.md) · [English](MODEL_BILLING.en.md) | 模型与工具、参考价格、异步结算、账户归档和额度重置契约。 |
| [PERIOD_ALLOWANCE_UPGRADE.md](PERIOD_ALLOWANCE_UPGRADE.md) · [English](PERIOD_ALLOWANCE_UPGRADE.en.md) | 周期售价与额度拆分，以及已有计费预览快照的迁移。 |
| [RELEASE_NOTES_v0.8.0.md](RELEASE_NOTES_v0.8.0.md) · [English](RELEASE_NOTES_v0.8.0.en.md) | v0.8.0: long tasks, original receipts, attachments and upgrade boundaries. |
| [RELEASE_NOTES_v0.7.0.md](RELEASE_NOTES_v0.7.0.md) · [English](RELEASE_NOTES_v0.7.0.en.md) | v0.7.0：商城与库存场景、配套升级和限制。 |
| [user-guide/conversations.md](user-guide/conversations.md) | 普通用户的多账户对话、完整沟通追溯和离线恢复指南。 |
| [QUICKSTART.md](QUICKSTART.md) | 从零部署百灵中枢，适合准备接入真实业务系统的开发者。 |
| [QUICKSTART.en.md](QUICKSTART.en.md) | English quickstart for Docker demo, first route, and first business tool. |
| [DEMO.md](DEMO.md) | Docker demo 闭环：中枢、MySQL、demo 业务系统、工具源、审计与 trace。 |
| [DEMO.en.md](DEMO.en.md) | English Docker demo walkthrough. |
| [INDEPENDENT_VALIDATION.md](INDEPENDENT_VALIDATION.md) | 陌生开发者仅凭公开资料验证 Docker demo 的任务卡、通过标准与反馈方式。 |
| [INDEPENDENT_VALIDATION.en.md](INDEPENDENT_VALIDATION.en.md) | English independent validation task, pass criteria, and report path. |
| [AGENT_CLIENT_QUICKSTART.md](AGENT_CLIENT_QUICKSTART.md) | 智能体客户端从 Core、业务授权页、通用 SDK 到本地宿主插件的完整接入路径。 |
| [AGENT_CLIENT_QUICKSTART.en.md](AGENT_CLIENT_QUICKSTART.en.md) | English end-to-end Agent Client integration guide and configuration ownership. |
| [LOCAL_AGENT_SETUP.md](LOCAL_AGENT_SETUP.md) | 管理员四步集中配置：授权入口、系统说明、工具与审批、连接检查。 |
| [LOCAL_AGENT_SETUP.en.md](LOCAL_AGENT_SETUP.en.md) | English local-agent setup guide and narrow configuration APIs. |
| [AGENT_SYSTEM_INFO.md](AGENT_SYSTEM_INFO.md) | 首次能力搜索前的受控系统定位，包含授权绑定与兼容降级契约。 |
| [AGENT_SYSTEM_INFO.en.md](AGENT_SYSTEM_INFO.en.md) | English selected-system descriptions and host read contract. |
| [AGENT_SUBJECT_DISPLAY.md](AGENT_SUBJECT_DISPLAY.md) | 业务授权显示名称：三方职责、新授权与旧会话名称同步。 |
| [AGENT_AUTH_API.md](AGENT_AUTH_API.md) | Agent Auth v1：业务登录态绑定、PKCE、Token 交换与会话撤销的语言无关契约。 |
| [AGENT_AUTH_API.en.md](AGENT_AUTH_API.en.md) | English Agent Auth v1 protocol and trusted business-identity boundary. |
| [INVOCATION_RECEIPTS.md](INVOCATION_RECEIPTS.md) | 只读核对原调用、审批与执行日志；与可能继续业务的 resume 分开。 |
| [AGENT_CLIENT_RUNTIME_API.md](AGENT_CLIENT_RUNTIME_API.md) | Agent Client Runtime v1：工作区、turn、能力搜索、工具执行与完成回传。 |
| [AGENT_TASK_CONTROL.md](AGENT_TASK_CONTROL.md) · [English](AGENT_TASK_CONTROL.en.md) | Core 0.8.0：跨轮任务额度、实际派发、暂停及 SDK/DSH 宿主接入。 |
| [AGENT_CLIENT_RUNTIME_API.en.md](AGENT_CLIENT_RUNTIME_API.en.md) | English Agent Client Runtime v1 contract. |
| [AGENT_CONVERSATION_AUDIT.md](AGENT_CONVERSATION_AUDIT.md) | 完整可见对话审计：逐授权成员确认、幂等文本事件、run 关联和管理员分页读取。 |
| [AGENT_CONVERSATION_AUDIT.en.md](AGENT_CONVERSATION_AUDIT.en.md) | English complete conversation audit protocol and authorization boundary. |
| [user-guide/README.md](user-guide/README.md) | 使用者/产品经理视角：从业务需求出发，理解为什么需要中枢、后台菜单怎么配、配完交给开发者什么。 |
| [CONTRACT.md](CONTRACT.md) | 业务系统和中枢之间的稳定网络契约，接入前应先读。 |
| [CONTRACT.en.md](CONTRACT.en.md) | English HTTP and wire contract summary. |
| [第三方对接指南.md](第三方对接指南.md) | 业务侧如何暴露工具、验签、授权与返回结果。 |
| [INTEGRATION.en.md](INTEGRATION.en.md) | English third-party integration guide. |
| [WIDGET_RENDERERS.md](WIDGET_RENDERERS.md) | 聊天组件的可信富内容渲染扩展：图表、交互报告与安全降级。 |
| [WIDGET_RENDERERS.en.md](WIDGET_RENDERERS.en.md) | English trusted rich-content renderer extension for the chat widget. |
| [integrations/dify/README.md](integrations/dify/README.md) | Dify 通过 BailingHub `/run` 与 `/jobs/{job_id}` 发起受治理任务的最小接入配方。 |
| [integrations/dify/README.en.md](integrations/dify/README.en.md) | English Dify + BailingHub minimal integration recipe. |
| [integrations/deepseek/README.md](integrations/deepseek/README.md) | DeepSeek V4 通过 BailingHub 参与受治理业务动作的双语 E2E 配方。 |
| [integrations/deepseek/README.en.md](integrations/deepseek/README.en.md) | English DeepSeek V4 + BailingHub bilingual E2E recipe. |
| [integrations/bailian/README.md](integrations/bailian/README.md) | 阿里云百炼通过自定义 MCP 调用 BailingHub 受治理任务的最小接入配方。 |
| [integrations/bailian/README.en.md](integrations/bailian/README.en.md) | English Alibaba Cloud Model Studio + BailingHub custom MCP recipe. |
| [integrations/ruoyi-vue-pro/README.md](integrations/ruoyi-vue-pro/README.md) | RuoYi-Vue-Pro / 芋道源码售后查询与退款的权限保留型社区接入配方。 |
| [integrations/ruoyi-vue-pro/README.en.md](integrations/ruoyi-vue-pro/README.en.md) | English authority-preserving RuoYi-Vue-Pro after-sale and refund recipe. |
| [integrations/jeecgboot/README.md](integrations/jeecgboot/README.md) | JeecgBoot 用户查询与冻结/解冻的租户、权限和最终授权保留型社区接入配方。 |
| [integrations/jeecgboot/README.en.md](integrations/jeecgboot/README.en.md) | English authority-preserving JeecgBoot user read and freeze/unfreeze recipe. |

## 架构与模型

| 文档 | 职责边界 |
|---|---|
| [ARCHITECTURE.md](ARCHITECTURE.md) | 当前架构的主说明：分层、核心运行链路、解耦边界和扩展方向。 |
| [ARCHITECTURE.en.md](ARCHITECTURE.en.md) | English architecture overview. |
| [KERNEL_HOST_API.md](KERNEL_HOST_API.md) | 完整 Core 的版本化高层嵌入 API、托管生命周期和升级边界。 |
| [MODEL_PROCESS_RECOVERY.md](MODEL_PROCESS_RECOVERY.md) · [English](MODEL_PROCESS_RECOVERY.en.md) | 当前源码的 opt-in 进程崩溃/确认丢失回归；不回写历史 Tag 验证。 |
| [KERNEL_HOST_API.en.md](KERNEL_HOST_API.en.md) | English versioned Kernel Host API and lifecycle boundary. |
| [PIPELINE.md](PIPELINE.md) | 一次任务从入口到执行、审计、送达的流水线。 |
| [PIPELINE.en.md](PIPELINE.en.md) | English runtime pipeline. |

## 运行面能力

| 文档 | 用途 |
|---|---|
| [TOOLS_MODEL.md](TOOLS_MODEL.md) | 工具抽象模型：不同来源如何归一成中枢可治理的 ToolDefinition。 |
| [TOOLS_MODEL.en.md](TOOLS_MODEL.en.md) | English tool model. |
| [TOOLS_DESIGN.md](TOOLS_DESIGN.md) | 工具治理实现：白名单、风险、限流、审批、审计、签名。 |
| [TOOLS_DESIGN.en.md](TOOLS_DESIGN.en.md) | English tool governance design. |
| [AI友好工具设计指南.md](AI友好工具设计指南.md) | 业务接口如何设计成 AI 容易正确调用的工具。 |
| [AI_FRIENDLY_TOOLS.en.md](AI_FRIENDLY_TOOLS.en.md) | English AI-friendly tool design guide. |
| [TOOLS.en.md](TOOLS.en.md) | English business tool and governance guide. |
| [SDK.en.md](SDK.en.md) | English SDK guide for PHP, Node, Python, Java, Go, .NET, and any-language integration. |
| [CHANNELS.md](CHANNELS.md) | 入站渠道模型，当前包含企微接入。 |
| [CHANNELS.en.md](CHANNELS.en.md) | English inbound channel model. |
| [OPERATIONS.md](OPERATIONS.md) | 生产部署、多副本、健康检查、容量、备份与恢复。 |
| [DEPLOYMENT_DIAGNOSTICS.md](DEPLOYMENT_DIAGNOSTICS.md) · [English](DEPLOYMENT_DIAGNOSTICS.en.md) | 只读部署 doctor：公开身份核对、显式 readiness、未知与未检查状态及机器退出码。 |
| [OPERATIONS.en.md](OPERATIONS.en.md) | English production operations guide. |
| [STREAMING.md](STREAMING.md) | 网页聊天的真实增量输出协议：SSE 事件、断线重放、权威结果和多副本边界。 |
| [STREAMING.en.md](STREAMING.en.md) | English chat streaming protocol and operations boundary. |

## 发布与维护

| 文档 | 用途 |
|---|---|
| [ECOSYSTEM.md](ECOSYSTEM.md) | 社区发行版、独立实现、生态组件和未来官方展示的原则。 |
| [ECOSYSTEM.en.md](ECOSYSTEM.en.md) | English policy for derivatives, independent implementations, and ecosystem listings. |
| [RELEASE_NOTES_v0.1.1.md](RELEASE_NOTES_v0.1.1.md) | `v0.1.1` 聊天组件运营控制与接入边界修复说明。 |
| [RELEASE_NOTES_v0.1.1.en.md](RELEASE_NOTES_v0.1.1.en.md) | English `v0.1.1` release notes. |
| [RELEASE_NOTES_v0.1.2.md](RELEASE_NOTES_v0.1.2.md) | `v0.1.2` 服务端根 token 与派生凭证安全加固说明。 |
| [RELEASE_NOTES_v0.1.2.en.md](RELEASE_NOTES_v0.1.2.en.md) | English `v0.1.2` security hardening release notes. |
| [RELEASE_NOTES_v0.1.3.md](RELEASE_NOTES_v0.1.3.md) | `v0.1.3` 便携式执行器接入与 OpenClaw 适配说明。 |
| [RELEASE_NOTES_v0.1.3.en.md](RELEASE_NOTES_v0.1.3.en.md) | English `v0.1.3` portable executor onboarding and OpenClaw adapter release notes. |
| [RELEASE_NOTES_v0.1.4.md](RELEASE_NOTES_v0.1.4.md) | `v0.1.4` 网页聊天真实流式输出与可重连 SSE 说明。 |
| [RELEASE_NOTES_v0.1.4.en.md](RELEASE_NOTES_v0.1.4.en.md) | English `v0.1.4` real web chat streaming and reconnectable SSE release notes. |
| [RELEASE_NOTES_v0.1.5.md](RELEASE_NOTES_v0.1.5.md) | `v0.1.5` 一键安装参数可靠性与全新服务器兼容性说明。 |
| [RELEASE_NOTES_v0.1.5.en.md](RELEASE_NOTES_v0.1.5.en.md) | English `v0.1.5` installer reliability and clean-server compatibility release notes. |
| [RELEASE_NOTES_v0.1.6.md](RELEASE_NOTES_v0.1.6.md) | `v0.1.6` 独立验证路径与安装后权限提示说明。 |
| [RELEASE_NOTES_v0.1.6.en.md](RELEASE_NOTES_v0.1.6.en.md) | English `v0.1.6` independent-validation and post-install privilege-hint release notes. |
| [RELEASE_NOTES_v0.1.7.md](RELEASE_NOTES_v0.1.7.md) | `v0.1.7` 版本化 Client API 与跨生态兼容门禁说明。 |
| [RELEASE_NOTES_v0.1.7.en.md](RELEASE_NOTES_v0.1.7.en.md) | English `v0.1.7` versioned Client API and cross-ecosystem compatibility-gate release notes. |
| [RELEASE_NOTES_v0.1.8.md](RELEASE_NOTES_v0.1.8.md) | `v0.1.8` 首次管理员只创建一次与重启安全说明。 |
| [RELEASE_NOTES_v0.1.8.en.md](RELEASE_NOTES_v0.1.8.en.md) | English `v0.1.8` create-once initial-admin bootstrap release notes. |
| [RELEASE_NOTES_v0.1.9.md](RELEASE_NOTES_v0.1.9.md) | `v0.1.9` 可选 OpenMetrics 运维指标与安全抓取说明。 |
| [RELEASE_NOTES_v0.1.9.en.md](RELEASE_NOTES_v0.1.9.en.md) | English `v0.1.9` optional OpenMetrics operational metrics release notes. |
| [RELEASE_NOTES_v0.1.10.md](RELEASE_NOTES_v0.1.10.md) | `v0.1.10` 实例品牌设置、模型标识诊断与生态接入配方说明。 |
| [RELEASE_NOTES_v0.1.10.en.md](RELEASE_NOTES_v0.1.10.en.md) | English `v0.1.10` instance branding, model identifier diagnostics, and ecosystem recipe release notes. |
| [RELEASE_NOTES_v0.1.11.md](RELEASE_NOTES_v0.1.11.md) | `v0.1.11` 副作用执行日志与不确定结果冻结说明。 |
| [RELEASE_NOTES_v0.1.11.en.md](RELEASE_NOTES_v0.1.11.en.md) | English `v0.1.11` side-effect execution journal and uncertain-outcome freezing release notes. |
| [RELEASE_NOTES_v0.1.12.md](RELEASE_NOTES_v0.1.12.md) | `v0.1.12` 语音转写策略与失败关闭说明。 |
| [RELEASE_NOTES_v0.1.12.en.md](RELEASE_NOTES_v0.1.12.en.md) | English `v0.1.12` voice transcription policy and fail-closed audio handling release notes. |
| [RELEASE_NOTES_v0.1.13.md](RELEASE_NOTES_v0.1.13.md) | `v0.1.13` 语音转写与分发版本一致性说明。 |
| [RELEASE_NOTES_v0.1.13.en.md](RELEASE_NOTES_v0.1.13.en.md) | English `v0.1.13` voice transcription and distribution-version alignment release notes. |
| [RELEASE_NOTES_v0.1.14.md](RELEASE_NOTES_v0.1.14.md) | `v0.1.14` 流式对话阶段性进度提示说明。 |
| [RELEASE_NOTES_v0.1.14.en.md](RELEASE_NOTES_v0.1.14.en.md) | English `v0.1.14` transient progress feedback for streaming chat release notes. |
| [RELEASE_NOTES_v0.1.15.md](RELEASE_NOTES_v0.1.15.md) | `v0.1.15` 可信富内容渲染与聊天可靠性说明。 |
| [RELEASE_NOTES_v0.1.15.en.md](RELEASE_NOTES_v0.1.15.en.md) | English `v0.1.15` trusted rich rendering and chat reliability release notes. |
| [RELEASE_NOTES_v0.1.16.md](RELEASE_NOTES_v0.1.16.md) | `v0.1.16` 工具运行时收敛与语义检索韧性说明。 |
| [RELEASE_NOTES_v0.1.16.en.md](RELEASE_NOTES_v0.1.16.en.md) | English `v0.1.16` bounded tool runtime and resilient semantic retrieval release notes. |
| [RELEASE_NOTES_v0.2.0.md](RELEASE_NOTES_v0.2.0.md) | `v0.2.0` 工具清单访问保护与主动核验说明。 |
| [RELEASE_NOTES_v0.2.0.en.md](RELEASE_NOTES_v0.2.0.en.md) | English `v0.2.0` tool catalog access protection and active verification release notes. |
| [RELEASE_NOTES_v0.3.0.md](RELEASE_NOTES_v0.3.0.md) | `v0.3.0` 可组合 Core 与 Kernel Host API v1 说明。 |
| [RELEASE_NOTES_v0.3.0.en.md](RELEASE_NOTES_v0.3.0.en.md) | English `v0.3.0` composable Core and Kernel Host API v1 release notes. |
| [RELEASE_NOTES_v0.3.1.md](RELEASE_NOTES_v0.3.1.md) | `v0.3.1` PDF 解析安全更新说明。 |
| [RELEASE_NOTES_v0.3.1.en.md](RELEASE_NOTES_v0.3.1.en.md) | English `v0.3.1` PDF parsing security update. |
| [RELEASE_NOTES_v0.3.2.md](RELEASE_NOTES_v0.3.2.md) | `v0.3.2` 受管演示数据引导说明。 |
| [RELEASE_NOTES_v0.3.2.en.md](RELEASE_NOTES_v0.3.2.en.md) | English `v0.3.2` managed demo dataset onboarding. |
| [RELEASE_NOTES_v0.3.3.md](RELEASE_NOTES_v0.3.3.md) | `v0.3.3` npm 发布来源元数据纠偏说明。 |
| [RELEASE_NOTES_v0.3.3.en.md](RELEASE_NOTES_v0.3.3.en.md) | English `v0.3.3` npm publication provenance-metadata correction. |
| [RELEASE_NOTES_v0.3.4.md](RELEASE_NOTES_v0.3.4.md) | `v0.3.4` 匿名预览与可信业务身份引导说明。 |
| [RELEASE_NOTES_v0.3.4.en.md](RELEASE_NOTES_v0.3.4.en.md) | English `v0.3.4` anonymous-preview and trusted-business-identity guidance. |
| [RELEASE_NOTES_v0.5.0.md](RELEASE_NOTES_v0.5.0.md) | `v0.5.0` 可撤销本地 Agent 授权与受治理本地编排说明。 |
| [RELEASE_NOTES_v0.5.0.en.md](RELEASE_NOTES_v0.5.0.en.md) | English `v0.5.0` revocable local-Agent authorization and governed local planning release notes. |
| [RELEASE_NOTES_v0.5.1.md](RELEASE_NOTES_v0.5.1.md) | `v0.5.1` 智能体客户端管理中心与批量写操作配置说明。 |
| [RELEASE_NOTES_v0.5.1.en.md](RELEASE_NOTES_v0.5.1.en.md) | English `v0.5.1` Agent Client management center and bulk write-operation configuration release notes. |
| [RELEASE_NOTES_v0.6.1.md](RELEASE_NOTES_v0.6.1.md) | `v0.6.1` 看完整沟通，再追到每次业务操作；配套多授权客户端升级。 |
| [RELEASE_NOTES_v0.6.0.md](RELEASE_NOTES_v0.6.0.md) | `v0.6.0` 看完整沟通，再追到每次业务操作；配套多授权客户端升级。 |
| [RELEASE_NOTES_v0.6.1.en.md](RELEASE_NOTES_v0.6.1.en.md) | English `v0.6.1` release notes and upgrade guide. |
| [RELEASE_NOTES_v0.6.0.en.md](RELEASE_NOTES_v0.6.0.en.md) | English `v0.6.0` release notes and upgrade guide. |
| [RELEASE_NOTES_v0.1.0.md](RELEASE_NOTES_v0.1.0.md) | 首个公开版本的 GitHub Release 草稿。 |
| [RELEASE_NOTES_v0.1.0.en.md](RELEASE_NOTES_v0.1.0.en.md) | English release notes. |
| [CHANGELOG.md](CHANGELOG.md) | 公开发布后的对外变更记录。 |
| [CHANGELOG.en.md](CHANGELOG.en.md) | English changelog. |
| [兼容性与升级.md](兼容性与升级.md) | SemVer、数据库迁移、契约稳定性和升级纪律。 |
| [COMPATIBILITY.en.md](COMPATIBILITY.en.md) | English compatibility and upgrade policy. |

## 维护纪律

- 新文档必须能归入上面某一类；如果归不进去，先判断是否只是临时讨论材料。
- 同一主题只保留一个主文档，其余文档必须说明自己是架构、契约、运行能力还是接入指南。
- 内部决策记录、发布演练、官网/控制台 UX 规范放 `internal/`，不进入公开分发物。
- 对外契约变更必须同步 [CONTRACT.md](CONTRACT.md)、SDK 示例和 [CHANGELOG.md](CHANGELOG.md)。