职责与阅读契约
需求设计报告是四份文档的阅读入口。顶部文档目录始终可见,默认显示报告;共用底座、小鹏灵犀参考架构和财务工作流演示在同页切换。报告原有章节锚点继续工作,定位时避开顶部目录;切回报告恢复原阅读位置。
报告正文直接保留在主页面,其他文档首次选择时才通过 iframe 加载。这样不复制内容,也不改变各文档内部资源的相对路径。普通切换保留已加载文档的阅读与交互状态;通过子文档的“返回需求设计报告”链接返回时,回到外层报告而不是嵌套报告,并重置该子文档。
VuePress 选型研究
选型研究保留数字员工、票据 OCR 与独立知识库的分组入口。知识库需求、候选产品、自托管及商业托管逐项资料评分纳入 content/,通过统一文档目录生成页面与侧栏;导航汇总不改变需求、权重或核验状态,不把候选清单视为最终选型结论。资料评分以知识库需求文档中已确认的口径为准,列出锁定代码、商业版本边界和待核实项,不把文档/代码初评视为 PoC 通过或生产验收。
数字员工选型分组同时保留原版目标静态架构与「数字员工目标静态架构v2」,报告正文链接至两版架构。v2 采用六层底座与贯穿各层的治理中枢,在交互层与编排层之间设置「身份、权限与工具访问」安全层,组合 Casdoor、1Password 与自研 MCP 安全网关。每层右侧纵向展示产品或工具,产品的候选或待选型状态按需标注,但模型列表只展示名称;交互层按 Lark、Slack、Web UI、邮件列名,不附括号说明并高亮 Lark,编排层展示 Grokbot 名称、不附括号说明,候选状态保留在报告正文中,模型层按 GPT、Grok、Claude、Gemini、DeepSeek、通义千问排列,不显示括号及首选、可选说明,系统层保留按需扩展说明。组件归属、选型状态与安全边界以选型报告第 9.6 节为准,不因导航发布而视为已实现或已验收。
VuePress 财务栏目展示状态
VuePress 中的财务工作流栏目暂时清空,仅保留入口和页面标题,不展示演示、总览、主流程等旧内容,也不列出子页面导航。已有子页面路径保留为仅含标题的空页,避免旧链接继续展示过期方案。原始财务文档及配套资源保留备查;此状态不改变原始独立文档的内容或业务结论。
本地预览与自动更新
docs:start 默认在后台运行 VuePress/Vite 开发服务,docs:dev 为同样机制的前台入口。content/ 保存后先增量同步生成页面和公开资源,再通知浏览器更新;HTML、SVG 与资源变动触发整页刷新,避免阅读框保留旧文档。日常生成不删除重建已监听目录,未改变的生成文件不重写,避免测试或生产构建破坏开发监听。源文档与目录登记先校验;无效输入不会先清空上一次生成的页面,修正后继续同步。文档目录变动由配置依赖监听重新加载导航。
docs:restart 在同一控制锁内停止已核验身份的托管服务、等待退出,超时后仅强制结束该托管进程;确认端口可用后清理 VuePress 临时目录和缓存,重新生成并启动开发服务。不按端口杀进程,不删除原始文档,不抢占手动启动的服务;重启默认沿用原端口和路径前缀。原静态托管进程可被安全识别并迁移。开发与生产构建使用不同临时目录,静态交付仍由 docs:build / docs:preview 承担,不承诺自动刷新。docs:check 默认临时启动独立的构建产物 HTTP 服务,避免把正在运行的开发页面误当作静态构建验证;可用 DOCS_ORIGIN 显式指定其他预览地址。
边界与退路
入口是自包含静态 HTML,不引入后端或外部依赖,可直接以本地文件打开,也可经静态 HTTP 服务访问。三份目标文档保持独立;文档导航不改变其业务内容或授权含义。财务演示依赖其目录内的样式和脚本,分发时须一并携带。
目录使用原生链接,禁用脚本时仍可普通跳转。嵌入阅读区提供独立打开当前文档的入口,文件缺失或浏览器限制时可用于排查;不把 iframe 的 load 事件视为内容成功加载的证明。来自嵌入报告的返回消息仅在来源窗口属于本页已创建的阅读框架时处理。
可访问性与适配
当前文档用文字、背景与 aria-current 共同标识;导航支持键盘焦点,切换时播报文档名称。手机上四个入口两列展示,报告保留原有响应式章节目录。顶部高度动态测量,章节定位和侧栏不被目录遮挡。打印始终输出报告正文,不输出导航和嵌入阅读区。