@baimingtao/lbs-agent 1.0.0

package/extensions/skills/builtin/dogfood/references/issue-taxonomy.md

@@ -0,0 +1,109 @@
+# Issue 分类标准
+
+使用此分类标准对内部测试 (dogfood QA) 阶段发现的问题进行分类。
+
+## 严重级别
+
+### Critical
+该问题导致核心功能完全无法使用，或导致数据丢失。
+
+**示例：**
+- 应用崩溃或显示白屏
+- 表单提交时静默丢失用户数据
+- 身份验证完全失效（完全无法登录）
+- 支付流程失败，但在未完成订单的情况下扣除了用户费用
+- 安全漏洞（例如 XSS、控制台中暴露的凭证）
+
+### High
+该问题严重损害了功能，但可能存在变通方案。
+
+**示例：**
+- 关键按钮点击无反应（但刷新后可恢复）
+- 对有效的查询条件，搜索未返回任何结果
+- 表单验证拒绝了有效的输入
+- 页面已加载，但缺少关键内容或内容乱码
+- 导航链接指向 404 或错误的页面
+- 核心页面的控制台中出现未捕获的 JavaScript 异常
+
+### Medium
+该问题较为明显并影响用户体验，但不会阻碍核心功能。
+
+**示例：**
+- 屏幕某些区域的布局错位或重叠
+- 图片加载失败（图片破损图标）
+- 性能缓慢（明显的加载延迟 > 3 秒）
+- 表单字段缺少适当的验证反馈（输入错误时无错误提示）
+- 控制台警告，提示功能已弃用或配置错误
+- 相似页面之间的样式不一致
+
+### Low
+不影响功能的轻微优化问题。
+
+**示例：**
+- 文本内容中的拼写或语法错误
+- 轻微的间距或对齐不一致
+- 生产环境中残留的占位文本（"Lorem ipsum"）
+- 缺少 Favicon
+- 控制台中出现了不应存在于生产环境的信息/调试消息
+- 未达到 WCAG 要求的轻微颜色对比度问题
+
+## 类别
+
+### Functional
+功能未按预期工作的问题。
+
+- 按钮/链接无响应
+- 表单未提交或提交不正确
+- 用户流程中断（无法完成多步骤流程）
+- 显示的数据不正确
+- 部分有效的功能
+
+### Visual
+页面视觉呈现方面的问题。
+
+- 布局问题（元素重叠、网格错乱）
+- 图片破损或缺少媒体资源
+- 样式不一致
+- 响应式设计失效
+- Z-index 问题（元素被隐藏在其他元素后面）
+- 文本溢出或截断
+
+### Accessibility
+阻碍或限制残障用户访问的问题。
+
+- 有意义的图片缺少 alt 文本
+- 颜色对比度差（未通过 WCAG AA 标准）
+- 元素无法通过键盘导航访问
+- 缺少表单标签或 ARIA 属性
+- 焦点指示器丢失或不清晰
+- 屏幕阅读器不兼容的内容
+
+### Console
+通过 JavaScript 控制台输出检测到的问题。
+
+- 未捕获的异常和未处理的 Promise rejection
+- 网络请求失败（控制台中的 4xx、5xx 错误）
+- 弃用警告
+- CORS 错误
+- 混合内容警告（HTTPS 页面中包含 HTTP 资源）
+- 开发阶段遗留的过多 console.log 输出
+
+### UX (User Experience)
+功能可用但用户体验较差的问题。
+
+- 令人困惑的导航或信息架构
+- 缺少加载指示器（用户不知道正在处理请求）
+- 用户操作后无反馈（例如，点击按钮后没有可见的结果）
+- 交互模式不一致
+- 缺少针对破坏性操作的确认对话框
+- 错误提示不明确，无法帮助用户恢复操作
+
+### Content
+页面文本、媒体或信息方面的问题。
+
+- 拼写和语法错误
+- 生产环境中存在占位符/虚假内容
+- 过时的信息
+- 内容缺失（空白部分）
+- 指向外部资源的无效或死链
+- 不正确或具有误导性的标签

package/extensions/skills/builtin/dogfood/templates/dogfood-report-template.md

