第零章 概述

本章帮助用户建立对致数的宏观认知，并在正式使用前完成必要准备。阅读本章后，用户应能够理解产品适合解决什么问题、手册面向哪些角色，以及使用系统前需要确认哪些环境条件。

1. 产品简介

致数是一款面向业务分析和报告生成场景的智能数据分析软件。系统将数据文件、分析模板、AI 对话、图表制品和报告输出整合在同一工作空间中，帮助用户把分散的数据问题转化为可追踪、可复用、可交付的分析成果。

产品的核心价值包括：

典型应用场景包括：

1. 经营分析、销售复盘、预算执行、门店运营等周期性业务分析。
2. 售前方案、客户演示、数据洞察报告等需要快速形成专业材料的场景。
3. 内部团队围绕统一数据和模板进行协同分析、复用结论和沉淀最佳实践。

2. 目标读者

本手册主要面向以下用户：

后续章节会以普通业务端用户的日常操作为主，尽量避免不必要的技术细节；涉及部署、权限、第三方登录或系统配置时，会单独说明管理员需要关注的事项。

3. 环境与要求

使用系统前，请确认以下条件已经满足：

为减少使用过程中的问题，建议首次登录前完成以下检查：

1. 确认浏览器版本为较新版本，并可以正常访问系统地址。
2. 确认账号、邮箱域名、密码或第三方登录方式符合组织要求。
3. 准备一份可用于测试的数据文件或明确要使用的分析模板。
4. 如果需要导出报告，请确认本地或服务器端导出能力已由管理员配置完成。

第一章 用户注册与登录

本文介绍如何在致数中完成账号注册、账号登录，以及如何切换到中文界面。截图基于桌面端浏览器界面。

1. 切换为中文界面

打开系统后，如果界面显示为英文，可点击页面右上角的语言切换按钮，将界面切换为中文。切换后，页面标题、表单字段、按钮和提示信息会显示为中文。

2. 注册新账号

在登录页点击“立即注册”，或直接访问 /register 进入注册页面。

注册页面包含以下信息：

操作步骤：

1. 在“姓名”中输入用户姓名。
2. 在“邮箱”中输入邮箱地址。
3. 在“密码”中输入密码。
4. 点击“注册”提交。

注册成功后，系统会自动保存登录状态并跳转到首页。若注册失败，请根据页面提示检查邮箱格式、邮箱域名限制、必填项和密码长度。

3. 登录已有账号

已有账号时，可在注册页点击“立即登录”，或直接访问 /login 进入登录页面。

登录页面包含以下信息：

操作步骤：

1. 在“邮箱”中输入账号邮箱。
2. 在“密码”中输入账号密码。
3. 点击“登录”进入系统。

如果系统配置了第三方登录，登录表单下方会显示“或者使用以下方式登录”。点击对应按钮后，按第三方平台提示完成授权即可。

4. 常见问题

第二章 仪表盘

仪表盘是登录后的默认首页，用于快速进入常用功能、查看当前使用概况，并从最近会话或分析模板继续工作。

1. 页面布局

仪表盘主要由三个区域组成：

2. 使用快捷入口

在首页顶部可以看到两个主要操作入口：

1. 点击“快速分析”，进入分析页面，适合临时提问、生成图表或创建报告。
2. 点击“从模板开始”，进入模板页面，适合使用标准分析模板发起结构化分析。

如果不确定从哪里开始，通常先使用“快速分析”；如果业务场景已有固定分析口径，优先使用“从模板开始”。

3. 查看使用概况

仪表盘中的统计卡片显示当前账号或工作空间的内容概况，包括：

这些数字可帮助用户快速判断当前空间中的分析沉淀情况。

4. 继续最近工作

“最近会话”区域会列出近期访问或更新过的分析内容。点击任意条目即可继续查看和编辑该分析。

建议将常用或重要的分析结果保存为制品，便于后续在“制品”模块中查找和复用。

5. 使用分析模板

“分析模板”区域展示可直接使用的标准模板。模板通常包含预设的数据要求、分析步骤和输出结构，适合重复性业务场景。

操作方式：

1. 浏览模板列表，选择符合当前业务问题的模板。
2. 点击模板进入详情或发起分析。
3. 按页面提示补充数据源、文件或分析条件。

6. 侧边导航说明

第三章 快速分析

快速分析用于把一个具体业务问题转化为可查看、可追问、可保存的分析结果。本章以“2026 年 4 月华东区销售额下降原因分析”为例，说明业务用户如何从数据文件出发，快速获得图表、计算结果和可复用制品。

