更新日期：2026 年 2 月 14 日

Hajimi Work 使用文档

Hajimi Work 是一款 AI 桌面助手，提供智能对话、文件管理、任务监控和插件扩展。它与 Hajimi Code（CLI）共享配置和会话数据，让你在命令行和桌面端之间无缝切换。当前版本：0.1.0。

概览

Hajimi Work 是一款桌面端 AI 助手应用，通过图形界面让你更直观地与 AI 协作。

个功能模块

种模型协议

个可用插件

智能助手

支持对话和代理两种模式，可附带文件提问，AI 能直接读写你授权的文件。

文件管理

内置文件管理器，支持浏览、创建、导入、重命名、删除和文本预览。

任务监控

实时查看代理模式任务的执行状态、进度和步骤详情。

历史会话

浏览所有对话记录，支持搜索、继续对话和删除。

插件中心

浏览和管理扩展插件，为 AI 增加新能力。

设置中心

配置 API 供应商、模型选择、角色绑定和通用参数。

与 CLI 共享—Hajimi Work 与 Hajimi Code（CLI）共享 ~/.hajimi 配置目录和会话数据，两端配置互通。

快速开始

按照以下步骤，几分钟内即可开始使用：

下载安装

前往 Releases 页面下载对应系统的安装包（支持 macOS、Windows、Linux），安装后启动应用。

配置 API 供应商

打开应用，点击左侧「设置」，在「API 供应商」中添加你的 API 配置：

• 填写供应商名称（如 "OpenAI"）
• 选择协议类型（OpenAI / Anthropic / Gemini）
• 输入 API Key 和 Base URL
• 添加可用的模型 ID（如 gpt-4o, claude-3-5-sonnet）

绑定模型角色

在「模型配置」中，至少为 General（主力模型） 角色绑定一个模型。这是使用智能助手的前提条件。

授权文件目录

进入「文件管理」，点击「授权目录」添加你希望 AI 能够访问的目录。AI 只能在授权范围内操作文件。

开始对话

回到「智能助手」，输入你的需求开始与 AI 对话。试试代理模式让 AI 帮你完成实际任务！

已有 CLI 配置？—如果你已经使用过 Hajimi Code（CLI）并完成了配置，Work 会自动读取 ~/.hajimi 下的配置文件，无需重复设置。

智能助手

智能助手是 Hajimi Work 的核心功能，位于应用首页。你可以在这里与 AI 进行对话，让它帮你完成各种任务。

界面组成

• 顶部工具栏：显示当前工作目录、模式切换开关和「新对话」按钮
• 对话区域：显示你和 AI 的对话内容，支持 Markdown 格式渲染
• 输入区域：底部输入框，支持多行输入和附件上传
• 快捷操作：首次对话时会显示常用任务的快捷按钮

发送消息

• 在输入框中输入内容，按 Enter 发送
• 按 Shift + Enter 换行
• 单次输入最多 20,000 字符
• 如果只上传了附件没有输入文字，系统会自动使用"请基于我上传的附件继续处理任务"作为提示

对话模式 vs 代理模式

通过顶部的模式切换开关，你可以在两种模式之间切换：

对话模式

直接对话获取建议和回答

• AI 只进行文本回复，不执行任何文件操作
• 优先使用 Fast 角色绑定的模型
• 未配置 Fast 时回退到 General
• 适合咨询问题、讨论方案、获取建议

代理模式默认

描述任务目标，助手自主规划并执行

• AI 可以读写文件、执行多步骤任务
• 优先使用 Pro 角色绑定的模型
• 未配置 Pro 时回退到 General
• 任务进度同步到「任务监控」页面
• 适合文件整理、代码编写、数据处理

如果 General 角色都未配置模型，智能助手会返回配置引导提示，不会触发模型调用。

附件功能

你可以在对话中附带文件，让 AI 基于文件内容进行分析和处理。

附件限制

• 单次最多 12 个附件
• 单文件大小上限 100KB
• 仅支持文本文件（代码、配置、日志等）
• 文件必须在授权目录范围内

异常处理

• 二进制文件 → 提示"无法作为文本读取"
• 路径未授权 → 提示"路径未授权，已跳过"
• 文件过大 → 提示"文件过大，已跳过"
• 无法读取 → 提示"无法读取"

