文档
设置指南
找到非 IM 设置入口，了解每个参数、默认值与生效范围。
版本范围：当前源码教程。 下列步骤包含尚未进入 npm v1.1.0 的界面更新；文中的旧测试包版本和截图属于历史验证记录。正式版与可选组件的区别见接入与可选能力。
本页说明公共包 deepseekbot 在 DSH 0.2.0-rc.1 中的非 IM 设置：从哪里打开、各参数做什么，以及保存后的作用范围。先完成 安装 和 API 与 Bot 模型配置。Slack、Lark 的账号和连接参数分别见现有连接教程。
设置入口地图
| 要设置什么 | 打开位置 |
|---|---|
| DSH 外观、语言、默认权限、输入行为 | 左下角「设置 → 通用设置」。 |
| API 提供商和模型目录 | 「设置 → 模型」；详见 模型教程。 |
| 原生 Agent 的工具和工作方式 | 「设置 → Agent 预设」。 |
| Bot 图标、动效、排序、并发、我的名字 | 左侧 Bot 模式旁的「Bot 设置」，或「设置 → Bot 设置」。 |
| 单个 Bot 的名称与头像 | Bot 私聊顶部的名称 / 头像 →「查看详细」。 |
| 单个 Bot 的模型与唤醒策略 | Bot 私聊右侧的「模型」和「唤醒策略」。 |
| 右侧栏的顺序、显示、会话视图 | 右侧 Channel sidebar 顶部的齿轮。 |
| 单个 Bot 的工作目录与任务权限 | 右侧「工作区授权」。 |
| 当前 DSH Session 的模型和权限 | 右侧「会话」打开目标 Session，在该会话的原生控件中查看。 |
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 并发上限 | 3；整数 1–32 | 输入后点「保存」。所有 Bot 共用的同时执行任务上限，不限制历史会话；降低上限不会中止正在执行的任务。 |
| DeepSeekBot 版本 | 显示运行中的版本 | 「检查更新」查询 npm；有新版本时可「立即更新」，Web 版装完可「立即重启」。见更新 DeepSeekBot。 |
| 我的默认名字 | 留空，显示 Human；最长 128 字符 | 填写后点「保存名字」，用于聊天、提及及 Bot 上下文。点「恢复默认」或保存空值恢复 Human。 |
| 匿名使用统计 | 开 | 切换即保存，立即生效、无需重启；被插件配置或环境变量关闭时锁定为关。见匿名使用统计。 |
下方「外部平台默认行为」属于 IM 收件与身份设置，参见 Lark / 飞书、Slack 与 Discord。各平台的默认值和版本独立保存。Profile 身份及群收件策略可以继承默认值或保留自定义选项；恢复继承时使用该平台的当前默认值。Discord 普通消息收件仍需 Message Content Intent 和实际投递验证，修改默认值不会授予这些能力。
创建 Bot 与编辑 Profile
创建入口为 Bot 模式中的「创建第一个 PersonaBot」或列表的「新建」。
| 参数 | 怎么配置 |
|---|---|
| 来源 | 「空白」创建新 Memory Repository；「从 Git 导入」填写可访问的 Git URL，使用其内容，不显示空白人格模板。 |
| 名称 | 必填显示名称；Profile 中点击名称旁的编辑按钮可以重命名。 |
| 岗位 | 可选标签；输入后按 Enter 或逗号确认，点击标签的关闭按钮移除。标签本身不授予能力。 |
| 简介 | 可选简短介绍，用于 Profile 展示。 |
| 人格模板 | 空白 / 同事 / 角色扮演，作为创建时的人格文本起点。 |
| 人格 | 创建时可编辑的指令文本，决定 Bot 的身份和交流方式；不是模型/API/权限配置。 |
创建后在 查看详细 中：
- 更换头像：选择 PNG、JPEG 或 WebP，按裁剪界面调整并保存；已有上传头像可以移除。
- 设计头像：选择插画 / 线条风格、预设、部件、形状滑块和颜色。编辑期间是预览，点击保存才应用，取消放弃草稿；上传图片存在时，实际显示优先使用图片。
- 活动概览：图钉控制哪些卡片显示在 Profile 小窗。Token 用量的时间范围、模型/提供商分组、筛选和自定义日期只改变统计视图；不会切换模型。缺失的用量显示未知，不当作零。
- 人格 / 记忆文件：在右侧「记忆文件」查看对应文件，使用文件可用的编辑/预览操作。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 的会话视图中改变过滤范围。 |
| 会话 → 排列方式 | 默认平铺，可按工作区分组。 |
| 侧栏宽度 | 默认 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）。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 包的产品组合是 Core、Client 和已验证的 IM Provider。Browser / Computer 等开发能力不因为上述安装步骤就自动可用；只在实际部署了相应插件时出现。Core 的 enabled（启用）、agentPreset（会话工具预设，默认 standard）、activityDetailConsumers（允许读取活动详情的受信任 Host 插件名单，默认空）、telemetry（匿名使用统计，默认开启）见代码生成的 Core 配置参考。可选 Browser 的目标、驱动、路径、无窗口模式和空闲停止参数见 Browser 配置定义；Computer 的目标、桌面资源、导出目录和操作授权参数见 Computer 配置定义。操作教程见 分享日常浏览器标签页 与 Computer 导出与迁移。
高级修改时先核对实际安装版本，再从 设置 → 内置插件 查看对应插件的详情 / 参数；没有表单的部署参数按 DSH 官方文档 在 Profile / Patch 层配置。当前网站开发参考可能比 npm 发布版更新，不能把开发参考中的可选能力当作这个安装包已经提供。