01
安全模式
默认档位。读取类操作直接放行，写文件、改动终端状态、访问网页或发起白名单之外的网络请求，都会先征求你的同意。
文档
使用文档
下面按主题说明 YouAgent 的主要机制。应用内每一处「了解更多」都会跳到这里对应的小节。
技能
技能
技能是一份可复用的说明书。把一种反复用到的做法写进去，智能体在需要时自己取用，不必每次重新交代。
- 每个技能是一个目录，里面必须有一份带 YAML 头部的 SKILL.md，配套的脚本、参考资料和模板放在旁边
- 技能可以放在全局、工作区或项目三个位置，优先级依次升高
- 同名技能出现在多个位置时，优先级高的生效，其余被遮蔽但不会被删除
- 项目内的技能目录随项目走，可以随代码一起提交给团队共享
放在哪里
全局技能在配置目录的 skills 子目录下，工作区技能在该工作区目录下，项目技能在你的项目根目录下。三层可以叠加使用。
权限
权限
智能体的每一次工具调用都要过权限引擎。你决定它可以自己做什么，什么必须先问过你。
02
全部放行
所有工具调用不再询问。只适合你完全信任的工作区，界面上会一直挂着提示条提醒你处在这个状态。
03
先出计划
智能体必须先提交计划，你接受、修改或否决之后，它才能执行计划之外的任何工具。
工作区
工作区
工作区是隔离单位。会话、技能、权限设置和项目上下文按工作区分开，互不干扰。
- 首次启动会自动建一个默认工作区，之后可以按项目或按主题继续新建
- 每个工作区在配置目录下有自己的文件夹，名称会转成一个便于识别的标识
- 工作区各自保存默认权限模式、主题和可切换的权限档位
- 切换工作区不会影响其他工作区正在进行的会话
什么时候该新建
当一批工作需要不同的权限尺度、不同的技能集合，或者你希望它的会话历史不要和现有的混在一起时，就值得开一个新的工作区。
主题
主题
界面配色基于一套六色体系，可以整体设定，也可以按工作区单独指定。
- 在设置的外观里选择应用级别的默认主题，支持浅色、深色和跟随系统
- 可以给单个工作区指定专属主题，没有指定的工作区沿用应用默认
- 配置目录里的主题文件是完整的主题包，应用启动时会自动读取
- 也可以只覆盖其中几个颜色，其余仍走内置默认值
全部可选
主题相关的设置都不是必填项。什么都不配置时，应用使用内置的默认配色。
连接与模型
连接与模型
在设置里配置模型连接。配置文件中不保存明文凭据，API 密钥交给系统的凭据管理器写入。
01
用已有订阅登录
通过授权流程接入你已经在用的对话服务订阅，不需要另外申请密钥。
02
填写服务商密钥
内置多家主流模型服务商的预设，选中之后填入自己的 API 密钥即可使用。
03
自建或本地端点
兼容 OpenAI 或 Anthropic 协议的自建服务可以直接填地址接入，本机运行的模型同理，密钥可以留空。
- 会话记录和导出文件里只保留连接与模型的标识，不含凭据
- 需要经过代理的网络环境可以在设置里指定代理
- 界面语言支持简体中文、英文和日文，随时切换
- 自动更新的检查行为也在这里开关
凭据去哪了
密钥和登录态由操作系统的凭据管理器加密保存，不写进任何明文配置文件，也不会随会话记录导出。
数据目录
数据目录与偏好
所有配置和数据集中在用户目录下的一个文件夹里。位置可以改，内容始终是你机器上的普通文件。
- 全局偏好、凭据、权限策略、主题、工具图标和日志各有自己的子目录
- 工作区数据在同一个根目录下按工作区分开存放
- 通过环境变量指定另一个根目录，可以隔离测试或并行运行多个实例
- 整个目录可以直接备份和迁移，不依赖任何注册表或系统数据库
工作区偏好
可以为工作区写下你的习惯和口味，比如输出的语言、详略程度和格式约定。智能体在该工作区里会遵循这些偏好。
浏览器
内置浏览器
桌面端自带一个浏览器面板。智能体在里面查资料和取内容，你能看到它在看什么，也能随时接管。
- 每个会话独立分配一个浏览器实例，会话之间互不干扰
- 聊天界面右上角的按钮可以随时打开或收起浏览器面板
- 智能体通过工具调用来操作它，每一次导航都受权限模式约束
- 是否启用浏览器工具可以按工作区在设置里开关
仅桌面端
浏览器面板由桌面应用承载。通过浏览器界面访问时，这个面板不会在远端另外创建。
文档工具
文档工具
安装包内置了一组文档处理工具，覆盖常见办公格式的读取、转换、对比和渲染。
01
读取与提取
PDF 可以按页取文本和表格，表格文件能枚举工作表并取指定区域，演示文稿能逐页取文字。
02
转换与对比
多数文档可以转成 Markdown 供智能体阅读，两份文档之间也能直接比出差异。
03
图片与日程
图片可以读取元信息、识别文字并重新编码，日历文件能解析成结构化的日程条目。