附带报错日志或代码文件提问，AI 能更准确地理解上下文并给出针对性建议。

快捷操作

首次打开对话（或消息数 ≤ 1 时），界面会显示常用任务的快捷按钮，点击即可快速开始：

整理文件夹

帮我整理下载文件夹，按文件类型归类到子目录

生成会议纪要

帮我把这次会议的要点整理成会议纪要

数据分析报告

分析上个月的销售数据，生成趋势分析报告

批量处理邮件

帮我处理收件箱中未读邮件，分类整理并草拟回复

内容改写分发

把这篇文章改写成适合公众号和小红书的版本

处理报销单

提取这些发票照片中的信息，生成标准报销表格

快捷操作只是预设的提示词，你可以在发送前修改内容。

文件管理

文件管理模块让你控制 AI 可以访问哪些目录，同时提供完整的文件操作功能。

授权目录

AI 只能在你授权的目录范围内进行文件操作。你可以添加多个授权目录。

• 点击「授权目录」按钮，通过系统文件选择器添加目录
• 首次使用时，如果没有授权任何目录，系统会建议使用文档、桌面或下载目录
• 取消授权不会删除文件，只是撤销 AI 的访问权限
• 授权信息保存在 ~/.hajimi/settings/file_roots.toml

浏览方式

列表视图（默认）

显示文件名、大小和修改时间，适合查看详细信息。

网格视图

以卡片形式展示文件，显示文件名和修改时间，适合快速浏览。

支持按文件名搜索过滤，在文件列表上方的搜索框中输入关键词即可。

文件操作详解

操作	说明
浏览目录	点击文件夹进入，通过面包屑导航返回上级目录
创建文件夹	在当前目录下创建新文件夹，输入名称确认
创建文件	在当前目录下创建新文件（默认名：新建文件.txt）
导入文件	通过系统文件选择器选取文件，复制到当前目录
重命名	修改文件或文件夹的名称
删除	永久删除文件或文件夹（需确认，不可撤销）
预览	查看文本文件内容（2MB 以内），在弹窗中显示

文件安全规则

Hajimi Work 对文件操作有严格的安全限制，保护你的数据安全：

路径限制

• 所有操作必须在授权目录范围内
• 超出范围的请求会被拒绝
• 不能删除或重命名授权根目录本身

命名规则

• 名称不能为空
• 不能包含 / 或 \（防止路径穿越）
• 不能是 . 或 ..
• 最长 128 个字符

预览限制

• 仅支持文本文件
• 文件大小上限 2MB
• 二进制文件无法预览

附件限制

• 最多 12 个附件
• 单文件上限 100KB
• 仅读取授权目录内的文本文件

任务监控

在代理模式下，每次对话都会创建一个任务。任务监控页面让你实时查看所有任务的执行状态。

任务状态

进行中

任务正在执行，可以查看实时进度

排队中

任务已创建，等待执行

已暂停

任务被暂停，可以恢复

已完成

任务成功完成

失败

任务执行失败，可查看错误信息

任务详情

• 进度条：显示任务完成百分比（0-100%）
• 步骤列表：最多显示 8 个步骤，标记已完成、进行中和待执行
• 更新时间：显示任务最后更新时间
• 会话详情：点击可查看关联的完整对话内容

筛选和刷新

• 顶部标签页可按状态筛选：全部 / 进行中 / 排队中 / 已暂停 / 已完成 / 失败
• 页面每 10 秒自动刷新一次
• 也可以点击刷新按钮手动刷新
• 顶部显示各状态的任务数量统计

历史会话

所有对话都会自动保存，你可以在历史会话页面回顾和管理。

搜索和筛选

• 按关键词搜索会话标题和项目路径
• 按状态筛选：全部 / 已完成 / 进行中 / 异常
• 初始加载 120 条，可点击"加载更多"

会话操作

• 查看详情 — 滑出面板显示完整对话内容
• 继续对话 — 跳转到智能助手页面继续
• 删除会话 — 永久删除（需确认）

会话信息

