@c4a/context-cli 0.7.4 → 0.7.8

package/indexers/bundles/context-note-indexer/templates/articles/d04.md

@@ -0,0 +1,21 @@
+---
+id: context.article.d04
+kind: procedure
+media-type: text/markdown
+---
+
+# D04 运维与排障入口
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：有维护脚本、配置、指标注册或已保存的 SOP／事件记录。
+
+建议章节：**运行与环境 → 配置定位 → 日志／指标／追踪 → 常见现象与诊断路径 → 恢复／回滚 → 验证依据**。
+
+表格列：问题／配置类别、代码使用点、查询入口、适用环境、下一步。平台标识不等于当前配置值，存在监控调用不等于告警已配置。读取脚本可以产生文档，不代表获得执行线上操作的授权。
+
+**工程基础设施／研发规范变体**：承接技术基础设施、研发规范和后端构建部署资料。章节为 **工程边界 → 构建与测试入口 → 环境和交付 → 兼容与研发约定 → 排障定位**。有独立维护资料且内容足够时单独成篇；否则并入服务运行说明。操作事实、团队规范和 Agent 建议分清来源，不遗漏后端工程知识，也不复制前端命令。
+
+## 图示选择
+
+工程交付或故障诊断用 flowchart TD；部署依赖图仅在有实际配置依据时采用。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/f01.md

@@ -0,0 +1,19 @@
+---
+id: context.article.f01
+kind: procedure
+media-type: text/markdown
+---
+
+# F01 架构
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：已定位启动入口与关键运行边界。
+
+建议章节：**架构总览 → 技术栈与运行方式 → 启动与分层 → 关键横切能力 → 部署边界 → 相关入口**。
+
+内容：启动／挂载文件、宿主与子应用职责、路由／状态／请求层的连接、跨层引用。架构图的每条边须有配置、调用或文档依据；历史设计原因需决策材料，不能从当前实现推断。远程模块身份不等于宿主身份。
+
+## 图示选择
+
+架构章节用 flowchart LR，按启动、宿主和请求层分组，每条边有来源。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/f06.md

@@ -0,0 +1,19 @@
+---
+id: context.article.f06
+kind: procedure
+media-type: text/markdown
+---
+
+# F06 类型模型
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：DTO、请求／响应、View Model 或生成类型的映射对理解应用有价值。
+
+建议章节：**类型来源与生成边界 → 核心类型 → 页面与 API 类型链路 → 转换及兼容约束 → 修改入口**。
+
+表格列：类型名、类别、关键字段语义、使用位置、权威来源；链路表列页面／能力、View Model、Request、Response、转换函数。仅保留稳定且被使用的类型；完整声明仍留源码或契约引用，不恢复长段 Source type declaration。
+
+## 图示选择
+
+类型目录优先表格；转换关系用 flowchart，不把 DTO 直接画成数据库实体。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/f08.md

@@ -0,0 +1,21 @@
+---
+id: context.article.f08
+kind: procedure
+media-type: text/markdown
+---
+
+# F08 样式与设计系统
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：存在影响页面开发的主题、token、样式覆盖或组件库接入规则。
+
+建议章节：**使用的组件库与设计系统 → 样式组织 → Token 与主题 → 覆盖顺序和隔离 → 响应式／可访问性 → 调整入口与示例**。
+
+保留 token 身份、定义／消费位置、配置与维护示例。响应式断点、无障碍保证和颜色语义需代码／规范支持。设计稿与代码不一致时标明版本，不从截图猜 Props 或 token。
+
+本篇负责应用如何消费和覆盖；系统自身的规范、基础资源和跨平台映射归 L03 独立设计系统模板。一组 CSS 变量不足以证明存在完整设计系统；没有系统资料时仍可写真实样式入口。
+
+## 图示选择
+
+token 定义/覆盖可用 flowchart；实际颜色或响应式外观使用授权来源图，代码不证明视觉效果。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/f09.md

