AI 智能体基础与 WorkBuddy 实践 · D1 上午

这是我的三份旧资料（在「旧文件」文件夹里，一份 Word、一份 PDF、一份 Excel），
现在要填一份新的《学员信息登记表》（在「待填模板」文件夹里）。
动手前先说明你的计划：要读哪些文件、大概怎么填，我确认后再开始。
把能找到的信息填进新模板对应字段，生成已填好的 Word 放到本目录；
旧文件里没有的信息一律标【待填】，不要编造；
如果不同文件里的同一信息不一致，指出来让我确认。

请逐字段列出每个已填信息分别来自哪份旧文件；
对标了【待填】的字段和你发现的不一致之处，
单独列一张清单给我确认。

你是一名严格的财务审核专员（角色）。
今天要处理部门本月的差旅与招待报销，
审核依据是 02_参考资料 里的差旅报销制度（背景）。
请读取 01_输入/报销单据 文件夹里的全部单据，对照制度逐单核验（任务）。
只依据制度条款判断，制度没写的不要自行发挥；
拿不准的单据归入「需人工复核」，不要直接判退回（约束）。
按「合规通过／需人工复核／退回」三类，输出两个文件到 03_输出：
一份审核报告 Word，写清每张单据的结论与原因；
一份 Excel 统计表，逐单列出单号、申请人、类别、金额、结论、原因，
并在表尾按三类汇总单数、金额小计与总计（格式）。
输出后自查：有没有漏掉的单据，Excel 的金额加总是否与单据一致（自检）。

请换成一名挑剔的审计师视角，复查你刚才的审核报告：
挑出 3 个最可能出错的判断（漏判、误判、依据不足），逐条说明理由，
然后修订报告并告诉我你改了什么。

请使用 web-research（网络调研）这个 Skill，帮我调研
「＿＿＿＿」（例如：2026 年上半年中国新能源汽车市场的最新动态与竞争格局；
也可以换成你自己所在的行业）。
要求：
1. 先给出调研计划（准备拆成哪几个子问题、各查什么方向），我确认后再开始；
2. 控制规模：最多 3 个子问题，每个子问题 2—3 个可靠来源，不做长时间深度研究；
3. 调研过程文件（research_plan、各路 findings）保留在本目录，随时可检查；
4. 最后综合成一份带小标题的行业简报：重要数字注明来源和日期，
   查不到的信息标【待确认】，文末附引用来源清单，导出 Word 到 03_输出。

你是我的装机助手（角色）。我要在这台电脑上安装 miniconda
（注意是 miniconda，不要装成完整的 anaconda），
作为以后文档处理和数据分析的 Python 基础环境（背景）。
请全自动完成安装（任务），按下面步骤：
1. 先侦察环境：我是 macOS 还是 Windows、什么芯片架构，
   是否已装过 miniconda 或 anaconda——装过就直接告诉我，不要重复安装；
2. 判断网络是否在中国大陆：在的话优先用清华镜像下载；
   用官方源就监控下载速度，明显过慢自动换到清华镜像。
   优先使用下面已核实的地址，按侦察到的系统和芯片选对应文件：
   · 官方目录 https://repo.anaconda.com/miniconda/
   · 清华镜像 https://mirrors.tuna.tsinghua.edu.cn/anaconda/miniconda/
   · 备用镜像 https://mirrors.bfsu.edu.cn/anaconda/miniconda/
   文件名：Mac（Apple 芯片）Miniconda3-latest-MacOSX-arm64.sh；
   Mac（Intel）Miniconda3-latest-MacOSX-x86_64.sh；
   Windows Miniconda3-latest-Windows-x86_64.exe；
3. 下载完成后自动静默安装，再自动初始化 conda，
   设置成以后每次打开终端（Terminal ／ PowerShell）都默认启用 base 环境；
4. 自我验证：新开一个终端，确认提示符自动出现 (base)，
   并成功运行 conda --version 和 python --version；
5. 验证不通过就自己诊断原因、修复，再重新验证——直到全部通过为止。
约束：只装 miniconda 本体，不要装别的；
删除或覆盖任何已有环境前必须先问我；需要管理员权限时提醒我（约束）。
全部通过后，把版本号、安装路径和过程中修过的问题汇总报告给我（自检）。

