Fayelin12/dsh-office

🏢 dsh-office

一眼看穿你的每个 Agent 在忙什么。 The agent-office dashboard for DeepSeek Harness (DSH): workspaces, sessions, token usage, subagents, Agent Mail, Feishu/Lark messages, meeting schedules & transcripts, visualized as a living 6-column sprite office — every agent, at a glance.

Aha moment: open the panel and the whole agent fleet is one screen — who’s working, who’s waiting for you, how many tokens each session burned, what tools they just called — plus your Feishu messages & upcoming meetings, without opening a single session.

📧 内置 Agent 邮箱 / 💬 飞书消息流 / 📅 会议日程 + 妙记逐字稿 / 🪵 办公室日志， 全部在面板内完成，不离开办公室。

DeepSeek Harness「办公室」插件：工作区 / 会话 / token 用量 / 子代理一屏总览， 内置 Agent 邮箱收发、飞书消息、会议日程与妙记逐字稿，每个 agent 在忙什么，一眼就知道。

What is dsh-office? / 这是什么

dsh-office is a floating office panel for DeepSeek Harness. It turns your workspaces, sessions, token usage, subagents, Agent Mail, Feishu/Lark messages and meetings into a 6-column sprite office, so you can see what every agent is doing at a glance — without opening each session.

dsh-office 是 DeepSeek Harness 的一个悬浮「办公室」面板，把工作区、会话、 token 用量、子代理、Agent 邮箱、飞书消息、会议日程变成一屏 6 列精灵办公室， 一眼看清每个 agent 在忙什么，不用逐个点开会话。

• Workspace / 工作区：6 列布局，一眼总览。
• Session / 会话：活跃 / 待确认 / 已完成状态，彩色边框区分。
• Token / token 用量：单次输入 vs 累计，活跃会话实时、历史会话冷读。
• Subagent / 子代理：自动过滤子代理会话，父会话聚合显示「有子代理在跑」。
• Mail / 邮箱：内置 Agent 邮箱页签，收件箱 / 已发送 / 读信 / 写信 / 回复，不离开面板。
• Feishu / 飞书：本机飞书消息流会话卡片（群聊/私聊），一屏查看 + 同步。
• Meetings / 会议：日程卡片 + 倒计时提醒 + 妙记/纪要 + 逐字稿一键保存。

Features / 特性

• 📧 Agent 邮箱页签 / Agent Mail tab（收件箱 / 已发送 / 读信 / 写信 / 回复，基于 agently-cli，不离开面板）
• 💬 飞书消息流 / Feishu messages（本机消息库会话卡片流：群聊/私聊、新增徽标、最近 3 条预览、消息弹窗、同步/定时增量/提到我悬浮提示）
• 📅 会议日程视图 + ⏰ 悬浮提醒 / Meetings & reminders（与飞书消息共用 lark-cli 授权，提前 1 小时提醒、每 5 分钟刷新倒计时，已开完会议自动关联妙记/纪要）
• 📄 妙记逐字稿 + 一键保存 / Transcripts（自动拉取已结束会议逐字稿到本地缓存，卡片提醒「逐字稿已生成」，点【保存】移动到目标目录）
• 🪵 办公室日志 / Office logs（帮助弹窗内 tab：实时查看加载 / 调用 / 同步等全部动作，排查问题）
• 🏢 6-column sprite office / 6 列精灵办公室
• 🔵 悬浮入口 + 一键开关 / floating FAB + toggle
• 🧠 MBTI 角色 + 个性化气泡 / MBTI characters + idle bubble texts
• 🔢 token 单次 vs 累计口径 / per-input vs cumulative token
• 🤖 子代理识别与过滤 / subagent detection & filtering

Install / 安装

从 npm 安装 / Install from npm

dsh plugin --profile web add dsh-office

本地开发安装 / Local (file:) install

pnpm add dsh-office@file:<path/to/dsh-office>
# 然后在 profile 的 bundles 里加 "dsh-office"

即：在 ~/.dsh/profiles/web/package.json 的 dsh.profile.bundles 数组中加入 "dsh-office"，然后重启 dsh web。

数据目录：~/.dsh/office/（office-config.json、token-usage.json）。

Usage / 使用

1. 右下角点 🏢 办公室 FAB。
2. 打开 6 列面板，看到工作区 / 会话 / token / 子代理。
3. 点会话卡片跳转；面板随侧边栏切换自动收起。

Agent Mail 邮箱功能 / Mail tab

The 📧 mail tab lets you read & send emails from your Agent Mail (腾讯 Agent 邮箱) address right inside the office panel. Each user has their own mailbox; credentials are stored in the local keychain by the CLI, so multiple people on the same machine don’t clash.

邮箱页签需要先安装并授权 Agent Mail CLI（每人一个独立邮箱，凭据由 CLI 存在本机 keychain，互不冲突）：

# 1. 安装 CLI（全局安装）
npm install -g @tencent-qqmail/agently-cli

# 2. OAuth 授权（浏览器完成）
agently-cli auth login

• 未安装 / 未授权时，面板的 📧 邮箱页签会显示安装引导卡片（含步骤与可复制的提示语），不影响办公室其它功能。
• 也可以让 Agent 代为安装配置，直接把下面这句发给 Agent：

  请阅读 https://agent.qq.com/doc/cli-setup.md 文档，按照步骤为我安装并配置 Agent Mail CLI。

• 完整安装文档：https://agent.qq.com/doc/cli-setup.md