@@ -0,0 +1,19 @@
+---
+id: context.article.f09
+kind: procedure
+media-type: text/markdown
+---
+
+# F09 构建与部署
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+生成条件：有项目拥有的脚本、工程配置或交付文档。
+
+建议章节：**开发前提 → 本地启动与调试 → 构建入口及产物 → 环境选择 → 发布与回滚入口 → 常见定位点**。
+
+命令来自 scripts／维护文档；说明包与执行目录、配置生效位置、产物身份。已存在发布脚本不等于线上已部署；仓库证据不足的真实平台值不补写。公共工程规则由一篇父级指南承载，子应用只写差异。
+
+## 图示选择
+
+构建交付顺序用 flowchart；命令和前提保留文字，步骤计划不代表执行回执。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/l01.md

@@ -0,0 +1,23 @@
+---
+id: context.article.l01
+kind: procedure
+media-type: text/markdown
+---
+
+# L01 公共能力与使用指南
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**用途和适用场景 → 支持的导入／命令 → 初始化及前提 → 能力分组 → 维护示例 → 兼容与修改入口**。
+
+能力表列：能力身份、入口、使用方、对应契约和示例。SDK 初始化、CLI 参数与插件注册各用已有专门模板；不复制源码中所有 export。可补分层架构、provider／middleware 和维护约定，但必须服务具体读者任务。
+
+## 公共组件与设计系统的专用标准
+
+L02 公共组件 已独立细化建议章节、家族、Props／事件／方法／Ref、示例与行为变体。非 UI 的公共 API 仍沿用对应 SDK／CLI 程序模板与 L01 的消费原则，不强套 UI 的样式／焦点章节。
+
+L03 设计系统 独立覆盖系统入口、基础规范、主题接入和平台版本关系，避免缩成组件库的一小段颜色说明。
+
+## 图示选择
+
+接入调用有顺序要求时用 sequenceDiagram；命令/签名用表格，模块层次用 text 树。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/l02.md