1. 真实业务场景

销售经理在月度经营会上发现华东区 4 月销售额低于预期，需要在短时间内回答三个问题：

1. 哪些城市、门店类型或品类贡献了主要降幅。
2. 销售额下降是由订单量、客流量还是客单价变化导致。
3. 下月应该优先采取哪些改进动作。

传统方式通常需要先整理表格、制作透视表、绘制图表，再人工撰写结论。使用快速分析时，用户只需要选择相关数据，并用自然语言描述分析目标，系统即可围绕数据生成计算过程、可视化图表和报告内容。

2. 选择分析数据

进入“分析”页面后，在“数据上下文”区域点击“选择已有数据”，选择本次分析需要使用的数据文件、数据源或快照。本示例使用文件“华东区月度销售明细（2026年4月）.csv”。

选择数据后，“开始分析”按钮会变为可用。用户也可以在此处选择分析模板，用于复用组织内已经沉淀的分析结构；如果只是临时探索问题，也可以不选择模板。

3. 输入业务问题

点击“开始分析”后，系统会创建一个新的分析会话，并自动带入已选择的数据。用户可以在输入框中直接描述业务问题，例如：

请分析 2026 年 4 月华东区销售额下降的主要原因，重点对比城市、门店类型、品类和客单价变化，并给出下月可执行的改进建议。

为了获得更稳定的结果，建议问题中尽量包含以下信息：

这样的描述方式可以减少来回补充信息的次数，让系统更快理解分析边界和输出目标。

4. 使用分析助手

分析页面右侧提供分析助手。用户可以先向助手描述目标，获取推荐的数据、模板或提问方式；也可以在分析过程中继续让助手补充拆解维度、生成汇报摘要或建议下一步追问。

在真实业务场景中，分析助手特别适合以下情况：

5. 查看分析结果

提交问题后，系统会基于所选数据执行计算、生成图表，并把结果展示在右侧制品区域。用户可以查看图表、计算表格和生成的报告内容。

快速分析的价值不只是“得到一张图”，而是帮助用户完成从数据到业务判断的闭环：

6. 继续追问与保存制品

得到初步结果后，用户可以继续追问更细的问题，例如：

1. “请按门店列出销售额下降最多的前 10 名。”
2. “请把结论整理成适合经营周会的一页摘要。”
3. “请只保留可执行建议，并按优先级排序。”

如果某个图表、计算结果或报告内容需要后续复用，可点击制品区域中的“保存制品”。保存后，用户可以在“制品”模块中再次查看、复制、下载或用于报告整理。

7. 使用建议

第四章 数据管理与文件上传

数据管理用于把分散在本地表格、业务系统和历史分析中的资料统一沉淀为可复用的数据资产。对于普通业务用户而言，它的价值不只是“把文件传上去”，而是让后续的快速分析、报告生成和团队协作建立在同一份可信数据之上。

本章以销售运营团队的月度复盘为例：运营人员每月从业务系统导出区域销售明细，上传到系统后确认解析状态和字段内容，再将该文件用于下降原因分析、门店对比和经营报告生成。

1. 查看数据管理总览

进入左侧导航栏的“数据”页面后，系统会汇总展示数据源、数据文件、数据快照和分析制品。用户可以在这里快速判断当前组织已经沉淀了哪些数据资产、最近上传了哪些文件，以及是否存在需要处理的数据健康问题。

总览页适合用作日常数据工作的起点。业务人员可以优先查看“最近活动”，确认新上传的文件、数据源快照和可复用制品是否已经进入系统；管理员则可以结合数据质量提示，及时发现转换未完成、架构缓存缺失、REST API 缺少 OpenAPI 配置等问题。

2. 管理数据源连接

数据源用于连接可长期复用的业务系统或数据库。进入“数据源”页面后，可以看到 REST API、SQLite、OLAP 等不同类型的数据连接，每个卡片会展示名称、类型、说明和快速操作入口。

建议在添加数据源时写清楚业务系统名称、数据范围和使用限制。例如“销售运营 REST API”适合承载订单、门店、库存与客户成功指标，“经营分析 ClickHouse”适合承载生产分析库中的宽表或聚合表。

点击某个数据源后，可以进入详情页查看连接配置、表结构或 API 配置。对于 OLAP 数据源，页面会展示主机、数据库、账号、建表语句，并提供自然语言查询入口，便于用户在正式分析前先验证数据是否可用。

如果数据源来自 REST API，应优先补充 OpenAPI/Swagger 规范，帮助系统理解接口路径、参数和返回结构。缺少规范的数据源仍可以被记录，但会在数据健康区域提示需要补充配置。

