artifact-chain-assistant 0.8.0

package/adapters/codex/templates/extended/contracts/ipc_contract/review-checklist.md

@@ -0,0 +1,78 @@
+# IPC Contract 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `IPC-{nnn}`）
+- [ ] `title` 清晰描述 IPC 通道范围
+- [ ] `version` 字段存在且符合语义化版本
+- [ ] `status` 字段存在且为有效值
+
+## 消息定义
+
+- [ ] 请求消息结构完整
+- [ ] 响应消息结构完整
+- [ ] 事件消息定义清晰（如适用）
+- [ ] 消息类型定义使用 TypeScript 接口
+
+## 通道规范
+
+- [ ] 通道名称明确
+- [ ] 通信方向清晰（前端→后端/后端→前端/双向）
+- [ ] 请求和响应示例完整
+- [ ] 错误码覆盖常见异常场景
+
+## 序列化规范
+
+- [ ] 数据格式明确（JSON/MessagePack/Protobuf）
+- [ ] 类型映射表完整
+- [ ] 日期和数字精度有说明
+- [ ] 字符编码有说明
+
+## 边界规则
+
+- [ ] 前端职责范围明确
+- [ ] 后端职责范围明确
+- [ ] 禁止事项有明确说明
+- [ ] 前后端边界清晰无歧义
+
+## 错误处理
+
+- [ ] 错误码定义完整
+- [ ] 错误消息用户友好
+- [ ] 错误恢复方式明确
+- [ ] 不暴露内部实现细节
+
+## 性能要求
+
+- [ ] 延迟指标有明确目标
+- [ ] 大数据传输策略有说明
+- [ ] 并发限制有说明
+- [ ] 超时设置有说明
+
+## 安全性
+
+- [ ] 输入验证规则完整
+- [ ] 权限控制机制明确
+- [ ] 敏感信息处理有说明
+- [ ] 防攻击措施有说明
+
+## 版本兼容
+
+- [ ] 向后兼容规则明确
+- [ ] 破坏性变更有处理流程
+- [ ] 版本迁移有说明
+- [ ] 旧版本兼容期有定义
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] IPC 通道可追溯到业务需求
+- [ ] 与 UI 契约关联清晰
+
+## 实现一致性
+
+- [ ] 与实际实现代码一致
+- [ ] 文档与实际行为匹配
+- [ ] 类型定义与代码类型一致

package/adapters/codex/templates/extended/contracts/ipc_contract/starter.md