• 会话标题（或截断的 ID）
• 状态标记（已完成 / 进行中 / 异常）
• 关联的项目路径
• 消息数量和步骤数
• 创建和更新时间

会话数据存储在 ~/.hajimi/sessions/，与 Hajimi Code（CLI）共享。CLI 中的对话也会出现在这里。

插件中心

插件中心提供丰富的扩展插件，为 AI 助手增加专业能力。

插件名称	分类	功能
邮件助手	办公	智能邮件处理与回复
文档处理器	办公	文档格式转换与编辑
数据分析引擎	数据	数据分析与可视化
表格处理器	数据	Excel/CSV 智能处理
OCR 文字识别	工具	图片文字提取
网页信息采集	工具	网页内容抓取与整理
日程管理	办公	日程安排与提醒
翻译助手	工具	多语言翻译
演示文稿生成	办公	PPT 自动生成
图片处理器	工具	图片编辑与优化
CRM 集成	企业	客户关系管理集成
合同审查	行业	合同条款智能审查

使用方式

• 通过分类标签页浏览不同类型的插件
• 使用搜索框按名称、描述或作者搜索
• 点击「安装」按钮一键安装插件
• 已安装的插件可以随时卸载

插件生态正在持续丰富中。安装信息保存在 ~/.hajimi/settings/plugins.toml。

设置中心

设置中心包含五个部分：API 供应商、模型配置、通用配置、数据信息和关于。

API 供应商

添加和管理 API 供应商，配置密钥和模型列表。

模型配置

为 General / Fast / Pro 三个角色绑定模型。

通用配置

审批模式、日志、Token 限制等全局参数。

数据信息

查看数据目录、会话数量、记忆数量等统计。

关于

版本号、技术栈、平台信息。

供应商配置

在设置中心的「API 供应商」部分，你可以添加多个 API 供应商：

添加供应商

1. 点击「添加供应商」按钮
2. 填写供应商名称（如 "OpenAI"、"Anthropic"）
3. 选择协议类型（OpenAI / Anthropic / Gemini / OpenAI Response）
4. 输入 API Key
5. 输入 Base URL（如 https://api.openai.com）
6. 添加可用的模型 ID，多个用逗号分隔（如 gpt-4o, gpt-4o-mini）

验证规则

• 名称、API Key、Base URL 不能为空
• Base URL 必须以 http:// 或 https:// 开头
• 至少需要添加一个模型 ID

配置保存在 ~/.hajimi/settings/providers.toml，与 CLI 共享。

模型角色绑定

Hajimi 使用三个角色来区分不同场景下使用的模型：

General（主力模型）

必须配置

通用模型，用于日常编码和对话。其他角色未配置时会回退到此模型。

Fast（快速模型）

可选

用于对话模式、快速规划和上下文压缩等轻量任务。未配置时回退到 General。

Pro（强力模型）

可选

用于代理模式、复杂规划等高难度任务。未配置时回退到 General。

在设置中心的「模型配置」部分，通过下拉菜单为每个角色选择供应商和模型。配置保存在 ~/.hajimi/settings/active.toml。

通用配置

在设置中心的「通用配置」部分，你可以调整以下参数：

配置项	可选值	默认	说明
审批模式	`default / auto_edit / yolo`	`default`	控制 AI 执行操作时是否需要确认
日志级别	`error / warn / info / debug / trace`	`info`	日志输出详细程度
最大步数	`数字`	`300`	代理模式下最大执行步数
日志保留天数	`数字`	`7`	日志文件保留时间
最大上下文 Token	`数字（0 = 200000）`	`0`	上下文窗口大小限制
最大输出 Token	`数字`	`8000`	单次最大输出 Token 数
自定义提示词文件	`文件路径`	`—`	自定义系统提示词文件
最大并发子代理数	`数字`	`—`	同时运行的子代理数量上限

配置保存在 ~/.hajimi/config.toml，与 CLI 共享。

支持的协议

Hajimi Work 支持以下 AI 模型协议，你可以根据使用的模型选择对应协议：

OpenAI

兼容所有 OpenAI 格式的 API（如 GPT-4o、GPT-4 等），通过 chat/completions 接口调用。

OpenAI Response

OpenAI 的 Responses API 格式，通过 /responses 接口调用。