3. 上传本地业务文件

当需要分析新的业务数据时，点击“上传文件”进入上传窗口。系统支持 CSV、Excel、JSON 和文本文件，适合承载销售明细、客户清单、库存台账、问卷结果等常见办公数据。

上传前建议先检查文件内容是否满足以下要求：

• 文件名能够说明业务主题和时间范围，例如“华东区月度销售明细（2026年4月）.csv”。
• 第一行包含清晰的字段名，避免使用“列1”“金额2”这类难以理解的标题。
• 关键字段保持一致口径，例如日期、区域、门店、品类、销售额、订单数等。
• 删除无关的空行、合并单元格和临时备注，降低后续解析和分析的不确定性。

4. 确认文件状态与可见性

上传完成后，进入“数据文件”页面查看文件库。文件卡片会展示文件标题、创建时间、文件类型、大小和处理状态。处理状态为 ready 时，代表文件已经可以被后续分析流程引用；如果显示 queued 或其他处理状态，说明文件仍在准备中。

点击文件后进入文件详情页。这里会显示文件类型、大小、创建时间、备注、可见性和处理状态。可见性用于控制数据共享范围。默认保持私有时，文件只服务于当前用户或受控流程；当团队需要共同复用同一份数据时，再根据组织规则调整共享方式。

文件详情页还提供“分析数据”入口。确认状态正常后，用户可以直接跳转到分析页面，把当前文件作为问题分析的数据基础，减少在不同页面之间反复选择数据的步骤。

5. 预览数据内容

数据预览可以帮助用户在发起分析前做一次快速校验。以上传的销售明细为例，预览中可以看到月份、区域、城市、门店类型、门店名称、品类、销售额、订单数、访客数、客单价和上月销售额等字段。

这个步骤能显著减少“分析结果不符合预期”的情况。比如销售额下降分析依赖 sales_amount 和 last_month_sales，门店效率分析依赖 orders、visitors 和 avg_order_value。如果字段缺失或单位不一致，用户应先修正源文件后再上传。

6. 将文件转换为数据库

当一个文件需要反复查询、关联分析，或包含多个工作表和较多记录时，可以在文件详情页点击“转成数据库”，把文件转换为 SQLite 数据源。转换后的结果会出现在数据源列表中，后续可以像使用其他数据库一样进入查询、分析和模板流程。

转换页面会自动检查当前文件是否已经存在目标 SQLite 数据库。如果已经转换过，页面会提示检测到的表，并提供“查看数据源”“查看已创建表”或“重置并转换”等操作，避免用户在不知情的情况下覆盖已有结果。

首次转换时，系统会启动一个代理式转换流程：AI 会先理解文件结构，再规划表结构、推断字段类型、生成建表 SQL，并按批次写入数据。它不是简单地把表格原样搬进数据库，而是会根据标题、样式、数据模式和多工作表关系，尝试整理出更适合查询和后续分析的 SQLite 结构。

转换页面左侧展示总体进度、已执行 SQL 数量、成功步骤和已创建表；右侧展示实时事件流，包括开始转换、处理工作表、执行 SQL、插入结果和数据源创建事件。这个日志能让用户看到代理每一步做了什么，也方便在出现问题时追溯原因。

转换过程中如果遇到数据格式或 SQL 执行问题，系统可能会暂停并提示用户选择处理方式。通常建议先查看错误信息和当前 SQL，再决定重试、忽略当前问题或中止转换。即使用户主动停止转换，已经写入的数据也会被保留，并可在条件满足时创建部分转换的数据源。

适合转换为数据库的文件包括月度销售明细、库存流水、客户续费清单、多工作表 Excel 和需要反复筛选聚合的大型 CSV。对于只需阅读的一次性纪要、说明文档或少量补充文本，直接作为文件参与分析通常更轻量。

7. 真实使用建议

在月度经营复盘中，推荐将数据管理作为固定流程的一部分：先上传本月数据，再检查解析状态和字段预览，最后进入快速分析或报告生成。这样团队可以围绕同一份数据讨论问题，避免多人各自使用不同版本表格导致口径不一致。

当数据文件需要长期复用时，建议在标题和备注中写清楚业务周期、数据来源和用途。例如“华东区月度销售明细（2026年4月）”适合用于本月销售下降分析，而“华东区门店基础信息表”则更适合作为长期维表反复引用。

对于稳定的业务系统，优先沉淀为数据源；对于一次性导出的表格或临时补充材料，优先上传为数据文件。两者都可以进入分析流程，但数据源更适合持续更新和多人复用，文件更适合快速验证和单次复盘。