# 任务：全自动安装 Hermes Agent 官方桌面版（中国大陆网络适配）

## 0. 授权声明与行为准则（先读这节）

我已为你开启「允许完全访问」权限。我明确授权你：安装软件、创建目录、
修改 PATH 和 shell 配置文件、设置环境变量、下载文件、直接运行和测试命令。
本任务的目的就是改变这台电脑的环境——不要因为"尽量不改动用户环境"的
默认习惯而畏手畏脚，该装就装、该改就改，边做边验证。

只有四类动作需要先停下来问我：
① 删除或覆盖已存在的旧安装、旧配置、用户文件；
② 需要系统管理员密码或弹窗授权；
③ 需要我提供 DeepSeek API Key；
④ 涉及我的飞书账号（扫码、创建应用、填 App 凭证）。
除这四类外，一律自动执行，不要频繁请示。

全程用中文汇报。每完成一个阶段，用一两句话说明：做了什么、结果如何、
下一步是什么。把整个任务整理成清单逐项推进，不要跳步。

⚠️ 关于我：我完全不懂命令行，从来没有打开过终端（Terminal）或
PowerShell，也不认识任何技术术语。因此凡是需要我亲手操作的环节
（授权弹窗、亲手运行命令、飞书后台设置），你必须给出"手把手"级别
的指引，一步一图景：
- 要我打开终端：macOS 上写清"按 Command+空格 调出搜索框 → 输入
  '终端'或'Terminal' → 按回车"；Windows 上写清"点击屏幕左下角
  开始按钮 → 直接输入 PowerShell → 点击打开的蓝色图标"；
- 要我输入命令：把命令单独放一行让我整行复制，告诉我"粘贴进去
  （macOS 按 Command+V，PowerShell 里右键即粘贴）后按回车"，并描述
  正常情况下屏幕会出现什么、出现什么字样算成功；
- 要我在网页或 App 里操作：写清点哪个菜单、哪个按钮的确切名称，
  一次只给一两步，等我确认完成再给下一步；
- 系统弹出授权窗口时，提前告诉我窗口长什么样、该点哪个按钮。
不要假设我知道"回车执行""环境变量""管理员权限"是什么意思，用大白话。

⚠️ 交互式命令红线：hermes setup、hermes model、hermes config migrate、
hermes gateway setup 是交互式全屏程序，你在非交互环境里运行会卡死。
凡是能用 hermes config set 或直接编辑配置文件替代的，一律替代；
确实绕不开交互的（如飞书扫码），按上一条的方式手把手带我运行。

## 1. 唯一目标与验收标准

目标：在这台电脑上装好 Nous Research 官方的 Hermes Agent 及其官方桌面版
（Hermes Desktop），并配好 DeepSeek 模型和飞书机器人。

验收标准（三条缺一不可，全部通过才算完成）：
1. hermes version 和 hermes doctor 运行正常；
2. 官方桌面应用能启动，并用 DeepSeek 模型完成一轮对话；
3. 我在飞书里给机器人发消息，能收到回复。

⚠️ 版本红线——严禁装错：中文社区另外做了一个「社区版桌面端」
（下载站 desktop.hermesagent.org.cn，Tauri 技术栈，内核是社区改版的
Hermes-CN-Core），它不是官方产品，禁止安装。我们只借用中文社区的
镜像加速方法；最终装的必须是官方版——桌面应用由 hermes desktop 命令
构建和启动（Electron 技术栈，macOS 包标识 com.nousresearch.hermes），
代码上游是 github.com/NousResearch/hermes-agent。社区文档页顶如有
「桌面版已正式上线，点此下载」横幅，那是社区版入口，忽略它。

## 2. 权威参考文档（遇到本指令没覆盖的问题，先查这里自行解决）

官方文档（英文；中文版把 /docs/ 换成 /docs/zh-Hans/）：
- 安装        https://hermes-agent.nousresearch.com/docs/getting-started/installation/
- 快速上手    https://hermes-agent.nousresearch.com/docs/getting-started/quickstart/
- 平台支持    https://hermes-agent.nousresearch.com/docs/getting-started/platform-support/
- 桌面版      https://hermes-agent.nousresearch.com/docs/user-guide/desktop/
- 飞书接入    https://hermes-agent.nousresearch.com/docs/user-guide/messaging/feishu/

