项目用户手册

日期：2026-07-01

用户目标

用户说明别的项目已经迁移到本项目里，希望重新盘点当前项目内有哪些信息、具备哪些功能、能做什么事、能完成什么目标，并要求相当于给一份用户手册。

最终答复或决策

将项目定位为三层系统：根目录方法论与交付仓库、招投标分析/ 本地分析应用、.codex/agents/ 招投标专属 Agent 工作台。新增 HTML 用户手册，说明资产地图、能力清单、使用流程、Agent 分工、交付物入口和业务目标。

文件变更

• 新增 docs/reports/20260701-project-user-manual.html。
• 更新 index.html，增加“项目用户手册”入口。
• 新增本运行记录 docs/runs/20260701-project-user-manual.html。

命令与验证

• 执行 bash scripts/sync_workflow.sh pull，结果为 Already up to date。
• 盘点 README、迁移包 README、Agent 使用说明、维度模型、客户需求挖掘 README、脚本入口、配置文件、输出目录和首页。
• 统计关键规模：统一招投标主表 5,017 行 67 列，销售机会 247 行 17 列，项目级 Agent 24 个，迁移包分析表 39 个，图表 12 张。
• 验证 HTML 文件存在、首页入口存在、无可见 em dash 字符、关键链接可解析。
• 迁移包测试环境说明：系统 Python 缺少 pytest 和 pandas，迁移包旧 .venv 的 shebang 仍指向旧同步盘路径；改用 Codex bundled Python 跑金额归一、产品标签、场景识别和竞品别名轻量断言，结果通过。

可复用模式

• 迁移后项目盘点优先按“根项目、迁移包、Agent 工作台、交付物、脚本、配置、运行记录”七类组织。
• 用户手册不只列目录，要把“信息资产、功能、使用方式、适用目标、已有交付物入口”串成业务可读路径。
• 本项目用户侧知识交付默认用 HTML，首页应补入口，方便开发站点浏览。

下一步

如继续深化，可把手册拆成“业务版快速上手”和“Agent/脚本运维版”，并把迁移包内 Markdown 经营报告批量转为 HTML 版。