8. 本章小结

通过数据管理，用户可以把本地文件、业务 API 和数据库连接转化为系统中的可用数据资产。它带来的直接收益是减少重复上传和重复选择，长期收益是让分析流程建立在更清晰、更统一、更容易协作的数据基础上。

第五章 制品管理与复用

制品是分析过程中沉淀下来的可复用成果，包括图表、报告、数据表和仪表板等。相比聊天记录，制品更适合在复盘、汇报和协作中反复使用：用户不需要重新追溯完整对话，也能快速找到已经生成过的关键结论。

本章以销售运营复盘为例：区域经理在完成“华东区销售下降原因分析”后，可以把图表和报告保存为制品。后续周会、月度汇报或跨部门沟通时，团队成员可以直接从制品库检索、查看、下载或回到来源聊天继续追问。

1. 查看制品库

点击左侧导航栏的“制品”，进入制品管理页面。页面顶部展示当前用户保存的制品数量和来源聊天数量，下方按时间分组展示图表、报告等内容。

制品卡片会显示制品类型、标题、创建时间和预览内容。对于业务用户来说，这相当于一个“分析成果书架”：常用图表、历史报告和阶段性结论都可以在这里集中管理。

2. 搜索历史成果

当制品数量逐渐增加时，可以使用搜索框按关键词查找。例如输入“薪资”后，系统会只保留标题或内容匹配的制品，帮助用户快速定位目标结果。

在真实业务中，建议用户使用稳定的业务关键词命名制品，例如“华东区销售下降分析”“门店客单价对比”“重点客户流失风险”。这样后续查找时，不需要记住具体聊天时间，也能凭业务语义快速找到成果。

3. 按类型筛选制品

制品页支持按类型筛选，例如图表、报告、仪表板和无效制品。需要准备汇报材料时，可以先切换到“报告”；需要找可视化结果时，可以切换到“图表”。

类型筛选能够降低信息噪音。比如销售运营人员在月会前只想下载结论报告，就不必逐个打开图表；数据分析人员需要复核指标变化时，则可以优先查看图表和数据表。

4. 复用与导出

每个制品卡片上提供常用操作入口。用户可以放大查看细节，复制制品内容，下载文件，或回到来源聊天查看该结果的生成过程。

这些操作让制品从“一次性回答”变成“可交付成果”。例如，区域经理可以下载销售下降分析图表放入周报，也可以回到来源聊天继续追问“哪些门店需要优先跟进”，在已有上下文上追加分析。

5. 真实使用建议

建议团队把重要分析结果及时保存为制品，并统一命名规则。一个实用的命名方式是“业务范围 + 分析主题 + 时间周期”，例如“华东区销售下降分析 2026年4月”或“重点门店客单价对比 2026年Q2”。

对于需要反复复盘的主题，建议保存报告和图表两类制品：报告用于向管理层解释结论，图表用于团队讨论细节。这样同一份分析既能支持正式汇报，也能支持一线经营动作。

6. 本章小结

制品管理帮助用户把分析过程中的关键输出沉淀下来，形成可检索、可查看、可下载、可追溯的成果库。它的核心价值是减少重复分析，让一次高质量分析能够服务更多会议、更多角色和更长周期的业务决策。

第六章 模板中心与标准化分析

模板用于把成熟的分析思路固化下来，让用户在面对相似业务问题时，不必每次从零描述分析目标、字段要求和期望输出。对于经常重复发生的经营复盘、项目评估、客户分析和质量分析，模板可以显著降低使用门槛，并帮助团队形成统一的分析口径。

本章以“开发区招商引资项目分析”为例。招商人员或园区运营人员可以使用模板分析引进企业数量、投资总额、项目落地情况和税收贡献，从而快速识别高效招商项目、低效项目和后续优化方向。

1. 浏览模板中心

点击左侧导航栏的“模板”，进入分析模板页面。页面会展示当前可用模板，每个模板包含名称、适用场景、预期洞察和数据源要求。

模板中心适合在分析前使用。用户可以先浏览是否已有接近的模板，再决定是直接复用、调整分析目标，还是创建新的模板。对团队管理者而言，模板也是沉淀最佳实践的入口。

2. 搜索业务模板

当模板数量较多时，可以通过关键词搜索快速定位目标模板。例如输入“招商”，系统会筛选出与招商引资相关的模板。

搜索模板时建议使用真实业务词汇，例如“销售”“库存”“客户流失”“招商”“预算”“测试质量”。这些词通常与模板名称、描述和预期洞察高度相关，能帮助用户更快找到合适的分析框架。