@@ -0,0 +1,88 @@
+---
+id: context.article.l02
+kind: procedure
+media-type: text/markdown
+---
+
+# L02 公共组件与组件家族
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+### 身份与拆页条件
+
+先确认包／公开入口、组件名、平台、适用版本、稳定或弃用状态。仓内共享组件如果有明确跨模块消费契约，即使未发布 npm，也可按公共组件处理；单纯 export、放在 components/ 或出现在演示站不构成公共性证明。
+
+默认按读者会选择和使用的能力成页。主组件、仅供其使用的 part、配置类型及辅助 hook 可以同页；独立公共能力、独立运行契约或明显不同平台再拆。静态方法不是第二个 SDK，Props 类型不是另一篇组件文章。
+
+Toast 类家族可以先给成员选择表，再按成员或调用方式分节；复杂家族可以保留一篇入口和少量详情。不因为导出多个符号就强制多页，也不因同名而合并不同平台、包版本和 deprecated 实现。
+
+### 默认文章结构
+
+以下八个章节角色和顺序稳定。1、2、4、8 是基本阅读责任；其他章节按事实适用性出现。没有资料支撑的示例可以只保留维护示例入口和具体缺失前提，不能补造行为。
+
+```markdown
+# <组件或家族名称>
+> 包与导入入口 · 平台 · 适用版本 · 维护状态
+
+## 用途与选用
+## 接入与基本用法
+## 典型场景与变体
+## API
+## 行为与组合规则
+## 样式与设计系统
+## 运行环境、可访问性与限制
+## 相关组件与源码入口
+```
+
+| 章节 | 应回答什么 | 内容形式与证据 |
+| --- | --- | --- |
+| 用途与选用 | 解决什么界面任务；与相近组件如何区分 | 简短用途；家族成员／选型表；产品语义来自维护说明或用法，不能按组件名发明设计建议 |
+| 接入与基本用法 | 怎么导入、先配置什么、最少怎样使用 | 精确 import／entry、必要 Provider／CSS 链接、最小有来源示例；示例依赖不能只存在于演练场隐藏 scope |
+| 典型场景与变体 | 哪些选择会改变使用方式 | 场景→相关 API→预期表现→示例；按行为差异选取，不枚举所有颜色和大小的笛卡尔积 |
+| API | 消费者能传什么、调用什么、收到什么 | 下述分类契约表；公共关键配置类型可在本节局部解释，规范信息只维护一份 |
+| 行为与组合规则 | 状态谁控制、如何交互、配置如何叠加 | 受控／非受控、回调、数据结构、覆盖顺序、关闭／清理、组合约束；具体内容由组件能力决定 |
+| 样式与设计系统 | 哪些是组件可覆盖项、哪些来自全局系统 | 变体、尺寸、slot、token、逻辑方向等具体差异；公共基础规范链接到设计系统，不整篇复制 |
+| 运行环境、可访问性与限制 | 在什么条件下可用、有什么已知边界 | SSR／Portal／宿主／移动端限制；已证实键盘、焦点、role、对比度相关行为；实际测试与静态观察区分 |
+| 相关组件与源码入口 | 继续查哪里、换用谁、哪份证据支持本页 | 相关能力、实现／类型／示例／文档定位，明确证据版本；关键行为的定位尽量贴近对应章节 |
+
+章节可以有组件特定的小节，例如“选择后是否关闭”“清理时机”“嵌套分组”。固定公共章节不要求把每个组件的业务特点改成相同文案，也不改变事实的原有语义。
+
+### API 分组规范
+
+| 类别 | 默认列 | 适用条件 |
+| --- | --- | --- |
+| Props／属性 | 名称、类型、必填、默认或取值来源、语义／约束 | 公共输入属性；仅展示一次，不混入 export-entry 伪属性 |
+| 事件／回调 | 名称、参数、触发时机、与状态的关系 | callback 也是 prop 时用链接或合并行，避免两份定义漂移 |
+| 方法／静态 API | 名称、签名或参数、返回、生命周期／清理 | show/destroy 等公开方法；不能只打印 JSDoc 一段字符串 |
+| Ref／命令式句柄 | 获取方式、公开成员、何时可用、失效／清理 | 有 ref/handle 契约时，函数类型需保留有效签名 |
+| 子组件／slot／part | 身份、放置位置、组合限制、独立 API | 公开复合组件，不将仅内部渲染函数列为消费者可用 |
+| Hook | 调用前提、参数、返回、Provider／生命周期依赖 | 有明确公共契约时；独立用途较大可另用公共库参考 |
+| 关键配置类型 | 判别字段、各分支必需项、嵌套项、关联 API | 对象数组、union、group/item、受约束配置等对用法必要时 |
+
+**类型必须可理解。** 保留 union 成员、数组元素、泛型和函数参数。无法解析的类型给准确别名与权威定义入口，不能渲染成 `{}` 后当作完整契约。不递归展开整个 React、宿主上下文或基础库类型树。
+
+**默认值必须有来源。** 区分参数默认、运行时分支默认、继承环境与文档声明。同版本事实矛盾时说明冲突并回查，不能用大量 `unknown` 遮住已知默认；未声明的默认不能猜成 false／undefined。正文与 API 表不能给相互冲突的确定值。
+
+继承属性优先“来源链接＋本组件差异／覆盖”；仅在独立消费必须时展开必要字段。配置类型用于解释约束，不在表后再次粘贴完整原始声明。少量无法由表表达的签名可以保留，声明压缩后的正确性需要核验。
+
+### 不同组件能力的章节变体
+
+| 能力形态 | 必须额外表达的有效信息 |
+| --- | --- |
+| 展示型 | 内容与截断、尺寸／外观变体；不能强造状态管理章节 |
+| 可交互／表单型 | 受控关系、输入输出、禁用与只读、校验、触发时机；不要混淆视觉禁用和实际阻止事件 |
+| 浮层型 | trigger、Portal root、定位／碰撞、开合、dismiss、焦点、安全区与层级；已证实的环境差异 |
+| 数据／复合型 | item/group 判别结构、部件组合、全局与局部配置优先级、选择后的动作 |
+| 命令式型 | 初始化上下文、show/update/destroy 等实际公开方法、返回句柄、排队／替换、卸载与资源清理 |
+
+这些是同一标准模板的条件章节，不是新增 Provider。一个组件同时满足多个形态时组合使用，语义信息只写一次。
+
+### 示例标准
+
+默认一个可说明基本用法的维护示例，再按独立行为补必要案例；没有固定六个示例或每个 Prop 一个示例的要求。命令式与声明式都是公开用法时，分别保留入口。至少覆盖会改变消费方式的关键分支，而非只提供装饰性按钮 demo。
+
+示例需标明原始文件／故事／官网来源及适用版本。摘取时保留必需 import、状态回写、Provider 和样式前提；允许省略重复的演示布局，不能删掉决定行为的控制代码。引用已有例子不等于本轮实际运行通过。官方示例若与目标版本不匹配，先记录版本差异，不能直接覆盖代码契约。
+
+## 图示选择
+
+公开 parts 层级用 text 树；有证据的受控交互或命令式生命周期用 sequenceDiagram/状态图；外观用授权示例图。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/l03.md