中文社区文档（镜像方案与本地化踩坑）：
- 安装（含镜像脚本） https://hermesagent.org.cn/docs/getting-started/installation
- Windows 安装       https://hermesagent.org.cn/docs/getting-started/windows-installation
- 常见问题 FAQ       https://hermesagent.org.cn/docs/reference/faq
- 飞书接入           https://hermesagent.org.cn/docs/user-guide/messaging/feishu
- 模型配置           https://hermesagent.org.cn/docs/user-guide/configuring-models
- 官方桌面端中文页   https://hermesagent.org.cn/docs/user-guide/desktop

大陆网络安装实录（镜像加速原理，实测可复现）：
- https://mp.weixin.qq.com/s/XxE-ZsAe7VOYGHEIkjv9eQ

如果你支持接入 MCP，可加中文社区文档检索服务（113 篇文档全文可查）：
- MCP 地址 https://mcp.hermesagent.org.cn/v1（Streamable HTTP，无需 Key）
不支持 MCP 就直接抓取上面的网页。

遇到报错的处理顺序：先跑 hermes doctor → 看 ~/.hermes/logs/ 下的相关
日志 → 到上面文档找对应章节 → 用报错原文上网搜索 → 修复后回到中断处
重新验证。同一个问题连试三种办法仍失败，才停下来向我说明情况、已试
方案和你建议的下一步。

## 3. 第一步：侦察环境（只读操作，全部收集完再定方案）

逐项收集并向我汇报：
1. 操作系统与版本、芯片架构：
   macOS 用 uname -m（arm64 = Apple 芯片，x86_64 = Intel）；
   Windows 用 PowerShell 查 $env:PROCESSOR_ARCHITECTURE；
2. 磁盘剩余空间（需 ≥ 5 GB）和内存大小；
3. 已有安装检查：hermes 命令是否存在；~/.hermes/（Windows 为
   %LOCALAPPDATA%\hermes）目录是否存在；git、python3（含版本）、
   node（含版本）、uv 是否已装。若发现装过 Hermes，先停下问我：
   修复升级还是删掉重装；
4. 网络探测（每条限时 10 秒，不要死等）：逐一测试连通性和下载速度，
   例如 curl -o /dev/null -m 10 -s -w "%{http_code} %{speed_download}\n"：
   - github.com
   - hermes-agent.nousresearch.com
   - res1.hermesagent.org.cn
   - registry.npmmirror.com
   - pypi.tuna.tsinghua.edu.cn
   - cnb.cool
5. 代理检测：http_proxy / https_proxy 环境变量是否已设；本机 7890、
   1080 等常见代理端口是否有服务在监听。

平台裁决：
- macOS（Apple 芯片）、Windows 10/11（x64 / arm64）→ 继续；
- macOS（Intel 芯片）→ 官方明确不支持，停止任务，向我说明原因，
  建议换电脑或云端方案（不要转而安装社区版桌面端）；
- 其他系统 → 对照官方平台支持矩阵后再决定。

Windows 额外检查：Windows 用户名 / 安装路径含中文或空格容易出怪问题，
如有，提前提醒我可能的风险。

## 4. 第二步：根据侦察结果选安装路线

- 路线 A（网络畅通或有可用代理）：github.com 能在 10 秒内连通且速度
  可用，或系统已配好代理 → 用官方脚本直装。
- 路线 B（大陆典型网络，默认路线）：GitHub 不通或极慢 → 走
  「社区镜像脚本 + 国内源预置」，见第 5 节。

两条路线共同的铁律：安装脚本必须先下载成本地文件再执行，禁止
curl … | bash 或 irm … | iex 管道直跑——脚本里的交互提问在管道下
会静默失败退出。统一加 --skip-setup --skip-browser --non-interactive
参数（跳过配置向导和浏览器组件，装完再配）。

路线 A 命令（macOS 示例）：
  curl -fsSL https://hermes-agent.nousresearch.com/install.sh \
    -o /tmp/hermes_install.sh
  bash /tmp/hermes_install.sh --skip-setup --skip-browser --non-interactive