3. 查看模板详情

进入模板详情页后，可以查看模板所需的数据字段、AI 分析指令和预期洞察。以“开发区招商引资项目分析”为例，模板要求包含投资金额、企业数量、产生收入、地点、行业等字段，并会围绕税收贡献、地区差异和招商效率生成洞察。

模板详情页的核心价值是帮助用户判断“我的数据是否适合这个模板”。如果数据缺少关键字段，建议先回到数据管理中补充或修正文件，再进行分析。

4. 使用模板发起分析

点击“使用此模板”后，会进入快速分析页面。用户需要选择对应的数据文件或数据源，并确认分析模板已经选中，再点击“开始分析”。

在实际操作中，建议用户把模板和数据一起检查：模板决定分析结构，数据决定结论质量。比如招商引资模板关注投资金额、企业数量和税收贡献，如果上传的数据只包含企业清单而没有金额和贡献字段，分析结果就会偏向描述性总结，难以形成经营判断。

5. 真实使用建议

对于团队高频场景，建议优先建设标准模板。例如销售团队可以沉淀“月度销售下降分析”和“门店经营复盘”，客服团队可以沉淀“客户流失风险分析”，项目团队可以沉淀“项目进度与预算偏差分析”。

模板命名建议直接反映业务问题，避免使用过于抽象的名称。好的模板名称会让用户一眼知道它解决什么问题，例如“开发区招商引资项目分析”比“项目分析模板”更容易被正确复用。

6. 本章小结

模板中心帮助用户把成熟分析方法转化为可复用流程。它的核心价值是提升分析一致性，减少重复沟通，让不同用户面对同类问题时都能使用相近的数据要求、分析步骤和输出标准。

第七章 个人账户与偏好设置

个人账户与设置用于管理当前用户的身份信息、登录安全、语言偏好、兴趣标签、主题和 API 访问密钥。对于最终用户而言，这些页面通常不需要频繁操作，但在首次使用、切换语言、修改密码或对接外部脚本时非常重要。

本章以普通业务用户的日常设置为例：用户可以从侧边栏底部的账户菜单进入“账户”或“设置”，确认自己的账号身份和角色，维护兴趣偏好以获得更贴近业务的分析建议，并按需管理密码和 API Key。

1. 打开账户菜单

点击左下角的用户名称，可以打开账户菜单。菜单中包含“关于 致数”、语言切换、浅色/深色/系统主题、“账户”、“设置”、“管理”和“退出登录”等操作。管理员用户会看到“管理”入口；普通用户只应使用自己有权限的功能。

日常使用中，账户菜单是最快的个人操作入口。需要切换语言时，可以直接点击“切换到中文”或 “Switch to English”；需要调整主题时，可以选择“浅色”、“深色”或“系统”；需要查看账号与 API Key 时点击“账户”；需要维护语言和兴趣偏好时点击“设置”。

2. 查看个人信息

进入“账户”页后，页面顶部会显示当前页面标题、用户角色标识和“退出登录”按钮。“当前账户”区域会显示头像首字、账号名称、邮箱、User ID、角色标识和当前认证方式。管理员用户会显示“管理员”标识，普通用户则以常规身份使用系统。

账号信息有助于用户确认当前登录身份，尤其是在多人共用测试环境、售前演示环境或企业内部多角色系统中。进行数据上传、模板管理和制品复用前，建议先确认自己使用的是正确账号。若只需要退出当前会话，可以直接使用页面右上角的“退出登录”，或在账户菜单中选择“退出登录”。

3. 修改登录密码

如果当前账号使用本地密码登录，“当前账户”区域会显示“认证方式”信息，并提示可以在此修改登录密码。点击“修改密码”后，系统会要求输入当前密码、新密码和确认新密码。

出于安全考虑，建议用户使用不易猜测的密码，并避免与其他系统共用同一密码。修改密码后，下次登录时需要使用新密码。

4. 管理 API 访问

“账户”页的“API 访问”区域用于管理程序化访问能力。页面会提示“使用此 API 密钥以编程方式访问您的数据。请妥善保管。”该区域展示密钥的部分掩码、“创建时间”和“最后使用”时间。

用户可以点击“重新生成”重新生成密钥，也可以点击“吊销”吊销密钥。重新生成后，旧密钥将不应继续使用；吊销后，依赖该密钥的 CLI、自动化脚本或外部系统对接需要改用新的认证方式。

API Key 应像密码一样妥善保管，不应粘贴到公开文档、聊天群或截图中。如果怀疑密钥泄露，应立即吊销并重新生成。