@@ -0,0 +1,214 @@
+---
+id: {IPC_ID}
+title: {IPC 通道名称}
+status: draft
+version: {v1}
+related_features: []
+---
+
+# {IPC_ID}: {IPC 通道名称}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个 IPC 通道的用途、通信方向和主要能力}
+
+## 基础信息
+
+- **版本**：{version}
+- **通信方向**：Frontend → Backend / Backend → Frontend / 双向
+- **通道名称**：{channel_name}
+- **框架**：Tauri / Electron / 自定义
+
+## 消息定义
+
+### 请求消息
+
+```typescript
+interface {RequestName} {
+  // 请求标识
+  id: string;
+  // 请求类型
+  type: "{request_type}";
+  // 请求载荷
+  payload: {
+    field1: string;
+    field2: number;
+    field3?: boolean;  // 可选字段
+  };
+}
+```
+
+### 响应消息
+
+```typescript
+interface {ResponseName} {
+  // 对应请求 ID
+  requestId: string;
+  // 响应状态
+  status: "success" | "error";
+  // 成功时的数据
+  data?: {
+    result: string;
+    metadata?: Record<string, unknown>;
+  };
+  // 错误时的信息
+  error?: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+}
+```
+
+### 事件消息（后端主动推送）
+
+```typescript
+interface {EventName} {
+  // 事件类型
+  type: "{event_type}";
+  // 事件载荷
+  payload: {
+    timestamp: number;
+    data: unknown;
+  };
+}
+```
+
+## 通道列表
+
+### {channel_name}
+
+**描述**：{通道描述}
+
+**方向**：{Frontend → Backend / Backend → Frontend / 双向}
+
+**请求示例**：
+
+```typescript
+// 前端发送
+invoke("{channel_name}", {
+  param1: "value",
+  param2: 123
+});
+
+// 后端响应
+{
+  requestId: "req_123",
+  status: "success",
+  data: { result: "processed" }
+}
+```
+
+**错误处理**：
+
+| 错误码 | 描述 | 前端处理 |
+|--------|------|---------|
+| INVALID_PARAM | 参数无效 | 提示用户修正输入 |
+| TIMEOUT | 请求超时 | 重试或提示稍后 |
+| PERMISSION_DENIED | 权限不足 | 提示用户授权 |
+| INTERNAL_ERROR | 内部错误 | 记录日志，提示联系支持 |
+
+## 序列化规范
+
+### 数据格式
+
+- **编码**：JSON / MessagePack / Protobuf
+- **字符编码**：UTF-8
+- **日期格式**：ISO 8601 或 Unix 时间戳
+- **数字精度**：整数 i64，浮点 f64
+
+### 类型映射
+
+| TypeScript | Rust/后端 | 说明 |
+|-----------|----------|------|
+| string | String | UTF-8 字符串 |
+| number | i64 / f64 | 整数或浮点 |
+| boolean | bool | 布尔值 |
+| Array<T> | Vec<T> | 数组 |
+| object | Struct | 对象 |
+| null | Option::None | 可选值 |
+
+## 边界规则
+
+### 前端职责
+
+- UI 状态管理
+- 用户输入验证
+- 错误展示
+- 加载状态
+
+### 后端职责
+
+- 业务逻辑处理
+- 数据持久化
+- 文件系统访问
+- 系统 API 调用
+- 安全验证
+
+### 禁止事项
+
+- ❌ 前端直接访问文件系统
+- ❌ 前端存储敏感信息（密码、Token 明文）
+- ❌ 后端直接操作 DOM
+- ❌ 绕过 IPC 通道的通信
+
+## 性能要求
+
+| 指标 | 目标值 | 说明 |
+|------|-------|------|
+| 单次调用延迟 | < {X} ms | 本地调用 |
+| 大数据传输 | 分片传输 | 超过 1MB 的数据 |
+| 并发调用 | 限制 {N} 个 | 防止资源耗尽 |
+| 超时时间 | {X} 秒 | 默认超时 |
+
+## 安全考虑
+
+### 输入验证
+
+- [ ] 所有输入参数在后端验证
+- [ ] 防止路径遍历攻击
+- [ ] 防止注入攻击
+- [ ] 限制输入长度和大小
+
+### 权限控制
+
+- [ ] 敏感操作需要权限确认
+- [ ] 最小权限原则
+- [ ] 权限检查在后端执行
+
+### 错误信息
+
+- [ ] 不暴露内部实现细节
+- [ ] 错误码和消息分离
+- [ ] 敏感信息不记录日志
+
+## 版本兼容
+
+### 向后兼容规则
+
+- 新增字段使用可选类型
+- 不删除已有字段
+- 不改变字段类型
+- 新增通道不影响已有通道
+
+### 破坏性变更处理
+
+- 版本号递增
+- 迁移指南文档
+- 旧版本兼容期
+- 客户端升级提示
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 设计文档：{related_designs}
+- UI 契约：{related_ui_contracts}
+
+## 变更日志
+
+| 日期 | 版本 | 变更 | 作者 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |

package/adapters/codex/templates/extended/contracts/report_contract/review-checklist.md