@@ -0,0 +1,66 @@
+---
+id: context.article.l03
+kind: procedure
+media-type: text/markdown
+---
+
+# L03 设计系统及基础规范
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+### 来源和归属
+
+有维护的设计规范、token 源或稳定的跨组件约定时启用。规范文档由 Markdown、实现与 token 由 Code 提供，各自保留来源职责；混合知识通过现有授权主题和引用组合，不新增一个同时吞设计、代码和运行态的通用 Provider。
+
+只有 token 或静态资源材料时，采用“基础资源参考”对应变体，给定义、别名、消费和修改入口；没有规范证据不补设计目标，也不将其标题或内容包装成完整设计系统。仅文档规范则可以独立成文，不以存在组件源码为前置。
+
+不能只由组件源码推断设计意图，也不能将设计图中的名称直接当作当前程序 API。平台、设计规范版本、组件包版本、资源版本分开记录。同名组件在 Web、原生与其他跨端实现中的属性不应互相覆盖。
+
+### 系统入口文章
+
+```markdown
+# <设计系统>
+## 目标与适用范围
+## 平台、软件包与版本
+## 基础规范地图
+## 组件与交互模式
+## 主题及运行配置
+## 采用、定制与迁移
+## 权威资源与维护入口
+```
+
+| 章节 | 必要内容 |
+| --- | --- |
+| 目标与适用范围 | 来自规范的设计目标、覆盖产品／平台范围、与组件库的关系；不虚构品牌原则 |
+| 平台、软件包与版本 | 平台、实现包／入口、设计规范版本、维护状态、文档和源码；不同版本状态分别列 |
+| 基础规范地图 | 已有的颜色、字体／排版、间距、布局／断点、圆角、阴影／层级、动效、图标／插画等主题及入口 |
+| 组件与交互模式 | 组件分类、组合模式、相近能力的选择依据；实际组件 API 链接 L02 |
+| 主题及运行配置 | 默认主题、上下文、局部覆盖、暗色／高对比、方向和响应式的实现边界 |
+| 采用、定制与迁移 | 按平台的接入导航、允许的扩展方式、已有迁移指引和版本差异；不复制安装全篇 |
+| 权威资源与维护入口 | 规范、设计资源、token 定义／生成、实现和维护说明，区分已读取与仅有导航链接 |
+
+### 基础规范专题变体
+
+同一模板按主题拆分 **colors、typography、spacing-layout、elevation、motion、icons-assets** 等文章；只生成有材料和独立阅读价值的主题。
+
+建议章节为 **用途与语义 → 分类／token 目录 → 命名及对应关系 → 消费方式 → 组合与适用规则 → 平台／主题差异 → 来源与修改入口**。
+
+Token 表列：语义名、层级（基础／语义／组件）、定义或别名指向、平台／主题、消费标识、来源。别名引用不等于当前运行值；生成映射要保留权威源和产物关系。颜色十六进制、字号或时长不是唯一重点，必须让读者理解用途与替换边界。
+
+图标／插画专题需说明资源包、命名、取得和渲染方式、镜像／方向或平台差异、定制约束；不是将每张 SVG 都变成一篇组件 Props 页。存在静态资源指南时保留它的使用入口。
+
+### 主题与运行接入专题变体
+
+建议章节为 **环境与 Provider → 全局配置 → 继承与局部覆盖 → CSS／资源加载顺序 → SSR／Hydration → 多端、方向与高对比 → 验证与排查入口**。
+
+只对有证据的技术机制成文。某个组件默认跟随上下文，不能简化为全系统固定常量；只有 Web 样本不能推断原生平台一致。可访问性应区分规范要求、实现行为和验证记录，不能仅靠 token 名称推定合规。
+
+### 分篇与去重
+
+系统内容较少时，上述内容在一篇系统入口中组织；规范丰富时采用“系统入口＋基础主题＋运行接入＋迁移”的菜单。它们是 L03 下不同阅读主题／文章计划，不是每个组件再生成一套设计系统。
+
+L05 组件库 说明实现包如何接入；L02 组件 只写组件特有 token／覆盖差异；F08 应用样式 只写该应用的消费和局部定制。三处通过链接连接，公共规范保持单一权威承载。
+
+## 图示选择
+
+token 别名/主题继承用 flowchart，系统资源目录用 text 树；颜色/排版/动效引用有来源视觉材料，不用关系图冒充视觉规范。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/l04.md

