← 返回总览

历史讨论稿 · 2026-11-11。后续访谈决定以总览和决策记录为准。

# CopyFlow 设计开发端产品需求文档

**状态：讨论稿 / 实现建议**  
**日期：2026-11-11**  
**参考页面：**[设计开发端演示](https://copyflow.zhinan.tech/demo/showcase/?view=design) · [功能与界面参考](https://copyflow.zhinan.tech/demo/showcase/reference.html#F07)

## 1. 简要描述

设计开发端是 CopyFlow 中查看来源文稿和版本变化的工作台。设计师、开发人员和策划可按项目找到石墨文档，查看可用的正文快照、修改位置、历史记录及版本差异，以便在设计和开发过程中核对文案及其来源。

**建议首期目标：**将当前静态演示接入真实、受权限控制的文档数据，完成“登记文档 → 采集归档 → 查看正文 → 查看修改和版本对比”的闭环。文案在何时被认定为正式定稿，需要另行明确；仅显示最新快照不等于已经确认定稿。

### 当前基础与差距

| 项目 | 当前已知情况 | 实现方向 |
| --- | --- | --- |
| 设计开发端页面 | 线上是静态演示；正文、时间线等由固定 JSON 提供。项目分类存在当前浏览器的 localStorage 中 | 接入真实项目、文档、快照和历史数据；分类由服务端持久化 |
| 石墨采集 | 独立策划工作台已有石墨文档登记、插件采集、快照归档等代码；未确认与展示页打通 | 评估复用现有能力，补齐设计开发端的读取权限和接入链路 |
| 真实业务验证 | 现有集成尚未使用真实企业文档完成端到端采集验收 | 在具备授权的企业环境中验证，特别是权限、分页、版本与图片 |
| 版本完整性 | 演示示例显示历史分页未确认完整；示例数量不能证明历史完整 | 对采集状态、缺页和重建能力明确提示，不能把不完整数据标为完整 |
| 上线维护 | 已知演示页面由线上静态目录提供；对应源码仓库及发布脚本尚未定位 | 先确认维护来源、归属与部署路径，避免直接覆盖线上文件 |

## 2. 用户、目标与边界

| 用户 | 主要任务 | 建议权限 |
| --- | --- | --- |
| 设计师 / 开发人员 | 找到项目文档、查看当前可用文稿、核对变化和来源 | 查看获授权项目的文档、快照、历史和差异 |
| 策划 | 登记来源、组织采集，提供正确文稿并核对修改 | 在项目授权范围内登记与管理文档，查看采集状态 |
| 项目管理员 | 管理项目成员和文档归属，排查采集异常 | 管理授权、文档关联和采集连接 |

角色命名、权限配置和正式身份系统均为**建议，待确认**。读取图片、正文、历史和原始响应均应遵循同一项目权限；来源链接可访问不代表当前用户自动有 CopyFlow 项目权限。

**首期建议包含：**项目与文档列表、石墨来源登记与采集、正文快照、修订标记、版本时间线、历史记录、两个快照对比、状态与权限。

**暂不默认包含：**在设计开发端直接编辑石墨正文、自动修改策划稿、自动发布到 CMS、真实邮件发送、Figma 同步或 AI 自动审核。它们需要单独确定产品流程和授权；采集本身不应触发这些写入行为。

## 3. 关键业务流程

1. **登记来源：**有权限的用户选择项目并登记石墨文档链接。系统校验链接与项目归属，显示登记结果。
2. **建立采集：**用户按界面说明连接浏览器插件，在已登录且有权访问的石墨文档中采集。连接过期、撤销或无权限时明确提示，不显示采集成功。
3. **归档：**系统接收允许的正文、历史、版本和图片数据；记录文档身份、采集时间、来源版本及解析状态，形成可追溯快照。重复采集按来源身份和版本去重；同一版本数据冲突时保留证据并提示处理，避免静默覆盖。
4. **查找与阅读：**设计或开发按项目、标题或链接查找文档，查看来源、采集状态与正文快照；能区分来源版本时间和采集时间。
5. **核对变化：**选择修订标记、版本时间线、历史修改或两个快照对比；版本不连续或无法可靠定位时明确说明。
6. **回到来源：**需要核实原稿时通过来源链接打开石墨；若业务需要确认某版为定稿，应由明确的定稿流程产生标识，而不是由采集时间推断。

## 4. 功能需求

以下“应”是首期建议需求，尚非已交付能力。具体交互可沿用演示页面，字段、权限和上线范围在开发前确认。

### 4.1 项目与文档列表

- 列出用户有权查看的项目和文档，展示标题、所属项目、来源类型、最近采集时间及采集状态；按标题、项目或来源链接搜索。
- 文档以稳定来源标识去重；同一来源在不同项目间如何关联由项目权限和业务规则决定，不能因同名合并。
- 有权限的人员可登记来源并维护项目归属；分类更改保存到服务端，其他有权用户刷新后看到相同结果。无权限人员只读。
- 无项目、无文档、无搜索结果、无权限、加载失败分别给出明确提示；不把本地浏览器分类当成团队共享数据。

### 4.2 来源登记与采集

- 首期以企业石墨文档为来源。登记时校验支持的域名和文档标识；重复登记提示既有关联。文档不可访问或授权失效时保留已归档数据并提示。
- 采集连接应绑定操作者、项目及允许采集的文档；明确有效期、撤销和重新连接流程。插件不采集或保存用户登录 Cookie、密码或令牌。
- 展示采集状态：未连接、采集中、最近成功时间、部分成功、失败或连接失效；失败原因以用户能采取的动作说明，例如重新登录来源或重新连接。
- 分别记录正文、历史分页、版本链和图片的采集/解析结果。某一项失败不能使整个文档显示为完整；重试不得覆盖已有正确版本。
- 采集只归档来源，不自动修改网页草稿、提交合入、发布或发送通知。是否沿用现有插件与连接方式，实施前做技术核对。

### 4.3 文档详情与正文快照

- 顶部展示文档标题、来源链接、所属项目、最近采集时间、可用快照数量及历史状态；明确“来源版本”和“采集时间”的含义。
- 展示有权限读取的正文和实际采集到的图片；可切换已归档快照，选择后正文、修订及相关信息均绑定同一快照。
- 默认展示规则建议为“最新可用且来源版本可识别的快照”，并清楚标明版本和渲染质量；若最新快照不可解析，提示原因并允许选择其他版本。此规则与当前演示优先选择排版质量的行为不同，需确认。
- 支持已能可靠解析的标题、段落、列表和文字格式；纯文本、可见片段或未支持的结构应标识质量，不冒充完整原稿。缺少图片显示占位，不用当前图片替代历史图片。
- 暂无快照、快照解析失败、无读取权限或来源已失效时保留清晰状态和可操作指引。展示内容进行安全处理，不执行来源文档中的脚本。

### 4.4 正文修订标记

- 用户在已选择的快照上开启或关闭修订标记；区分新增、删除和格式变化，并在正文与修订列表之间联动。
- 修订列表显示可用的修改类型、作者、时间和来源版本；支持按类型筛选，以及跳转上一处、下一处。
- 标注结果需绑定基准版本、目标版本和本次重建所用数据。版本链不连续、字符坐标不匹配、复杂块无法解析或部分修改无法落位时，展示缺口及未定位数量；不能将推测位置表现为精确位置。
- 不存在可靠删除原文时，展示已知的删除数量或摘要，并说明原文不可用；不编造删除内容。关闭标记不改变快照正文。

### 4.5 版本时间线与历史修改

- 时间线按来源版本顺序展示可识别的版本及修改人、时间、文字增删摘要、格式变化；用户可查看已有或可靠重建的指定版本正文。
- 没有基准快照或中间版本缺失时，明确显示缺失范围，不能把跨缺口的结果标为完整重建。只抓到末页响应也不自动证明分页完整。
- 历史修改列表展示实际获得的修改记录和可用的作者、时间、类型、变更摘要；作者或时间缺失时显示未知。
- 支持从可定位记录跳到正文，定位属于近似结果时明确标识；不可定位的记录仍可查看，不伪造落点。记录较多时应分页或分批加载，不能静默截断而让用户以为已展示全部。

### 4.6 两个版本的对比

- 选择同一文档的两个已归档正文快照，标明各自来源版本与采集时间，并展示旧版删除/替换和新版新增/替换内容。
- 至少需要两个可比较的快照；相同正文显示“正文一致”。不支持对比的格式、缺失数据和图片变化应说明，不应把不可比较解释为没有变化。
- 明确对比算法的能力边界。现有演示仅截取去除共同前后缀后的一个变化区间，并不是逐处精细差异，也不代表中间每一次操作。首期是否要求逐处对比待确认；如仅实现区间对比，界面必须明示。

### 4.7 权限、安全与可追溯

- 使用正式身份系统识别用户，项目成员权限在服务端校验；设计开发端、采集接口和图片接口均不可只依赖前端隐藏。
- 保存必要的登记、归属调整、连接、采集、失败及权限变更记录，包含操作者、时间和对象；日志不记录来源凭据、Cookie 或不必要的正文。
- 对采集量、单文档大小和图片容量设置限制，达到限制时保留已有数据并给出可理解的处理提示；具体配额按部署环境确认。
- 原始响应如需用于排错，应限定管理员权限、展示脱敏策略和保留期限，避免默认向所有读者暴露。

## 5. 主要状态与处理

| 情况 | 界面应表达的事实 | 建议动作 |
| --- | --- | --- |
| 从未采集 | 尚无正文或历史 | 有权限者连接采集；其他人联系项目负责人 |
| 仅采集到片段 | 当前正文不是完整文稿 | 标注片段和采集时间，保留来源入口 |
| 历史分页未确认完整 | 已有记录，但无法证明全部历史已获取 | 展示已获得范围及缺口；可重试或补采 |
| 版本链缺失 | 部分版本不可可靠重建或定位 | 显示缺失版本，保留可查看记录；禁止宣称精确 |
| 来源权限失效 | 不能继续采集，不代表历史归档消失 | 保留授权范围内的既有快照，提示重新授权 |
| 图片未采集 / 格式不支持 | 当前版本部分内容不可还原 | 显示占位或格式提示，避免替换成其他版本 |
| 项目权限被撤销 | 当前用户无权访问项目数据 | 服务端拒绝读取，不继续显示缓存的受保护正文 |

## 6. 验收标准建议

1. 授权用户可登记一份真实石墨文档，完成采集并在设计开发端看到其来源、快照和采集状态；未授权用户无法读取正文、历史或图片。
2. 不同用户访问同一项目时，文档归属和已归档数据一致；刷新或更换浏览器后仍存在。重复采集不生成误导性的重复版本，也不覆盖已有历史。
3. 选择不同快照后，正文、版本信息及修订结果与所选快照一致；缺图、片段、解析失败能明确区分。
4. 在版本链连续且坐标可靠的数据上，新增、删除、格式标记与列表可相互定位；缺版本或无法落位的情况必须显示警告及可确定的范围。
5. 时间线、历史记录和快照对比展示真实可获得的数据；缺少记录、版本或不同格式时，不宣称全量历史或完整重建。
6. 采集、查看和版本切换不会自动改变策划草稿或触发 CMS 合入、线上发布和邮件发送。

这些是建议验收条件，不代表本轮已进行验收。真实企业文档、用户权限和异常场景的样本需在实施阶段准备。

## 7. 实施顺序建议

1. **确认基础与权限：**确定源码和发布归属、真实项目身份体系、设计/开发访问范围、石墨接入方式及示例数据处理。
2. **打通来源到归档：**复核并复用现有石墨采集、连接、归档及图片能力，接入正式权限；先保证可追溯和部分失败提示。
3. **接入阅读与版本：**将列表、正文快照、历史和对比连接真实接口，服务端持久化分类；以同一文档/快照标识贯穿页面。
4. **补齐修订定位：**按版本连续性和坐标可信度呈现标记；不能可靠定位的内容保留记录及原因。
5. **试点与上线：**用获授权的真实文档验证采集范围、权限和版本准确性，再确定生产部署与运维方式。

## 8. 实现前待确认

| 问题 | 为什么需要决定 |
| --- | --- |
| 设计开发端首期服务哪些团队、哪些项目？ | 决定身份、成员范围及数据隔离 |
| 采用现有策划工作台的项目与石墨归档，还是独立项目库？ | 决定是否共用数据、权限和部署，不能默认两套系统已打通 |
| 文档来源是否只支持企业石墨？采集插件能否在目标环境安装？ | 决定接入方案及真实数据可获得性 |
| “最新可用快照”和“已确认定稿”分别由谁确认？ | 决定默认展示及设计开发能否据此交付 |
| 谁可以登记、变更归属、连接采集和查看原始响应？ | 决定细粒度权限与审计范围 |
| 首期版本对比需要逐处精细差异，还是接受当前区间级对比？ | 决定实现成本和页面需要显示的准确性说明 |
| 数据部署位置、保留期限、删除和导出规则是什么？ | 决定企业数据治理、容量与恢复方式 |
| Showcase 的源码维护方与目标正式部署入口是什么？ | 决定从哪里实现和如何发布，避免覆盖现有演示 |

## 9. 依据

- [设计开发端演示](https://copyflow.zhinan.tech/demo/showcase/?view=design)及其[页面资源](https://copyflow.zhinan.tech/demo/showcase/design/)：用于梳理现有界面和静态演示行为。
- [功能与界面参考 F07—F11](https://copyflow.zhinan.tech/demo/showcase/reference.html#F07)：用于梳理石墨文稿、修订、时间线、对比与策划来源入口。
- 本地 `preview-workbench/SHIMO.md` 与相关实现：用于识别独立策划工作台已有的采集和归档能力及准确性边界；不代表设计端已接入或真实企业数据已验收。