Windows 则下载 https://hermes-agent.nousresearch.com/install.ps1 到本地
后运行（参数名先读脚本开头 param 块确认）。

## 5. 第三步（路线 B）：镜像加速安装 CLI 本体

### 5a. macOS 步骤（逐段执行，每段成功再进下一段）

# ① 下载社区镜像版安装脚本到本地
curl -fsSL --connect-timeout 15 --max-time 120 \
  https://res1.hermesagent.org.cn/install.sh -o /tmp/hermes_install.sh

# ② 用清华 PyPI 预装 uv 到 ~/.hermes/bin/（绕开慢速下载源；
#    脚本检测到 uv 已就位就跳过自带的慢速下载）
python3 -m venv /tmp/uv-venv
/tmp/uv-venv/bin/pip install -i https://pypi.tuna.tsinghua.edu.cn/simple uv
mkdir -p ~/.hermes/bin
cp /tmp/uv-venv/bin/uv /tmp/uv-venv/bin/uvx ~/.hermes/bin/
~/.hermes/bin/uv --version

# ③ 用 npmmirror 预装 Python 3.11（同理触发脚本的预置检测）
UV_PYTHON_INSTALL_MIRROR="https://registry.npmmirror.com/-/binary/python-build-standalone" \
  ~/.hermes/bin/uv python install 3.11

# ④ 当前会话预设国内源
export UV_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"
export UV_PYTHON_INSTALL_MIRROR="https://registry.npmmirror.com/-/binary/python-build-standalone"

# ⑤ 运行安装脚本
bash /tmp/hermes_install.sh --skip-setup --skip-browser --non-interactive

# ⑥ 刷新 PATH 并验证
export PATH="$HOME/.local/bin:$PATH"
hermes version && hermes doctor

注：若 python3 不存在（macOS 可能弹出安装"命令行开发者工具"的窗口），
先提醒我点安装，等装完再继续。若 res1 镜像站下载慢（实测可能只有
几十 KB/s），预置 uv 和 Python 的第②③步正是为了绕开它——脚本本体
只有几十 KB，慢也能下完；代码仓库脚本默认从国内 cnb.cool 克隆，不走
GitHub。

### 5b. Windows 原生步骤（PowerShell，普通权限即可）

# ① 允许当前用户运行本地脚本
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

# ② 预防中文乱码
chcp 65001

# ③ 用户级持久化设置国内镜像（当前会话也各 $env: 设一遍）
[Environment]::SetEnvironmentVariable("UV_INDEX_URL","https://pypi.tuna.tsinghua.edu.cn/simple","User")
[Environment]::SetEnvironmentVariable("UV_DEFAULT_INDEX","https://pypi.tuna.tsinghua.edu.cn/simple","User")
[Environment]::SetEnvironmentVariable("UV_PYTHON_INSTALL_MIRROR","https://registry.npmmirror.com/-/binary/python-build-standalone","User")
[Environment]::SetEnvironmentVariable("ELECTRON_MIRROR","https://npmmirror.com/mirrors/electron/","User")
[Environment]::SetEnvironmentVariable("PLAYWRIGHT_DOWNLOAD_HOST","https://npmmirror.com/mirrors/playwright","User")

# ④ 下载镜像版安装脚本到本地
Invoke-WebRequest https://res1.hermesagent.org.cn/install.ps1 `
  -OutFile "$env:TEMP\hermes_install.ps1"
# 备选（res1 太慢时，用加速代理下载官方脚本）：
# Invoke-WebRequest https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 `
#   -OutFile "$env:TEMP\hermes_install.ps1"

# ⑤ 先读脚本开头 param 块确认参数名，找到与 skip-setup / skip-browser /
#   non-interactive 对应的开关后运行；若无对应参数则直接运行，
#   遇交互提问按默认或推荐项选择
& "$env:TEMP\hermes_install.ps1"

# ⑥ 关闭当前 PowerShell，新开一个（刷新 PATH），验证
hermes version; hermes doctor