@@ -0,0 +1,17 @@
+---
+id: context.article.l04
+kind: procedure
+media-type: text/markdown
+---
+
+# L04 中间件、适配与运行模式
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**扩展边界 → 注册及执行顺序 → 输入输出与上下文 → 与宿主／下游的协作 → 错误和清理 → 使用／测试入口**。
+
+只输出有维护意义的中间件、服务协作和代码约定，不把某个私有实现提升为团队规范。事件执行器沿用 S07，网关适配沿用现有 request-adaptation-guide。
+
+## 图示选择
+
+注册、调用和清理用 sequenceDiagram，宿主/扩展边界用 flowchart；不将声明顺序推断为运行顺序。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/l05.md

@@ -0,0 +1,36 @@
+---
+id: context.article.l05
+kind: procedure
+media-type: text/markdown
+---
+
+# L05 组件库总览与接入
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+用于一个明确面向消费者的组件集合、公共业务组件包或多个相关实现包的入口。它与 L02 单组件文章分开，也不将站点自身的演示组件当成库的公共组件。
+
+默认章节：
+
+```markdown
+# <组件库>
+## 定位与适用平台
+## 软件包、版本与维护状态
+## 安装与全局接入
+## 组件分类与选择导航
+## 公共配置、资源与设计系统
+## 兼容、迁移与已知限制
+## 示例、文档与源码入口
+```
+
+包表列：包／子入口、用途、平台、适用版本、维护状态、文档与源码。主入口、deprecated 子入口、图标／颜色资源包分别说明，不能以相近名字混成一套版本。
+
+接入须根据维护资料给依赖前提、CSS／reset 顺序、Provider、环境配置和一个最小消费入口。局部组件页链接本篇并提示必要前提，不重复整份安装指南。配置包含全局与局部优先级时保留其证据。
+
+组件目录按用途／交互任务／正式分类组织，记录公共名称、家族、导入入口、摘要、详情或源码。单组件尚不足以独立成文也应在目录有入口。仅公共类型或 helper 可以在相应能力下承载，不独立制造空页。
+
+规模较小时总览与接入合一；多平台或接入复杂时分总览、quick-start、组件地图、迁移等文章。页面数由阅读边界决定。L05 可采用 C01 的索引结构，但同一库只有一个主入口，不能重复生成同义的 C01/L01/L05 三篇概览。
+
+## 图示选择
+
+包与能力目录用 text 树或表格；真实包依赖用 flowchart，链接组件详情和系统图。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/q01.md

