能交给它做什么
Hiworks 是 Gabia 推出的企业邮件、审批和考勤服务。Claude Code 是 Anthropic 的 AI 工具，在终端（通过输入命令操作电脑的窗口）里用对话吩咐它干活；插件则是给它添加新功能的扩展包。装上 hiworks 插件后，Claude Code 会直接调用 Hiworks 网页在后台使用的通道，不打开浏览器就把结果取回来。
能做的事见下表。查询会立即执行，会影响他人的操作则先显示预览。
| 要做的事 | 这样吩咐 | 执行方式 |
|---|---|---|
| 查找和阅读邮件 | 在收件箱里找含“报价”的邮件 | 立即查询 |
| 发送邮件 | 把这个文件发给某某 / 回复这封邮件 | 先预览，确认后发送；回复和转发会引用原文 |
| 删除邮件 | 删掉这封邮件 | 先预览，确认后移入废纸篓 |
| 我的剩余休假 | 我还剩几天年假 | 立即查询 |
| 同事的休假日期 | 这个月我们组谁什么时候休假 | 立即查询，连续的日子合并为一段 |
| 申请和取消休假 | 帮我申请 12 月 21 日的年假 | Hiworks 预检查后预览，确认后提交；自动加上已保存的审批线 |
| 日程 | 明天有什么安排 / 周五三点约个会 | 查询立即执行，新增日程先预览 |
| 电子审批文件和状态 | 显示审批中的文件 | 立即查询，每份文件附 Hiworks 页面链接 |
| 组织架构和找人 | 告诉我某某组长的联系方式 | 立即查询，只显示本人公开的联系方式 |
| 早间汇总 | 帮我汇总今天 | 一次看完未读邮件、待审批文件、今天的日程和今天休假的组员 |
安装两行，注册只需一次密码窗口
首先需要 uv。uv 是一个会自动下载 Python 程序及其所需组件并运行的工具。在 Mac 上用下面第一行安装，然后在终端用两行命令装上插件。
重新打开 Claude Code，输入 /hiworks:setup 并在后面加上自己的 Hiworks 邮箱，屏幕上会弹出“Hiworks”密码窗口，在里面输入密码就完成了。如果已经注册过，则不弹窗口直接完成。
输入窗口只显示圆点。如果键盘处于韩文输入状态，密码会以韩文输入，而且很难察觉。我自己的第一次尝试就是这样被拒绝的，所以现在窗口会提示“请确认是英文输入状态”。
如果有常用的审批线，说一次就行。比如说“我的休假审批线是金某审批、李某抄送”，它会保存下来，之后的休假申请和取消都会自动加上。
curl -LsSf https://astral.sh/uv/install.sh | sh
claude plugin marketplace add hjsh200219/hiworks
claude plugin install hiworks@hiworks/hiworks:setup 账号@公司域名密码既不留在聊天里，也不留在文件里
把公司账号密码交给 AI 工具，是大家最犹豫的地方，所以我先定了保存方式。密码只放进操作系统的钥匙串。钥匙串是操作系统加密保管密码的保险箱，比如 Mac 的“钥匙串访问”、Windows 的“凭据管理器”。只有邮箱地址和登录状态（会话）保存在电脑上一个只有本人能读的隐藏文件夹里。
输入途径只有三种：在终端里是不显示字符的输入，在 Claude Code 里是操作系统密码窗口，自动化时是标准输入。它不通过聊天框接收密码，我也故意没做在命令后面直接带上密码的方式，因为写在命令后面的值会原样出现在正在运行的程序列表里。
注册时会先试登录一次，只有密码正确才保存。失败也不会重试，因为错误密码累积多了账号会被锁定。
开发中卡住的三个地方
第一，保存的登录总是失效。Hiworks 由多台服务器分担工作，各个服务会另外发一个写着“这个用户在几号服务器”的 Cookie（浏览器按网站记住的小标签）。一开始我只保存了登录 Cookie，下一次运行一旦被分到别的服务器，好好的登录就被当成不存在。现在，确认登录有效的那次运行结束时会把这些标签全部保存下来。
第二，休假预检查不会拦截超过剩余年假的申请。我的账号只剩 9 天，可填入 20 个工作日，Hiworks 的预检查仍然显示“可以申请”。所以预览里会另外比较工作日数和剩余天数并给出警告。与已休日期重叠的申请，预检查则能正确拦下。
第三，就是前面说的韩文输入问题。自动测试全部通过，可真人第一次使用就卡住了。自动测试无法重现人的键盘状态。
发送和删除都要再确认一次
发送和删除邮件、申请和取消休假、添加和删除日程都遵循同一条规则：先预览收件人、标题、正文，或日期、剩余天数、审批线，用户确认后才真正执行。删除邮件默认是移入废纸篓，彻底删除需要另外明确指示。发送失败也不会重发，因为如果服务器已经收到后才断开，同一封邮件就会发出两封。
验证也尽量不影响别人。邮件只发到我自己的 Hiworks 地址和我自己的 Gmail，确认附件、回复和转发都正常送达，Hiworks 那边的测试邮件随后删除。日程是在我的个人日历里建了一个测试日程再删掉。休假申请和取消只跑到预检查和预览，没有真正提交。自动测试共 68 项。
其他员工的信息只取我的账号在 Hiworks 页面上能看到的范围。手机号、邮箱和入职日期，只有对方设为公开时才会出现在结果里。
还没验证的部分
Windows 只有密码窗口的代码，还没在真正的 Windows 电脑上运行过。开启两步验证（登录时再输入一次六位验证码）的账号也有代码，但没有用真实账号确认。
电子审批只做到查看文件和状态。批准或驳回要通过结果里的链接打开 Hiworks 页面亲自操作。它不知道公休日，所以中间隔着公休日的休假会显示成两段。
这个插件不是 Hiworks 的官方功能。它调用的是 Hiworks 网页使用的通道，Hiworks 改版后可能就无法使用。使用中遇到问题，可以在代码仓库留言。