# spec-workbench

**Repository Path**: wii95/spec-workbench

## Basic Information

- **Project Name**: spec-workbench
- **Description**: sdd企业工作台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-30
- **Last Updated**: 2026-08-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业 Agent 实践工程平台

企业内部 Agent 工程实践的「**资产库 + 规约库 + 统一入口**」。

> **一句话目标**：让企业里任何一名员工，通过一次对话就能知道公司有哪些 Agent 能力可用、怎么用、该遵守什么规约，并能直接调用。

## 工程划分

| 工程 | 说明 | 技术栈 |
|---|---|---|
| [`spec-center/`](./spec-center) | 后端，Maven 多模块（大模块 / 子模块两层聚合） | JDK 25 · Spring Boot 4.1 · Spring AI 2.0 · Spring AI Alibaba 2.0.0-M1.1 · LiteFlow 2.16.1 · MyBatis-Plus 3.5.17 · PostgreSQL 18 |
| [`spec-ui/`](./spec-ui) | 前端，monorepo 单 app，`--mode` 切换多形态 | Vue 3 · Vite 5 · TypeScript 5 · Element Plus · TailwindCSS · Pinia |

两仓**独立 CI**，通过 REST + SSE 契约对接。

## 架构

三段式分层：**内核（Agent Kernel）+ 能力供给 + 治理横切**。

- **内核**：Agent 运行时是系统内核。资产 / 知识 / 规约不直接对外提供对话能力，而是被装配进 Agent 后由 Kernel 统一调度。内核不理解「团队」语义。
- **能力供给**：资产、知识、规约、工作流，各自独立演进，统一实现 `CapabilityProvider`。
- **治理横切**：权限、审计、通知、配额、降级、数据保留，以拦截器 + AOP 织入。

两套编排引擎分工：**Graph 管认知、LiteFlow 管流程**。硬约束——LiteFlow 节点不得调模型，Graph 节点不得写业务 SQL。

## 规格与项目记忆

| 路径 | 说明 |
|---|---|
| [`specs/2026-08/enterprise-agent-platform/`](./specs/2026-08/enterprise-agent-platform) | 平台级基线规格（requirements / design / sources） |
| [`specs/steering/`](./specs/steering) | 项目记忆：`product.md` / `tech.md` / `structure.md` |

## 关键约束

进入编码前必读 `specs/steering/tech.md`，其中记录了**只会静默失败、必须显式验证的坑**：

- MyBatis-Plus 必须用 `mybatis-plus-spring-boot4-starter`，且需显式 `@Bean` 声明 `MybatisPlusInterceptor`
- fastjson 必须强制收敛到 `2.0.61` 兼容包 + `safeMode`（SAA 传递依赖 1.2.83 命中 CVE-2026-16723）
- `graph-checkpoint-*` 制品不存在，`PostgresSaver` 内嵌于 `graph-core`
- 不引入 Elasticsearch；向量检索不用 Spring AI `VectorStore` 抽象（过滤发生在召回之后）
- pgvector：embedding 维度 ≤ 1536、`SET LOCAL hnsw.ef_search=100`、灌完数据再 `CONCURRENTLY` 建索引
- `pg_textsearch` 中文必须 `ADD MAPPING`，否则静默返回空
- 前端：Tailwind preflight 与 Element Plus 通过 `--vp-*` 变量桥接；SSE 不走 Axios

## 当前状态

**骨架阶段**。目录结构与构建配置已就位，业务代码未开始。首个落地动作应为版本冒烟工程（JDK 25 + Boot 4.1 + MP Boot4 + PG18/pgvector + SAA + LiteFlow），它被后端技术方案标记为「阻塞一切」。