@@ -0,0 +1,86 @@
+# Dogfood QA 报告
+
+**目标：** {target_url}
+**日期：** {date}
+**范围：** {scope_description}
+**测试员：** Hermes Agent（自动化探索性 QA）
+
+---
+
+## 执行摘要
+
+| 严重性 | 数量 |
+| ---------- | ------- |
+| 🔴 严重 | {critical_count} |
+| 🟠 高 | {high_count} |
+| 🟡 中 | {medium_count} |
+| 🔵 低 | {low_count} |
+| **总计** | **{total_count}** |
+
+**总体评估：** {one_sentence_assessment}
+
+---
+
+## 问题
+
+<!-- 针对发现的每个问题重复此部分，按严重性排序（严重优先） -->
+
+### 问题 #{issue_number}：{issue_title}
+
+| 字段 | 值 |
+| ------- | ------- |
+| **严重性** | {severity} |
+| **类别** | {category} |
+| **URL** | {url_where_found} |
+
+**描述：**
+{detailed_description_of_the_issue}
+
+**复现步骤：**
+1. {step_1}
+2. {step_2}
+3. {step_3}
+
+**预期行为：**
+{what_should_happen}
+
+**实际行为：**
+{what_actually_happens}
+
+**截图：**
+MEDIA:{screenshot_path}
+
+**控制台错误**（如适用）：
+```
+{console_error_output}
+```
+
+---
+
+<!-- 单个问题部分结束 -->
+
+## 问题汇总表
+
+| # | 标题 | 严重性 | 类别 | URL |
+| --- | ------- | ---------- | ---------- | ----- |
+| {n} | {title} | {severity} | {category} | {url} |
+
+## 测试覆盖范围
+
+### 已测试页面
+- {list_of_pages_visited}
+
+### 特性 已测试
+- {list_of_features_exercised}
+
+### 未测试 / 超出范围
+- {areas_not_covered_and_why}
+
+### 阻碍项
+- {any_issues_that_prevented_testing_certain_areas}
+
+---
+
+## 说明
+
+{any_additional_observations_or_recommendations}

package/extensions/skills/builtin/email/DESCRIPTION.md

@@ -0,0 +1,3 @@
+---
+description: 用于在终端中发送、接收、搜索和管理电子邮件的 Skills。
+---

package/extensions/skills/builtin/email/himalaya/SKILL.md

