From b96ab1303ade6eee9dac8d4b23408bd4ca1e9a76 Mon Sep 17 00:00:00 2001 From: bruce Date: Sat, 6 Jun 2026 00:56:41 +0800 Subject: [PATCH] =?UTF-8?q?docs(file-summary):=20=E5=AF=B9=E9=BD=90?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=B7=AF=E5=BE=84=E5=92=8C=E9=99=84=E4=BB=B6?= =?UTF-8?q?=E6=A8=A1=E5=9E=8B=E5=91=BD=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/2.功能设计/1.自动汇总.md | 10 +++++----- docs/3.详细设计/1.自动汇总.md | 4 ++-- docs/4.数据库设计/1.自动汇总.md | 6 +++--- docs/5.开发计划/1.自动汇总.md | 12 ++++++------ 4 files changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/2.功能设计/1.自动汇总.md b/docs/2.功能设计/1.自动汇总.md index d6bf121..4e3fcb4 100644 --- a/docs/2.功能设计/1.自动汇总.md +++ b/docs/2.功能设计/1.自动汇总.md @@ -4,7 +4,7 @@ | 项目 | 内容 | | --- | --- | -| 需求分析文档 | docs/需求分析/1.自动汇总.md | +| 需求分析文档 | docs/1.需求分析/1.自动汇总.md | | 功能名称 | 自动汇总文件夹文件目录与页数 | | 所属模块 | 审核智能体 review_agent | | 设计日期 | 2026-06-05 | @@ -137,7 +137,7 @@ WorkflowExecutor | 职责 | 接收对话页上传的压缩包或多个文件，保存原始文件，创建上传批次 | | 输入 | conversation_id、user_id、uploaded_files | | 输出 | batch_id、upload_file_ids、upload_type、original_storage_paths | -| 数据写入 | FileSummaryBatch、UploadedSourceFile | +| 数据写入 | FileSummaryBatch、FileAttachment、FileSummaryBatchAttachment | | 关键规则 | 文件必须绑定当前 Conversation；同一对话只使用本对话上传的文件 | ### 4.3 压缩包解压 Skill @@ -252,9 +252,9 @@ WorkflowExecutor | started_at | DateTimeField | 开始时间 | | finished_at | DateTimeField | 完成时间 | -### 5.2 UploadedSourceFile +### 5.2 FileAttachment -上传原始文件记录。 +上传原始文件记录。用户上传即存储为 `FileAttachment`，批次启动时再通过 `FileSummaryBatchAttachment` 固化本次使用的附件版本。 | 字段 | 类型 | 说明 | | --- | --- | --- | @@ -552,7 +552,7 @@ export_id -> batch -> conversation -> user | 设计点 | 说明 | | --- | --- | | 对话隔离 | 所有批次查询和下载必须校验 conversation.user | -| 防串文件 | 工作流只能读取当前 batch 绑定的 UploadedSourceFile | +| 防串文件 | 工作流只能读取当前 batch 通过 FileSummaryBatchAttachment 绑定的 FileAttachment | | 解压安全 | 禁止压缩包内路径跳出批次工作目录 | | 文件执行安全 | 不执行上传文件中的脚本、宏或外部链接 | | 下载权限 | 下载接口必须验证当前用户拥有批次所属对话 | diff --git a/docs/3.详细设计/1.自动汇总.md b/docs/3.详细设计/1.自动汇总.md index 36f468a..832534c 100644 --- a/docs/3.详细设计/1.自动汇总.md +++ b/docs/3.详细设计/1.自动汇总.md @@ -4,8 +4,8 @@ | 项目 | 内容 | | --- | --- | -| 需求分析文档 | docs/需求分析/1.自动汇总.md | -| 功能设计文档 | docs/功能设计/1.自动汇总.md | +| 需求分析文档 | docs/1.需求分析/1.自动汇总.md | +| 功能设计文档 | docs/2.功能设计/1.自动汇总.md | | 功能名称 | 自动汇总文件夹文件目录与页数 | | 所属模块 | 审核智能体 review_agent | | 设计日期 | 2026-06-05 | diff --git a/docs/4.数据库设计/1.自动汇总.md b/docs/4.数据库设计/1.自动汇总.md index 194c506..5ae7641 100644 --- a/docs/4.数据库设计/1.自动汇总.md +++ b/docs/4.数据库设计/1.自动汇总.md @@ -4,9 +4,9 @@ | 项目 | 内容 | | --- | --- | -| 需求分析文档 | docs/需求分析/1.自动汇总.md | -| 功能设计文档 | docs/功能设计/1.自动汇总.md | -| 详细设计文档 | docs/详细设计/1.自动汇总.md | +| 需求分析文档 | docs/1.需求分析/1.自动汇总.md | +| 功能设计文档 | docs/2.功能设计/1.自动汇总.md | +| 详细设计文档 | docs/3.详细设计/1.自动汇总.md | | 数据库类型 | SQLite / Django ORM | | 表名前缀 | ra_ | | 设计日期 | 2026-06-05 | diff --git a/docs/5.开发计划/1.自动汇总.md b/docs/5.开发计划/1.自动汇总.md index 86e4b96..bd4aee2 100644 --- a/docs/5.开发计划/1.自动汇总.md +++ b/docs/5.开发计划/1.自动汇总.md @@ -4,10 +4,10 @@ | 项目 | 内容 | | --- | --- | -| 需求分析文档 | docs/需求分析/1.自动汇总.md | -| 功能设计文档 | docs/功能设计/1.自动汇总.md | -| 详细设计文档 | docs/详细设计/1.自动汇总.md | -| 数据库设计文档 | docs/数据库设计/1.自动汇总.md | +| 需求分析文档 | docs/1.需求分析/1.自动汇总.md | +| 功能设计文档 | docs/2.功能设计/1.自动汇总.md | +| 详细设计文档 | docs/3.详细设计/1.自动汇总.md | +| 数据库设计文档 | docs/4.数据库设计/1.自动汇总.md | | 功能名称 | 自动汇总文件夹文件目录与页数 | | 所属模块 | 审核智能体 review_agent | | 执行方式 | 单人开发 + Codex 流水线自动化执行 | @@ -120,7 +120,7 @@ | 开发步骤 | 1. 定义 `FileAttachment`；2. 定义 `FileSummaryBatch`；3. 定义 `FileSummaryBatchAttachment`；4. 定义 `FileSummaryItem`；5. 定义 `WorkflowNodeRun`；6. 定义 `WorkflowEvent`；7. 定义 `ExportedSummaryFile`；8. 使用 Django `TextChoices` 管理枚举 | | 验收标准 | 模型字段、关联、默认值、`db_table`、`indexes`、`constraints` 与数据库设计一致 | | 验证命令 | `python manage.py check` | -| Codex 执行提示 | 请按 `docs/数据库设计/1.自动汇总.md` 在 `review_agent/models.py` 新增 7 个 `ra_` 表模型，使用 Django ORM、TextChoices、短表名、索引和唯一约束。 | +| Codex 执行提示 | 请按 `docs/4.数据库设计/1.自动汇总.md` 在 `review_agent/models.py` 新增 7 个 `ra_` 表模型，使用 Django ORM、TextChoices、短表名、索引和唯一约束。 | ### FS-P1-002 生成并验证数据库迁移 @@ -616,7 +616,7 @@ 后续可直接对 Codex 输入： ```text -请按 docs/开发计划/1.自动汇总.md 执行，从 V2 创建 codex/YYYYMMDD-自动汇总文件目录页数 分支，按 P0 到 P7 顺序开发、验证和阶段提交。每个阶段完成后调用 git-commit-summary 生成提交摘要并本地提交。全部完成后合并回 V2，并重新运行总体验收。 +请按 docs/5.开发计划/1.自动汇总.md 执行，从 V2 创建 codex/YYYYMMDD-自动汇总文件目录页数 分支，按 P0 到 P7 顺序开发、验证和阶段提交。每个阶段完成后调用 git-commit-summary 生成提交摘要并本地提交。全部完成后合并回 V2，并重新运行总体验收。 ``` ---