1. 使用说明#
本手册介绍办公套件“系统配置”功能，适合首次使用该功能的系统管理员和实施人员。您可以按照本文步骤查找配置项、修改配置、验证是否生效，并在需要时恢复原设置。如果不确定某个配置项的含义或影响范围，请先联系石墨技术支持确认，再进行修改。
1.1 使用入口#
管理后台 > 办公套件 > 配置管理 > 系统配置1.2 使用前准备#
确认登录账号具有办公套件系统配置的查看和修改权限。
先确认目标范围是全局还是某个企业，并取得准确的企业 ID。
从配置需求或附录 A 中确认配置键名。配置键名是唯一标识，请不要只根据中文名称猜测。
记录修改前的来源、状态和生效值；重要配置应同时准备回滚值。
影响范围较大的全局配置应在业务低峰期修改，并提前告知相关负责人。
2. 配置范围与优先级#
系统配置支持全局和企业两个范围。修改前必须先核对企业 ID 字段和页面底部的范围提示。| 功能区域 | 全局范围 | 企业范围 | 页面识别信号 |
|---|
| 系统配置 | 企业 ID 留空 | 选择企业 ID | 底部提示“全局版本覆盖”或“企业最终生效结果” |
2.1 全局配置#
全局值是未设置企业覆盖时的基础值，修改后可能影响多个企业。
2.2 企业级配置#
页面展示默认值与当前企业自定义配置合并后的最终生效结果。
企业级配置只影响所选企业，不直接改变其他企业的配置。
同一配置项存在企业级配 置时，企业最终生效值优先于全局值。
2.3 覆盖、继承与恢复#
“恢复系统默认”、删除当前覆盖等操作，通常表示移除当前范围的覆盖并重新继承上一级值。
页面中的“系统默认”“全局版本覆盖”“企业最终生效结果”等提示，可用于判断当前值来自哪一层。
执行恢 复或删除前，应先记录当前值并确认继承后的结果符合预期。
3. 系统配置#
系统配置用于查看和调整办公套件的通用功能、配额及运行参数。3.1 查找方式一：精确搜索#
企业 ID：留空表示全局；选择企业 ID 表示企业级配置。
查找条件：按需要选择类型、值类型和生效端；不确定时保留“全部”。
key 名：填写配置键名；支持一行一个键名或使用英文逗号分隔。
单击“搜索”，确认结果中的名称、键名、来源、状态和当前值。
3.2 查找方式二：在列表中直接定位#
保持企业范围和筛选条件正确，使用页面滚动浏览列表。
按“名称”或“键名”确认目标配置，不要仅根据当前值判断。
单击最右侧“编辑”。如果看不到操作列，将表格横向滚动到最右侧，也可以扩大浏览器可视区域。
3.3 编辑不同类型的系统配置#
3.3.1 键值类型#
编辑弹窗上半部分展示只读元数据，包括键名、名称、描述、类型和生效端。开启状态后，在“字符串值”等输入框中填写值并保存。字符串中如果承载 JSON、URL、路径或列表，应保持原有格式。3.3.2 配额类型#
配额弹窗通常包含状态、最小值、最大值和“不校验”开关。启用配置后按业务要求填写范围；开启“不校验”表示系统不按照所填范围执行限制校验。数值必须与弹窗单位一致，例如“个”“MB”等。3.3.3 功能类型#
功能类型以状态开关为主。开启表示在当前范围启用该配置项；关闭表示禁用或不启用。部分键具有反向语义，应以配置项名称和说明为准。例如名称中包含 unsupport 或 disable 的键，开启可能代表“不支持”或“禁用”。3.4 保存、删除与恢复#
保存前再次确认企业范围、键名、类型、单位和修改值。
保存后重新搜索同一配置项，确认来源、状态和生效值已经变化。
当前范围存在覆盖时，“删除”操作可能可用；删除覆盖后会回到上一级继承值。
需要回滚时优先写回已记录的原值，或在确认继承关系后删除当前覆盖。
不要把“删除”理解为删除配置项本身；页面中的删除通常只针对当前范围的覆盖记录。
4. 生效验证与回滚#
4.1 保存后的验证#
在系统配置页面重新查询同一企业范围和同一配置项，确认来源、状态和生效值。
进入实际使用该配置的功能页面，检查功能表现，而不是只看配置后台。
全局配置至少抽查一个未设置企业级配置的企业；企业级配置只验证目标企业。
账号、权限或缓存相关配置必要时应刷新页面、重新登录或等待缓存更新。
记录修改时间、操作人、企业 范围、键名、修改前后值和验证结果。
4.2 回滚#
仅需移除当前范围覆盖：使用“恢复系统默认”或删除当前覆盖。
回滚后再次查询来源和生效值，并重新进入业务页面验证。
若全局修改造成大面积异常，应优先恢复全局覆盖，再排查各企业的覆盖差异。
5. 常见问题#
| 问题 | 处理方法 |
|---|
| 找不到编辑或操作按钮 | 表格较宽时向右横向滚动到最右侧；也可以扩大浏览器可视区域。 |
| 精确搜索没有结果 | 确认键名大小写和下划线；确认企业 ID 范围；清空过度严格的类型、值类型或生效端筛选。 |
| 保存后业务页面没有变化 | 检查是否选错企业范围、来源是否被企业覆盖、是否需要刷新或重新登录，并确认配置项是否适用于当前功能。 |
| 恢复系统默认按钮不可用 | 当前范围没有覆盖，已经在使用继承值或系统默认值。 |
| JSON 或 URL 配置报错 | 保持合法 JSON 或 URL 格式，不要省略引号、逗号或协议；先在测试企业验证。 |
| 企业最终生效值与全局值不同 | 当前企业可能存在覆盖。检查来源和覆盖记录，确认是否需要保留企业差异或恢复继承。 |
附录 A： 系统配置项索引#
以下索引仅列出可在当前页面查询和修改的系统配置项；具体可见范围以当前部署版本和页面实际展示为准。| 配置键名 | 配置项名称 | 类型/规则 | 页面支持情况 |
|---|
| allow_team_admin_get_invited_user_password | 企业管理员获得邀请用户的初始密码 | 空字符串 | 页面可配置 |
| auto_login_on_no_permission_page | 匿名访问无权限转跳登录页 | 空字符串 | 页面可配置 |
| batch_delete_file_count_limit | 批量删除文件的最大数量 | 0–500 | 页面可配置 |
| batch_download_files | 单次批量下载文件数上限 | 0–500 | 页面可配置 |
| batch_download_size | 单次批量下载总大小上限 | 0–21474836480 | 页面可配置 |
| batch_move_file_count_limit | 批量移动文件的最大数量 | 0–500 | 页面可配置 |
| brand | 前端品牌名称 | 空字符串 | 页面可配置 |
| change_folder_collaborator | 文件夹协作 | 空字符串 | 页面可配置 |
| classification_mark_config_limit | 降级审批策略的最大数量 | 0–30 | 页面可配置 |
| classification_mark_limit | 密级标签的最大数量 | 0–20 | 页面可配置 |
| classification_mark_rule_limit | 密级标签规则的最大数量 | 0–30 | 页面可配置 |
| cloud_team_space_download_file_size | 单个下载文件的最大体积 (MB) | 0–3072 | 页面可配置 |
| cloud_team_space_upload_file_size | 团队空间上传文件大小限制 | 0–300 | 页面可配置 |
| day_unpack_file_count_limit | 每天解压文件最大数量 | 0–2000 | 页面可配置 |
| default_avatar | 默认头像地址 | 路径 | 页面可配置 |
| default_enterprise_trash_quota | 企业回收站默认配额 | 0–0 | 页面可配置 |
| default_space_quota | 团队空间默认配额 | 0–107374182400 | 页面可配置 |
| default_team_user_quota | 企业成员默认容量上限 | 0–0 | 页面可配置 |
| default_user_file_tags | 用户文件默认标签 | JSON 数组 | 页面可配置 |
| default_user_quota | 团队内个人空间默认配额（我的桌面） | 0–107374182400 | 页面可配置 |
| department_count_limit | 企业可创建部门的最大数量 | 0–500 | 页面可配置 |
| department_depth_limit | 部门嵌套层级的最大数量 | 0–20 | 页面可配置 |
| disable_batch_download | 禁用批量下载 | 空字符串 | 页面可配置 |
| disable_enterprise_trash | 隐藏企业回收站 | 空字符串 | 页面可配置 |
| display_ip_location | 显示 IP 归属地 | 空字符串 | 页面可配置 |
| drive_editor_about_brand_visible | 办公套件编辑器关于页品牌信息显示 | 空字符串 | 页面可配置 |
| drive_editor_about_entry_visible | 办公套件编辑器“关于”入口显示 | 空字符串 | 页面可配置 |
| drive_editor_official_website_entry_visible | 办公套件编辑器官网入口显示 | 空字符串 | 页面可配置 |
| enable_link_report | 外链举报 | 空字符串 | 页面可配置 |
| enable_outsider | 外部协作者 | 空字符串 | 页面可配置 |
| enable_pc_system_theme | enable_pc_system_theme | 空字符串 | 页面可配置 |
| enable_rdoc_md_image_export_options | enable_rdoc_md_image_export_options | 空字符串 | 页面可配置 |
| enable_risks | 风险识别 | 空字符串 | 页面可配置 |
| enable_share_expire_time | 分享链接过期时间 | 空字符串 | 页面可配置 |
| enable_share_password | 分享密码 | 空字符串 | 页面可配置 |
| file_collaborator_limit | 单个文件可添加的最大协作者数量 (个) | 0–100 | 页面可配置 |
| folder_children_count_limit | 同层级文件的最大数量 | 0–2000 | 页面可配置 |
| free_user_create_limit | 控制免费用户可创建模板数量上限 | 0–5 | 页面可配置 |
| frontend_runtime_features | 前端运行时配置项列表 | JSON 数组 | 页面可配置 |
| import_user_rows_limit | 单次导入用户的最大数量 | 0–500 | 页面可配置 |
| invite_mobile_limit_expired | 通过手机号邀请文件协作次数统计的过期时间窗口 | 0–3600 | 页面可配置 |
| invite_mobile_limit_max | 通过手机号邀请文件协作次数限制 | 0–20 | 页面可配置 |
| is_open_role_apply | 文件权限申请 | 空字符串 | 页面可配置 |
| login_device_limit | 单个账号同时登录设备数上限 | 0–0 | 页面可配置 |
| max_creator_teams_per_account | 单个账号可创建企业数上限 | 0–3 | 页面可配置 |
| max_folder_depth | 文件夹最大嵌套层数 | 0–50 | 页面可配置 |
| max_joined_teams_per_account | 单个账号可加入企业数上限 | 0–100 | 页面可配置 |
| max_trashes_list_size | 回收站列表接口返回记录的数量 | 0–500 | 页面可配置 |
| multipart_upload_enable | 分片上传 | 数值字符串 | 页面可配置 |
| once_unpack_file_count_limit | 单次解压文件最大数量 | 0–500 | 页面可配置 |
| only_owner_can_delete | only_owner_can_delete | 空字符串 | 页面可配置 |
| premium_user_create_limit | 用户可创建的模板的最大数量 | 0–50 | 页面可配置 |
| private_deploy_page_icon | 页面图标配置 | 空字符串 | 页面可配置 |
| public_share | 公开分享 | 空字符串 | 页面可配置 |
| rag_search_rule | RAG 搜索规则 | JSON 对象 | 页面可配置 |
| sdkCheckpointCacheTTL | 编辑器配置缓存时长 | 0–600 | 页面可配置 |
| sdk_checkpoint_whitelist | 编辑器配置项白名单 | JSON 对象 | 页面可配置 |
| search_ai_enable | search_ai_enable | 空字符串 | 页面可配置 |
| share_password_length | 分享密码长度 | 0–6 | 页面可配置 |
| single_file_upload_size_limit | 单个上传文件的最大体积 (GB) | 0–1 | 页面可配置 |
| single_upload_file_count_limit | 批量上传 | 空字符串 | 页面可配置 |
| team_change | team_change | 空字符串 | 页面可配置 |
| team_role_manage | 角色管理 | 空字符串 | 页面可配置 |
| theme_color | 前端主题色 | 空字符串 | 页面可配置 |
| theme_color_btn | 按钮主题色 | HEX 色值 | 页面可配置 |
| ui_radius_config | 前端圆角配置 | 空字符串 | 页面可配置 |
| upload_batch_max | 单次上传文件的最大数量 (个) | 0–500 | 页面可配置 |
附录 B：术语与页面字段对照#
| 术语 | 含义 |
|---|
| 配置键名 / key 名 | 配置项的唯一键名，例如 batch_download_files。 |
| 企业 ID | 企业标识。选择后进入企业级配置范围。 |
| 全局配置 | 企业 ID 留空时查询和修改的默认范围。 |
| 企业级配置 | 只对所选企业生效的覆盖配置。 |
| 系统默认 | 当前范围没有自定义覆盖，使用产品内置默认值。 |
| 全局版本覆盖 | 当前配置项在全局范围存在自定义设置。 |
| 企业最终生效结果 | 企业默认值与企业覆盖合并后的实际生效结果。 |
| 键值 | 以字符串等形式保存的单值参数，可能承载文本、URL、路径或 JSON。 |
| 配额 | 包含最小值、最大值或限制开关的数值范围。 |
| 功能 | 开关或状态型参数。 |
| 不校验 | 不按照所填上限进行限制校验。 |