5. 维护语言、兴趣与主题偏好

“设置”页用于维护个性化偏好。“语言 (Language)” 区域会显示当前语言，例如 “Current: 中文”，并提供“切换语言 (Toggle Language)”按钮。语言切换会影响系统界面显示，用户也可以从账户菜单中快速切换语言。

“兴趣”区域用于维护兴趣标签。用户可以在输入框中填写一个兴趣并按 Enter 键，或点击“添加”；已有兴趣会以标签形式展示，并可通过标签上的关闭按钮移除。调整完成后，点击“保存兴趣”保存。

例如销售运营人员可以添加“盈利能力”“排名”等兴趣标签，后续在分析结果说明中，系统会更容易围绕经营表现、排序对比和异常原因进行表达。

“主题”区域当前显示 Theme customization coming soon...，表示更完整的主题自定义能力尚未开放。已经可用的“浅色”、“深色”和“系统”主题，可以从账户菜单中快速切换。

6. 安全使用建议

在企业环境中，建议用户养成三个习惯：第一，离开共享电脑前使用“退出登录”退出当前会话；第二，不把 API Key 发送给无关人员；第三，发现账号显示的姓名、邮箱、User ID 或角色不符合预期时，先暂停数据操作并联系管理员确认。

对于管理员用户，还应特别注意管理入口的权限边界。日常分析和数据操作尽量使用普通功能入口，只有在确实需要用户、模板或系统级管理时再进入管理后台。

7. 本章小结

个人账户与偏好设置帮助用户确认身份、控制登录安全、调整使用体验，并管理程序化访问能力。“账户”更关注身份、安全和 API Key，“设置”更关注语言、兴趣和主题。它们的核心价值是让每位用户在正确身份、合适语言和安全凭据下使用系统。

第八章 数据安全与协作规范

数据分析系统往往承载业务文件、经营结论、个人账号和程序化访问能力。良好的安全与协作习惯，可以减少误共享、误操作和口径混乱，让团队在更可靠的边界内复用数据和分析成果。

本章面向普通业务用户和团队管理员，说明在日常使用中如何理解文件可见性、账号权限、API Key、制品复用和协作命名规范。

1. 识别数据可见性

在文件详情页中，用户可以查看文件的可见性状态。默认私有的文件只应由当前用户或授权流程使用，适合承载尚未确认口径的原始表格、客户明细或内部经营数据。

如果需要把文件作为团队统一数据源使用，应先确认数据口径、字段含义和使用范围，再按组织规则调整共享方式。不要把临时草稿、未脱敏客户数据或来源不明的数据直接共享给团队。

2. 确认账号身份与权限

个人信息页会显示当前登录用户、邮箱、用户 ID 和角色。用户在上传数据、保存制品或进行管理操作前，应确认自己使用的是正确账号。

管理员账号拥有更高权限，应避免用于普通日常分析。推荐在需要管理用户、模板或系统配置时才使用管理员能力；日常业务分析、文件上传和报告生成尽量使用普通账号完成。

3. 保护 API Key

API Key 可用于 CLI、自动化脚本或外部系统调用。它具备程序化访问能力，应像登录密码一样妥善保管。

使用 API Key 时请遵循以下原则：

• 不要把完整密钥写入公开文档、截图、聊天群或邮件正文。
• 不要与无关人员共享密钥。
• 如果怀疑密钥泄露，应立即吊销并重新生成。
• 离职、转岗或项目结束后，应清理不再使用的自动化脚本和密钥。

4. 安全复用制品

制品库用于保存分析过程中生成的图表、报告和数据表。它能提升团队复用效率，但也意味着分析结论可能被多次传播和引用。

在分享制品前，建议先确认三件事：第一，制品使用的数据是否允许共享；第二，图表或报告中的结论是否已经过业务确认；第三，接收方是否理解数据时间范围和适用场景。

对于包含敏感客户、合同金额、员工绩效或未公开经营指标的制品，应谨慎下载和转发。

5. 使用账户菜单完成安全操作

账户菜单提供语言切换、主题切换、设置入口和退出登录。使用公共会议室电脑、演示设备或他人电脑后，应及时点击“退出登录”。

如果界面语言、主题或账号名称异常，建议先暂停当前操作，确认是否登录了正确账号。多人共享演示环境时尤其需要注意，避免把数据上传到错误账号或保存到错误的制品库。

6. 团队协作命名规范

为了让数据和制品更容易被团队理解，建议使用统一命名方式：

