多场景样板间体验馆
声明式元数据驱动与内生安全护栏（Safe by Construction）—— 专为 AI Agent 协同演进打造的现代 .NET 极简应用开发平台。
一键复制预设的宣传卡片文案，直接分享到技术社区、微信群、Twitter 或 Reddit。
🤖 Agent Studio (智能体自举演进工作台)
3 CLI 角色（Architect / Developer / Tester）闭环协作与自举演进工作台
NetYamlForge 核心落地的声明式 AI 协作引擎。基于 roles.yaml 动态元数据驱动与 Model Context Protocol (MCP) 端点，实现端到端的角色提示词装配、协同流水线调度与执行日志追踪。
“摒弃代码中生硬的 switch-case 角色分支，将角色职责与交互准则全面 YAML 元数据化。配合 MCP 开放接口与确定性租户数据隔离，让 AI 协作既具备无限扩展性，又绝对 Safe by Construction。”
- ✓ roles.yaml 声明式角色驱动：元数据配置化定义职责、准则与三阶段协同流水线
- ✓ 动态 CRUD 任务管理：通过 agent_task 与 agent_task_log 实时跟踪演进任务与执行步骤
- ✓ MCP 标准协议端点：内置 EntityToolService 与 JSON-RPC 2.0，无缝对接外部分析器
- ✓ Fail-Closed 租户熔断隔离：多租户会话与上下文强绑定，杜绝数据串话穿透
roles:
Architect:
description: "System Architect"
system_prompt: |
You are the project architect. Focus on high-level structure and design patterns.
NetYamlForge is a lightweight .NET 10 Web framework driven by YAML configurations and C# hooks.
responsibilities:
- "Analyze the business and technical requirements thoroughly."
- "Define architectural boundaries, interfaces, and component interactions."
- "Produce a clear Specification/RFC with concrete file paths and contract signatures."
Developer:
description: "Senior Software Developer"
responsibilities:
- "Implement the feature or fix according to the Architect's specification."
- "Write clean, robust, and idiomatic C# code targeting .NET 10."
Tester:
description: "QA & Test Engineer"
responsibilities:
- "Design and write comprehensive xUnit unit and integration tests."
- "Verify test cases against edge cases, failure modes, and regression risks."⚡ Todo Workspace (现代高效待办工作台)
多维卡片流、行内极速添加、紧急预警与双轨解耦待办工作台
基于 NetYamlForge 声明式架构与 Claude 架构师协同自举落地的现代化任务协作平台。告别单调冰冷的数据表格，提供四维指标看板、可视化百分比完成度进度条、毫秒级模糊检索与圆形一键勾选微交互。
“采用前台业务门户（HomePage）与底层元数据运维（DynamicEntity）彻底解耦的双轨模式。前台专注于极致的用户人机工效与响应式微交互，后台提供零成本的完整字段审计与数据管理，兼顾审美与工程严谨性。”
- ✓ 四维指标看板与动态完成率进度条：实时掌控全局与紧急高优任务进展
- ✓ 行内极速创建卡片（Inline Fast Creator）：支持回车快捷建档与优先级智能选择
- ✓ 截止日期状态动态预警：自动高亮 ⚠️ 已逾期（红底警示）与 ⏳ 今日截止（黄底提醒）
- ✓ 双轨分离架构：前台现代化卡片流交互 + 后台 DynamicEntity 完整运维审计
name: todo-app
displayName: "Todo App"
version: "1.0.0"
description: "NetYamlForge 轻量级待办应用"
database:
type: sqlite
path: database/todo-app.db
features:
multiLanguage: true
userAuthentication: true
dashboard: true
pages: true
api: true
layout:
theme: synthwave
dashboardTheme: workspace
landingPageByRole:
viewer: /todo-app/Page/HomePage
editor: /todo-app/Page/HomePage
admin: /todo-app/Page/HomePage📰 Modern Blog (标准博客与发布平台)
标准一览流、Markdown 详情沉浸阅读、分类聚合与独立发布系统
遵循现代人机交互规范重塑的标准博客系统。提供优雅的文章一览卡片流、单篇独立沉浸阅读详情页、智能字数预估、多标签分类聚合以及全生命周期文章草稿与发布管控。
“实现标准博客系统的经典动线解耦：一览流（Archive Index）负责高密度信息检索与分类导航，单篇阅读页（Post Detail）负责无干扰沉浸阅读。内置安全 Markdown HTML 消毒防护，坚决杜绝富文本 XSS 漏洞。”
- ✓ 双动线人机交互：优雅的文章一览流与单篇沉浸式独立阅读详情页完全解耦
- ✓ 沉浸式阅读体验：智能字数统计、预计阅读分钟数、作者签名与发布时间戳
- ✓ 分类与标签智能索引：支持多分类胶囊切换与草稿/已发布状态可视化标识
- ✓ 内生安全消毒：Markdown 渲染管线内置 HTML 净化，杜绝富文本 XSS 注入风险
name: blog-app
displayName: "Blog App"
version: "1.0.0"
description: "NetYamlForge 独立博客与内容发布平台"
database:
type: sqlite
path: database/blog-app.db
features:
multiLanguage: true
userAuthentication: true
dashboard: true
pages: true
api: true
layout:
theme: synthwave
dashboardTheme: workspace
landingPageByRole:
viewer: /blog-app/Page/HomePage
editor: /blog-app/Page/HomePage
admin: /blog-app/Page/HomePage📚 Wiki Hub (全声明式知识库协作门户)
零手写 Razor、全 YAML 积木装配、沉浸式架构文档流与实时指标看板
NetYamlForge 声明式积木生态扩展的里程碑应用。不编写任何一行 C# 或 Razor 视图代码，完全依赖通用声明式组件（_SectionMarkdown、_SectionKanban、stat_cards）与元数据定义拼装而成的企业级知识库门户。
“体现自举演进引擎的核心哲学：通过将可复用 UI 积木沉淀至框架内核，将 AI 生成代码的表面积压缩至极限。零 Razor 视图意味着零编译风险与零注入通道，达成真正意义上的 Safe by Construction。”
- ✓ 零手写 Razor 视图：100% 由 YAML 元数据与组件积木拼装驱动，无编译包袱
- ✓ 通用 Markdown 积木：自动绑定 titleField、dateField 与 contentField 正文解析
- ✓ 全景指标看板：实时聚合呈现全部文档数、已发布量与架构最佳实践热度
- ✓ 自举沙箱交付：由 AppManifestationService 引擎全自动安全落盘与热挂载
page:
title: "NetYamlForge 架构设计与知识库协作中心"
description: "沉浸式阅读架构演进规范、最佳实践与多智能体协同蓝图"
layout: "default"
sections:
- id: stats
type: stat_cards
title: "知识库全景指标"
- id: intro_doc
type: markdown
title: "架构全景与核心规范"
- id: articles_overview
type: card_list
title: "架构文章与规范速查"📋 Approval Flow (企业表单审批流中心)
行政差旅/财务报销/设备采购多级审批流、状态流转与历史流转审计
基于 Agent Studio 自举孵化的企业级多级流程审批工作台。涵盖费用报销、设备采购、带薪休假等场景，提供完整的状态机流转（待审批/已通过/驳回/撤回）、审计历史追踪与自定义 Hook 动作闭环。
“将企业级复杂工作流建模为'声明式表单 + 自定义动作处理器（ICustomActionHandler）+ 审计日志'三位一体。动作处理器在事务内严格原子执行状态跃迁与操作流水回写，天然防脏读与重复决断。”
- ✓ 多级业务流转闭环：审批通过、驳回、自主撤回完整动作处理器物理实装
- ✓ 流转历史审计日志：自动向 approval_log 回写操作人、决断动作与审计意见
- ✓ 声明式效能大屏：一览展示待我审批、已通过、已驳回及紧急单据实时指标
- ✓ 高优紧急程度预警：支持 normal / high / urgent 多维权重排序与警示凸显
entities:
approval_request:
table: approval_request
key: id
displayName: "审批申请单"
actions:
approve_request:
label: "审批通过"
handler: approve_request_handler
reject_request:
label: "驳回申请"
handler: reject_request_handler
withdraw_request:
label: "撤回单据"
handler: withdraw_request_handler📊 Analytics Dashboard (经营指标决策看板)
经营指标实时聚合、商业营收漏斗、渠道 ROI 与平台基础设施大屏
为企业核心决策层打造的全景数据监控与洞察工作台。无缝聚合季度 GMV、活跃客户规模、多渠道营收贡献与高 ROI 增长引擎，支持纯声明式卡片流与全量明细矩阵联动分析。
“结合 NetYamlForge 声明式积木的 stat_cards 与 card_list，通过 SQL 动态聚合实现亚毫秒级的经营大屏渲染。数据结构灵活可扩展，无需硬编码图表组件即可迅速洞察关键商业指标。”
- ✓ 全景商业指标大屏：季度 GMV、租户增长率、付费转化率及平台响应延迟
- ✓ 主力业务线与增长引擎：渠道营收规模、客户转化单数与 ROI 投资回报倍数对比
- ✓ 纯声明式积木驱动：通过 SQL 统计聚合与 card_list 组合，开发交付零延迟
- ✓ 经营明细数据表格：无缝下钻至业务渠道与核心指标完整生命周期
title: "企业经营分析与决策看板"
sections:
- id: gmv_overview
title: "核心战略指标"
source: "SELECT metric_name as label, current_value as value, icon FROM kpi_metric"
component: stat_cards
- id: channel_cards
title: "主力业务线与增长引擎"
source: "SELECT id, channel_name, category, revenue, roi_multiple FROM business_channel"
component: card_list🏛️ 架构哲学：为什么 NetYamlForge 能支撑从 AI 沙箱到 ERP 核心？
传统架构在「开发速度」与「业务复杂性/安全性」之间往往非此即彼。NetYamlForge 通过独创的三位一体架构，破解了这一困境：
1. 声明式 YAML 元数据驱动
实体、字段、校验、看板、导航与权限完全配置化。页面秒级生成，代码量减少 80%，AI Agent 可直接理解并安全生成结构定义。
2. 编译期与运行期硬安全护栏
SqlSafetyGuard、PathSafetyGuard 与 Default-Deny 实体管道，在底层熔断注入与越权行为，为 AI 编程与开放互联提供确定性保护。
3. 原生 C# 业务 Hooks 无限扩展
拒绝“黑盒无代码”的灵活性死胡同。通过清晰的 IEntityHook 接口与 Dapper/EF Core 事务注入，深水区的复杂 ERP 状态机与审批流游刃有余。
| 对比维度 | 传统纯手写开发 (ASP.NET / Spring) | 通用商用无代码 (Directus / Strapi) | NetYamlForge (声明式 + 护栏 + C# Hooks) |
|---|---|---|---|
| 交付速度 | 慢（大量重复样板代码） | 快（图形化操作） | 极快（YAML 驱动，秒级生成） |
| AI Agent 代码友好度 | 中（需生成复杂 C# 代码，易出错） | 差（强依赖 GUI，Agent 难操作） | 极高（纯结构化 YAML，自然对齐 LLM） |
| AI 生成安全防护 | 无（依赖人工 Code Review 兜底） | 弱（依赖通用鉴权） | 极强（编译期 AST 阻断 + Path 隔离） |
| 复杂 ERP 业务上限 | 极高（代码随心所欲） | 受限（遇到复杂外键/审批流触顶） | 无上限（原生 C# 事务 Hooks 随需挂载） |