Commit Graph
169 Commits
Author SHA1 Message Date
lhl 5eac6480cf feat(frontend): 视觉重塑 - 深色指挥中心 + 文档工作台混合风格
- 颜色令牌替换 Material 蓝 → 深空灰底 (#0B0F17) + 唯一青绿强调色 (#5EEAD4)
- 字体策略:Google Fonts → 系统字体栈(-apple-system, PingFang SC, Microsoft YaHei 等)
- 六大区域样式全部按 spec §二 重写:侧边栏 / 顶栏 / 聊天 / 上传 / 输入 / 抽屉
- 气泡去掉阴影改细边;用户消息左侧 2px accent 竖条;助手消息顶头 6px accent 圆点
- 顶栏 backdrop-filter: blur(12px) 毛玻璃;抽屉 backdrop-filter: blur(8px) 遮罩
- 字号阶梯 11/12/13/14/15/17;圆角阶梯 6/10/14

spec: docs/superpowers/specs/2026-08-30-frontend-beautify-design.md
plan: docs/superpowers/plans/2026-08-30-frontend-beautify.md
2026-08-30 22:51:40 +08:00
lhl 561f7ee747 refactor(frontend): 拆分 chat.html 内联 CSS 到 chat.css(机械拆分,行为零变更) 2026-08-30 22:46:06 +08:00
lhl 520c9e25b0 feat(ui): 前端整改 —— RAG 入口产品化、放开 select、高级字段折叠、字段级红框
按"不考虑时间、考虑正确合理"原则逐块实施。

P0-B 放开 select
  - chat_state.js: shouldHideUploadSelect 始终 false; resolveUploadType 尊重用户选择
  - chat.html: 选项目时 select 不再隐藏 + 不再强改 file_type=requirements
  - 客户端 file_type↔扩展名校验(existing_system=.zip, requirements=.xlsx 等)
  - 项目已预置同类型时 confirm() 显式覆盖确认(不藏起入口)

P0-C 高级字段折叠 + 字段级红框
  - 项目抽屉主面板仅留 项目名/显示名;4 个服务器路径字段收进 details.advanced
  - saveDrawerProject 错误时按 ProjectConfigError label 关键字(模板/做成说明书/
    既有系统代码库/既有设计文档目录/项目名)给对应输入加 .invalid 3s 清除
  - 删除按钮 pf-delete 改用 hidden 而非 style.display

P0-A RAG 入口产品化
  - 后端 RagStore.count(scope) 线程安全读加锁
  - GenesisService.rag_stats(sid) 含 except 兜底(count 抛错返回 0)
  - GET /api/sessions/{sid}/rag-stats 端点
  - 前端顶栏:RAG 开关 + RAG 已索引 N 片段 状态徽标 + 开始影响调查按钮
  - 上传 existing_system 后自动 refreshRagStats 刷新徽标
  - 开关持久化到 localStorage(genesis_rag_enabled)

P1-D loadSession 不再隐式覆盖 draftProject
  - activeProject vs draftProject 分层;不一致时由 renderProjectMismatchHint
    提示用户主动"切到该项目"或"保留当前项目"
  - 保留 写入 sessionStorage 标记,避免每次 load 都提示

P1-F 删除抽屉项目 fallback 收敛
  - 先记 deleted 再清 drawerSelected,修复"先 null 后比较"恒假 bug
  - buildWelcome 唯一来源(chat_state.js 单点,前端内联重复移除)

P2-H 杂项
  - send() in-flight 锁防双击
  - input maxlength=2000
  - 启动恢复前校验项目存在 + loading 占位
  - select 关联 label for
  - esc 转义加 引号
  - sid 全程 encodeURIComponent
  - avatar 按 name hash 选色 + 中文首字(Array.from)+ aria-label 含名字

测试:619 passed / 99.01% 99.0% 达标(+8 覆盖 store.count/service.rag_stats/
rag-stats 端点/rag_stats 异常);Node chat_state 9 passed
2026-08-30 21:16:07 +08:00
lhl cc8850cffe docs(rag): 补录 RAG 迭代各任务评审报告 2026-08-30 00:57:36 +08:00
lhl b2277ebf05 feat(rag): 影响调查 RAG 化迭代(上传即索引 D1 / 线程安全 D2 / 强 e2e D3) 2026-08-30 00:49:02 +08:00
lhl ee224e7c56 test(rag): 补充引擎懒构建与 HTTP 级 RAG e2e 覆盖,恢复 99% 门禁 2026-08-30 00:44:49 +08:00
lhl 9a02fcd00f fix(rag): 移除 service 未用参数 + 引擎构建加锁 + 修正文档措辞 2026-08-30 00:31:18 +08:00
lhl f77fab707d feat(rag): 服务层接线(上传即索引 + use_rag 异步链路 + 强 e2e) 2026-08-30 00:25:24 +08:00
lhl 9514749b9f fix(rag): run_impact 改为 async 并 await 引擎(StructuredResult) 2026-08-29 23:16:12 +08:00
lhl 974bf12dc0 feat(rag): ImpactAgent 接入可选 RAG 上下文(use_rag) 2026-08-29 23:05:53 +08:00
lhl 9037ea6f4b fix(rag): 补充 ImpactRAG 分支测试与防御,覆盖率达 100% 2026-08-29 22:55:59 +08:00
lhl 6f0cb2f792 feat(rag): 新增 ImpactRAG 索引/检索服务(含 index_dir) 2026-08-29 22:48:42 +08:00
lhl 69a7ba7226 fix(rag): 强化 RagStore 并发读写验证 + close/健壮性 2026-08-29 22:45:17 +08:00
lhl 2eab0183ee feat(rag): 新增 RagStore(SQLite 向量存储 + 余弦检索,线程安全) 2026-08-29 22:39:37 +08:00
lhl afc09fc908 fix(rag): 移除 embeddings camelCase 死代码,覆盖率达 100% 2026-08-29 22:35:16 +08:00
lhl 9bc7828e63 feat(rag): 新增 Embedder 抽象与离线 FakeEmbedder 2026-08-29 22:27:24 +08:00
lhl 80daadcd31 fix(websocket): 修复 app.py 不可导入并新增真实链路验证
- 将 /api/sessions/{sid}/ws 端点移入 create_app(此前置于模块级导致整模块 import NameError,回归被验证拦截)
- register_loop + subscribe 调整至 accept 之前,缩小连接已开但未订阅期间的进度丢失窗口
- 新增 tests/test_verify_ws_real_flow.py:驱动真实 HTTP 聊天流程断言 WS 收到 agent 实际发射的 parse/impact 进度
- 同步 WebSocket 计划文档 Task 3 代码片段(标注端点必须位于 create_app 内)
- 全量 pytest 实测 583 passed / 99.03% 达标
2026-08-29 14:36:12 +08:00
lhl 9f5342e2be docs: 追加 WebSocket 进度流实现记录(_AI_USAGE_LOG) 2026-08-29 12:21:04 +08:00
lhl 6cb92e3798 test(chat): WebSocket 进度流端到端冒烟 + design.md 记录 2026-08-29 12:15:02 +08:00
lhl 14a7dc3501 feat(chat): 前端 chat_ws.js 实时渲染进度/错误(保留重载兜底) 2026-08-29 11:58:38 +08:00
lhl 61611b6b8a feat(server): 暴露 /api/sessions/{sid}/ws 进度流端点(+websockets 依赖) 2026-08-29 11:55:45 +08:00
lhl 8493bea589 feat(chat): agent 产出进度/错误时发射事件(保留持久化兜底) 2026-08-29 11:46:22 +08:00
lhl 91ac52de5f chore(test): 声明 pytest-asyncio 依赖并启用 asyncio_mode=auto(Task1 异步测试可复现) 2026-08-29 11:42:05 +08:00
lhl 74d15ccdc2 feat(server): 新增 ProgressHub 进程内进度发布/订阅单例 2026-08-29 11:40:48 +08:00
lhl 014a51a277 docs: 新增 WebSocket/RAG 迭代计划与工程评审记录(规划产物) 2026-08-29 11:37:45 +08:00
lhl be79624db5 fix(chat): 前端审计修复——预览契约改HTML/状态机统一/进度错误持久化/chat_state.js抽取
- app.py: /result/preview 返回渲染 HTML(HTMLResponse) 而非 {html} JSON;新增 /chat_state.js 静态路由;预览缺失返回 404(RESULT_NOT_FOUND)
- chat.html: currentProject 统一为 draftProject;新会话继承已选项目(§4.2);上传区显隐/类型映射/抽屉脏检测改用 GenesisState;loadSession 按 role 渲染 progress/error;加 h1 标题
- chat_state.js(新): 抽取 autoBindProject/shouldHideUploadSelect/resolveUploadType/computeDrawerSnapshot/isDrawerDirty/buildWelcome 纯函数(U+1 分隔符)
- agent.py: 新增 _persist_progress/_store_error,进度与错误以 role 入库(重载可见)
- 测试: test_chat_state.js(11 passed) + test_frontend_audit_fixes.py(5) + 修正 test_server_api 旧 JSON 契约断言;全量 pytest 568 passed / 99.06%
2026-08-29 11:28:08 +08:00
lhl c7897a15c1 docs: 更新 AI 使用日志(UI 修复 3 项) 2026-08-28 15:34:12 +08:00
lhl 8ff935122c fix(chat): UI 修复—抽屉+新建项目可见性/标题迁移/折叠按钮不遮挡logo 2026-08-28 15:33:45 +08:00
lhl a225c84dc8 docs: 新增 chat v4 DeepSeek 会话模式设计文档与实现计划 + 更新 AI 使用日志 2026-08-28 02:12:38 +08:00
lhl 57df45eae5 feat(chat): 首条消息建会话(D-v4)+上传门禁(B5/F1)+Esc焦点(C1)+抽屉未保存守卫(B6) 2026-08-28 02:12:04 +08:00
lhl 851a3dae6a refactor(server): list_sessions 移除永不执行的 except 兜底以达 99% 覆盖率 2026-08-28 02:12:03 +08:00
lhl 6bb7b5fa10 feat(chat): 会话状态机重塑——空白草稿态 + draftProject 重命名 + 空态提示 2026-08-28 02:01:24 +08:00
lhl 33df996f0b feat(server): GET /api/sessions 支持 project 查询参数 2026-08-28 01:59:39 +08:00
lhl 0424883cd0 fix(server): delete_session 级联删除 chat_messages(A1) 2026-08-28 01:58:21 +08:00
lhl c4f1773de0 feat(server): list_sessions 支持 project 过滤(json_extract + Python 兜底) 2026-08-28 01:57:15 +08:00
lhl e6702a2009 feat(web): 前端 v3 — 移除 Aura Pipeline 痕迹 / 项目切换器 / 删除会话 / 抽屉化项目配置 / 侧边栏折叠
按 docs/design-web-chat-v3.md 实施,仅前端改动,JS 与后端 0 改动:
- 移除品牌区 "Aura Pipeline" 装饰小标与 header 面包屑装饰
- 顶栏项目切换器(#proj-switcher):按钮 + 下拉菜单,含「不选择项目」+ 项目列表 + 「+ 项目管理」;
  存在项目时自动绑首项(用户显式选过则不覆盖),项目被外部删除自动回退
- 会话项 hover 显示 × 删除图标 → confirm → DELETE /api/sessions/{sid};删的是当前会话自动 newSession
- 侧边栏 #sidebar-toggle 按钮整体折叠 56↔264px,状态 localStorage 持久化,刷新保持
- 项目配置(7 字段表单 + 列表 + 保存/删除)整体迁入主区右侧 #proj-drawer(460px 滑入,Esc 关闭);
  侧边栏 #proj-panel / #proj-form 已移除
- 全量 558 passed, 覆盖率 99.10%
2026-08-28 00:01:13 +08:00
lhl d6361cf025 style(web): 前端 UI 美化(Aura Space 规范,功能零改动)
- 按 Aura Space 暗色洁净混合美学 v2.0 重排 chat.html:google 色板令牌、Inter 字体、
  12/16px 圆角、玻璃拟态 header(sticky + backdrop-blur)、品牌 logo 蓝色光晕、
  助手消息前置 auraPulse 蓝色脉冲点、Material 多层阴影、全量 200ms 过渡动画
- 侧边栏改白底洁净风:品牌块、会话项 hover/active 蓝 50 态 + 左侧指示条、
  项目配置面板卡片化;文件选择改用 label + 隐藏 input(上传逻辑不变)
- JS 逐字节不变(已程序化校验一致);test_root_serves_frontend 通过
2026-08-27 23:16:48 +08:00
lhl 916c5beed7 feat(web): 项目级配置 + 会话命名/历史 + 设计文档纳入影响调查
- 会话支持 name/project 字段,上传要件定义后自动命名;前端侧边栏会话历史 + localStorage 恢复,顶部只显示会话名
- 新增 ProjectsStore(SQLite)与 /api/projects CRUD;绑定项目后 _rebuild_source 合并模板/规则/代码库/设计文档,上传区仅要件定义
- StructuredSource.design_docs 与 ImpactReport.design_references;影响调查新增既有设计文档确定性交叉引用(无 LLM)
- 同步更新 docs/design.md §12.7、README、_AI_USAGE_LOG.md;全量测试 558 通过,覆盖率 99.10%
2026-08-27 12:13:28 +08:00
lhl 838a93720e 聊天式交互改造(Web UI 升级)
- 前端由分步表单页升级为 DeepSeek 式聊天页(static/chat.html)
- 新增 chat 包:意图识别(intent.py)+ ChatAgent(agent.py)自动驱动
  解析→影响→生成→QA 整条工作流,影响确认节点反问、错误分支兜底
- store.py 扩展 pending_intent 字段与 chat_messages 表
- app.py 新增 POST/GET /api/chat/{sid}/messages,GET / 返回聊天页
- README/design.md 同步聊天模式说明;测试 4 文件覆盖
- 全量 pytest 522 passed / 99.03%,覆盖率红线达标
2026-08-27 05:11:40 +08:00
lhl 215c605650 feat(server): Web 服务化(FastAPI + SQLite + 内嵌零构建前端)
参赛成果物 03「交互界面 + 数据存储」落地:
- src/genesis/server/: store.py(SQLite 会话持久化)、service.py(会话化服务层:
  上传→解析→确认→影响→确认→生成→QA)、app.py(api-design §2 核心端点 9 组)、
  static/index.html(内嵌单页,零构建无 node_modules 依赖)
- scripts/serve.py 启动入口(--fake 离线引擎 / 默认真实 LLM)
- pyproject 加 fastapi/uvicorn/python-multipart
- 修复 qa_loop._build meta={} 导致真实模板 {{doc_title}} 等占位符残留 DocxInjectError
- README Web 服务说明 + service_url 登记指引;design.md §12.5 记录(含同步执行/
  zip 既有系统/无 WebSocket 的诚实偏差标注)
- 测试:test_server_store/service/api 共 34 用例(TestClient 全链路 + zip 影响流程 + 错误分支)
全量 pytest 473 passed / 99.20%
2026-08-26 22:13:19 +08:00
lhl a1fefd43eb docs(deliverables): 参赛成果物补齐(README 五项 + 范式图/架构图 + coverage 报告)
按《参赛成果物提交规范·赛道一》§8:
- README:新增项目性质:新规声明、项目概述、整体功能说明、效果总结
  (431 测试/99.15% 覆盖/双语试运行/影响调查基线)、团队分工、规模与难度自评
- design.md:开发范式流程图(mermaid,6 步与 AI 日志步骤列一致)+ §2.1
  Agent 架构图(感知-规划-行动-记忆映射)
- _AI_USAGE_LOG.md:回填「待补充」→架构设计、「整体迭代」→反馈迭代
- tests/coverage/ 覆盖率 HTML 报告(99.15%)+ tests/test-execution-log.txt 执行日志
- docs/参赛成果物提交规范-赛道一.md → docs/submission-spec-track1.md(ASCII 化)
- pyproject: pytest norecursedirs 排除 test-execution-log.txt
全量 pytest 431 passed / 99.15%
2026-08-26 14:24:02 +08:00
lhl becd3e1f57 chore(assets): 参赛提交规范红线修复(ASCII 化 + 相对路径)
按《参赛成果物提交规范·赛道一》§6 红线:
- samples/ 目录改名 sample/(git mv,保留历史)
- 10 个中日文样本文件 + docs 参赛手册 PDF 重命名为 ASCII
  (requirements_*/template_*/rules_*/contestant-handbook.pdf)
- tests/test_zh_template.py 硬编码绝对路径 D:\00_project\Genesis 改为相对路径
- 全局更新 21 个活动文件引用;历史日志/审查文档不改(追加说明记录)
全量 pytest 431 passed / 99.15%
2026-08-26 14:15:52 +08:00
lhl 1925ef7239 feat(writer): 章级管道重试兜底 + 表格 caption 语言检查 + 文档收尾
#1/#2 真实 LLM 随机方差兜底:orchestrator.generate 新增 chapter_attempts(默认 3),
单章 WriterGenerationError 不连坐整次 run,重试耗尽才抛错(不吞错)。新增
tests/test_orchestrator_retry.py(前 N 次失败后恢复 / 耗尽仍抛错)。

#3 表格 caption 语言检查:find_language_violations 现检 table.caption(生成正文需跟随
输出语言),rows/headers 仍照抄源不检;QA 维度经 ChapterArtifact.blocks=(type,text,caption)
同步生效。修复真实 zh 输出中表格说明引用日文源表名绕过强制的问题。

文档收尾:README 新增 --output-language/中文模板用法;design.md §6.2.1 输出语言控制、
§7.2 校验清单 10→11 项;计划验收勾选;.gitignore 加 .opencode/。
全量 pytest 431 passed / 99.15%
2026-08-26 00:49:36 +08:00
lhl 84d3b87da3 docs: 输出语言功能文档收尾(README/design.md/计划/opencode忽略)
- README 新增 --output-language 参数表、中文模板用法、auto 推导规则与中文场景注意
- design.md §6.2.1 新增输出语言控制设计(贯通链路/auto推导/生成期强制/标签本地化);
  §7.2 十项校验清单 → 11 项(新增语言一致性维度)
- 计划文档验收复选框勾选
- .gitignore 加入 .opencode/(AI 工具本地配置不入库)
2026-08-26 00:45:09 +08:00
lhl 3f4d17cf69 fix(writer): auto 模式语言 fallback 改用规则文档,修复日文文档被误判期望 zh
真实 ja 试运行暴露:auto 模式 fallback 误用 impact/data 源数据(含中文元素名
止损风控等 + 汉字标签无假名)→ 把日文文档误判为期望 zh → LLM 正常日文输出被
判违规 → 硬失败。修复:fallback 改用 write_rules/design_rules(RAG 自日文作成
说明书/记入规则检索,含假名可靠判 ja);加回归测试
test_generate_chapter_auto_with_ja_rules_but_chinese_source_data_enforces_ja。
修复后 ja 真实试运行成功(7章);zh 真实试运行成功(7章);425 passed / 99.15%
2026-08-26 00:36:54 +08:00
lhl d01e1b720f feat(writer): 输出语言一致性保障 + 用户可选输出语言
- 步骤0: 新增中文镜像模板 scripts/make_zh_template.py 与 samples/概要设计书模板_中文.docx(7章锚点原样保留)
- 步骤1: config.WriterConfig.output_language→Settings.writer;GenerationContext.output_language + to_vars.language_instruction(zh/ja/auto);writer_agent【语言约束】改引变量;context_builder/orchestrator/run_trial 透传 --output-language
- 步骤A: 新建 src/genesis/writer/language.py(detect_script/resolve_expected_language/find_language_violations);WriterAgent.generate_chapter 按期望语言强制、违规重试、耗尽硬失败;max_retries 默认 1→2
- 步骤B: _format_impact 影响调查标签按 output_language 本地化(zh 新建/变更/删除/警告)
- 步骤C: eval scorer 第 11 维度 language_consistency(不可验证=满分,不拉低总分);ChapterArtifact.expected_language;QAValidator.validate_doc 透传;QALoop.run 透传 output_language
- 测试: test_zh_template/test_language_plumbing/test_writer_language/test_scorer_language/test_language_coverage,并更新 test_phase5_e2e
- 全量 pytest 424 passed / 99.15%(覆盖率门槛 99% 达标)
2026-08-25 23:30:24 +08:00
lhl 9d0d3409c2 docs(log): 修复 _AI_USAGE_LOG.md 表格渲染断裂
- 删除表内 4 处空行与 1 处误写入的工具输出残留行
- L55 摘要内嵌错误码表的管道符转义为 \\|(GFM 表格内反引号不保护 |)
- 拆分被 || 拼接的两条 2026-08-23 记录为独立两行
- 零日志行删除;修复后 116 行均为有效 5 列,单一表格完整渲染
2026-08-24 16:03:09 +08:00
lhl 5091125fbc fix(writer): 无子节章剔除 LLM 自造 heading 块
- writer_agent: prompt【小节约束】明确空结构时不得输出 heading 块
- writer_agent: generate_chapter 程序化强制——template_marker.sub_headings
  为空的章,剔除生成结果中全部 type=heading 的内容块(LLM 遵循度不完美,
  以模板结构为准做确定性兜底)
- 真实试运行验证:自造与章同名 H2 清零、H2 总数 14→6(仅模板定义子节)、
  内容引用不受影响
2026-08-24 13:19:11 +08:00
lhl 0a498e4f7a fix(writer): 无锚点子章归并父章生成 + 注入后裸重复子节去重
- template_mapper: 按 design §6.5 仅 Heading level<=1 起章,H2/H3 归入
  父章 sub_headings(此前每个 heading 独立成章,无 {{section:id}} 锚点的
  6 个子章生成后被静默丢弃)
- models: ChapterSpec.sub_headings 字段;to_vars 暴露 sub_headings 变量
- writer_agent: prompt 新增【小节约束】(有子节时按小节顺序以 level=2
  heading 组织,不得遗漏或新增)
- docx_injector: 注入后删除同章内与已生成标题同名且完全无内容的模板裸
  H2/H3(保守策略:带内容的模板子节保留)
- 真实试运行验证:7 章 / 无静默丢弃告警 / 14 个 H2 无重复
2026-08-24 12:23:35 +08:00
lhl 80ccc324fc fix(writer): 章节级数据注入 + 修复 prompt 从未渲染的关键缺陷
- models: CHAPTER_SHEET_TYPES/CHAPTER_IMPACT_ELEMENT 章节→数据映射(design §6.8 ①)
- models: _format_chapter_data 按章定向渲染 ExcelTable 为 Markdown;GENERIC 自由記述作通用背景
- models: _format_impact 支持按 ElementType 过滤(章节级影响上下文)
- writer_agent: {{source}}(全量repr) → {{data}}(章节数据);新增【主题约束】
- writer_agent: 关键修复——真实 PromptRegistry.get 返回模板字符串,
  引擎对 str 不做变量渲染,LLM 实际收到的是 {{占位符}} 原文;
  _resolve_prompt 统一包装为 Prompt 对象保证渲染
- 真实试运行验证:13 章主题全部正确、引用影响调查数据、语言漂移消除
2026-08-24 11:50:59 +08:00