@@ -0,0 +1,302 @@
+---
+name: himalaya
+description: "Himalaya CLI：在终端中使用 IMAP/SMTP 收发邮件。"
+version: 1.1.0
+author: community
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [Email, IMAP, SMTP, CLI, Communication]
+    homepage: https://github.com/pimalaya/himalaya
+prerequisites:
+  commands: [himalaya]
+---
+
+# Himalaya Email CLI
+
+Himalaya 是一个 CLI 邮件客户端，允许你在终端中使用 IMAP、SMTP、Notmuch 或 Sendmail 后端管理邮件。
+
+这个 skill 独立于 Hermes Email gateway adapter。gateway adapter 允许人们给 agent 发送电子邮件，并使用 Hermes 内置的 IMAP/SMTP adapter；而这个 skill 允许 agent 通过终端工具操作邮箱，并且需要外部的 `himalaya` CLI。
+
+## 参考资料
+
+- `references/configuration.md`（配置文件设置 + IMAP/SMTP 身份验证）
+- `references/message-composition.md`（用于撰写电子邮件的 MML 语法）
+
+## 前置条件
+
+1. 已安装 Himalaya CLI（使用 `himalaya --version` 进行验证）
+2. 在 `~/.config/himalaya/config.toml` 存在配置文件
+3. 已配置 IMAP/SMTP 凭据（密码已安全存储）
+
+### 安装
+
+```bash
+# 预编译二进制文件（Linux/macOS — 推荐）
+curl -sSL https://raw.githubusercontent.com/pimalaya/himalaya/master/install.sh | PREFIX=~/.local sh
+
+# 通过 Homebrew 安装 (macOS)
+brew install himalaya
+
+# 或通过 cargo 安装（任何支持 Rust 的平台）
+cargo install himalaya --locked
+```
+
+## 配置设置
+
+运行交互式向导来设置账户：
+
+```bash
+himalaya account configure
+```
+
+或者手动创建 `~/.config/himalaya/config.toml`：
+
+```toml
+[accounts.personal]
+email = "you@example.com"
+display-name = "Your Name"
+default = true
+
+backend.type = "imap"
+backend.host = "imap.example.com"
+backend.port = 993
+backend.encryption.type = "tls"
+backend.login = "you@example.com"
+backend.auth.type = "password"
+backend.auth.cmd = "pass show email/imap"  # 或使用 keyring
+
+message.send.backend.type = "smtp"
+message.send.backend.host = "smtp.example.com"
+message.send.backend.port = 587
+message.send.backend.encryption.type = "start-tls"
+message.send.backend.login = "you@example.com"
+message.send.backend.auth.type = "password"
+message.send.backend.auth.cmd = "pass show email/smtp"
+
+# 文件夹别名（himalaya v1.2.0+ 语法）。当服务器文件夹名称
+# 与 himalaya 的标准名称（inbox/sent/drafts/trash）不匹配时
+# 必须使用此项。Gmail 是最常见的情况 — 有关 `[Gmail]/Sent Mail` 
+# 的映射，请参阅 `references/configuration.md`。
+folder.aliases.inbox = "INBOX"
+folder.aliases.sent = "Sent"
+folder.aliases.drafts = "Drafts"
+folder.aliases.trash = "Trash"
+```
+
+> **关于别名语法的提醒。** v1.2.0 之前的文档使用了
+> `[accounts.NAME.folder.alias]` 子节（单数 `alias`）。
+> v1.2.0 会静默忽略这种格式 —— TOML 解析没问题，但
+> 别名解析器永远不会读取它，因此每次查找都会回退到
+> 标准名称。在 Gmail 上，这意味着在 SMTP 投递成功*之后*，
+> 保存到“已发送”会失败，并且 `himalaya message send` 会以
+> 非零状态退出。任何基于该退出代码进行重试的调用者
+> （agent、脚本、用户）都将重新运行整个发送过程
+> —— 包括 SMTP —— 从而导致向收件人发送重复的
+> 邮件。请始终使用 `folder.aliases.X`（复数形式，点分
+> 键，直接位于 `[accounts.NAME]` 之下）。
+
+## Hermes 集成说明
+
+- **阅读、列出、搜索、移动、删除**均直接通过终端工具完成
+- **撰写/回复/转发** —— 建议使用管道输入（`cat << EOF | himalaya template send`）以确保可靠性。交互式 `$EDITOR` 模式可在 `pty=true` + 后台 + 进程工具下运行，但需要了解编辑器及其命令
+- 使用 `--output json` 获取结构化输出，更易于以编程方式解析
+- `himalaya account configure` 向导需要交互式输入 —— 请使用 PTY 模式：`terminal(command="himalaya account configure", pty=true)`
+
+## 常见操作
+
+### 列出文件夹
+
+```bash
+himalaya folder list
+```
+
+### 列出电子邮件
+
+列出 INBOX（默认）中的电子邮件：
+
+```bash
+himalaya envelope list
+```
+
+列出特定文件夹中的电子邮件：
+
+```bash
+himalaya envelope list --folder "Sent"
+```
+
+分页列出：
+
+```bash
+himalaya envelope list --page 1 --page-size 20
+```
+
+### 搜索电子邮件
+
+```bash
+himalaya envelope list from john@example.com subject meeting
+```
+
+### 阅读电子邮件
+
+通过 ID 阅读电子邮件（显示纯文本）：
+
+```bash
+himalaya message read 42
+```
+
+导出原始 MIME：
+
+```bash
+himalaya message export 42 --full
+```
+
+### 回复电子邮件
+
+要在 Hermes 中进行非交互式回复，请阅读原始邮件，撰写回复，然后通过管道传输：
+
+```bash
+# 获取回复模板，编辑它，然后发送
+himalaya template reply 42 | sed 's/^$/\nYour reply text here\n/' | himalaya template send
+```
+
+或者手动构建回复：
+
+```bash
+cat << 'EOF' | himalaya template send
+From: you@example.com
+To: sender@example.com
+Subject: Re: Original Subject
+In-Reply-To: <original-message-id>
+
+Your reply here.
+EOF
+```
+
+全部回复（交互式 —— 需要 $EDITOR，建议改用上述模板方法）：
+
+```bash
+himalaya message reply 42 --all
+```
+
+### 转发电子邮件
+
+```bash
+# 获取转发模板并通过管道传输修改后的内容
+himalaya template forward 42 | sed 's/^To:.*/To: newrecipient@example.com/' | himalaya template send
+```
+
+### 撰写新邮件
+
+**非交互式（从 Hermes 使用此方法）** —— 通过 stdin 管道传输邮件：
+
+```bash
+cat << 'EOF' | himalaya template send
+From: you@example.com
+To: recipient@example.com
+Subject: Test Message
+
+Hello from Himalaya!
+EOF
+```
+
+或者使用 headers 标志：
+
+```bash
+himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"
+```
+
+注意：没有管道输入的 `himalaya message write` 会打开 `$EDITOR`。这可以在 `pty=true` + 后台模式下运行，但管道传输更简单且更可靠。
+
+### 移动/复制电子邮件
+
+移动到文件夹（目标文件夹在前，然后是邮件 ID）：
+
+```bash
+himalaya message move "Archive" 42
+```
+
+复制到文件夹（目标文件夹在前，然后是邮件 ID）：
+
+```bash
+himalaya message copy "Important" 42
+```
+
+### 删除电子邮件
+
+```bash
+himalaya message delete 42
+```
+
+### 管理标志
+
+添加标志：
+
+```bash
+himalaya flag add 42 --flag seen
+```
+
+移除标志：
+
+```bash
+himalaya flag remove 42 --flag seen
+```
+
+## 多账户
+
+列出账户：
+
+```bash
+himalaya account list
+```
+
+使用特定账户：
+
+```bash
+himalaya --account work envelope list
+```
+
+## 附件
+
+从邮件中保存附件：
+
+```bash
+himalaya attachment download 42
+```
+
+保存到特定目录：
+
+```bash
+himalaya attachment download 42 --downloads-dir ~/Downloads
+```
+
+## 输出格式
+
+大多数命令支持使用 `--output` 获取结构化输出：
+
+```bash
+himalaya envelope list --output json
+himalaya envelope list --output plain
+```
+
+## 调试
+
+启用调试日志：
+
+```bash
+RUST_LOG=debug himalaya envelope list
+```
+
+包含 backtrace 的完整追踪：
+
+```bash
+RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list
+```
+
+## 提示
+
+- 使用 `himalaya --help` 或 `himalaya <command> --help` 获取详细用法。
+- 邮件 ID 是相对于当前文件夹的；更改文件夹后请重新列出。
+- 要撰写带有附件的富文本邮件，请使用 MML 语法（见 `references/message-composition.md`）。
+- 使用 `pass`、系统 keyring 或输出密码的命令安全地存储密码。

