修复: 消息溯源P2切读确认完成 + 走查报告高优项

- 更新 P2 切读方案文档(确认批次B已上线)
- ㉑ query LIKE 通配符转义(project/idea/task/knowledge 4 处)
- ⑱ dag.rs deep_merge null 覆盖全局配置
- ⑲ dag.rs _ 通配 match 展开显式变体
- ⑩ INDEX.md 补漏 10 个文档索引
- ⑫ ARCHITECTURE.md 删除与新文档逐字重复
- ㉒ coordinator.rs 加 #[deprecated] 编译守卫
- ㉛ AiChat.vue 空值传播加 console.warn
This commit is contained in:
2026-06-28 05:05:30 +08:00
parent fee856129c
commit c022e2d4d8
9 changed files with 55 additions and 179 deletions

View File

@@ -535,6 +535,8 @@ CREATE TABLE app_settings (
## 七、三层模型:模板 → 工作流 → 人设
> 本章详细设计已迁至专项文档,详见 [docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md](./docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md)。此处仅保留摘要性定义。
### 7.1 三层定义
| 层 | 回答的问题 | 本质 | 生命周期 | 当前状态 |
@@ -543,126 +545,9 @@ CREATE TABLE app_settings (
| **工作流 (Workflow)** | 怎么执行 | 模板的运行时实例DAG + 状态 + 数据绑定) | 随项目启停,单次执行归档 | ✅ df-workflow 核心完成 |
| **人设 (Persona)** | 谁来做 | Agent 角色卡system prompt + 工具集 + 行为规则) | 长期存在,跨节点复用 | ⬜ 待设计 |
### 7.2 三者关系
**关键原则**:模板不绑定具体人设、工作流不感知人设、人设与模板解耦。
```
流程模板 (蓝图)
│ 实例化(填入项目参数)
工作流实例 (运行时 DAG)
│ 分配人设(绑定到每个 AINode
人设驱动 Agent 执行
```
**关键点**
- 模板不绑定具体人设,只标注"建议人设类型",实例化时由用户覆盖
- 工作流不感知人设,只管 DAG 执行;人设注入发生在 AINode 执行时
- 人设与模板解耦:同一个人设可用于不同模板的同类节点
### 7.3 模板实例化流程
```
① 选择模板 → "功能开发模板"
模板定义: [需求分析]→[架构设计]→[编码]→[测试]→[审查]→[发布]
建议人设: analyst → architect → coder → tester → reviewer → none
② 实例化为工作流 DAG
┌─ AINode(需求分析) 建议人设: analyst
├─ AINode(架构设计) 建议人设: architect
├─ AINode(编码) 建议人设: coder
├─ AINode(单元测试) 建议人设: tester
├─ ScriptNode(运行测试) 无人设(纯脚本)
├─ HumanNode(审批发布) 无人设(人工)
└─ AINode(发布说明) 建议人设: writer
③ 实际分配人设(可覆盖)
编码节点 → coder-rust项目是 Rust 后端)
测试节点 → tester-py测试框架是 Python
④ 执行
工作流引擎按 DAG 拓扑调度节点
每个 AINode 执行时载入对应人设的 system_prompt + 工具集
NodeContext 中传递 persona_idAI Node 据此取人设配置
```
### 7.4 人设定义
```rust
/// 智能体人设Agent 角色卡)
pub struct AgentPersona {
pub id: PersonaId,
pub name: String, // 人设名称
pub description: String, // 一句话描述
pub system_prompt: String, // 角色系统提示词
pub allowed_tools: Vec<String>, // 可用工具列表
pub suggested_tier: ModelTier, // 推荐模型层级
pub output_format: OutputFormat, // 输出格式约束
pub rules: Vec<BehaviorRule>, // 行为规则
pub examples: Vec<PersonaExample>, // Few-shot 样例
}
// 预置人设(平台内置,用户可自定义扩展)
Persona::coder "你是资深 Rust/TS 工程师..."
Persona::reviewer "你是代码审查员,关注安全漏洞..."
Persona::architect "你是系统架构师,关注模块划分..."
Persona::tester "你是测试工程师,生成边界用例..."
Persona::analyst "你是需求分析师,拆解用户故事..."
```
### 7.5 模板示例功能开发模板YAML
```yaml
# templates/feature-dev.yaml
id: feature-dev
name: 功能开发模板
description: 标准功能开发流程,从需求分析到发布
template_version: 1
nodes:
- id: analysis
type: ai
persona_hint: analyst
prompt: "分析以下需求:{{inputs.requirement}}"
inputs:
requirement: "$ctx.requirement"
outputs:
prd: text
- id: design
type: ai
persona_hint: architect
prompt: "基于 PRD 设计架构:{{inputs.analysis.prd}}"
inputs:
analysis: "$nodes.analysis"
outputs:
arch_doc: text
- id: coding
type: ai
persona_hint: coder
prompt: "按架构设计实现:{{inputs.design.arch_doc}}"
inputs:
design: "$nodes.design"
outputs:
code: text
- id: review
type: ai
persona_hint: reviewer
prompt: "审查代码:{{inputs.coding.code}}"
inputs:
coding: "$nodes.coding"
quality_gates:
- node: review
condition: "output.verdict == 'pass'"
on_fail: "goto coding"
artifacts:
prd: "$nodes.analysis.prd"
code: "$nodes.coding.code"
review_report: "$nodes.review.text"
详细定义、三者关系、实例化流程、数据结构及 YAML 模板示例见 [专项设计文档](./docs/02-架构设计/专项设计/三层模型-流程模板与人设体系-2026-06-28.md)。
## 八、Phase 规划