@@ -0,0 +1,61 @@
+# Report Contract 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `RPT-{nnn}`）
+- [ ] `title` 清晰描述报告范围
+- [ ] `version` 字段存在且符合语义化版本
+- [ ] `status` 字段存在且为有效值
+- [ ] `output_format` 字段存在且为有效格式
+
+## 数据源质量
+
+- [ ] 所有数据源已列出
+- [ ] 数据源类型明确（数据库 / API / 文件）
+- [ ] 数据刷新频率已定义
+- [ ] 数据源可靠性已评估
+
+## 字段定义
+
+- [ ] 所有字段有清晰的中文/英文名称
+- [ ] 字段类型明确（string / number / date / boolean）
+- [ ] 聚合逻辑已定义（SUM / AVG / COUNT / MAX / MIN / NONE）
+- [ ] 字段含义有详细说明
+
+## 时间窗口
+
+- [ ] 报告周期已定义
+- [ ] 时间粒度已明确（小时 / 天 / 周 / 月）
+- [ ] 时区已指定
+- [ ] 截止规则已说明
+
+## 聚合逻辑
+
+- [ ] 关键指标计算规则完整
+- [ ] 过滤条件已列出
+- [ ] 排序规则已定义
+- [ ] 边界情况处理已说明（如空值、零值）
+
+## 性能与安全
+
+- [ ] 生成时间要求已定义
+- [ ] 数据量级已评估
+- [ ] 并发支持已说明
+- [ ] 数据权限已定义
+- [ ] 敏感字段已标记并说明脱敏方式
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] 报告可追溯到业务需求
+- [ ] 版本变更可追溯
+- [ ] 关联数据契约存在
+
+## 实现一致性
+
+- [ ] 报告输出与定义一致
+- [ ] 字段计算逻辑与实现匹配
+- [ ] 性能满足要求
+- [ ] 测试覆盖核心场景

package/adapters/codex/templates/extended/contracts/report_contract/starter.md

@@ -0,0 +1,97 @@
+---
+id: {RPT_ID}
+title: {报告名称}
+status: draft
+version: {v1}
+output_format: {输出格式}
+related_features: []
+---
+
+# {RPT_ID}: {报告名称}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个报告的用途、业务场景和主要能力}
+
+## 基础信息
+
+- **版本**：{version}
+- **输出格式**：PDF / Excel / CSV / JSON / HTML
+- **生成频率**：每日 / 每周 / 每月 / 按需
+- **数据时效性**：实时 / T+1 / 截止到指定时间点
+- **目标受众**：{报告的使用者，如业务分析师、管理层、运维团队}
+
+## 报告结构
+
+### 数据源
+
+| 数据源 | 类型 | 刷新频率 | 说明 |
+|--------|------|---------|------|
+| {数据源名称} | 数据库 / API / 文件 | {频率} | {数据源描述} |
+
+### 字段定义
+
+| 字段名 | 类型 | 聚合逻辑 | 说明 |
+|--------|------|---------|------|
+| {field_name} | {type} | SUM / AVG / COUNT / MAX / MIN / NONE | {字段含义} |
+
+### 时间窗口
+
+- **报告周期**：{报告覆盖的时间范围，如"过去 30 天"}
+- **时间粒度**：小时 / 天 / 周 / 月
+- **时区**：{时区，如 UTC / Asia/Shanghai}
+- **截止规则**：{数据截止时间点的定义，如"每日凌晨 2:00 截止"}
+
+## 报告示例
+
+### 示例输出
+
+```
+{报告输出的示例片段}
+```
+
+## 聚合逻辑
+
+### 计算规则
+
+{描述关键指标的计算方法，如"订单金额 = SUM(订单明细.单价 * 数量)"}
+
+### 过滤条件
+
+| 条件 | 字段 | 运算符 | 值 | 说明 |
+|------|------|--------|-----|------|
+| {条件名称} | {field} | = / != / > / < / IN / LIKE | {value} | {条件描述} |
+
+### 排序规则
+
+| 排序字段 | 方向 | 说明 |
+|---------|------|------|
+| {field} | ASC / DESC | {排序逻辑} |
+
+## 权限与安全
+
+- **数据权限**：{报告访问的数据范围控制}
+- **用户权限**：{哪些角色可以访问}
+- **敏感字段**：{是否包含敏感数据，如何脱敏}
+
+## 性能要求
+
+- **生成时间**：{报告生成的最大允许时间}
+- **数据量级**：{预期数据行数}
+- **并发支持**：{是否支持多人同时生成}
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 数据契约：{related_data_contracts}
+- 设计文档：{related_designs}
+- 决策：{related_decisions}
+
+## 变更日志
+
+| 日期 | 版本 | 变更 | 作者 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |

package/adapters/codex/templates/extended/contracts/ui_contract/review-checklist.md

