# 方块 · 产品需求说明

版本：2026.10.12 网站同步版；产品负责人：王誉翔。

## 目标与核心任务

为建筑设计中的资料查找和来源核对缩短路径。当用户开始方案、核对做法或比较项目时，先找到相关资料，再确认原文并留下自己的判断。岗位差异以任务情境组织，不以虚构访谈替代验证。

## 交付状态（2026.10.12）

| 交付层 | 已实现 | 当前边界 |
| --- | --- | --- |
| 本机知识工作台 | PDF/TXT/MD 文本资料、检索、指定项目与 2–4 项目比较、引用上下文、原始文档与跨分卷阅读 | 单人本机入口，依赖云端存储和模型；生成服务需恢复并重新验收 |
| Windows 桌面小方 | 拖动、收起、置顶、托盘、减弱动效、按需启动工作台、查询状态 | 没有安装开机自启；只同步状态与数量等白名单元数据，不同步问题与原文，不是离线应用 |
| 独立网页演示 | 资料浏览、关键词搜索、分类、来源阅读、收藏、摘录、研究夹 | 保存在当前浏览器，刷新可回看；无账号或跨设备同步，未连接私人库和实时 RAG；公开访问权限未核实 |
| 新版首页 | 项目档案、规范标准、地区政策，照片封面、来源、FAQ、登录窗口、动态方块 | 登录未开通；首页场景与动画不是实际模型任务结果 |
| 截图旁批 | 选区编号、建议展开、保存、返回图中 | 图纸与建议为预编写示例，未接真实视觉模型、截图捕获与 CAD 操作 |

独立演示共 36 条目录：20 个公开案例、8 项规范索引、8 项重庆政策索引。本机 RAG 收录 15 个公开案例，不能与演示案例相加。另有 5 个个人/投标项目与 1 个历史合成测试项，后者需隔离。两份真实大 PDF 共 293 页，5 个私有分卷、289 个文本片段；不在公开演示中，也不证明图纸被模型理解。规范与政策的来源核对日期为 2026.10.08，并非自动更新的法规全文库。

## 需求优先级与验收

| 优先级 | 需求与取舍 | 验收要求 / 当前状态 |
| --- | --- | --- |
| P0 | 恢复真实问答 | 服务故障、证据不足与生成失败分别提示；恢复后用真实资料重新验收，当前尚未通过 |
| P0 | 来源可回查 | 引用可查看邻近上下文，打开原始文档与跨分卷阅读；原页码及返回位置可对应 |
| P0 | 测试数据隔离 | 从正常浏览、检索和真实案例计数中隔离历史合成记录；下一阶段执行 |
| P1 | 分类与研究路径 | 三类入口、层级分类、关键词查找、返回保留条件；独立演示摘录保存后刷新回看 |
| P1 | 可辨认的案例 | 主图、设计线索、来源、摄影署名与核对日期同时存在；摘要与原文明确区分 |
| P1 | 低干扰桌面入口 | 主动展开收起、置顶与托盘；仅同步状态白名单，不同步问题原文 |
| P1 | 首页与品牌展示 | 登录窗口不发送凭据；动态方块四态可手动选择、暂停、键盘操作、4.8 秒轮换，后台/离屏/减弱动效停止 |
| P2 | 真实截图分析 | 当前只验证编号、展开、保存与返回交互；接入视觉模型之前不得承诺读图或尺寸/法规判断 |

## 验证记录与失败处理

历史 2026.10.09 发布记录包含软件构建、搜索分类、阅读、摘录刷新恢复与旁批回看检查；其 40 项软件回归不代表模型质量与用户成效。2026.10.11 检索抽查 6 次中 5 次返回、1 次请求失败，生成服务认证未通过，未完成问答质量评估。

问题与来源不同步、请求失败、资料为空应分别呈现。不得把请求失败写成无资料，也不把正常 HTTP 状态当作答案正确。展示形态不接真实任务服务，登录不收集凭据。

## 试用与反馈

已邀请三位设计院同事参与试用，覆盖高级设计师、设计师助理与总建筑设计师。意见是作者汇总转述，不是逐字访谈；岗位情境和虚拟头像仅作示意，不归为任何个人推荐语。逐人任务记录、效率与满意度数据仍待补充，不表述为机构采购或规模化部署。

| 归纳问题 | 产品回应 | 后续检查 |
| --- | --- | --- |
| 只有名字与局部图，参考价值不清楚 | 补完整主图、设计线索与来源 | 做深 5 个代表案例，不只增加数量 |
| 找过的条文需要反复定位 | 分层分类，分类内查找，返回保留条件；摘录关联来源 | 独立参与者能否找到正确依据 |
| 摘要难以支持方案讨论中的核对 | 本机引用、邻近上下文及分卷阅读 | 逐项检查结论是否由来源支持 |
| 桌面助手容易打断设计 | 仅显示状态，主动展开和收起 | 检查真实任务中的打断程度 |

2026.10.11 的检索抽查有 6 次请求，5 次返回成功、1 次请求失败。生成服务认证未通过，因此未完成回答质量评估；这些数字不是答案准确率，也不是长期可用率。
## 下一阶段

先恢复真实问答并完成端到端回归；隔离历史合成测试记录；做深 5 个代表案例并检查少量难 PDF 页；建立人工参考证据题集；邀请独立参与者完成方案前期资料查找与比较任务。以上均为计划，不是已完成的里程碑。

衡量找到正确依据的耗时、任务完成情况与证据支持情况，保留失败和恢复记录。软件检查、自测和设计院同事试用分别记录，不合并为用户研究样本，不预设节省时间的百分比。

## 责任与访问范围

本人负责问题、资料、优先级、交互与验收；Claude Code、Codex 协作实现与验证。个人作品网站只发布公开案例素材与经核对的说明；私人 PDF、投标文字、原始运行日志、数据库标识和签名链接不进入公开附件。