@@ -0,0 +1,17 @@
+---
+id: context.article.q01
+kind: procedure
+media-type: text/markdown
+---
+
+# Q01 测试域概览
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**业务范围 → 系统与能力 → 测试资料导航 → 开发知识关联 → 工具入口**。
+
+目录可用 business-info、test-plans、regression、tools；多业务线差异显著时可 common + 业务线分层。共同能力只有一份，导航链接只指向现有页面。纯资料目录可并入有明确阅读任务的概览，不为每个空分类生成文章。
+
+## 图示选择
+
+测试资料入口用 text 树；系统范围图复用已有开发知识，不另造系统关系。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/q02.md

@@ -0,0 +1,19 @@
+---
+id: context.article.q02
+kind: procedure
+media-type: text/markdown
+---
+
+# Q02 测试策略
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**目标与边界 → 测试分层 → 覆盖维度 → 风险与回归选择 → 准入准出依据 → 协作方式**。
+
+代码和已有文档可支持风险判断，但正式门禁、优先级和团队分工需权威来源。Agent 建议的测试策略单独注明为建议，不写成已经执行或团队既定规定。
+
+**单次变更测试方案变体**：章节为 **变更对象与版本 → 影响面和场景 → 环境与数据 → 执行及回归安排 → 结果记录入口**。用于真实测试方案材料，与长期测试策略区分；安排不是执行回执。
+
+## 图示选择
+
+测试分层/覆盖可用 flowchart；长期策略与单次执行安排分别标明，图不证明通过。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/q03.md

@@ -0,0 +1,17 @@
+---
+id: context.article.q03
+kind: procedure
+media-type: text/markdown
+---
+
+# Q03 用例目录
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**范围与来源 → 按能力分组的场景表 → 前置条件和数据 → 自动化入口 → 相关需求／缺陷**。
+
+场景表列：场景、输入／动作、预期结果、来源类别、脚本／正式用例链接、关联代码。正式用例、源码测试、代码推导候选必须区分；没有运行记录不得写“通过”。目录定位完整不等于覆盖率达标。
+
+## 图示选择
+
+用例场景优先表格；分支组合复杂时用 flowchart，区分正式用例与推导候选。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/q04.md

@@ -0,0 +1,17 @@
+---
+id: context.article.q04
+kind: procedure
+media-type: text/markdown
+---
+
+# Q04 回归基线
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**适用版本 → 冒烟集 → 变更影响与回归集 → 执行前提 → 结果记录入口**。
+
+表格列：能力／风险、场景集、适用环境／区域、选用依据、执行回执。业务变更导致的测试范围可以建议；P0 全过、准出结论和实际失败数必须来自测试记录。
+
+## 图示选择
+
+回归选择用 flowchart，场景集和执行回执用表格；没有记录不画成已通过流程。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/q05.md

@@ -0,0 +1,17 @@
+---
+id: context.article.q05
+kind: procedure
+media-type: text/markdown
+---
+
+# Q05 测试数据与环境
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**数据需求 → 准备入口 → 环境和隔离条件 → 数据生命周期 → 验证和清理**。
+
+保留脚本、配置、测试数据模板及适用前提。静态 fixture、造数程序和真实账号是不同材料；只说明取得数据的方法，不复制实际凭证。某脚本存在不代表当前账号有权限运行。
+
+## 图示选择
+
+数据准备/使用/清理用 flowchart；环境依赖有来源才画，不包含真实凭证。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/q06.md