@@ -0,0 +1,70 @@
+# UI Contract 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `UI-{nnn}`）
+- [ ] `title` 清晰描述 UI 流程范围
+- [ ] `version` 字段存在且符合语义化版本
+- [ ] `status` 字段存在且为有效值
+
+## 用户流程
+
+- [ ] 主流程步骤清晰完整
+- [ ] 分支流程有明确条件说明
+- [ ] 流程起始和结束状态明确
+- [ ] 用户操作和系统响应对应关系清晰
+
+## 状态管理
+
+- [ ] 所有状态已列出
+- [ ] 状态转换条件明确
+- [ ] 无死循环或不可达状态
+- [ ] 错误状态有恢复路径
+
+## 交互设计
+
+- [ ] 表单元素类型和验证规则完整
+- [ ] 按钮行为和禁用条件明确
+- [ ] 快捷键定义清晰（如适用）
+- [ ] 加载状态有明确反馈
+
+## 错误处理
+
+- [ ] 错误类型覆盖完整（网络、验证、权限、服务器）
+- [ ] 错误提示用户友好
+- [ ] 错误恢复方式明确
+- [ ] 错误展示方式符合设计规范
+
+## 可访问性
+
+- [ ] ARIA 标签完整
+- [ ] 键盘导航支持
+- [ ] 颜色对比度符合标准
+- [ ] 屏幕阅读器兼容
+
+## 响应式设计
+
+- [ ] 断点定义清晰
+- [ ] 各断点布局调整明确
+- [ ] 元素变化有说明
+- [ ] 移动端交互适配
+
+## 性能要求
+
+- [ ] 性能指标有明确目标
+- [ ] 测量方式有说明
+- [ ] 关键路径有优化策略
+
+## 追溯性
+
+- [ ] 关联功能特性存在
+- [ ] UI 流程可追溯到业务需求
+- [ ] 与 API 契约关联清晰
+
+## 实现一致性
+
+- [ ] 与实际实现代码一致
+- [ ] 文档与实际行为匹配
+- [ ] 设计稿与文档描述一致

package/adapters/codex/templates/extended/contracts/ui_contract/starter.md