Windows 备注：安装目录在 %LOCALAPPDATA%\hermes；提示"hermes 不是内部
或外部命令"第一招就是重开 PowerShell；报 Microsoft Visual C++ 14.0
required 就需要装 VC++ Build Tools（先告诉我下载来源并征得同意）。
若原生路径反复失败，备选方案是 WSL2 + Ubuntu 后按 5a 流程装（需要
管理员权限跑 wsl --install，先问我）。

### 5c. 装完 CLI 的通用检查

- hermes doctor 若提示 Config version outdated 需要 migrate：
  hermes config migrate 是交互式命令，按第 0 节的手把手方式带我运行
  （先教我打开终端/PowerShell，再让我整行粘贴命令，告诉我每个提问
  该选什么）；
- 通用镜像速查（后续任何环节遇到对应下载慢/失败时套用）：
  · Python 包     清华 https://pypi.tuna.tsinghua.edu.cn/simple
                  或阿里 https://mirrors.aliyun.com/pypi/simple/
  · npm           https://registry.npmmirror.com
  · Node 二进制   https://registry.npmmirror.com/-/binary/node/
  · Electron      https://npmmirror.com/mirrors/electron/
  · Playwright    https://npmmirror.com/mirrors/playwright
  · GitHub 加速   前缀 https://ghfast.top/https://github.com/…
                  或 gitcode.com 镜像仓库

## 6. 第四步：构建并启动官方桌面版

前置检查：
1. node --version 是否 ≥ v22。镜像版脚本可能跳过了 Node——若缺失或
   过旧，从 npmmirror 装 Node v22：先打开
   https://registry.npmmirror.com/-/binary/node/latest-v22.x/
   查到当前平台的确切文件名（macOS Apple 芯片选 darwin-arm64.tar.gz，
   Windows 选 x64.msi），下载安装（macOS 解压到 ~/.local/node22 并把
   其 bin 目录加入 PATH；Windows 用 msiexec /i 静默安装后重开终端）；
2. npm config set registry https://registry.npmmirror.com
3. macOS 若后续报缺编译工具（g++ / clang），运行 xcode-select --install
   会弹系统窗口，提前告诉我去点确认。

启动构建（首启会 npm install 并构建 Electron 应用，10—20 分钟属于
正常，持续观察日志输出，不要提前放弃）：

  export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"   # Windows 已在 5b 设过
  hermes desktop

若卡在 Electron 下载、日志反复出现 retrying attempt=…：
1. 中断后清损坏缓存：
   macOS   rm -f ~/Library/Caches/electron/electron-*.zip
   Windows 清空 %LOCALAPPDATA%\electron\Cache
2. 确认 ELECTRON_MIRROR 已设置，重跑 hermes desktop；
3. 仍失败，用官方备用命令手动构建：
   cd ~/.hermes/hermes-agent/apps/desktop
   CSC_IDENTITY_AUTO_DISCOVERY=false npm run pack
   （Windows 对应目录 %LOCALAPPDATA%\hermes\hermes-agent\apps\desktop）
4. 排障入口：日志在 ~/.hermes/logs/desktop.log（hermes logs gui -f）；
   删除 .hermes-bootstrap-complete 文件可强制重新初始化。

验收：桌面应用窗口成功打开。首启引导（onboarding）如果要求选模型
提供商，选「稍后配置」，下一步统一配。然后告诉我：可以在 Settings
里把界面语言切成简体中文。

## 7. 第五步：配置 DeepSeek（需要我配合的第一处）

1. 引导我拿 Key：打开 https://platform.deepseek.com → 登录 →
   确认账户有余额（⚠️ 余额为 0 时 API 直接报错，这是"装好了却不回话"
   的最常见原因）→ 创建 API Key（sk- 开头）→ 把 Key 发给你。
2. 拿到 Key 后写配置（不要用交互式向导）：
   hermes config set DEEPSEEK_API_KEY sk-xxxx
   （若该命令不可用，直接把 DEEPSEEK_API_KEY=sk-xxxx 追加到
   ~/.hermes/.env，Windows 为 %LOCALAPPDATA%\hermes\.env）
   然后编辑 ~/.hermes/config.yaml，只改模型相关段落、保留其余内容：
     model:
       provider: deepseek
       name: deepseek-chat
     providers:
       deepseek:
         api_key: ${DEEPSEEK_API_KEY}
   （若文件结构与此不同，以文件现有结构为准，把主模型指到
   deepseek / deepseek-chat 即可；deepseek-chat 上下文 128K，满足
   Hermes 至少 64K 的硬性要求。）