• 数据文件：业务范围 + 数据主题 + 时间周期，例如“华东区月度销售明细（2026年4月）”。
• 分析制品：业务范围 + 分析问题 + 时间周期，例如“华东区销售下降原因分析 2026年4月”。
• 模板：业务场景 + 分析目标，例如“开发区招商引资项目分析”。

清晰命名可以减少重复上传、重复分析和误用历史结果。团队成员看到标题时，应能判断该内容解决什么问题、适用于哪个周期、是否能直接复用。

7. 本章小结

安全与协作规范的核心目标，是让数据、账号和分析成果都处在清晰可控的边界内。用户只要养成确认身份、谨慎共享、保护密钥、规范命名和及时退出登录的习惯，就能显著降低日常使用风险，并提升团队复用分析成果的效率。

第九章 高级功能（致策）

_待补充内容_

第十章 管理员操作指南

管理员后台用于维护组织级的账号、模板、会话、安全设置和审计资料。普通用户通常只需要完成数据上传、分析和制品复用；管理员则需要保证系统入口、权限边界和共享内容处在可控状态。

本章以“张鸿峰”管理员账号登录后的管理页面为例，说明如何阅读后台信息、处理用户与模板、调整系统设置，并完成日常安全检查。

1. 进入系统管理

使用管理员账号登录后，点击左侧导航栏的“管理”，进入“系统管理”页面。页面顶部按功能分为“概览”“用户”“模板”“会话”“设置”和“审计日志”六个标签。

“概览”页适合做每日巡检。管理员可以在这里快速查看总用户数、30 天活跃用户数、对话数、文件数和模板数，并确认 MOTD、注册开关和活跃会话状态。右侧的近期动态会显示最新的登录等行为，帮助管理员判断系统是否有人正在使用。

2. 管理用户账号

点击“用户”标签进入用户管理。页面支持按姓名或邮箱搜索，也可以按角色筛选“管理员”或“用户”。列表展示用户姓名、邮箱、角色、账号状态、认证方式和最后登录时间。

每个用户行右侧的更多菜单可执行账号治理操作：

• 将普通用户提升为管理员，或将管理员降级为普通用户。
• 禁用或重新启用账号。
• 在用户已有 API Key 时撤销密钥。
• 删除用户。该操作为软删除，用于停用不再需要的账号记录。

调整角色前，应先确认该用户是否确实需要管理权限。管理员权限可以影响模板可见性、用户状态、系统设置和审计资料，因此不建议把管理员账号用于普通日常分析。

3. 管理模板审核与标记

点击“模板”标签进入模板管理。管理员可以搜索模板，也可以按状态筛选“已通过”“待审核”“已拒绝”或“草稿”。列表展示模板名称、描述、状态、标记和使用量。

模板行右侧的更多菜单可执行以下操作：

• 通过或拒绝模板，控制模板是否进入可用状态。
• 设置或取消“推荐”，让重要模板在模板中心更容易被发现。
• 设置或取消“官方”，用于标识组织认可的标准模板。
• 设置为公开或私有，控制模板是否面向更多用户可见。

审核模板时，建议重点检查三类内容：模板名称是否能清楚表达业务问题，字段要求是否与真实数据匹配，分析指令是否会引导用户得出可解释的结论。对经营口径、财务指标或客户数据相关模板，应在公开或官方化前完成业务确认。

4. 查看和撤销活跃会话

点击“会话”标签可以查看当前活跃会话。页面显示活跃会话数量、用户 ID、IP、最后活跃时间和客户端信息，并提供刷新按钮。

如果发现异常 IP、异常客户端或明显不再需要的会话，可以点击行尾的撤销按钮结束该会话。公共电脑、演示设备或离职账号留下的会话，应优先清理。

会话列表为空并不代表系统没有用户，只表示当前没有被后台识别为活跃的会话。需要判断用户规模时，应结合“概览”中的 30 天活跃用户数和“用户”页的最后登录时间。

5. 配置系统设置

点击“设置”标签进入系统设置。该页面用于调整影响全体用户的运行参数，保存前应确认变更范围和业务影响。

常见设置包括：

• 每日公告 (MOTD)：向所有用户展示系统公告，例如维护通知或使用提醒。
• 允许注册：控制是否开放新用户注册。
• 允许的邮箱域名：限制可注册邮箱域名；留空表示允许所有域名。
• 全局速率限制：设置每分钟请求上限，用于降低滥用或异常调用风险。
• 每用户存储配额：限制单个用户可使用的存储容量；设为 0 或留空表示不限制。
• LLM 模型覆盖：运行时覆盖对话、分析、前端和快速模型名称。API Key 仍来自环境变量。
• IP 访问控制：配置白名单和黑名单。设置白名单后，仅白名单 IP 可以访问；黑名单始终优先。

