10 KiB
assistant 开发进度
维护日期：2026-10-22，日期采用 Asia/Shanghai。
本文件记录实际进展与验证事实。优化方向、优先级及后续步骤统一维护在 整体方案第 14 节。后续每轮结束前追加记录；本次将此前会话中的工作按阶段补记，不虚构各轮发生时间。
当前状态
- 已有 React/TypeScript 学习后台、FastAPI API、Node.js Playwright 工作进程。
- A2A 学习后台的适用页面与组件已裁剪迁入；原工程保持只读。
- 学习账本已接入独立 PostgreSQL 17。检索库准备
pg_search 0.26.1、pgvector 0.8.6；SQLite 保留作离线开发和测试适配，原数据及备份保留。 - 管理员在空账号库初始化为
admin / 123456，已有账号和密码不随启动重置。 - 已支持人工确认会话、采集证据、记录参数化步骤、生成不可变候选、静态校验、实际试跑及追加验证历史。
- 首期学习方式已确认为维护者与本地 Codex 协作：Codex 观察、编写、修订和验证，后台保留资料。未完成真实小红书学习，也未实现后台内置自主学习 Agent。
- 第一条目标链路为小红书「搜索笔记 → 详情 → 评论读取」。平台自动身份核验、完整独立来源读回、正式发布分发、Electron 商家端、macOS 实机验收及商业 AI/计量仍未完成。
- 最近已执行的工程验证为：后台套件 28 项通过、浏览器工作进程 12 项回归通过、PG + Edge 本机演示页端到端通过、检索扩展烟测通过。具体边界与证据见下文；这些阶段计数不累加，也不表示本轮重新执行。
- Git：基建代码与此前文档已提交并推送至
origin/main，主实现提交为cd34154；本轮同步结果见第 07 条，后续文档回写以实际远端提交为准。
2026-10-22-01：学习后台与浏览器基础（历史回填）
目标：先搭学习与验证基础，首条平台目标选小红书搜索、详情、评论读取。
已完成：
- 建立
apps/admin/、apps/server/、tools/learning/及本机启动/验证脚本。 - 从原 A2A 后台裁剪导航、学习批次、账本总览、能力实体、参数表、操作链详情、测试列表、历史及证据抽屉，接本项目 API；清单见 迁入来源。
- 实现固定账号资料目录、同账号会话互斥、人工确认后观察、动作前后证据和参数绑定。重开后保留资料，但需重新确认当前会话。
- 实现不可变候选与证据摘要绑定、追加验证记录、发布条件预检。未接入完整独立来源读回或正式分发。
- 修复工作进程 EOF/输出管道关闭时的清理，以及测试端口与实例标识隔离。
阶段验证：TypeScript 检查与生产构建通过；该阶段后台套件 19 项通过，浏览器回归后续收敛为 12 项真实 Edge 无头测试。浏览器测试仅使用隔离本机页面，不涉及真实小红书账号；保留 Cookie、会话互斥、正确/错误预期和执行中退出均有覆盖。
证据：浏览器测试脚本、本机回归报告。报告属于忽略的本机临时资产，不随仓库提交，不能当作其他设备的验证结果。
未完成：真实平台适配、平台身份自动核验、后台自主学习、macOS 实测、发布分发。原 A2A 的多机调度、完整知识合同与恢复系统未整包迁入。
提交/推送：本阶段基建尚未提交或推送。
2026-10-22-02：管理员初始化（历史回填）
目标：按用户要求初始化 admin / 123456。
已完成：空账号库一次性创建管理员，密码使用随机盐 scrypt 摘要；并发初始化幂等，已有任意维护者或已修改密码保留。登录表单默认账号为 admin，README 同步说明。
阶段验证：当时后台套件 23 项通过，实际本机登录返回成功，本机端到端也通过。该计数是后续 28 项套件之前的阶段快照。
未完成：本轮没有新增账号管理或改密页面。
提交/推送：未提交、未推送。
2026-10-22-03：PostgreSQL 与检索扩展（历史回填）
目标：学习后台使用 Docker PostgreSQL，并核对原项目的 pg_search / pgvector 与真实学习核心。
已完成：
- 增加 Compose 配置、初始化 SQL 和
pnpm db:up/status/stop/check；建立独立学习库、检索库和测试库。启动时实际健康检查通过，绑定本机55432端口，不据此推断当前持续在线。 - 存储层 支持 PostgreSQL URL 与独立 schema、原生参数绑定、事务互斥、顺序及不可变事实保护；SQLite 适配保留。health 增加
database_backend。 - 增加 迁移脚本：从一致备份导入空 PG 命名空间，同一事务核对数量，保留原 SQLite 和备份，非空目标拒绝覆盖。本次实际迁移 1 个维护者、2 条会话，无学习任务/候选/验证需要迁移；不声称已验证所有历史学习资料的迁移。
- 实际后台 health 返回
postgresql，迁移后的admin登录成功。 - 核对原工程：
pg_search/pgvector服务学习后的知识检索；原初次学习入口是独立 runner + Skills + 受限工具，部分 runner 与对象落盘实现仅适用 macOS，不能直接宣称 Win/Mac 完整迁移。
阶段验证：
- 后台套件 28 passed，无跳过，含 4 项真实 PG 用例；测试中的浏览器动作使用
FakeWorker，不属于真实平台验收。覆盖鉴权、候选并发、不可变事实、失败断言、密码保留和重启恢复。测试入口为pnpm test:server。 pnpm test:learning在专用 PG 测试库与随机 schema 中，用真实 Edge 跑本机演示页；保存 23 份观察、5 个步骤、2 组成功参数试跑和总计 4 条验证记录，故意错误预期正确失败，重启保留记录，发布预检未放行。证据见 本机端到端摘要。pnpm db:check验证 PG17、pg_search 0.26.1、vector 0.8.6，中文 BM25、平台过滤、索引计划及固定样本向量排序通过；未调用真实 embedding 服务，未测语义召回质量。- 方案图解七个标签页检查通过，未发现脚本错误或几何越界。
未完成：业务知识索引、真实 embedding、检索代际/发布资格衔接、自主学习、真实小红书和双端业务验收。完整规划见整体方案第 5.9、14 节。
提交/推送：未提交、未推送。
2026-10-22-04：确认本地 Codex 协作学习（历史回填）
目标：明确首期直接由本地 Codex 学习与固化。
已确认并写入方案：维护者登录 → 本地 Codex 观察与开发 → 提交候选 → 后台校验及变参试跑 → 根据证据修订；后台内置无人值守 Agent 后置。商家运行固化链路，内容理解/意图判断按需调用业务模型。
涉及文件：README、整体方案第 5.9 节与方案图解。
验证：文档差异检查通过；本轮为设计澄清，没有新增模型工具循环，也没有进行真实平台学习或重跑功能测试。
提交/推送：未提交、未推送。
2026-10-22-05：确认平台登录窗口（历史回填）
目标：明确小红书应在哪个浏览器登录。
已确认：Codex 右侧可以打开学习后台；平台登录在该后台「打开浏览器」启动的专用窗口完成，再回后台记录人工确认。日常 Chrome、Codex 右侧浏览器与该专用资料目录的登录态分别管理；资料持久化不保证平台永久免登录。
验证：此轮为操作说明，没有代码变更；尚未据此确认用户已登录，也没有采集真实小红书页面。
下一步：按 近期规划 完成首次实际观察与限定链路学习。
提交/推送：未执行。
2026-10-22-06：建立逐轮进度与规划维护约定
目标：每轮实际进度写入进度文档，优化与后续方向写入规划方案。
已完成：新增本进度文档并回填上述阶段；新增根 AGENTS.md 与持续生效的项目规则；README 增加入口；整体方案新增近期实施规划与维护约定，修正“尚无任何实测”的过时表述。
验证：本轮只修改文档和规则；执行本地链接与文档差异检查，不重复运行应用功能测试。历史 28 项套件及其他验收只作为历史事实引用。
未完成与下一步：真实小红书链路仍待学习，详见整体方案第 14 节。
提交/推送：未执行。
2026-10-22-07：提交并同步当前仓库（本轮）
目标：按用户指令，将当前学习后台基建、数据库配置模板、方案、图解、进度及项目规则同步到 GitHub。
本轮范围：apps/、tools/learning/、scripts/、Compose/初始化 SQL、依赖声明与锁文件，以及已有文档和项目规则；保留用户的 docs/Skills.md 内容并一并同步。
验证与检查：核对当前分支 main、远程 zwt-cmd/assistant、70 个暂存文件及忽略规则，远端无待合并更新；未发现真实凭据或私有连接串，.env、数据库、浏览器资料、依赖、构建和临时验收产物不进入提交。修正两处文件末尾多余空行，暂存差异检查通过，无功能变化；复用此前记录的功能验证结果，本轮不重复运行应用功能测试。
实施规划：本轮仅同步仓库，不改变整体方案第 14 节的优化优先级；下一步仍为本地 Codex 协作的小红书实际链路学习。
提交/推送：主实现提交 cd34154 已成功推送到 origin/main，远端从 f76f166 前进到 cd34154。前两次直连分别遇到连接重置与超时，定位系统本机代理后，以单次命令代理参数重试成功。本条为推送成功后的进度回写，随后续文档提交同步，最终状态以 origin/main 核验。