💬 飞书消息流 / Feishu messages

飞书消息视图把本机消息库（如飞书群聊/私聊消息）汇总到办公室面板一屏查看， 由 feishu-config.json 的 scripts.sync（采集入库）与 scripts.latest（读取）两个本地脚本驱动：

• 插件不直接调用飞书 API、不上传任何数据——只执行你配置的本地脚本并解析其 stdout JSON；
• 面板以会话卡片流展示：会话名 + 群/私聊标签 + 新增徽标（+N）+ 最近 3 条预览 + 最后活跃时间， 点卡片打开消息弹窗，点消息行展开完整正文；
• 同步：手动点「同步」深捞最近 30 天（manualWindowDays 可调），或开启 autoSync 定时增量同步 （整点对齐，无后台守护进程）；
• 「提到我」悬浮提示：定时同步后若新消息提到 mention 关键词，办公室按钮旁闪过 📢 提示。

未配置 feishu-config.json 时，💬 飞书视图显示引导卡（含步骤、配置模板、在线指南链接），不影响其它功能。 完整「飞书消息 + 会议日程 从 0 到 1」配置指南见面板内 📖 指南链接。

📅 会议日程 + ⏰ 提醒 / Meetings & reminders

会议功能与飞书消息共用同一套 lark-cli 授权：在 feishu-config.json 的 scripts 里加一个 calendar 脚本（拉取日程的 Node 脚本，输出 { ok, events }），消息同步完成时会顺带拉取日程， 缓存到 ~/.dsh/office/calendar-cache.json。

// ~/.dsh/office/feishu-config.json
{
  "scripts": {
    "sync": "<ingestor.js 绝对路径>",
    "latest": "<latest.js 绝对路径>",
    "calendar": "<calendar.js 绝对路径>",      // ← 可选：会议日程脚本
    "transcript": "<transcript.js 绝对路径>",   // ← 可选：妙记逐字稿脚本
    "permission": "<permission.js 绝对路径>"    // ← 可选：妙记权限申请脚本
  }
}

• 面板 📅 会议视图：按日期分组的日程卡片（左时间轴 + 中标题/组织者 + 右倒计时）， 即将开始橙色描边、进行中绿色描边、已结束灰色淡化；过去 3 天前的组默认折叠。
• ⏰ 悬浮提醒按钮：办公室按钮旁，会议开始前 1 小时出现，每 5 分钟轮询刷新倒计时， 点击直接打开面板会议视图。
• 📝 妙记/纪要：已开完的会议自动尝试关联 AI 智能纪要 / 妙记（需授权 vc:meeting.meetingevent:read + vc:record:readonly，lark-cli auth login --scope "vc:meeting.meetingevent:read vc:record:readonly"）， 有产物时卡片显示可点击的「📝 纪要 / 妙记」入口。
• 📄 逐字稿 + 一键保存：配置 scripts.transcript（仓库 scripts/transcript.js 开箱示例，依赖 minutes:minutes.basic:read 授权）后，日历同步时对比新旧日程，只对「新出现的妙记」自动生成逐字稿 （历史会议可点【转逐字稿】手动转换），暂存到 ~/.dsh/office/transcripts/；会议卡片显示「✅ 逐字稿已生成」， 点【保存】输入目标目录即可把逐字稿移动到该目录（记忆上次保存目录；拉取失败 30 分钟后自动重试， 卡片可手动重试）。
• 🔑 妙记权限申请：配置 scripts.permission（仓库 scripts/permission.js，依赖 minutes:permission:apply 授权）后，无妙记查看权限的会议卡片显示【申请权限】按钮，一键向妙记 owner 发起查看申请。

未配置 scripts.calendar 时，会议视图显示引导卡，不影响其它功能；未配置 scripts.transcript 时，逐字稿功能不显示。

Why dsh-office? / 解决什么问题

• Before / 之前：工作区多、会话散、token 不可见、子代理混在主列表里。
• After / 之后：一屏总览所有 agent 状态与资源占用。

FAQ / 常见问题

Q: 它和 dsh-polling 有什么区别？ A: dsh-polling 管定时任务；dsh-office 管可视化总览。两者可共存。

Q: token 的「单次输入」和「累计」是什么口径？ A: 单次输入 = 最近一次请求的输入 token；累计 = 该会话历史输入 + 输出 + 缓存读写之和。活跃会话显示单次，空闲会话显示累计。

Q: 子代理会话为什么看不到？ A: 子代理会话默认从列表 / 徽标 / 悬浮里过滤（避免噪声），但 token 仍计入父会话。

Q: 飞书消息 / 会议数据是怎么来的？会不会上传？ A: 插件不直接调用飞书 API。你在 feishu-config.json 里配置本地脚本（采集/读取），插件执行脚本并解析 stdout JSON——数据只在本机流转，不上传任何服务器。

Q: 怎么排查插件问题？ A: 帮助弹窗 → 「办公室日志」tab，实时查看加载 / 调用 / 同步等全部动作（/office-ui/logs）。

Q: 会议逐字稿保存在哪？ A: 拉取后暂存 ~/.dsh/office/transcripts/；点卡片【保存】可输入目标目录移动过去（记忆上次目录）。

Ecosystem / 生态

• DeepSeek Harness — the harness this plugin runs on
• dsh-plugin topic — more DSH plugins
• awesome-deepseek-harness — curated DSH ecosystem

License

MIT