package/extensions/skills/builtin/email/himalaya/references/configuration.md

@@ -0,0 +1,216 @@
+# Himalaya 配置参考
+
+配置文件位置：`~/.config/himalaya/config.toml`
+
+## 最小化 IMAP + SMTP 配置
+
+```toml
+[accounts.default]
+email = "user@example.com"
+display-name = "Your Name"
+default = true
+
+# 用于读取邮件的 IMAP backend
+backend.type = "imap"
+backend.host = "imap.example.com"
+backend.port = 993
+backend.encryption.type = "tls"
+backend.login = "user@example.com"
+backend.auth.type = "password"
+backend.auth.raw = "your-password"
+
+# 用于发送邮件的 SMTP backend
+message.send.backend.type = "smtp"
+message.send.backend.host = "smtp.example.com"
+message.send.backend.port = 587
+message.send.backend.encryption.type = "start-tls"
+message.send.backend.login = "user@example.com"
+message.send.backend.auth.type = "password"
+message.send.backend.auth.raw = "your-password"
+
+# Folder aliases — 当服务器文件夹名称与 himalaya 的规范名称不同时必填。
+# 参见下文的“Folder Aliases”。
+folder.aliases.inbox = "INBOX"
+folder.aliases.sent = "Sent"
+folder.aliases.drafts = "Drafts"
+folder.aliases.trash = "Trash"
+```
+
+## 密码选项
+
+### 原始密码（仅用于测试，不推荐）
+
+```toml
+backend.auth.raw = "your-password"
+```
+
+### 从命令获取密码（推荐）
+
+```toml
+backend.auth.cmd = "pass show email/imap"
+# backend.auth.cmd = "security find-generic-password -a user@example.com -s imap -w"
+```
+
+### 系统密钥环（需要 keyring 特性）
+
+```toml
+backend.auth.keyring = "imap-example"
+```
+
+然后运行 `himalaya account configure <account>` 来存储密码。
+
+## Gmail 配置
+
+```toml
+[accounts.gmail]
+email = "you@gmail.com"
+display-name = "Your Name"
+default = true
+
+backend.type = "imap"
+backend.host = "imap.gmail.com"
+backend.port = 993
+backend.encryption.type = "tls"
+backend.login = "you@gmail.com"
+backend.auth.type = "password"
+backend.auth.cmd = "pass show google/app-password"
+
+message.send.backend.type = "smtp"
+message.send.backend.host = "smtp.gmail.com"
+message.send.backend.port = 587
+message.send.backend.encryption.type = "start-tls"
+message.send.backend.login = "you@gmail.com"
+message.send.backend.auth.type = "password"
+message.send.backend.auth.cmd = "pass show google/app-password"
+
+# Gmail folder 映射。
+# 如果没有这些配置，在 SMTP 投递成功后，保存到“已发送”的操作会失败
+# （Gmail 的 Sent 文件夹是 `[Gmail]/Sent Mail`，而不是 `Sent`），
+# 并且 `himalaya message send` 会以非零状态退出。
+# 任何针对该错误进行重试的调用者都会重新执行 SMTP —— 导致向收件人
+# 发送重复的邮件。对于 Gmail，务必始终包含此配置块。
+folder.aliases.inbox = "INBOX"
+folder.aliases.sent = "[Gmail]/Sent Mail"
+folder.aliases.drafts = "[Gmail]/Drafts"
+folder.aliases.trash = "[Gmail]/Trash"
+```
+
+**注意：** 如果 Gmail 启用了 2FA，则需要使用 App Password。
+
+## iCloud 配置
+
+```toml
+[accounts.icloud]
+email = "you@icloud.com"
+display-name = "Your Name"
+
+backend.type = "imap"
+backend.host = "imap.mail.me.com"
+backend.port = 993
+backend.encryption.type = "tls"
+backend.login = "you@icloud.com"
+backend.auth.type = "password"
+backend.auth.cmd = "pass show icloud/app-password"
+
+message.send.backend.type = "smtp"
+message.send.backend.host = "smtp.mail.me.com"
+message.send.backend.port = 587
+message.send.backend.encryption.type = "start-tls"
+message.send.backend.login = "you@icloud.com"
+message.send.backend.auth.type = "password"
+message.send.backend.auth.cmd = "pass show icloud/app-password"
+```
+
+**注意：** 请在 appleid.apple.com 生成 app-specific password
+
+## Folder Aliases
+
+将 himalaya 的规范文件夹名称（`inbox`、`sent`、`drafts`、`trash`）映射为服务器实际使用的名称。请使用 v1.2.0 的 `folder.aliases.X` 语法（复数形式，点分隔键名，直接位于 `[accounts.NAME]` 之下）：
+
+```toml
+[accounts.default]
+# ... 其他账户配置 ...
+
+folder.aliases.inbox = "INBOX"
+folder.aliases.sent = "Sent"
+folder.aliases.drafts = "Drafts"
+folder.aliases.trash = "Trash"
+```
+
+v1.2.0 也支持等效的 TOML 子节形式：
+
+```toml
+[accounts.default.folder.aliases]
+inbox = "INBOX"
+sent = "Sent"
+drafts = "Drafts"
+trash = "Trash"
+```
+
+> **不要使用单数形式的 `alias`。** v1.2.0 之前的文档展示了 `[accounts.NAME.folder.alias]`（单数）形式。v1.2.0 会静默忽略该子节 —— TOML 解析时不会报错，但 alias 解析器永远不会读取它。随后每次查找都会直接回退到规范名称。在 Gmail 上（其 `sent` 实际上是 `[Gmail]/Sent Mail`），这意味着在 SMTP 投递成功*之后*，保存到“已发送”的操作会失败，并且 `himalaya message send` 会以非零状态退出。任何针对该错误代码进行重试的调用者（agent、脚本、用户）都会重新执行发送操作 —— 包括 SMTP —— 从而导致向收件人发送重复的邮件。务必始终使用 `folder.aliases.X`（复数形式）。
+
+## 多账户配置
+
+```toml
+[accounts.personal]
+email = "personal@example.com"
+default = true
+# ... backend 配置 ...
+
+[accounts.work]
+email = "work@company.com"
+# ... backend 配置 ...
+```
+
+使用 `--account` 切换账户：
+
+```bash
+himalaya --account work envelope list
+```
+
+## Notmuch Backend（本地邮件）
+
+```toml
+[accounts.local]
+email = "user@example.com"
+
+backend.type = "notmuch"
+backend.db-path = "~/.mail/.notmuch"
+```
+
+## OAuth2 身份验证（适用于支持该方式的提供商）
+
+```toml
+backend.auth.type = "oauth2"
+backend.auth.client-id = "your-client-id"
+backend.auth.client-secret.cmd = "pass show oauth/client-secret"
+backend.auth.access-token.cmd = "pass show oauth/access-token"
+backend.auth.refresh-token.cmd = "pass show oauth/refresh-token"
+backend.auth.auth-url = "https://provider.com/oauth/authorize"
+backend.auth.token-url = "https://provider.com/oauth/token"
+```
+
+## 其他选项
+
+### 签名
+
+```toml
+[accounts.default]
+signature = "Best regards,\nYour Name"
+signature-delim = "-- \n"
+```
+
+### 下载目录
+
+```toml
+[accounts.default]
+downloads-dir = "~/Downloads/himalaya"
+```
+
+### 撰写邮件的编辑器
+
+通过环境变量设置：
+
+```bash
+export EDITOR="vim"
+```