3. 验证：hermes chat -q "只回复OK两个字" 得到正常回复；再让我在桌面
   应用里发一条消息确认。
   报 400 → 检查模型名拼写和账户余额；报 401 → Key 错误或失效；
   报 429 → 限流，稍候重试。

## 8. 第六步：接入飞书（需要我配合的第二处）

首选方案·扫码自动建应用：
记住我从没用过终端——先按第 0 节的方式教我打开一个新的终端窗口
（macOS：Command+空格 → 输入"终端"→ 回车；Windows：开始按钮 →
输入 PowerShell → 打开），然后让我整行粘贴并回车：
  hermes gateway setup
接着逐屏告诉我：现在屏幕上显示什么、用键盘上下键选哪一项、按什么键
确认。选 Feishu / 飞书 → 屏幕出现二维码 → 提醒我拿手机打开飞书 App
右上角"+"里的"扫一扫"扫码授权，Hermes 会自动创建机器人应用、配好
权限、保存凭据（连接方式选 websocket——不需要公网 IP）。每一步等我
说"好了"再讲下一步。

备选方案·手动建应用（扫码流程不可用时；全程按第 0 节方式一次
一两步带我在网页后台点击，别一口气丢一整串步骤）：
1. 指导我在 https://open.feishu.cn 创建「企业自建应用」，把 App ID 和
   App Secret 发给你；
2. 告诉我在后台开启「机器人」能力；权限管理里添加：
   im:message、im:message:send_as_bot、im:resource、im:chat、
   im:chat:readonly（推荐再加 im:message.reactions:readonly、
   contact:user.id:readonly）；
3. 事件与回调：连接方式选「长连接」，订阅事件 im.message.receive_v1；
4. 提醒我到「版本管理与发布」创建版本并发布（企业账号可能需要
   管理员审批，权限发布后才生效——机器人不回话十有八九卡在这步）；
5. 你把配置写入 ~/.hermes/.env：
   FEISHU_APP_ID=cli_xxx
   FEISHU_APP_SECRET=xxx
   FEISHU_DOMAIN=feishu
   FEISHU_CONNECTION_MODE=websocket

启动与验证：
  hermes gateway
我在飞书里私聊机器人发一句话，收到回复即通过。之后建议把
FEISHU_ALLOWED_USERS 设成只允许我自己（问我要不要加白名单）。

常见故障速查：
- 报 lark-oapi / websockets / aiohttp 未安装 → 装进 Hermes 自己的
  venv：macOS 用 ~/.hermes/hermes-agent/venv/bin/pip install lark-oapi
  websockets；Windows 先定位 venv 里的 python.exe 再
  uv pip install lark-oapi --python <该路径>；
- 机器人不回话 → 依次查：应用版本是否已发布、事件订阅是否长连接、
  权限是否齐、hermes gateway status、日志 ~/.hermes/logs/gateway.log；
- Windows 原生网关一启动就退（WinError 11）→ 按中文社区
  windows-installation 页的补丁方法处理，或改走 WSL2；
- 同一个 App ID 同时只能被一个网关实例使用。

## 9. 最终自检与总结汇报

逐项执行，全部通过才算完成；任何一项失败就回到对应章节自行诊断、
修复、再测，循环直到通过：
1. hermes version 输出正常版本号；
2. hermes doctor 无报错项；
3. hermes chat -q 一轮问答正常（DeepSeek）；
4. 桌面应用打开并完成一轮对话；
5. 飞书私聊机器人一问一答正常。

全部通过后，向我提交总结报告：
- 安装的版本号、所走路线（A/B）、用过的镜像源；
- 各路径清单：代码目录、数据目录（~/.hermes/）、桌面应用位置；
- 过程中遇到并修复的问题列表（问题→原因→解法）;
- 日常使用速查：怎么打开桌面版（hermes desktop）、怎么在飞书用、
  怎么更新（hermes update）、出问题先跑什么（hermes doctor）。