From ad4e8d18a0a78e9342192c96ce39a50caecd705a Mon Sep 17 00:00:00 2001 From: JefMacMini Date: Tue, 8 Sep 2026 23:58:20 +0800 Subject: [PATCH] docs: align task workspace milestones while preserving history --- HANDOVER.md | 8 ++++++++ PROJECT_CONTEXT.md | 14 ++++++++++++++ README.md | 10 ++++++++++ agent/README.md | 4 ++++ backend/README.md | 10 ++++++++++ backend/app/knowledge/README.md | 4 ++++ docs/api/README.md | 16 ++++++++++++++++ docs/architecture.md | 10 ++++++++++ docs/backend-development.md | 4 ++++ docs/data-and-frontend-boundaries.md | 6 ++++++ docs/data-dictionary.md | 16 ++++++++++++++++ docs/local-macos-development.md | 10 ++++++++++ docs/reports/agent-business-outcomes.md | 4 ++++ docs/reports/agent-progress-events.md | 4 ++++ docs/reports/agent-workspace-delivery.md | 10 ++++++++++ docs/reports/task-workspace-verification.md | 4 ++++ docs/runbooks/knowledge-server-handoff.md | 8 ++++++++ frontend/README.md | 12 ++++++++++++ frontend/style.md | 4 ++++ 19 files changed, 158 insertions(+) diff --git a/HANDOVER.md b/HANDOVER.md index 3224f14..58ebe74 100644 --- a/HANDOVER.md +++ b/HANDOVER.md @@ -1,5 +1,13 @@ # ShopSteward 当前开发交接 + +### 三阶段合并状态与旧文阅读规则（2026-09-08增补） + +[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)已合并第一阶段；[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)已于2026-09-08合并第二/三阶段及补齐项，提交 `1bbcad5`，与已测 `c7607ea` 文件树相同，[Windows CI](https://github.com/yhnapoleon/ShopSteward/actions/runs/34246514054)通过。工程事实统一从[组合交付说明](docs/reports/agent-workspace-delivery.md)进入。 + +本次Markdown增补只明确当前状态与历史适用范围，原正文、测试数字和验证JSON不改写。下方“第二/三阶段尚未提交”“证据/试算未实现”等仍描述各报告形成时点；不能据此重复开发或重新认领已合并工作。语音、正文流、多任务并发、完整Agent验收和已知排队延迟仍是未完成项。 + + ### Agent工作区组合交付（2026-09-08） 第二、三阶段及原件下载/代码块复制已组成同一交付范围。[组合交付说明](docs/reports/agent-workspace-delivery.md)逐项说明业务目标、后端支撑边界、迁移要求与验证；[最终指纹](docs/reports/agent-workspace-delivery-verification.json)对应本轮组合源码。515项后端/Agent普通用例分批通过，2项真实浏览器通过，23项前端回归通过。四项文档运行时配置失败补齐环境后复验通过，未改变业务实现。 diff --git a/PROJECT_CONTEXT.md b/PROJECT_CONTEXT.md index cfc481d..cab765d 100644 --- a/PROJECT_CONTEXT.md +++ b/PROJECT_CONTEXT.md @@ -1,5 +1,19 @@ # ShopSteward 项目总说明与对话交接 + +### 三阶段任务交互已合并（2026-09-08增补） + +第一阶段建立同一Mission贯穿的任务卡、独立详情页、常驻Agent区和共享会话，通过[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)合并为 `c46e85c`。第二阶段增加真实工具生命周期与可恢复事件；第三阶段增加准确历史证据、结构化试算/修订成果，并补齐历史原件下载和逐代码块复制，通过[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并为 `1bbcad5`，文件树与已验证 `c7607ea` 一致。 + +本次是前后端支撑能力交付：backend/agent_bridge、读取契约、事件/活动存储和就绪检查承接前端需求，组合代码需要 `0012_agent_progress`。规划、Mission、账本、审批执行、经营状态、业务调度和 `agent/` 主体源码未改。依据、作用条件与分批验证统一见[组合交付](docs/reports/agent-workspace-delivery.md)，运行接续见[HANDOVER](HANDOVER.md)。 + +本机Mac mini模型保持关闭；先前Windows真实模型报告仍保留其原版本和环境，不能视为三阶段新增体验的模型验收。语音、正文流、多任务并发、完整A-01/L-01及远端Knowledge新一轮验收仍未完成。 + +以下“最新”小节按各自阶段时点保留，包括PR #10创建时状态、早期接口数、迁移版本和运行进程。它们不替代本节与HANDOVER顶部的当前接续；知识服务交付、上云限制和原业务职责不因本次前端交付而被删除或判定完成。 + +原Windows参考工程及仓库外资料链接保留来源环境；本机未能解析的旧路径不能当作当前可用入口，也不通过创建空文件或复制工程来补造来源。 + + ### 最新实施与交付：知识检索及服务器交接（2026-09-08） 本轮新增独立 `knowledge` 服务、解析/索引/重试与发布、PG有向关系、可选云embedding与重排接口、Agent只读证据工具及Compose/恢复/验证工具。已按用户要求本地提交并推送到YH，创建 [PR #10](https://github.com/yhnapoleon/ShopSteward/pull/10)（YH → main，更新时为OPEN，未合并）。功能提交 `96ee2a0`，同步main提交 `2406371`，完整手册提交 `e65e066`；未部署到开发服务或创建云资源。原K0冻结集与K1契约保留；新backend迁移 `0011_knowledge_delivery` 和独立knowledge迁移 `knowledge_0002` 已通过专用PG验收。 diff --git a/README.md b/README.md index 1a4638d..7c88b83 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,15 @@ # ShopSteward + +## 当前实现入口（2026-09-08增补） + +任务工作区第一阶段已通过[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)合并；真实工具进度、历史证据、试算/修订成果及原件下载/代码块复制通过[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并为 `1bbcad5`。从[当前交接](HANDOVER.md)与[三阶段组合交付](docs/reports/agent-workspace-delivery.md)读取实际能力、迁移和验证边界。 + +第二、三阶段包含必要的后端桥接、接口与持久记录改动，业务库要求 `0012_agent_progress`；没有改动既有规划、账本、审批执行、Mission、业务调度和Agent主体源码。模型启用情况按运行环境核对，合并不代表完整A-01/L-01或部署验收。 + +下方“B0-01至B0-05”“下一步B0-06”“Agent后续接入”“21个操作”“空目录”等文字与目录示意保留初始搭建时点；不再作为当前进度或完整目录清单。模块职责和原有启动入口继续保留。 + + [项目总说明与对话交接](PROJECT_CONTEXT.md)：新对话先读，包含架构、资料与参考项目索引，以及主干设计/实施状态。 按团队职责划分的项目。backend已完成B0-01至B0-05：业务事实、Mission/规划、警报/看板/历史、审批采购与回执核对；显式推进的完整SC01已验证。下一步为B0-06周期调度。 diff --git a/agent/README.md b/agent/README.md index 1a21ac7..b1043f7 100644 --- a/agent/README.md +++ b/agent/README.md @@ -1,5 +1,9 @@ # ShopSteward Agent + +> **2026-09-08任务工作区接入增补：** [PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)在 `backend/app/agent_bridge` 增加真实工具生命周期、进度回放与历史证据/业务成果公开投影；本目录Agent主图、模型适配、记忆及技能主体源码没有本轮改动。工具结果仍走原受限协议，`revise_plan` 成功结果额外保留 `base_plan_id`；采购确认不交给模型。运行支撑依赖业务库 `0012_agent_progress`，模型是否启用仍由当前环境配置决定。具体需求、事务/权限条件及受控执行器验收边界见[组合交付](../docs/reports/agent-workspace-delivery.md)。下方原模型/知识实验继续保留各自版本和环境，不计作三阶段新增UI的真实模型验收。 + + 首版已实现为 Python 包，由 backend 的独立 Agent worker 装配。真实 LangGraph 主图、OpenAI 模型、PostgreSQL 检查点、Hermes 派生记忆策略、任务 Skill 和受限业务工具已经贯通。前端聊天现已通过官方 `gpt-5.6-luna` 真实浏览器验收，包含解释、试算、修订、澄清恢复、偏好和主动跟进。外部 Agent HTTP 服务、向量 RAG、真实预测模型仍属于后续接入。 ```mermaid diff --git a/backend/README.md b/backend/README.md index d7803ef..5da7557 100644 --- a/backend/README.md +++ b/backend/README.md @@ -1,5 +1,15 @@ # Backend B0-01 至 B0-07 + +## 任务工作区所需后端支撑（2026-09-08增补） + +[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)组合版本需要迁移至 `0012_agent_progress`：新增Run进度序号、`agent_run_events` 与 `agent_tool_activity`，就绪检查验证这些结构。继续使用本模块既有迁移/启动命令，先核对目标数据库；独立Knowledge库的迁移不替代业务库迁移。 + +Agent桥接层提供真实工具开始/完成/失败/中断记录、事件回放/SSE、历史证据和结构化成果读取；修订结果增加原方案关联。业务目标、调用条件和验证见[组合交付](../docs/reports/agent-workspace-delivery.md)。规划、Mission、库存/现金账本、审批执行、业务调度和Agent主体源码未在此三阶段修改，不增加采购自主权限。 + +下文B0接口数和旧阶段边界保留历史用途；当前公开字段/路径以[运行时契约及增补](../docs/api/README.md)为准，不把已有设计稿的planned标记当作运行时不可用证明。 + + 后续已实现 B2-A Agent 框架：会话/Run、受限工具、记忆与任务 Skill、方案试算与修订、独立 Agent worker 和持久跟进。启动与 API 接入见 [Agent README](../agent/README.md)。当前迁移 head 为 `0009_agent_scopes`；原业务 worker 仍是默认 profile，Agent 不在线时原业务链路仍可工作。 已实现运行基础、业务状态/事件账本、Mission/规划、警报/看板/历史，以及B0-05精确审批、采购发送、资金预留、回执核对和到货入账。独立API/worker/simulator的显式完整SC01及重启回放已验证。B0-06已实现持久周期派发、Schedule配置、事件合并和持续新鲜度检查；自动SC01及三进程重启验收见 `docs/api/b0-06-periodic-smoke-result.json`。 diff --git a/backend/app/knowledge/README.md b/backend/app/knowledge/README.md index 86b5cce..0f7f528 100644 --- a/backend/app/knowledge/README.md +++ b/backend/app/knowledge/README.md @@ -1,5 +1,9 @@ # Knowledge K1 backend + +> **2026-09-08 integration update (PR #12):** This document retains the original K1 delivery and its test timestamps. The combined backend now requires `0012_agent_progress`; the `0010` readiness/head statements below describe K1's original checkpoint, not the current backend requirement. The separate Knowledge service migration is unchanged by this delivery. The Agent workspace can read an authorized historical excerpt from a committed tool result and download its exact original version through the existing version/content APIs. This does not add parsing/search controls to Document Center, change original-file ownership rules, or prove remote retrieval quality. See the [combined delivery](../../../docs/reports/agent-workspace-delivery.md) and [runtime API](../../../docs/api/README.md). + + Scope follows `docs/superpowers/plans/2026-09-07-k0-k1-execution.md`. K1 stores originals and metadata only. No index job, parsing, extraction, search, reindex or index activation is registered. Those belong to K2. diff --git a/docs/api/README.md b/docs/api/README.md index 4af3371..e1befcb 100644 --- a/docs/api/README.md +++ b/docs/api/README.md @@ -1,5 +1,21 @@ # Swagger / OpenAPI 契约使用说明 + +## 当前运行时契约增补（2026-09-08，PR #12） + +已核对 `1bbcad5` 的[运行时JSON](backend.runtime.openapi.json)：**50条路径、57个HTTP操作**，与当前已注册源码及前端生成类型/代理白名单一致。本文下方21/22/29/40/41等操作数及B2 planned文字属于各批设计/交付时点，原文保留；当前调用以runtime为准，不把设计草案直接当运行服务。 + +| 三阶段新增/扩展 | 读取语义与条件 | +|---|---| +| GET `/api/v1/agent-runs/{run_id}` | 原Run增加progress_seq、activity和outcomes；先校验会话所有者及门店权限；只白名单投影真实成果 | +| GET `/api/v1/agent-runs/{run_id}/events` | 按after_seq/limit回放，同一Run单调序号，超前游标拒绝 | +| GET `/api/v1/agent-runs/{run_id}/events/stream` | 同源SSE与Last-Event-ID恢复，连接期间重验身份；不提供模型私有推理 | +| GET `/api/v1/agent-runs/{run_id}/evidence` | 查询id/version_id/generation_id/chunk_id/metadata_revision/content_sha256，按持久记录读取准确历史片段并重新鉴权，未取到不换最新版 | +| 既有documents版本与content接口 | 历史片段弹窗复用它们下载原件，前端核对原件版本、大小和hash；不是新增下载协议 | + +`revise_plan`内部工具成功结果增加base_plan_id供准确前后比较，未修改普通用户方案审批/修订请求契约。组合代码依赖业务库 `0012_agent_progress`，独立Knowledge服务迁移另行管理。完整字段、错误、身份约束由runtime与[交付说明](../reports/agent-workspace-delivery.md)承接。 + + 完整设计契约仍包含待实现业务；B0、首批前端查询和 B2-A Agent 已实现，当前源码导出40个已注册操作（36条路径）。Agent 的11个操作见 [agent-v1.openapi.json](agent-v1.openapi.json)，启动与对话流程见 [Agent README](../../agent/README.md)。开发 backend 已迁移至 0009 并切换至当前代码，Agent 仍关闭。启动见 [Backend说明](../../backend/README.md)，实施范围见 [实现清单](implementation-status.json)。 2026-09-07 Simulator 控制台已实现：默认服务 9 个操作（含 ready），开启本地控制台后 19 个操作。可配置 SANDBOX 输入已同步到共享设计契约；运行契约见 [simulation runtime](simulation.runtime.openapi.json)、[console runtime](simulator-console.runtime.openapi.json)，验收见 [结果](simulator-console-acceptance-result.json)。 diff --git a/docs/architecture.md b/docs/architecture.md index 5afdfc0..1f83ada 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1,5 +1,15 @@ # 简化架构与分工 + +## 当前任务交互链路补充（2026-09-08） + +任务工作区三阶段已随[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)和[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并。一个Mission承接用户委托，Plan承接候选/修订，Action与批准承接实际采购；Conversation/Run承接对话和工具过程。前端共用同一任务/会话同步器，不为每张卡片复制任务或账目。 + +模型选择工具并解释结果；backend业务模块决定真实方案/账目/审批状态，Agent桥接层记录运行与工具生命周期并公开经过筛选的进度、历史证据和成果。结果/完成记录与原业务事务一致；当前Agent没有审批采购工具。第一阶段以已有接口为主，第二/三阶段包含新增桥接接口和0012存储，不应统称纯前端改动。 + +下方“Agent/RAG后接”的叙述、虚线和职责表保留原先分工阶段。Agent及Knowledge的已有实现见各模块说明；本次没有改动原主图、规划、账本、审批执行、业务调度或独立Knowledge服务架构。[组合交付](reports/agent-workspace-delivery.md)列明本轮已验与未验，不能将UI合并视为完整A-01/L-01或云部署完成。 + + 按交付模块划分，backend的B0-01至B0-07已完成；Mission、规划、警报、看板、审批采购、持续源同步及周期/事件调度可用。B0-07补齐组合故障与双worker进程验收，并修复两处锁竞争阻塞；范围与边界见[测试报告](reports/b0-07-test-report.md)。实际启动见 [Backend说明](../backend/README.md)。后端内部聚类与开发契约见 [Backend 开发与接口规范](backend-development.md)，接口预览见 [Swagger / OpenAPI](api/README.md)。以下按“先做 backend，Agent/RAG 后接”的最新安排更新职责。 ## 模块职责 diff --git a/docs/backend-development.md b/docs/backend-development.md index 74d2590..223d886 100644 --- a/docs/backend-development.md +++ b/docs/backend-development.md @@ -1,5 +1,9 @@ # ShopSteward Backend 开发与接口规范 + +> **2026-09-08实现口径增补：** 本文保留B0/B2设计、经营规则和历史兼容讨论。当前Agent会话/工具已实现，任务工作区三阶段的公开进度、历史证据和成果字段以[实际运行时API说明](api/README.md)及[组合交付](reports/agent-workspace-delivery.md)为准；下文B2 planned/未注册的文字限定原设计阶段。PR #12仅补Agent桥接、事件/活动记录、读取契约与就绪检查，业务库需0012；没有修改本文核心采购计算、账本、审批执行、Mission或业务调度实现。原设计JSON继续作为设计依据保留，不用其历史状态替代runtime。 + + 版本：0.2.0-draft · 日期：2026-09-07 · 状态：整体为开发设计；B0-01至B0-07已完成；自动SC01、双worker故障恢复及全服务重启已验证 本文面向后端、Nuxt 前端、模拟环境、预测模型和 Agent 的开发人员。目标是先完成不依赖 Agent/RAG 的确定性业务后端，再通过稳定契约接入智能能力。本文中的路径、端口、频率、状态和字段是本项目建议采用的约定；不表示当前仓库已经提供这些能力。 diff --git a/docs/data-and-frontend-boundaries.md b/docs/data-and-frontend-boundaries.md index c094a7b..f560959 100644 --- a/docs/data-and-frontend-boundaries.md +++ b/docs/data-and-frontend-boundaries.md @@ -1,5 +1,11 @@ # 数据存储与前端访问边界梳理 + +> **2026-09-08后续实现索引：** 本文以下是2026-09-07原范围分析，表内“尚未实现”、21张表及旧接口数按当时时点保留。现已具备真实前端、Agent会话/运行、知识资料管理，以及[PR #12组合交付](reports/agent-workspace-delivery.md)的持久工具进度、准确历史证据和试算/修订成果。新增数据边界见[数据字典增补](data-dictionary.md)，公开读取见[API增补](api/README.md)。这没有补齐通用报价持久产物、完整L-01或多任务经营范围；原分析中这些剩余问题仍保留。 + +原文的仓库外产品建议资料路径在本机未找到，保留原链接供追溯；本次三阶段判断使用上方已核对的交付、数据字典和runtime，不把缺失旧副本当作现行实现依据。 + + 日期：2026-09-07。性质：依据现有需求与代码形成的**范围核对及契约建议**，不是已批准的新实现计划，也不表示下列拟议接口已经上线。本轮只读取资料、核对源码与生成文档，没有修改业务代码、数据库或飞书原文。 后续进展：用户同意后，已据此完成[首批数据字典](data-dictionary.md)、[补充OpenAPI](api/frontend-data.openapi.json)及[实施计划](superpowers/plans/2026-09-07-frontend-data-implementation.md)，并实现7个只读GET；当前runtime为29操作/28路径，见[测试报告](reports/frontend-data-test-report.md)。以下保留实施前边界分析的依据；具体字段与查询规则以新字典和契约为准。 diff --git a/docs/data-dictionary.md b/docs/data-dictionary.md index 938ae7e..5b8f23f 100644 --- a/docs/data-dictionary.md +++ b/docs/data-dictionary.md @@ -1,5 +1,21 @@ # 首批前端数据字典 v1 + +## Agent过程、证据与成果的数据增补（2026-09-08） + +本字典原有业务字段与查询口径保留。三阶段新增的是可观察过程与只读成果，不能用模型文字或前端副本代替经营账本。当前字段来源见[运行时契约](api/backend.runtime.openapi.json)及[组合交付](reports/agent-workspace-delivery.md)。 + +| 对象 | 持久来源 | 含义与约束 | +|---|---|---| +| Run进度序号 | agent_runs.progress_seq | 0012新增，Run内递增；作为快照/事件恢复水位 | +| 运行事件 | agent_run_events | Run+seq唯一；记录排队、开始、补充输入、终态及工具生命周期，保留事件发生时点 | +| 工具活动 | agent_tool_activity | Run+invocation唯一；状态、attempt、服务端起止与耗时，不暴露参数/租约凭据 | +| 试算/修订成果 | 既有agent_tool_calls与plans | 白名单投影候选、约束和前后版本；修订调用保留base_plan_id，不另建影子方案/账本 | +| 历史文档片段 | 既有工具结果、文档与原件版本 | 精确绑定document/version/generation/chunk/metadata revision/hash/locator；当前权限、归档及原件存在性仍须检查 | + +Plan、Run、工具调用和Action不是同一对象；仅试算不写经营事实，方案更新不代表已采购，采购受理不代表已到货。历史结果版本落后时显示历史口径；缺少明确关联不补造原方案。原字典内早期接口/表计数不涵盖此增补。 + + 日期：2026-09-07。**新增7个GET接口已实现**，runtime现为29个操作、28条路径；基础提交为`YH / da79cbd`，实现保留在工作区。需求依据见[来源与范围核对](data-and-frontend-boundaries.md)；字段约定和示例见[前端数据OpenAPI](api/frontend-data.openapi.json)，实际服务schema见[runtime](api/backend.runtime.openapi.json)；处理规则见[设计规格](superpowers/specs/2026-09-07-frontend-data-contract-design.md)，验证见[测试报告](reports/frontend-data-test-report.md)。 状态含义：**已有**=当前代码保存/计算并可按接口访问；**新增查询**=本批已提供的7个只读接口；**后续范围**=本批不建立字段或表，不能返回伪造默认值。逻辑对象不必一一建表；派生展示字段不创建第二份权威事实。 diff --git a/docs/local-macos-development.md b/docs/local-macos-development.md index cb89a6d..f524646 100644 --- a/docs/local-macos-development.md +++ b/docs/local-macos-development.md @@ -1,5 +1,15 @@ # macOS 本地开发 + +## 当前Mac mini接续补充（2026-09-08） + +三阶段已通过[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)、[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并，业务代码 `1bbcad5` 需要 `0012_agent_progress`。Mac mini开发库已在第二阶段备份并升级0012；下文9382779基准、0009/0010迁移、空前端和初次测试数字继续保留原环境配置时点，不表示当前版本。 + +本指南的start/status/migrate/test仍是该Mac mini环境入口；实际进程每次用status核对，不能沿用旧PID。三阶段没有改变其他机器环境、业务调度或模拟器迁移。真实模型保持关闭，未启动Agent worker；已有窗口中的旧Windows模型记录不改变本机设置。 + +组合验证见[交付说明](reports/agent-workspace-delivery.md)。全部后端/Agent测试须按本脚本使用backend/pyproject.toml配置；语料的Office/PDF用例还需将KNOWLEDGE_DOCUMENT_PYTHON指向本机已存在且包含对应库的文档Python运行时。该值因机器而异，缺配置的失败不能算业务通过，也不能为测试删改原业务实现。 + + 2026-09-07 · 已在Apple Silicon Mac完成本机配置和验证。基准为main提交 `9382779` 加本次未提交的Mac适配改动；不是新的团队合并版本。真实模型由用户明确暂缓配置，当前只启动业务worker。 ## 日常使用 diff --git a/docs/reports/agent-business-outcomes.md b/docs/reports/agent-business-outcomes.md index 0870ab2..8c8ef13 100644 --- a/docs/reports/agent-business-outcomes.md +++ b/docs/reports/agent-business-outcomes.md @@ -1,5 +1,9 @@ # 证据与业务成果 · 第三阶段 + +> **后续状态（2026-09-08增补）：** 本报告保留第三阶段原实现与61/12项验证时点。随后补齐历史版本原件下载、代码块复制，并将第二/三阶段一并通过[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并为1bbcad5；[组合交付](agent-workspace-delivery.md)及其验证JSON承接最终源码。下文“未提交”已由该合并取代；旧结果缺关联、模型关闭、远端检索未验等局限继续成立。原机器可读证据不因本次Markdown增补而重写。 + + 2026-09-08。基准 `jeffrey / c46e85c`，第二阶段未提交改动继续保留；本阶段也未提交、推送或部署。开工时第二阶段验证JSON的源码指纹全部一致，基线差异和36份文件指纹保存在ignored `var/phase3-baseline/`。旧 `HANDOVER 2.md` 和stash未处理。 ## 用户怎样操作 diff --git a/docs/reports/agent-progress-events.md b/docs/reports/agent-progress-events.md index 9d45a4d..bdc9e14 100644 --- a/docs/reports/agent-progress-events.md +++ b/docs/reports/agent-progress-events.md @@ -1,5 +1,9 @@ # Agent工具生命周期 · 第二阶段 + +> **后续状态（2026-09-08增补）：** 本报告保留第二阶段形成时的实现、失败/续验与验证数字；“未提交”“下一步证据/试算”等文字是当时状态。第二阶段现已与第三阶段通过[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并为1bbcad5，后续能力与组合验证见[交付说明](agent-workspace-delivery.md)。原64/23/4项及SC01超时后续验仍按原口径保留，不能与后续批次相加或改写为完整自动流程一次通过。 + + 2026-09-08。第一阶段已通过[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)合并为 `c46e85c`，合并前 `8b9246b` 的[Windows CI](https://github.com/yhnapoleon/ShopSteward/actions/runs/34228884666)通过。第二阶段在该合并基线上独立实现，目前为个人分支的未提交改动；没有并入第一阶段PR。 ## 做了什么，业务上意味着什么 diff --git a/docs/reports/agent-workspace-delivery.md b/docs/reports/agent-workspace-delivery.md index 993812e..e699fc9 100644 --- a/docs/reports/agent-workspace-delivery.md +++ b/docs/reports/agent-workspace-delivery.md @@ -1,5 +1,15 @@ # Agent 工作区：第二、三阶段交付 + +## 合并结果与三阶段关系（2026-09-08增补） + +[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)交付第一阶段任务页和共享会话，合并为c46e85c。[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)交付本页第二/三阶段及两个补齐项，已合并为 **1bbcad543554a4324979bb0df452bdfed13060db**；合并树与已测 **c7607ea2490f58482d8cc77036fa653bbaf4e830** 一致，[Windows CI](https://github.com/yhnapoleon/ShopSteward/actions/runs/34246514054)通过。 + +本文以下验证与范围说明保留，515项普通用例是失败项补配置后分批覆盖，2项显式浏览器另跑，23项前端及复制定向复验不重复累加。合并不等于部署、真实模型/远端检索或完整首版验收。 + +本次仅增补相关Markdown的当前状态和历史适用说明；原报告JSON继续保留原始哈希及验证时点，其中包含的MD哈希不冒充本次增补后的文件哈希。源码、测试、生成契约和原有证据文件未因本次文档对齐而修改。 + + 2026-09-08，基于第一阶段合并提交 `c46e85c`。本次交付覆盖真实工具进度、历史证据、结构化试算和方案变化，并补齐原件下载与代码块复制。阶段二/三的原始报告保留各自验证时点；本页及[最终验证指纹](agent-workspace-delivery-verification.json)记录组合版本。 ## 业务目标与后端边界 diff --git a/docs/reports/task-workspace-verification.md b/docs/reports/task-workspace-verification.md index c27d9f7..e048f30 100644 --- a/docs/reports/task-workspace-verification.md +++ b/docs/reports/task-workspace-verification.md @@ -1,5 +1,9 @@ # 任务工作区前端 · 第一阶段 + +> **后续状态（2026-09-08增补）：** 本报告是第一阶段原验收记录，正文、测试数字与JSON指纹保持原时点。第一阶段已通过[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)合并为c46e85c；其中“尚无工具开始/原文/完整试算”的缺口由后续[PR #12组合交付](agent-workspace-delivery.md)补齐。语音、流式正文和多任务并发仍未实现。第一阶段的“后端契约未修改”不能扩展为第二/三阶段也没有后端支撑改动。 + + 2026-09-08，Mac mini；验证基于 `jeffrey / 5f57a3b` 的提交前工作区；后续发布状态见仓库交接与GitHub。用户在本轮确认“任务卡片 → 独立任务页 → 常驻 Agent 工作区”，以及“后端确定状态、运行时上报工具、Agent 解释工作”的职责分离。本报告只说明当前交付，不将下一阶段视为已经实现。 ## 已实现的体验 diff --git a/docs/runbooks/knowledge-server-handoff.md b/docs/runbooks/knowledge-server-handoff.md index 42e6e79..820c633 100644 --- a/docs/runbooks/knowledge-server-handoff.md +++ b/docs/runbooks/knowledge-server-handoff.md @@ -1,5 +1,9 @@ # Knowledge 服务器交接与部署完整手册 + +> **2026-09-08业务backend版本增补：** 本手册原Knowledge交付、部署步骤、迁移所有权和未验限制全部保留。若使用[PR #12组合代码](../reports/agent-workspace-delivery.md)（`1bbcad5`），业务backend库必须迁移至 `0012_agent_progress`；下文§6中的0011预期及排障表的0011检查是本手册原交付时点。独立Knowledge库仍按本文自己的 `knowledge_0002` 流程核验，不能用它代替业务库迁移。三阶段没有修改Knowledge服务部署或宣称云端已验收；现有`upgrade head`命令继续按所选代码/目标库使用。 + + 更新：2026-09-08。本文整合部署边界、配置、启动、入库、LangGraph接入、测试、恢复、运维和选型说明。服务器负责人可以按本文完成准备与试部署，无需先阅读其他说明文档；末尾链接仅用于源码、原始证据和进一步审查。实际操作仍需仓库中的代码、Compose、依赖锁和语料文件。 **当前结论：可以开展隔离云端试部署，完整搬迁验收尚未通过。`pilot_ready=false`、`MVP_ready=false`。** 本文中“已验证”指已完成的本地隔离运行；Linux/云端命令是根据当前代码整理的操作步骤，尚未在目标服务器执行。没有选定云厂商、区域、正式机器规格或最终embedding模型。 @@ -311,6 +315,10 @@ backend/publisher/Agent进程要使用相同测试库、key、URL和业务授权 Windows把 `../.venv/bin/python` 换为 `../.venv/Scripts/python.exe`。这些命令使用 `DATABASE_URL`，务必确认指向shopsteward_test；预期 `0011_knowledge_delivery`。已有 `tests/integration/test_knowledge_runner.py` 会读取本机backend/.env并派生测试库，但它不是新服务器自动配置工具。 + +> **使用PR #12代码时：** 上句0011仅为原手册预期；当前业务backend应核对 `0012_agent_progress`。命令保持 `upgrade head/current/check`，先确认DATABASE_URL的目标库。独立Knowledge库仍使用自己的迁移版本。 + + 在backend目录分别启动三个进程，采用上面的同一组私有配置： ```bash diff --git a/frontend/README.md b/frontend/README.md index 5462811..9f0c3c3 100644 --- a/frontend/README.md +++ b/frontend/README.md @@ -1,5 +1,17 @@ # ShopSteward 前端 + +## 三阶段当前行为与适用范围（2026-09-08增补） + +第一阶段经[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)合并；第二/三阶段及补齐项经[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并为 `1bbcad5`。当前是“首页任务卡 → 同一Mission详情 → 方案/事实与常驻Agent区”，手机在业务结果与Agent间切换；真实工具状态、历史片段、试算/修订成果可恢复，原件入口固定引用版本，代码块可逐段复制。 + +这一组合版本包含后端支撑变化，需要 `0012_agent_progress`；试算不改变方案或账目，修订仍需独立采购确认，停止回答不撤销已提交变更。接口、条件和分批验收见[组合交付](../docs/reports/agent-workspace-delivery.md)与[运行时契约](../docs/api/backend.runtime.openapi.json)。 + +下文“任务工作区·2026-09-08”是第一阶段记录，其中“实时工具生命周期属于下一阶段”仅适用于当时。“文档中心不接Agent引用”限定文档中心自身的K1管理职责；当前Agent区已可核对历史证据，不代表文档中心已新增检索控制。早期“无迁移/后端不变”和Windows模型通过记录也仅对应各自那一轮。 + +本机模型保持关闭；语音、流式正文、多任务并发、完整A-01/L-01及远端检索的本轮联合验收未纳入。旧后端的工具完成摘要降级不等于完整支持当前成果/证据接口，缺能力时不能猜测结果。 + + 按v0.3高仿真原型实现的Nuxt/Vue前端，面向首版接口联调。默认三项主视图外，另提供只读的次级经营概览。当前视觉采用暖光磨砂、顶部导航、连续经营工作区、固定快捷浮条、资料入口和确认弹层；经营名称、数值、日期与状态取真实API，不使用原型的模拟账本或文字匹配来驱动采购。 后续界面迭代先读取[前端视觉规范](style.md)，沿用当前的材质、布局、控件、响应式与验证约定。经营功能与接口边界仍以下文为准。 diff --git a/frontend/style.md b/frontend/style.md index 2860e45..81f3258 100644 --- a/frontend/style.md +++ b/frontend/style.md @@ -1,5 +1,9 @@ # ShopSteward 前端视觉规范 + +> **2026-09-08三阶段状态增补：** 当前呈现以第10–12节及其原件下载/代码复制补充为准，实现已随[PR #11](https://github.com/yhnapoleon/ShopSteward/pull/11)、[PR #12](https://github.com/yhnapoleon/ShopSteward/pull/12)合并。前文原材质、排版、控件和响应式规则保留；不同阶段的未实现提示按其时点阅读，功能与验证边界见[组合交付](../docs/reports/agent-workspace-delivery.md)。本次不改样式源码或原设计参数。 + + 2026-09-07 · 暖光磨砂风格。本文件记录当前已实现的视觉语言，供后续前端迭代沿用。修改界面前先读本文件，再核对对应组件和 `app/assets/css/shop.css`；具体数值以样式源码为准，显著风格调整需同步更新本文。 ## 1. 产品气质与信息层级