Anthropic

支持 Claude 系列模型，通过 /v1/messages 接口调用。

Gemini

支持 Google Gemini 系列模型，通过 generateContent 接口调用。

如果你使用的是 OpenAI 兼容的第三方 API（如 DeepSeek、Moonshot 等），选择 OpenAI 协议即可。

快捷键

场景	快捷键	操作
对话输入框	`Enter`	发送消息
对话输入框	`Shift + Enter`	换行
文件操作弹窗	`Enter`	确认操作
文件操作弹窗	`Escape`	取消操作
会话详情面板	`Escape`	关闭面板

使用技巧

善用代理模式

需要 AI 帮你修改文件、整理代码时，使用代理模式。AI 会自动创建任务，你可以在任务监控中实时查看进度。

合理设置授权目录

只授权 AI 需要访问的目录，避免范围过大。这样既保障安全，也能让 AI 更精准地定位文件。

利用附件功能

在提问时附带相关文件，AI 能更准确地理解上下文。比如附带报错日志让 AI 帮你排查问题。

CLI + Work 协作

两端共享配置和会话数据。你可以在 CLI 中快速执行任务，然后在 Work 桌面端查看历史记录和管理文件。

选择合适的模型

为 Pro 角色绑定强力模型（如 GPT-4o、Claude 3.5 Sonnet），为 Fast 角色绑定快速模型（如 GPT-4o-mini），平衡效果和速度。

利用快捷操作

首次对话时的快捷按钮可以帮你快速开始常见任务，节省输入时间。你也可以在发送前修改预设内容。

定期查看任务监控

代理模式的任务可能需要一些时间执行，通过任务监控可以实时了解进度，及时发现问题。

管理历史会话

定期清理不需要的历史会话，保持列表整洁。重要的对话可以通过「继续对话」功能随时恢复。

已知限制

• 输入长度：单次输入最多 20,000 字符。
• 附件数量：最多 12 个附件，仅支持文本文件，单文件上限 100KB。
• 文件预览：仅支持 2MB 以内的文本文件，二进制文件无法预览。
• 文件名长度：最长 128 个字符，不能包含路径分隔符。
• 模型依赖：至少需要为 General 角色配置模型，否则智能助手无法使用。
• 插件功能：插件中心当前处于早期阶段，主要提供安装状态管理。
• 桌面端运行：完整功能需在桌面端运行，浏览器预览模式下文件操作和 AI 对话功能受限。
• Web 预览：在浏览器中打开时，大部分 Tauri 命令会提示"该功能仅在桌面端可用"。

常见问题

智能助手提示"未配置模型"

进入「设置」→「模型配置」，至少为 General 角色绑定一个模型。如果还没有添加供应商，需要先在「API 供应商」中添加。

输入内容过长被拒绝

单次输入限制为 20,000 字符。如果内容过长，建议拆分为多次发送，或将长文本保存为文件后通过附件上传。

附件提示"路径未授权"

附件文件必须在授权目录范围内。进入「文件管理」添加包含该文件的目录为授权目录。

附件提示"文件过大"

单个附件文件上限 100KB。如果文件较大，可以只截取关键部分保存为新文件后上传。

文件预览显示"二进制文件"

预览功能仅支持文本文件。图片、PDF、压缩包等二进制文件无法直接预览。

任务一直显示"进行中"

检查网络连接和 API 配置是否正确。如果 API 调用超时，任务可能会停滞。可以尝试新建对话重试。

历史会话加载失败

确认 ~/.hajimi/sessions/ 目录存在且有读取权限。如果某个会话数据损坏，可以删除对应的会话目录。

供应商配置保存失败

检查所有必填字段是否已填写：名称、API Key、Base URL 不能为空，Base URL 必须以 http:// 或 https:// 开头，至少需要一个模型 ID。

浏览器中功能受限

Hajimi Work 的完整功能需要在桌面端运行。在浏览器中打开时，文件操作和 AI 对话等核心功能会受限，显示"该功能仅在 Tauri 桌面端可用"。

CLI 的配置在 Work 中没有生效

两端共享 ~/.hajimi 目录。如果修改了配置文件，可能需要重启 Work 应用才能生效。