「仓库层」是 repository 的直译,中文里与「代码仓库 / git 仓库」同词, 而这一层做的事就是数据访问。名字改成它实际在做的事。 改名口径(纯机械替换,无逻辑改动): - 包:internal/repository → internal/dal(package repository → package dal) - 类型:XxxRepo → XxxDAO(TaskRecordDAO / SpecialistDAO / PositionDAO …) - 变量:xxxRepo → xxxDAO - import 路径、包限定符、日志前缀 [repository] → [dal] 同步 - 注释里的「仓库层」→「数据访问层」;core.go 包注释补上 DAL/DAO 全称 命名规范补登(AR09 是命名问题的最高依据,改了名就得回去登记): - AR09 §3.1 术语表新增「数据访问层 dal / DAO」一行 - AR09 §5.6 缩写表新增 DAO / dal —— 原文是「只有下表内的缩写允许使用」, 不登记就是自己破自己的规矩 - PROJECT_STATE.md 新增 D27 记录本次更名决策 验证:全部在 db 副本上做,生产库 data/eai_agentplatform.db 未触碰。 - 等价性对照:拿 HEAD 源码 + 仅改名 造出第二棵树,两棵树各自起 httptest 服务跑同一份探针(60 个 GET + 13 个写/回读,覆盖专员/技能/应用/ 任务/交付物/项目/岗位/考试/知识/积分/管理端只读等),逐端点比对响应体: 73 项里 52 项字节完全一致、21 项仅运行期时间戳不同、内容差异 0。 - 探针非空:往改名后的树注入「SpecialistDAO.List 限 3 条」变异, /api/specialists 立刻被抓出 —— 证明上面那个 0 不是没测到。 - 暂存区自洽:把索引整个导出成源码树,go build / go vet / go test ./... 全绿。 - gofmt:因 import 排序变化而错位的 19 个文件已修;另 2 个文件(skill_definition.go、 seed.go)的格式问题是工作区里别人的在制品带来的,未替其改动。 未纳入本次提交:工作区里正在进行中的「文生语音技能 + 技能展示色/交互卡」 (tts_handlers.go、text_to_speech/manifest.go、skillCatalog.js 等), 以及 router.go / skill_definition.go / seed.go 三个文件里属于该在制品的改动 —— 这三个文件只把「改名那一版」放进索引,工作区原样保留。 Co-Authored-By: Claude Code <noreply@anthropic.com>
02_Architecture — 架构设计
命名规则:
AR{NN}_{描述}.md用途: 后端架构、前端架构、数据库架构、部署架构⚠️
AR01–AR04为 V1.1 设计期历史快照。 当前实现已重写为 Go + Gin + GORM + SQLite + Go 原生 brute-force 向量检索,以docs/changelog.md、docs/db_schema.md、docs/deploy.md为准。AR05–AR08是 2026-09-16 / 17 的工作台设计稿,不属于 V1.1 快照,其中AR08为部分被取代稿,取用前先读其文首补注。 当前产品导航与工作台口径,请以docs/01_System_Overall/SY22_Role_Skill_App_Unified_Task_Architecture.md为准:新建任务 / 项目 / 专员·技能·APP·连接器 / 长程APP / 知识库 / 后台管理 / 我的AR09是规范性文件(对象命名规范),不是设计稿。 它约束新增代码的命名,并登记了当前已核实的命名问题与修复流程;与TOP_CODING_RULES.md的 G03 配套使用。
文件清单
| 文件 | 说明 |
|---|---|
README.md |
本索引文件 |
AR01_Backend_Arch.md |
后端架构(V1.1 FastAPI 快照;现为 Go + Gin + GORM) |
AR02_Frontend_Arch.md |
前端架构(Vue3 + Element Plus 三栏布局) |
AR03_Database_Arch.md |
数据库架构(SQLite 单文件 + Go 原生向量检索) |
AR04_Deploy_Arch.md |
部署架构(V1.1 Docker 快照;现为单二进制 + systemd) |
AR05_Workbench_Architecture_Contract.md |
数字员工 Workbench 架构合同(任务为中心、对象挂载到任务,前端重构强约束) |
AR06_Skill_Packaging_Specification.md |
技能文件规范(技能 = 定义文件 + 执行器 + 结果组件,不以独立页面存在) |
AR07_Architecture_Alignment_Audit.md |
架构对齐确认与本轮修复范围(收敛两套并行模型的确认记录) |
AR08_Role_Interaction_Design.md |
AI 角色与工具统一交互设计(部分被取代:不跳页结论已采纳,「数字技术员」对象已废弃,见文首补注) |
AR09_Object_Naming_Standard.md |
对象命名规范(规范性文件:原理 / 判据 / 术语表 / 分层规范 / 检查守卫 / 修复流程 / 现状问题登记 / 反例库) |
AR10_XApp_Removable_Packaging_Specification.md |
XApp 可删除封装规范(面向一级业务包,目标是“删目录 + 删注册 + 跑卸载”) |
AR11_Skill_Specialist_Connector_Removable_Packaging_Specification.md |
Skill / Specialist / Connector 可删除封装规范(复用 AR10 思想,但区分能力包、策略定义包、连接插件包的边界) |