@@ -0,0 +1,150 @@
+---
+id: {UI_ID}
+title: {UI 流程名称}
+status: draft
+version: {v1}
+related_features: []
+---
+
+# {UI_ID}: {UI 流程名称}
+
+<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
+<!-- 插件模板是入门指导，项目本地模板是权威 -->
+
+## 概述
+
+{描述这个 UI 流程的用途、目标用户和核心交互}
+
+## 基础信息
+
+- **版本**：{version}
+- **适用平台**：Web / Desktop / Mobile
+- **页面/组件**：{页面或组件名称}
+- **入口**：{用户如何进入此流程}
+
+## 用户流程
+
+### 主流程
+
+```
+用户操作 → 系统响应 → 下一步
+    ↓
+[步骤 1] {操作描述}
+    ↓
+[步骤 2] {系统响应}
+    ↓
+[步骤 3] {后续操作}
+    ↓
+[完成] {最终状态}
+```
+
+### 分支流程
+
+| 条件 | 分支路径 | 说明 |
+|------|---------|------|
+| {条件描述} | {分支路径} | {说明} |
+
+## 状态转换
+
+### 状态列表
+
+| 状态 | 描述 | 可转换到 |
+|------|------|---------|
+| initial | 初始状态 | loading, ready |
+| loading | 加载中 | ready, error |
+| ready | 就绪状态 | loading, completed |
+| error | 错误状态 | loading, ready |
+| completed | 完成状态 | - |
+
+### 状态转换图
+
+```
+[initial] → [loading] → [ready] → [completed]
+                ↓            ↓
+            [error] ←--------
+```
+
+## 交互元素
+
+### 表单元素
+
+| 元素 | 类型 | 必填 | 验证规则 | 错误提示 |
+|------|------|------|---------|---------|
+| {字段名} | {input/select/checkbox} | {yes/no} | {验证规则} | {错误提示} |
+
+### 按钮和操作
+
+| 按钮 | 位置 | 行为 | 禁用条件 |
+|------|------|------|---------|
+| {按钮名} | {位置} | {点击后行为} | {何时禁用} |
+
+### 快捷键
+
+| 快捷键 | 功能 | 适用场景 |
+|--------|------|---------|
+| {快捷键} | {功能} | {场景} |
+
+## 错误处理
+
+### 错误类型
+
+| 错误类型 | 触发条件 | 用户提示 | 恢复方式 |
+|---------|---------|---------|---------|
+| 网络错误 | 网络请求失败 | "网络连接失败，请重试" | 重试按钮 |
+| 验证错误 | 输入不符合规则 | {字段级错误提示} | 修正输入 |
+| 权限错误 | 无操作权限 | "无权限执行此操作" | 联系管理员 |
+| 服务器错误 | 后端返回错误 | "服务暂时不可用" | 重试或稍后再试 |
+
+### 错误展示
+
+- **字段级错误**：在对应字段下方显示红色提示
+- **页面级错误**：顶部 Toast 或 Alert 组件
+- **阻断级错误**：模态对话框，需用户确认
+
+## 可访问性
+
+### ARIA 标签
+
+| 元素 | aria-label | aria-describedby |
+|------|-----------|------------------|
+| {元素} | {标签} | {描述元素 ID} |
+
+### 键盘导航
+
+- Tab 顺序：{说明 Tab 键导航顺序}
+- 焦点管理：{说明焦点如何移动}
+- 屏幕阅读器：{说明屏幕阅读器如何播报}
+
+### 视觉设计
+
+- 颜色对比度：符合 WCAG 2.1 AA 标准
+- 字体大小：最小 14px
+- 点击区域：最小 44x44px
+
+## 响应式设计
+
+| 断点 | 布局调整 | 元素变化 |
+|------|---------|---------|
+| Desktop (>1200px) | {布局描述} | {元素变化} |
+| Tablet (768-1200px) | {布局描述} | {元素变化} |
+| Mobile (<768px) | {布局描述} | {元素变化} |
+
+## 性能要求
+
+| 指标 | 目标值 | 测量方式 |
+|------|-------|---------|
+| 首屏加载 | < {X} 秒 | Lighthouse |
+| 交互响应 | < {X} 毫秒 | 用户感知 |
+| 动画流畅 | 60fps | DevTools |
+
+## 关联制品
+
+- 功能特性：{related_features}
+- 设计文档：{related_designs}
+- API 契约：{related_api_contracts}
+
+## 变更日志
+
+| 日期 | 版本 | 变更 | 作者 |
+|------|------|------|------|
+| {YYYY-MM-DD} | v1 | 初始版本 | {作者} |

package/adapters/codex/templates/extended/domain/database_migration/review-checklist.md

@@ -0,0 +1,51 @@
+# Database Migration 审查清单
+
+<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->
+
+## 结构完整性
+
+- [ ] `id` 字段存在且符合项目 ID 模式（如 `MIG-{nnn}` 或时间戳）
+- [ ] `title` 清晰描述迁移内容
+- [ ] `database` 已指定
+- [ ] 迁移类型已标注（DDL / DML / 混合）
+
+## SQL 质量
+
+- [ ] 正向迁移 SQL 语法正确
+- [ ] 回滚 SQL 语法正确且与正向迁移对称
+- [ ] SQL 已在测试环境验证
+- [ ] 无硬编码环境变量或凭证
+
+## 兼容性与安全
+
+- [ ] 向前/向后兼容性已分析
+- [ ] 应用停机需求已明确
+- [ ] NOT NULL 约束处理策略已说明
+- [ ] 默认值策略合理
+
+## 回滚方案
+
+- [ ] 回滚 SQL 完整可执行
+- [ ] 回滚触发条件明确
+- [ ] 回滚窗口已定义
+- [ ] 回滚数据丢失风险已评估
+
+## 性能影响
+
+- [ ] 锁策略已评估
+- [ ] 大表变更策略已说明（分批 / 在线 DDL）
+- [ ] 预估执行时间合理
+- [ ] 迁移期间监控方案已定义
+
+## 验证方案
+
+- [ ] 迁移前检查项完整
+- [ ] 迁移后验证步骤可执行
+- [ ] 数据完整性校验方案存在
+- [ ] 回归测试覆盖关键场景
+
+## 追溯性
+
+- [ ] 关联数据契约存在
+- [ ] 关联功能特性存在
+- [ ] 迁移可追溯到 schema 变更原因