@@ -0,0 +1,17 @@
+---
+id: context.article.q06
+kind: procedure
+media-type: text/markdown
+---
+
+# Q06 工具与排障工具箱
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**任务到工具 → 接入前提 → 常用操作 → 结果解释 → 对应代码／文档入口**。
+
+表格列：问题、工具／平台、定位所需信息、来源、下一步。查询坐标和已有操作说明可发布；没有平台材料时不能猜参数。复用同一工具正文，避免 tools/ 与 references/ 两份重复维护。
+
+## 图示选择
+
+问题到工具的选择用 flowchart；参数、前提和结果解释保留文字或表格。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/q07.md

@@ -0,0 +1,17 @@
+---
+id: context.article.q07
+kind: procedure
+media-type: text/markdown
+---
+
+# Q07 缺陷模式与复盘
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**现象与适用范围 → 触发条件 → 已知根因 → 诊断证据 → 修复和验证 → 防复发检查**。
+
+跨事件归纳需多个有来源的案例；单次经验保留其范围。C05 可作为模块排障入口并链接本篇；Note／Sessions 中后续纠正优先反映到原主题，不同时保留相互冲突的确定结论。
+
+## 图示选择
+
+已确认事故过程可用 sequenceDiagram/flowchart；根因、修复、验证与猜测分开，不用完整图掩盖缺证据。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/s01.md

@@ -0,0 +1,17 @@
+---
+id: context.article.s01
+kind: procedure
+media-type: text/markdown
+---
+
+# S01 服务概览
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**服务定位 → 接入和启动 → 架构分层 → 核心能力／接口 → 模型与依赖摘要 → 知识索引 → 源码位置**。
+
+最低证据：注册、bootstrap／handler、运行身份或稳定调用边界。索引列主题、用途、目标；摘要链接详细文章，不复制全部字段和接口表。代码中名为 Service 的类不自动满足服务分类。
+
+## 图示选择
+
+架构摘要用 flowchart LR；概览链接专业图，不复制全部接口执行链。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/s04.md

@@ -0,0 +1,21 @@
+---
+id: context.article.s04
+kind: procedure
+media-type: text/markdown
+---
+
+# S04 领域模型
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**领域范围 → 实体与概念表 → 核心实体 → 已证实关系 → 状态与转移 → 业务约束 → 实现和相关资料**。
+
+实体表列：业务／代码身份、角色（实体、值对象、事件、DTO）、关键字段、来源；转移表列当前状态、动作／条件、目标状态、执行位置。
+
+领域实体、传输 DTO、持久化表必须区分；领域知识不足时可只保留“代码对象与定位”，不宣称已完整建模。ER 图需要关系证据，状态机需要转移证据；只有 Status 字段时不能生成统一 Active 自循环。没有关系的实体目录使用表格，无需画假 ER 图。
+
+前端也可采用本模板表达有依据的页面实体与约束，服务端规则通过链接引用。没有实体或状态问题的服务不生成空页。
+
+## 图示选择
+
+概念关系用 flowchart，持久实体关系有证据才用 erDiagram；状态转移用 stateDiagram-v2，不能由枚举推导。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/s05.md

@@ -0,0 +1,17 @@
+---
+id: context.article.s05
+kind: procedure
+media-type: text/markdown
+---
+
+# S05 数据模型
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**存储职责 → 表／集合与持久化对象 → 查询和索引依据 → 缓存／锁 → 事务与一致性 → 读写入口**。
+
+表格列：实体／表、字段或键、定义位置、主要读写者、索引／TTL 来源。每种存储仅在发现证据时出现；未找到数据库使用不等于证明全系统无数据库。区别 ORM 声明、迁移 DDL、实际线上 schema；逻辑关联不能直接标成数据库外键。结构可引用契约正文，不展开全部长类型声明。
+
+## 图示选择
+
+数据关系用 erDiagram，基数和关联均须有证据；字段/索引/TTL 用表格，读写链可单独用 flowchart。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/s06.md

