Files
pj0235-eai_agentplatform/docs/02_Architecture/目录说明.md
T
eaiadminandClaude Code 593323a934 refactor: 专员目录收敛为 6 个,重整 AI 路由与系统管理页
一次性提交当天全部改动(110 个文件)。

**未按 TOP_CODING_RULES.md G14.5「一次提交只装一件事」拆分** —— 用户明确要求
单一提交,此处如实记录,不静默忽略该冲突。

提交前验证:后端 go build / go vet / go test ./... 全绿,前端 npm run build
exit 0,/api/health 与管理员 login 均返回 200。

- 专员目录收敛为 6 个:下线 knowledge-operations / process-coordination /
  presentation-briefing / report-generation 四个专员(前后端 manifest 与 seed
  同步删除),新增 general-assistant。专员的归属关系(拥有哪些技能定义、
  哪些目录项、提示词与绑定从哪来)改由 specialists/core 的 ownership.go、
  prompt_provider.go、binding_provider.go 统一提供,seed 与 admin_handlers
  随之内置化,卸载路径统一走 uninstall.go。
- 技能:补齐 text-to-speech 的前端 manifest(后端包在 HEAD 已存在),
  skillcore/ownership.go 提供与专员对称的归属查询。
- AI 路由:ai_config.json 由 OpenRouter/Ollama 切到 LMUAI / SiliconFlow /
  llama.cpp 本地路由,ai_secrets.example.json 与部署 env 样例同步新增
  SILICONFLOW_API_KEY。
- 系统管理页重整:新增 AiAdminPage、OrganizationManagementPage,删除
  AdminOverviewPage、CompanyConfigPage,SystemConfigPage 精简,nav / router /
  config/workbench.js 同步调整。依 G05.5,开发阶段直接收口到新结构,不留旧路由。
- 新增 internal/objectrefs:统一统计对象(专员 / 技能 / xapp)的运行时引用
  (被多少 xapp、项目、任务引用),供管理页做删除前的影响面判断。
- 公众号创作专员:新增 OfficialAccountSpecialistPanel,workflow 与投递链路调整。
- XApp:考试 / 培训 Shell 扩展,XAppDirectoryPage 与 xappDefinition 同步。
- 文档:新增 GW01–GW05 工作台演进系列与 AR12 对话驱动与结构化交互架构;
  同步 AR05 / SY17 / SY23 / SY25 / PL04;TOP_CODING_RULES.md 增补 G05.5。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-23 09:01:28 +08:00

3.4 KiB
Raw Blame History

02_Architecture — 架构设计

命名规则: AR{NN}_{描述}.md 用途: 后端架构、前端架构、数据库架构、部署架构

当前主层只保留现状有效架构文档。 AR01–AR03 已按当前任务中心与对象中心口径重写;旧版培训系统稿已移入 Historical_Records/。 AR04 仍保留较强历史痕迹,阅读时应优先以 docs/02_Architecture/部署文档.md 为准。 AR05–AR08 是 2026-09-16 / 17 的工作台设计稿,不属于 V1.1 快照,其中 AR08 为部分被取代稿,取用前先读其文首补注。 当前产品导航与工作台口径,请以 docs/01_System_Overall/SY22_角色技能应用统一任务架构.md 为准: 新建任务 / 项目 / 专员·技能·APP·连接器 / 长程APP / 知识库 / 后台管理 / 我的 AR09 是规范性文件(对象命名规范),不是设计稿。 它约束新增代码的命名,并登记了当前已核实的命名问题与修复流程;与 TOP_CODING_RULES.md 的 G03 配套使用。 AR12 是当前交互范式讨论的主文档。 它定义“对话发起 + 结构化决策接管 + 对话继续推进”的混合交互架构,后续 Workbench 与专员工作流交互以此为依据。 当前正式对象目录请以 docs/05_Object_Catalog/ 为准;本目录负责跨层架构契约,不再承担对象清单主仓职责。

文件清单

文件 说明
目录说明.md 本索引文件
部署文档.md 当前部署步骤与交付方式说明
对象标准化与解耦总则.md 对象化建设的总原则文档
AR01_后端架构.md 当前后端架构(任务中心 + 对象域 + 兼容业务域)
AR02_前端架构.md 当前前端架构(Workbench 前门 + 对象目录 + App 运行面)
AR03_数据库架构.md 当前数据库架构(对象定义域 + 任务运行域 + 知识底座 + 兼容业务域)
AR04_部署架构.md 部署架构(V1.1 Docker 快照;现为单二进制 + systemd)
AR05_工作台架构约定.md 数字员工 Workbench 架构合同(任务为中心、对象挂载到任务,前端重构强约束)
AR06_技能封装规范.md 技能文件规范(技能 = 定义文件 + 执行器 + 结果组件,不以独立页面存在)
AR07_架构对齐审计.md 架构对齐确认与本轮修复范围(收敛两套并行模型的确认记录)
AR08_角色交互设计.md AI 角色与工具统一交互设计(部分被取代:不跳页结论已采纳,「数字技术员」对象已废弃,见文首补注)
AR09_对象命名规范.md 对象命名规范(规范性文件:原理 / 判据 / 术语表 / 分层规范 / 检查守卫 / 修复流程 / 现状问题登记 / 反例库)
AR10_应用可删除封装规范.md XApp 可删除封装规范(面向一级业务包,目标是“删目录 + 删注册 + 跑卸载”)
AR11_技能专员连接器可删除封装规范.md Skill / Specialist / Connector 可删除封装规范(复用 AR10 思想,但区分能力包、策略定义包、连接插件包的边界)
AR12_对话驱动与结构化交互架构.md Workbench 交互范式主文档(对话发起 + 结构化决策接管 + 对话继续推进)
Historical_Records/目录说明.md 架构迁移说明、历史清单、旧版 AR01–AR03 与阶段性记录索引