17 KiB
17 KiB
问题与修复台账
维护规则：问题记录与开发经验闭环。每个问题一个稳定 ID；主记录是事实与状态来源，本表为可检索投影。新发现及时登记，修复后保留记录；发布 blocker 仍见 gap-matrix。
更新：2026-09-28。激活预览前端预检与管理台密钥 form 已在 dev 浏览器复验（resolved，dev 3e534bbb，项目 6023）。非编制人触发小队账本提交被 uow: permission denied 拒绝（fixing，待 dev 重跑）。test 注册 INTERNAL：标准角色 role-guest 缺失导致 FK 23503，已补种并重启 test（goose 77，resolved）。重复用户名 400 在新代码单测通过；当前 rc 二进制仍返回 INTERNAL，随下次含本提交的 test 制品生效。管理台重置密码入口被 F4-A 误删（端点仍在），已恢复 UI（resolved）。2026-09-27。上传链路：登记并修复上传文档跨端不可访问（占位模板退化 + 元数据/正文不落服务端，fixing 待 dev 集成）。2026-09-26。docgov 批准链：登记并修复 review_snapshot_id 装载缺失与 uow 行锁自死锁（resolved）；memDocs 持久化失败缓存投毒（investigating）。历史 resolved 不表示本日产品回归通过。系统 code review P0/P1 批次修复落账（5 resolved + 1 deferred + 1 open，主记录见 整改文档，来源 审计）。
| issue_id | 模块 / 检索词 | 问题 | 严重度 | issue_state | owner | 证据日期 / 范围 | 唯一主记录 | 经验 |
|---|---|---|---|---|---|---|---|---|
| ISSUE-20260928-activation-preview-precheck | web / projectSettings / activation-preview / NO_GOVERNED_DOCUMENT / clientDutyIssues | 全部文档未纳入人工审批时前端仍 POST activation-preview，控制台 400 | medium | resolved | Cursor | 2026-09-28；dev 项目 6023 默认计划无 activation-preview 请求，兼任后 preview 200 | 主记录 | LESSON-20260928-activation-preview-client-gate |
| ISSUE-20260928-admin-secret-password-form | web / EnvSettingsSection / password / form / secrets | 管理台 5 个密钥输入不在 form 内，Chromium 报 password DOM 警告 | low | resolved | Cursor | 2026-09-28；dev 模型与密钥页 passwordInputs=5 outsideForm=0 | 主记录 | 密码框放进 form；autocomplete 不能单独消除该 DOM 警告 |
| ISSUE-20260928-squad-commit-authority | bizdev / docflow / dutyAuthorizer / uow permission denied / OnBehalfOf / bd_intake | 非编制人触发受控小队任务时，账本提交用触发者身份，被编制人职责门拒绝，正文无法落盘 | high | fixing | Cursor | 2026-09-28；dev task_runs user 74 ≠ author 4（doc_proj6022_bd_intake）；单测已绿，dev 重跑未做 | 主记录 | LESSON-20260928-squad-commit-as-author |
| ISSUE-20260928-register-internal | auth / register / role-guest / system_roles / 23503 / 23505 / INTERNAL | test 缺 role-guest 时注册 FK 失败被脱敏为 INTERNAL；重复用户名唯一冲突同样 500 | high | resolved | Cursor | 2026-09-28；test:8081 补种并重启后注册 200（goose 77，req_regfix_after_restart）；重复用户名 400 由单测覆盖，rc 二进制仍为 INTERNAL | 主记录 | LESSON-20260928-standard-role-reseed |
| ISSUE-20260928-admin-reset-ui-removed | web / UsersSection / 重置密码 / F4-A / adminResetPassword | F4-A 在 F4-B 端点已合入的基线上删除管理台重置密码按钮，管理员无法重置口令 | high | resolved | Cursor | 2026-09-28；dev API :8080 + worktree Vite :3110 真实 UI 探针 PASS（临时口令长度 16、强制改密仅一次、旧口令 401） | 主记录 | LESSON-20260928-ui-dead-control |
| ISSUE-20260927-upload-doc-cross-device | freedoc / upload / freeform / fileMeta / 占位模板 / 跨端 | 上传文档源文件元数据与正文不落服务端：换浏览器/清存储/共享他人查看时退化为注册占位模板，文本类连二进制都未存（伴生 <512B 显示 "0 KB"） | high | resolved | pi | 2026-09-27；dev 86efba2c 合入并在 dev 环境验证：FS-UPLOAD-01/02 真实浏览器 PASS（跨上下文可见真实正文），DB 核验元数据+asset 落库；存量无元数据旧文档不可恢复（重新上传即可） |
主记录 | LESSON-20260927-server-facts-and-iso-db-recipe |
| ISSUE-20260923-nullable-duty | docgov / nullable / 23503 / reviewer_id | 可选职责空值写 0 导致 FK 失败 | high | resolved | Codex（历史补录） | 2026-09-17；历史 PG / API 冒烟；当前未复测 | 主记录 | LESSON-20260923-nullable-duty |
| ISSUE-20260923-content-hash | docrevision / canonicalize / hard-break / 404 | 规范化破坏 Markdown 语义并造成正文哈希漂移 | critical | resolved | Codex（历史补录） | 2026-09-14；历史真实 UI / 重启；当前未复测 | 主记录 | LESSON-20260923-content-hash |
| ISSUE-20260923-coordination-authority | agentctl / claim / SQLite / CAS / CURRENT / FEATURE-MATRIX | 本地副本 CAS 与任务许可不能表达跨主机全局权威认领 | high | investigating | Codex（研究） | 2026-09-23；源码/只读状态，未复现具体丢写 | 主记录 | 沿用 content-hash 投影经验；跨机结论待实施验证 |
| ISSUE-20260923-matrix-status-regression | FEATURE-MATRIX / module-batches-ag / merge / docs-apply | 矩阵行 done 被 closeout 合并冲突手解回退为 planned | high | resolved | Cursor | 2026-09-23；本机 tip 与 git 考古；docs apply 已恢复 | 主记录 | LESSON-20260923-matrix-status-cas |
| ISSUE-20260924-admin-reset-dead | auth / adminResetPassword / T20-F4 / chenwei | 管理台重置密码死按钮；验收口令不可知后无法恢复 | high | resolved | Cursor | 2026-09-24；test 库实查 + API 单测 | 主记录 | 待补 LESSON |
| ISSUE-20260924-login-error-envelope | auth / AUTHZ / 无权访问 / auth.ts | 登录失败展示裸 JSON / 「无权访问」误导 | medium | resolved | Cursor | 2026-09-24；wire 复现 + 前端单测 | 主记录 | 待补 LESSON |
| ISSUE-20260924-zombie-credentials | auth / user_credentials / LEFT JOIN / CreateUser | 空哈希静默建号导致永久无法登录 | high | resolved | Cursor | 2026-09-24；三环境只读盘点；机制修复不含存量清理 | 主记录 | 待补 LESSON |
| ISSUE-20260924-cursor-test-rule-drift | Cursor / test-reports / 固定模型 / 规则副本 | Cursor 测试规则与验证契约存在固定模型及范围冲突 | medium | verifying | Cursor | 2026-09-24；规则文本已缩为验证契约指针；客户端实际读取行为待实机 | 主记录 | LESSON-20260924-cursor-hook-advisory-gates |
| ISSUE-20260924-pi-executor-boundaries | PI executor / 路径规范化 / MCP / 子进程 / 幂等 | 未发布初版只读边界与执行可靠性缺陷 | high | resolved | Cursor/Codex | 2026-09-24；173 工程回归与真实 Cursor CLI/MCP/PI | 主记录 | 工具路径与输入隔离 |
| ISSUE-20260924-cursor-cli-mcp-path | Cursor CLI / MCP / workspaceFolder / NDJSON | agentctl/jev MCP 加载失败（路径 + Content-Length 回包） | medium | verifying | Cursor | 2026-09-24；相对路径+NDJSON 已修；待 IDE 重载后 list-tools 实机 | 主记录 | LESSON-20260924-cursor-hook-advisory-gates |
| ISSUE-20260924-cursor-hook-event-contract | Cursor / hooks / beforeMCPExecution / probe | hook 事件 stdin 字段名与 matcher 官方未文档化 | medium | verifying | Cursor | 2026-09-24；IDE postToolUse tool_name=MCP:pi_subagent_roles 已采样；beforeMCP 全量 stdin 仍缺 |
主记录 | LESSON-20260924-cursor-hook-advisory-gates |
| ISSUE-20260924-non-author-400-duty | iam-authz / docgov / duty / 400 / 非编制 | 权限不足误报 400；run/edit 与编制职责绑死导致成员无法上传总结写草稿 | high | resolved | Cursor | 2026-09-24；真实 PI TestNonAuthorMember_PiAgent_RunEditSubmitGates PASS |
主记录 | LESSON-20260924-deny-only-submit |
| ISSUE-20260926-docgov-snapshot-load | docgov / loadDocumentFromDBLocked / review_snapshot_id / 跨重启批准 | 文档装载 SELECT 漏 review_snapshot_id，重启/缓存未命中后最终批准必失败 | high | resolved | pi | 2026-09-26；隔离库 PG 回归 + dev 真实批准 200/state=approved（dev 121b33f8） |
主记录 | 待补 LESSON |
| ISSUE-20260926-docgov-uow-deadlock | docgov / persistApproveAndFAV / uow / FOR UPDATE / 57014 | docflow uow 行锁后 FAV 持久化自开第二连接更新同行，语句超时致死锁，所有最终批准失败 | critical | resolved | pi | 2026-09-26；生产形状 PG 回归（FOR UPDATE+FAV+Within）+ dev 真实批准转 200（dev 5d5cd5fd） |
主记录 | 待补 LESSON |
| ISSUE-20260926-docgov-memdocs-poison | docgov / memDocs / 状态机 / 持久化失败 / 缓存投毒 | 状态机先改内存后落库；持久化失败不复原，memDocs 缓存与 DB 永久分叉并掩盖真实错误（表现为「approved 状态」误报） | high | investigating | pi | 2026-09-26；dev 两次复现（快照/死锁两根因均被投毒掩盖）；修复方向：失败时回滚内存快照或失效缓存条目 | 主记录 | 待补 LESSON |
| ISSUE-20260926-ctx-idor | ctxmgr / GetUserContext / session_id / IDOR / handlers_context | GetUserContext 按 session_id 取消息无归属校验，登录用户可读他人会话正文（已证实） | critical | resolved | pi | 2026-09-26；handler 403 + SQL/内存双防线；内存 HTTP 与隔离 PG 回归 PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-archcheck-untracked | archtest / table_owners / untracked / sql_write / 门禁盲区 | arch-check 对未登记表 SQL 写静默跳过，含 swboot_controlled_executions 等 ~50 表；门禁形同关闭 | critical | resolved | pi | 2026-09-26；未登记表 fail-closed + 补登 50 表 + 噪音豁免清单；arch-check block PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-authz-failopen | authz / IsProjectMember / pool==nil / fail-open / NewInMemoryAuthorizer | Authorizer 无池时 IsProjectMember/IsProjectOwner 对任意登录用户返回 true，误配即全量放行 | high | resolved | pi | 2026-09-26；无池严格拒绝 + 显式内存授权接缝 + 组合根按 AllowInMemory 选择；隔离 PG authz 套件 PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-swboot-shell-prefix | swboot / executor / sh -c / 命令注入 / 前缀白名单 / commandAllowed | 受控命令经 sh -c 执行且白名单前缀匹配（go 放行 go-evil）；元字符可求值 | high | resolved | pi | 2026-09-26；argv 化 + basename 精确匹配；前缀伪装/不求值回归 PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-intentflow-validated-confirm | intentflow / DecisionConfirm / PlanProposed / validated_only / ExecuteClaimed | validated_only（shadow）计划可经 Confirm 进入 executing 并真实执行；执行器不读 ExecutionMode | high | resolved | pi | 2026-09-26；Confirm 拒 + 执行器硬拒双层 + 错误码/HTTP 映射；确认/派发双回归 PASS | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-dual-flags-drift | intent / intentflow / FeatureFlags / PlanTier / MULTI_INTENT_ENABLED / 静默漂移 | 双套 flags 可配置出「intentflow 升档但 intent 关闭」的矛盾组合并静默降级 | high | resolved | pi | 2026-09-26；组合根经 intentflow.ValidateFlagConsistency 启动期 fail-fast + 单测；入口收敛残差另立 deferred | 主记录 | LESSON-20260926-failclosed-bypass-contract |
| ISSUE-20260926-governance-multi-entry | docgov / 多意图 / 多入口 / Coordinator / OwnerMux / GovernanceEngine | docgov 三入口 + Coordinator ~40 case 与 intentflow OwnerMux 平行，鉴权/确认/审计易漂移 | high | deferred | pi | 2026-09-26；flag 漂移面已修（dual-flags-drift）；入口合并是多日级重构，需独立任务授权与回归矩阵 | 主记录 | 沿用 failclosed-bypass-contract |
| ISSUE-20260926-server-pool-wiring | server / swboot_handlers / Runtime.Pool / 组合根越界 / FIND-ARCH-02 | server 持 Pool 直装 swboot repo/executor 并直查表，成为第二组合根（本轮未授权修复） | critical | open | pi | 2026-09-26；代码审证据齐（审计 FIND-ARCH-02），待修复授权 | 主记录 | 待修复后补 |
| ISSUE-20260927-demo-fallback | web / App.tsx / sess-001 / projectId fallback / demo seeds 关闭 | demo seeds 关闭模式下前端硬编码 fallback（激活 sess-001、项目 1）对真实后端发假请求，新登录用户首屏 9 个 404/403（chat 窗口被迫回退本地缓存） | medium | resolved | pi | 2026-09-27；dev 真实浏览器修复前后对照（author+member 双账号：9 假请求→0） | 主记录 | 经验小结（独立 lesson 待后续任务补登） |
| ISSUE-20260927-active-session-residue | web / storage.ts / loadActiveSessionId / localStorage 残留 / sess-001 / demo-seed-purge 写回窗口 | 旧前端把 demo fallback 值写回 localStorage active_session；一次性 purge 已执行不再清，读取侧无 legacy 校验，老浏览器 + 无可见会话账号首屏 4×chat 404（ISSUE-20260927-demo-fallback 修复残留路径） | medium | resolved | pi | 2026-09-27；dev 主入口 :3100 复验 admin+残留 sess-001：phantom=0/4xx5xx=0，key 被清除（dev 36c5fb54） |
主记录 | 经验小结 |