@@ -0,0 +1,17 @@
+---
+id: context.article.s06
+kind: procedure
+media-type: text/markdown
+---
+
+# S06 外部依赖
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**依赖概览 → RPC／HTTP → 事件与任务 → 存储及配置服务 → 初始化与选择 → 故障边界和下一步**。
+
+表格列：依赖身份、类型、用途、调用／初始化位置、选择条件、权威入口。Topic、服务名、配置 namespace 都保留其真实类别；仅字符串匹配命中的项只能列候选，不生成确定调用边。特定平台的初始化规则由已授权的来源和扩展解释。
+
+## 图示选择
+
+依赖章节用 flowchart LR，区分 RPC/HTTP、消息、存储、配置，不推断未读取的外部系统。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/articles/s07.md

@@ -0,0 +1,19 @@
+---
+id: context.article.s07
+kind: procedure
+media-type: text/markdown
+---
+
+# S07 事件、任务与对账
+
+This is a writing blueprint, not a completion gate. Adapt the headings and level of detail to the reader, evidence and language. Missing or additional chapters and ordinary version differences are advisory. Preserve real source coordinates and a useful next investigation step.
+
+建议章节：**职责与触发源 → 注册／订阅 → Payload 与过滤 → 处理链路 → 重试、幂等与并发 → 检查点／补偿／对账 → 运行和观测入口**。
+
+入口表列：topic／schedule／command 身份、登记文件、handler、输入契约、首个下游或持久化边界。结果部分按证据解释返回、ack、跳过、重试及死信／人工处理去向。区分定时任务、事件消费、任务执行器、同步／对账作业；任务函数名不是调度证据。
+
+保留现有 event-consumer、background-runtime、data-sync-reconciliation 的各自语义，不统一成 RPC 模板。运行保证需配置或实现证据，不能从框架依赖推定 exactly-once。
+
+## 图示选择
+
+消费与重试顺序用 sequenceDiagram，任务/对账分支用 flowchart TD；明确 ack、补偿与失败出口。 图放在对应解释章节，图前说明目的与范围，图后给来源和继续位置；按已下发的共用图示指导编写，无增益时省略，不增加独立必填章节。

package/indexers/bundles/context-note-indexer/templates/decision-record.md

@@ -0,0 +1,33 @@
+# The choice and why
+
+This is the page shape for one adopted choice. Use it as an outline, not a form
+to fill.
+
+## Section blueprint
+
+```markdown
+## <the decision, named by what it settles>
+- Decision: the choice as adopted
+- Status: recorded, agreed, implemented or verified — and what establishes it
+- Because: the reasons that actually drove the choice
+- Instead of: alternatives considered, and why each lost
+- Applies to: the scope, version or platform the decision governs
+- Open: what this decision explicitly did not settle
+```
+
+`Decision` and `Because` are required — a choice without its reasons cannot be
+re-evaluated later, which is the only reason this page exists. List an
+alternative under `Instead of` only when it explains the choice or prevents
+someone repeating a failed approach; a catalog of every option raised is noise.
+Keep `Open` whenever a reader would otherwise assume the matter is closed.
+
+`Status` follows the evidence in the record. Use `recorded` or `proposed` when
+adoption is not established. If the note explicitly records confirmation by the
+relevant decision maker, retain it as an attributed agreement; the storage type
+does not undo that confirmation. Approval does not prove implementation or
+verification. Use supporting code, maintained material or actual results in
+authorized scope for those claims; attribute a report when that is all available.
+
+Do not turn a note's proposal into policy. If the record shows someone intended
+a choice and nothing shows it was adopted, the page either says that or is not
+written yet.