修改 IP 白名单或黑名单时要格外谨慎。错误的白名单可能导致正常用户无法访问系统；错误的黑名单可能阻断管理员自己。建议先记录原配置，再保存变更，并在保存后立即验证关键账号仍可登录。

6. 下载和清理审计日志

点击“审计日志”标签可以下载或清除审计日志。下载日志适合用于安全排查、合规留档和问题复盘；清除日志会移除现有记录，应只在确认已完成备份或确有清理需求时执行。

审计日志通常应由管理员或安全负责人保存。下载后的日志文件不要随意转发到公共聊天群、邮件列表或外部工单，因为其中可能包含用户、时间、路径或操作行为等敏感信息。

7. 日常巡检建议

管理员可以按以下顺序完成日常检查：

1. 在“概览”查看用户、文件、模板和近期动态是否异常。
2. 在“用户”确认新增账号、管理员角色和禁用账号是否符合预期。
3. 在“模板”处理待审核模板，并检查推荐、官方和公开标记是否准确。
4. 在“会话”清理异常或遗留会话。
5. 在“设置”确认注册、限流、配额、模型和 IP 访问控制没有被误改。
6. 在“审计日志”按需下载留档，避免在未备份前清除日志。

对于生产环境，建议把高风险操作形成团队规则：角色变更、IP 访问控制、清除审计日志和模型覆盖调整，都应有明确原因和操作记录。

8. 本章小结

管理员后台的核心价值，是把用户权限、模板标准、访问边界和审计资料集中管理起来。管理员在日常使用中应坚持最小权限、谨慎公开、及时清理和保留证据四个原则，让系统既方便团队使用，又保持清晰可靠的治理边界。

术语表

本术语表汇总手册中反复出现的产品概念和业务术语，帮助用户在阅读不同章节时保持一致理解。

数据源

指系统可以连接和使用的数据来源，例如数据库、API 端点、SQLite 数据库或其他结构化数据服务。数据源通常适合长期复用，常用于稳定的业务系统数据分析。

数据文件

指用户上传到系统中的本地文件，例如 CSV、Excel、JSON、PDF、Word 或文本文件。数据文件适合承载临时分析材料、月度业务明细、客户清单、问卷结果等内容。

数据快照

指在某个时间点保存下来的数据状态。快照适合用于历史追溯、版本对比和结果复现，帮助用户理解“当时使用的是哪一份数据”。

快速分析

指用户选择数据后，直接描述业务问题，由系统辅助生成分析结果的流程。快速分析适合处理临时问题、经营复盘、异常排查和探索性分析。

分析助手

指快速分析页面右侧的智能辅助入口。用户可以用自然语言描述目标，系统会辅助推荐数据、模板或下一步分析思路。

模板

指预先定义好的分析结构，包括数据字段要求、分析指令和预期洞察。模板用于把成熟分析方法标准化，减少重复描述和口径差异。

制品

指分析过程中生成并保存下来的成果，例如图表、报告、数据表或仪表板。制品适合用于复盘、汇报、下载、分享和后续追问。

可见性

指数据文件、数据源或其他资源的共享范围。私有资源通常只对当前用户可见；共享资源应在确认数据口径、权限和使用范围后再开放给团队使用。

API Key

指用于程序化访问系统能力的密钥，常用于 CLI、自动化脚本或外部系统对接。API Key 应像密码一样妥善保管，避免泄露。

CLI

命令行工具。适合技术用户或管理员通过脚本方式上传文件、查询数据、调用分析能力或集成外部流程。

处理状态

指文件上传或数据解析后的系统状态。状态为 ready 时，通常表示该文件已经可以用于后续分析。

JSON Schema

一种用于描述数据结构的格式。系统可以根据 JSON Schema 理解字段名称、类型和层级关系，从而提升分析稳定性。

业务口径

指团队对指标、字段和计算规则的统一定义。例如“销售额”是否含税、“订单数”是否包含取消订单、“华东区”包含哪些城市，都属于业务口径。

预期洞察

指模板或分析流程希望产出的关键结论方向，例如趋势变化、排名对比、异常原因、风险提示或优化建议。

兴趣标签

指用户在个人设置中维护的关注主题。系统可在分析解释和建议中适度参考这些兴趣，使输出更贴近用户的业务关注点。

角色

指用户在系统中的权限身份，例如管理员或普通用户。不同角色可能拥有不同的管理入口和操作权限。