文档
设置指南
找到非 IM 设置入口，了解每个参数、默认值与生效范围。
版本范围：当前源码教程。 本页同步自当前源码（正式版现已发布至 deepseekbot v1.4.1）；文中的旧测试包版本和 DSH 0.2.0-rc.1 截图属于历史验证记录。正式版与各能力的版本范围见接入与可选能力。
本页说明公共包 deepseekbot 在 DSH 0.2.1-rc.2 中的非 IM 设置：从哪里打开、各参数做什么，以及保存后的作用范围。先完成 安装 和 API 与 Bot 模型配置。Slack、Lark 的账号和连接参数分别见现有连接教程。
设置入口地图
| 要设置什么 | 打开位置 |
|---|---|
| DSH 外观、语言、默认权限、输入行为 | 左下角「设置 → 通用设置」。 |
| API 提供商和模型目录 | 「设置 → 模型」；详见 模型教程。 |
| 原生 Agent 的工具和工作方式 | 「设置 → Agent 预设」。 |
| Bot 图标、动效、排序、并发、我的名字 | 左侧 Bot 模式旁的「Bot 设置」，或「设置 → Bot 设置」。 |
| 单个 Bot 的名称与头像 | Bot 私聊顶部的名称 / 头像 →「查看详细」。 |
| 单个 Bot 的模型与唤醒策略 | Bot 私聊频道设置（顶部 ··· 菜单）中的「模型」和「唤醒策略」。 |
| 右侧栏的顺序、显示、会话视图 | 右侧 Channel sidebar 顶部的齿轮。 |
| 单个 Bot 的工作目录与任务权限 | Bot 私聊频道设置中的「工作区授权」。 |
| 当前 DSH Session 的模型和权限 | 右侧「会话」打开目标 Session，在该会话的原生控件中查看。 |
完整环境备份与恢复
进入 Bot 设置 → 完整环境备份与恢复 → 管理备份。点击「预览导出」查看历史身份总数、受管文件数、估算大小与未迁移的底层 Session 数量；「下载已验证备份」生成一个 .botharness-backup，完成后显示实际压缩大小。
备份包含完整 BotHarness 数据库、自定义位置及已删除身份保留的 Memory 仓库、当前引用附件与身份绑定、仍可达的旧 CAS、模型预设与各 Bot 的独立计划、运行依赖、哈希和真实内容清除检查点。保留数据缺失会使导出失败，主动清除的 Memory 单独标记。文件含敏感聊天、来源内容、账号描述、授权／触发设置及 Outbox／审计历史，请私密保存。
凭证、可执行插件、Workspace 文件和底层 DSH Session 正文不进入备份；Session 历史归属保留为不可用引用。源机器 Git 配置替换为安全默认值，hooks 在恢复时隔离。这是整个 Profile 的备份，与单个 Bot 的 Profile 详情及生成新身份的 Zip／Git 分享不同。
选择备份文件可检查清单、数据库完整性、数量、实际大小和 SHA-256；哈希证明完整性，不证明来源。用可信安装包提供的本地命令，将文件恢复到一个尚不存在的新目录：
botharness-profile restore --file "environment.botharness-backup" --new-home "new-environment"
源码 checkout 可使用 node scripts/profile-restore.mjs 加相同参数。恢复完成时环境仍停止；用已验证的 DSH（0.2.1-rc.2 或 0.2.0-rc.2）和匹配的 BotHarness Bundle 启动该 DSH_HOME。开发环境可运行 node scripts/dev-instance.mjs --home <新目录> --port <端口>，由固定原生 CLI 创建 Profile 组合，不加载备份里的可执行配置。运行中的 Settings 不提供任意目标目录写入，也不替换自身数据；已有目录会被拒绝，暂存数据库使用既有 Profile Writer Lease 校验和迁移后才发布。
恢复默认进入灾难恢复状态：Bot 暂停，账号绑定、外部触发器、Service Grants、持久工具授权和定时任务挂起；Workspace 需要重新映射，Browser／Computer 访问关闭，旧 Session／Inbox／Outbox 不重放。冷状态仍能读取聊天历史和 Memory。在 DSH 模型设置配置目标本地凭证，并在 Bot Profile 保存明确的模型计划；回到管理备份刷新准备度，点击「授权此目标模型」，确认已考虑旧设备仍运行的同身份双活风险，再「激活此 Bot」。发送新的 DM，保留身份并使用新的 Orchestrator Session。模型不可用或计划修订变化会阻止新请求，不静默回退；外部账号需要另行明确授权。
恢复在开放 Messaging 前应用包中的真实清除检查点；离线旧文件无法知道导出后接受的清除。当前解包限制为 512 MiB／60,000 项。空间不足、文件变动、捕获超时或输出文件已存在会拒绝导出；关闭／取消会在发布前中止，下载丢失后应重新预览导出。支持的向前迁移只发生在暂存区；较新且不支持的 Schema、损坏文件、不安全路径／链接或引用闭包缺失会拒绝恢复，不留下已提交目标。计划迁移及替换已有环境留待后续。
DSH 通用设置
这些是 DSH 的原生设置。下表的初始值来自本页的干净 RC1 Profile；已有 Profile 可能保留自己的选择。选择器和开关直接保存，名称等带保存按钮的字段需点击保存。
| 参数 | 选项 / 初始值 | 用途与作用范围 |
|---|---|---|
| 权限 | 仅可查看 / 工作区内修改 / 完全权限；初始工作区内修改 | 新原生会话的默认权限。Bot 的新任务权限另在工作区授权设置，不能用这里的标签推断已有任务权限。 |
| 语言 | 中文或英文；本页使用中文 | 切换界面语言。 |
| 外观 | 浅色 / 深色 / 跟随系统；初始跟随系统 | 界面主题。 |
| 字号大小 | 初始 14 px；用增大 / 减小按钮调整 | 只影响会话内容字体。 |
| 工作步骤展示 | 简洁 / 标准 / 详细 / 完全展开；初始详细 | 工具调用细节的展示程度，不改变工具权限。 |
| 性能与用量 | 简洁 / 详细；初始详细 | 性能与 token 信息的展示程度。 |
| 代码工作工具 | 开 / 关；初始开 | 显示轨迹、本轮代码差异，以及新对话中的 Agent 预设切换入口。 |
| 快捷键 | 点击「编辑快捷键」 | 查看并编辑操作按键。按界面显示的冲突提示调整，保存或恢复默认。 |
| 繁忙时的发送行为 | 初始「排队发送」；可选「插话发送」 | 控制 Agent 运行时 Enter / 发送按钮如何提交；Cmd/Ctrl+Enter 使用另一行为。与 Bot 的唤醒策略分别设置。 |
| 在使用官方模型 API 时上传 Session Log | 开 / 关；本次原生初始为开 | 决定是否通过官方模型 API 上传会话日志以改进模型与产品；按你的偏好选择。 |
| 打开配置文件 | 按钮，无默认值 | 查看当前 Profile 配置的原生入口；日常配置优先使用对应表单。 |
Agent 预设与内置插件
Agent 预设 决定原生 Agent 的工具和工作方式。点击一个预设的「设为新任务默认」后，对之后的新原生任务生效；查看配置、模式说明和如何使用可以先了解差异。它与 Bot 模型预设 是不同设置。
| 预设 | 什么时候使用 |
|---|---|
| 标准模式（初始默认） | 大多数代码、文件和资料任务。 |
| PTC 模式 | 批量工具调用，以及结果筛选、去重、统计和汇总。 |
| 极简模式 | 使用终端工具完成任务，适合基础表现测试和对比。 |
| 创造模式 | 编写 DSH 插件，组合工具和提示词以扩展 DSH。 |
| 自定义 | 使用「让 Agent 帮我创建预设模式」入口。创建后先查看配置与说明。 |
内置插件 页可搜索插件，区分「会话插件」与「全局插件」，选择要查看的 Agent 预设并查看启用状态与详情。第三方插件的参数由其自身声明，因安装内容而变化；不把所有插件条目当作 DeepSeekBot 必填项。插件包安装和启用按 安装教程 操作。开发部署层和所有 BotHarness 配置键见本页末尾的高级参考。
Bot 全局设置
| 参数 | 默认值 / 可选值 | 如何保存与用途 |
|---|---|---|
| Bot 图标 | DeepSeekBot 吉祥物；可选简约、生成形象、通用机器人 | 点击即保存。改变应用侧边栏和设置导航的 Bot 标记，不替代单个 Bot 的头像。 |
| 界面动效 | 跟随系统；可选减少动效、完整动效 | 选择即保存；下方预览显示实际采用的动效。 |
| Bot 列表排序 | 最近更新；可选手动 | 默认列表排序。手动排序时拖动条目；置顶区 / 各分区可有自己的排序设置。 |
| 开发者模式 | 关 | 开启后显示工作区授权的历史和高级选项，不会授予文件权限。 |
| 自动接受入群邀请 | 开 | 自动加入受邀群聊，不唤醒 Bot；关闭后由受邀 Bot 决定是否加入。指 BotHarness 群邀请，不会配置 IM 连接。 |
| Assignment 并发上限 | 8；整数 1–32 | 输入后点「保存」。所有 Bot 共用的同时执行任务上限，不限制历史会话；降低上限不会中止正在执行的任务。 |
| DeepSeekBot 版本 | 显示运行中的版本 | 「检查更新」查询 npm；有新版本时可「立即更新」，Web 版装完可「立即重启」。见更新 DeepSeekBot。 |
| 我的默认名字 | 留空，显示 Human；最长 128 字符 | 填写后点「保存名字」，用于聊天、提及及 Bot 上下文。点「恢复默认」或保存空值恢复 Human。 |
| 匿名使用统计 | 开 | 切换即保存，立即生效、无需重启；被插件配置或环境变量关闭时锁定为关。见匿名使用统计。 |
下方「外部平台默认行为」属于 IM 收件与身份设置，参见 Lark / 飞书、Slack 与 Discord。各平台的默认值和版本独立保存。Profile 身份及群收件策略可以继承默认值或保留自定义选项；恢复继承时使用该平台的当前默认值。Discord 普通消息收件仍需 Message Content Intent 和实际投递验证，修改默认值不会授予这些能力。
外观与壁纸
打开 Bot 设置 → 界面设置（在 Bot 模式下，macOS 按 ⌘, 、其他系统按 Ctrl+, 可直接打开 Bot 设置）。本页设置只保存在这台设备上，网页和桌面端各自保存，不会改变 DSH 主题。
| 设置项 | 选项 | 作用 |
|---|---|---|
| 主题 | 浅色、深色或跟随系统 | Bot 模式自己的主题。 |
| 配色与主色 | 经典蓝、雾紫、森林绿、暖琥珀；主色可任选 | 浅色和深色模式分别设置。 |
| 面板标题栏 / 内容底层 | 底色、不透明度、背景模糊 | 作用于当前模式下的所有面板；文字和消息气泡保持各自颜色。 |
| 壁纸库 | 最多 24 张；图片最大 20 MB，静音视频最大 100 MB | 点击「添加壁纸」或一次拖入多个文件，选中一张或选「无」；「调整取景」设置位置和缩放。首次设置壁纸时，未调整过的面板会变为半透明。 |
| 自动切换 | 关闭、每 1／5／15／30 分钟、每小时；「随机顺序」 | 在壁纸库中轮换。视频静音循环，切到后台时暂停；无法播放时显示已保存的封面并说明原因。 |
| 恢复外观 | 「清除面板单独设置」「恢复默认外观…」 | 前者清除当前模式下各面板的单独设置；后者先确认，再恢复两种模式的默认外观并清空壁纸库。Bot、数据和布局不受影响。 |
要单独设置某个面板，打开它标题栏的菜单 →「外观设置」。每一项都可以跟随全局或单独设置，「恢复此面板」会清除它的单独设置。deepseekbot 的外观和壁纸命令需要指定一个已打开的 Client，见 CLI 指南。
上下文压缩
Bot 的主会话（Orchestrator Session）会随着每轮对话变长。压缩会用摘要替换冗长的历史，让下一条消息要重读的内容更少。
- 立即压缩： 在 Bot 私聊输入框输入
/compact，在 IM 私聊发送/compact（或/压缩），或运行deepseekbot bot-compact <bot-id>。结果会显示压缩前后的 token 数。Bot 正在工作时会被拒绝，请先停止或等待。 - 空闲时提前压缩上下文： 位于 Bot 设置 → 模型与运行，默认开启。Bot 安静到所用模型提示缓存寿命的一半时（最少 15 分钟；DeepSeek 模型在观测到实际数据前按 2 小时估计），Host 会趁缓存还在压缩会话，比之后在缓存失效时压缩更省。聊天里不显示，每次都记录在 Bot 活动中。细节和按模型的覆盖方式见 CLI 指南。
如果某一轮仍因上下文已满而失败，失败提示会直接说明；请缩小请求后重试。
快速搜索与快捷键
在 Bot 模式下按 Alt+K（macOS 为 Option+K）可搜索 Bot、群聊、频道以及 Bot 设置里的具体一行；浏览器能收到 Ctrl+K 或 ⌘K 时也可以使用。中文名称可用全拼或首字母搜索。选中设置结果会打开对应页面并高亮那一行。按 ? 或 Ctrl/⌘+/ 查看全部快捷键，在 Bot 设置 → 键盘快捷键 中修改。
创建 Bot 与编辑 Profile
创建入口为 Bot 模式中的「创建第一个 PersonaBot」或列表的「新建」。
| 参数 | 怎么配置 |
|---|---|
| 来源 | 「空白」创建新 Memory Repository；「从 Git 导入」填写可访问的 Git URL，使用其内容，不显示空白人格模板。 |
| 名称 | 必填显示名称；Profile 中点击名称旁的编辑按钮可以重命名。 |
| 岗位 | 可选标签；输入后按 Enter 或逗号确认，点击标签的关闭按钮移除。标签本身不授予能力。 |
| 简介 | 可选简短介绍，用于 Profile 展示。 |
| 人格模板 | 空白 / 同事 / 角色扮演，作为创建时的人格文本起点。 |
| 人格 | 创建时可编辑的指令文本，决定 Bot 的身份和交流方式；不是模型/API/权限配置。 |
创建后在 查看详细 中：
- 更换头像：选择 PNG、JPEG 或 WebP，按裁剪界面调整并保存；已有上传头像可以移除。
- 设计头像：选择插画 / 线条风格、预设、部件、形状滑块和颜色。编辑期间是预览，点击保存才应用，取消放弃草稿；上传图片存在时，实际显示优先使用图片。
- 活动概览：图钉控制哪些卡片显示在 Profile 小窗。Token 用量可在 每日总量 和 按模型 之间切换，时间范围有 7 / 30 / 90 天和全部，自定义范围在 ⋯ 菜单里；鼠标悬停在柱子上可以看到缓存输入、非缓存输入和输出的拆分。这些只改变统计视图，不会切换模型。缺失的用量显示未知，不当作零。
- 人格 / 记忆文件：在右侧「记忆文件」查看对应文件，使用文件可用的编辑/预览操作。Profile 没有把全部创建字段重复为编辑表单。
- 常驻记忆上限 已移到 Channel sidebar：在 Bot 私聊 → 记忆文件 → 常驻记忆上限 设置
SOUL.md与MEMORY.md的字符上限，从下一个 Session 或当前 Session 下次压缩时生效；见 Bot 灵魂与核心记忆。 - 外部身份与外部连接器 也已从 Profile 移到 Bot 私聊的 Channel sidebar：见 外部身份 与 外部连接器。
Bot 唤醒策略与本地群聊
Bot 的 唤醒策略 已移到私聊的 Channel sidebar。打开 Bot 私聊 → Channel sidebar → 唤醒策略，点击来源行，选择规则后点保存；「恢复默认」撤销这个来源的修改。各来源的选项与范围见 唤醒策略。
本地群聊可在 群名 / 头像 → 查看详细 中为每个成员 Bot 覆盖普通消息提醒；继承使用该 Bot 默认规则，修改与恢复继承作用于该群。群成员管理入口用于邀请、加入申请与成员操作。群级提醒不改变 Provider、模型或工作区权限。
Channel sidebar 显示设置
Channel sidebar 章节按功能提供操作教程；标签页、排序与隐藏的具体流程见显示与布局。
聊天顶部的 ··· → 频道设置… 打开这个聊天的模型、工作区授权、唤醒策略、外部身份、外部连接器或群管理。侧栏的显示选项放在各区域标题右侧的齿轮里，是浏览器中的显示偏好，不改变 Bot 的持久记忆或任务授权。
| 参数 | 默认 / 作用 |
|---|---|
| + 视图（标签页旁） | 勾选显示的标签页并拖动排序，立即生效；Bot 私聊和群聊可以有不同布局。 |
| 编辑侧边栏（窄窗口） | 拖动排序，勾选显示的入口，然后完成。 |
| 记忆演化 → 显示术语 | 默认记忆术语，可切换 Git 术语；同一份提交记录使用不同名称展示。 |
| Bot 收件箱 → 呈现方式 | 默认按时间，可按来源分组。 |
| 会话 → 会话范围 | 默认当前，可选全部；在该 Bot 的会话视图中改变过滤范围。 |
| 会话 → 排列方式 | 默认按状态（进行中／空闲），可按工作区分组。 |
| 侧栏宽度 | 默认 320 px，可拖动分隔条在 260–560 px 调整；选中的标签页、上下分区比例与展开状态也会保留。 |
工作区授权与任务权限
在目标 Bot 私聊的 频道设置（顶部 ··· 菜单 → 频道设置…）中打开 工作区授权。Memory Repository 是该 Bot 的记忆目录；额外任务目录通过「添加文件夹」在 Host 的目录浏览器中选择。远程浏览器使用的是运行 DSH 的机器路径。
| 参数 / 操作 | 作用与生效范围 |
|---|---|
| 添加文件夹 | 选择允许这个 Bot 使用的任务目录，确认后产生工作区授权；每个 Bot 分别管理。 |
| 目录撤销 / 移除 | 撤销对应授权；后续任务不能继续把它作为有效授权。不是删除该目录的文件。 |
| 新事项允许所有文件访问 | 默认关：新 Assignment 保持工作区写入与逐次询问。开启会要求明确确认，之后的新任务使用完整文件访问；不会改写已创建任务的权限快照。 |
| 工具批准规则 | 允许一次、按具体操作记住或更宽的规则以实际批准界面为准；已有规则可查看细节并撤销。检查所针对的 Bot、角色、目录和操作范围再确认。 |
| 开发者模式中的历史 / 高级选项 | 查看已撤销授权等历史。显示这些记录不等于重新授权。 |
第一次使用建议先添加一个明确任务目录，保持默认任务权限，然后实际发起任务验证。模型选择、目录授权与任务权限分别配置。
匿名使用统计
DeepSeekBot 默认由 DSH 后台发送匿名使用统计；首次打开 Bot 模式时会弹出一次说明。事件只关联一个保存在 $DSH_HOME/botharness/telemetry.json 的随机安装 ID：
plugin_started：插件版本、DSH 版本、操作系统和架构。bot_created、bot_archived、bot_deleted、marketplace_bot_installed、avatar_edited：只记录发生了这个操作。connector_enabled：只记录连接器类型（feishu、lark、slack、discord、weixin或other）。- 首次进入引导和新手教程：
intro_shown；intro_step_viewed（步骤名）；intro_dismissed（停在哪一步，点的是跳过还是关闭）；intro_completed（选了哪个开场问题，不含文字）；intro_theme_changed（只记scheme、preset或wallpaper）；intro_model_saved（只记是否用了进阶的执行模型）；intro_community_clicked（github、discord或qq）；以及tutorial_action（start、pause、skip、continue、restart或finish）。不包含模型名称、壁纸文件或输入的文字。 daily_usage：每天最多一次，记录 PersonaBot 数量、自上次汇总以来新增的会话数和消息数，以及这段统计时长（整小时数）；不会按单条消息发送事件。$exception：BotHarness 代码在后台出现未处理的错误时，记录错误类型和调用栈中的函数名与行号，文件只保留包内相对路径（如@botharness/core/dist/index.mjs）或文件名；调用栈中没有 BotHarness 代码的错误会被丢弃。报告先保存在本机，下次启动时发送；从不包含错误信息正文。
名称、Persona 或 Memory 内容、对话、提示词、工具参数、仓库地址、连接器账号或工作区、你的文件路径、凭据和 IP 地址从不发送。要关闭，打开 Bot 设置，关掉 匿名使用统计 开关即可：立即生效、无需重启，尚未发送的事件会被丢弃，选择保存在同一个 telemetry.json 里，重启后仍然有效；重新打开同样无需重启。部署方也可以在 BotHarness core 插件上设置 telemetry: false（见下方高级参数），或用 DO_NOT_TRACK=1 或 BOTHARNESS_TELEMETRY=0 启动 DSH 强制关闭，此时开关显示为关闭且不可操作，并注明是哪项设置关闭了它。详见隐私说明和源码。
高级参数与可选能力
公共 npm 包 deepseekbot 默认包含 Core、Client、Browser、Computer 和已验证的 IM Provider；首次安装不连接任何 IM 账号，每个 Bot 的 Browser / Computer 访问权限也默认关闭，需按 Bot 显式开启。Core 的 enabled（启用）、agentPreset（会话工具预设，默认 standard）、activityDetailConsumers（允许读取活动详情的受信任 Host 插件名单，默认空）、telemetry（匿名使用统计，默认开启）见代码生成的 Core 配置参考。Browser 的目标、驱动、路径、无窗口模式和空闲停止参数见 Browser 配置定义；Computer 的目标、桌面资源、导出目录和操作授权参数见 Computer 配置定义。操作教程见 分享日常浏览器标签页 与 Computer 导出与迁移。
高级修改时先核对实际安装版本，再从 设置 → 内置插件 查看对应插件的详情 / 参数；没有表单的部署参数按 DSH 官方文档 在 Profile / Patch 层配置。当前网站开发参考可能比 npm 发布版更新，不能把开发参考中的可选能力当作这个安装包已经提供。