meeting-suite

会议套件：会议纪要 × 任务日历

两个配合使用的 DeepSeek Harness 插件，外加一个让 AI 在会议场景里自动选对工具的配套 Skill。

一句话：装「会议套件」→ 开会/贴纪要 → 对 AI 说“整理一下，待办加到日历” → AI 调工具完成，并在写日历前等你确认。

---

目录

• 功能总览
• 安装
  • 首选：一次装两个
  • 通过插件市场安装
  • 单独安装其中一个
  • 本地开发安装
• 5 分钟上手
• 配套 AI Skill（重点）
• 工具参考
• 会议自动入库
• 数据、隐私与权限
• 架构说明
• 配置
• 常见问题
• 开发与测试
• 发布流程（维护者）
• 仓库结构
• 版本记录
• 许可

---

功能总览

会议纪要

任务日历

---

安装

首选：一次装两个

在 Harness 左侧 Plugins → Add plugin 里输入：

@zhangguitao666/meeting-suite

确认安装后按提示刷新页面（⌘R）。你会同时得到：

• 侧栏「会议纪要」面板
• 侧栏「任务日历」面板
• 配套 AI Skill meeting-minutes-workflow
• 会议纪要→任务日历的待办写入能力

也可以对 Agent 说：

用 plugin_manager 安装 @zhangguitao666/meeting-suite

安装器会自动把两个插件作为依赖装好，并把它们插入当前 profile 的插件列表。

通过插件市场安装

1. 打开 Plugins → Discover。

   • 看不到 Discover 时，先在 Experimental plugins 里开启 Custom plugin markets。

2. 点 Add index source，填入：

   https://raw.githubusercontent.com/zhangguitao666/meeting-suite/main/market/index.json
   

   国内网络访问 raw 不稳定时可用：

   https://cdn.jsdelivr.net/gh/zhangguitao666/meeting-suite@main/market/index.json
   

3. 在列表里安装 会议套件（一键装两个）；也可以单独安装「会议纪要」「任务日历」。

4. 刷新页面（⌘R）。

市场条目使用 npm 源（name@version），安装时从 npm registry 拉取。

单独安装其中一个

在 Plugins → Add plugin 输入：

dsh-plugin-meeting-minutes@1.1.0

或：

dsh-plugin-task-calendar@1.0.0

只装会议纪要时，待办写入日历的能力会不可用（插件会明确提示）；需要两个一起用时请装套件。

本地开发安装

开发时可以把工作区目录链接进 profile，改代码后通过停用/启用 bundle 重新加载宿主模块：

# 在 Harness 的插件页操作，或让 Agent：
plugin_manager install_bundle /绝对路径/dsh-plugin-meeting-minutes
plugin_manager install_bundle /绝对路径/dsh-plugin-task-calendar

浏览器端插件需要刷新页面（⌘R）才会加载新面板。宿主代码改动后停用再启用对应 bundle 即可重新加载；已安装的 npm 版本不会热替换 JS 模块，升级后需要重启应用。

---

5 分钟上手

场景 A：把一段会议文本变成纪要和待办

1. 把会议纪要/聊天记录贴给 AI。

2. 说：

   帮我整理这场会议，待办加到日历。

3. AI 会：

   • meeting_create 存原文（不会把总结当原文）；
   • meeting_summarize 生成结构化纪要；
   • 把待办列给你确认；
   • 你确认后 meeting_push_todos 写入任务日历。

4. 去「任务日历」就能看到任务和提醒；打开「会议纪要」可以导出 HTML。

场景 B：录音转纪要

1. 打开「会议纪要」面板 → 录音（或把录音文件路径给 AI）。

2. 录音结束后 AI 可以自动总结，也可以说：

   把这段录音转成纪要。

3. 会议纪要在后台转写，完成后生成纪要；待办确认流程同上。

场景 C：只想加一条待办

直接说：

把“周五前给客户发报价单”加到日历，负责人张三。

AI 用 calendar_add_tasks 建任务；这条不依赖会议纪要。

场景 D：会议结束自动入库

1. 在「会议纪要」面板打开「自动入库」。
2. 插件会监控本机腾讯会议录制目录；也可以在设置里加额外目录。
3. 会议结束后新录制会自动转写并生成一条待整理会议，等你之后打开整理。
4. 对 AI 说“看看自动入库状态”会调 meeting_auto_ingest action=status。

---

配套 AI Skill（重点）

为什么需要 Skill

插件注册了工具，但 AI 不一定知道什么时候该用、按什么顺序用、哪些步骤必须等用户确认。Skill 解决三件事：

1. 发现：用户贴会议文本、给录音、说“加待办”时，AI 能从技能目录匹配到 meeting-minutes-workflow 并加载。
2. 流程：先存原文 → 再总结 → 展示待办 → 确认 → 写日历；避免顺序错误。
3. 护栏：明确“绝不自动写入日历”“相对时间必须换算”“不要直接改 JSON”等规则。

它会自动出现在技能目录里

会议纪要插件启用后，宿主会通过 ctx.skills.register(...) 注册一个 runtime skill：

注册是插件生命周期的一部分：停用/卸载会议纪要插件，skill 自动从目录移除；重新启用会重新出现。

触发例子

• “这是今天的会议记录：…… 帮我整理，待办加到日历。”
• “把这个录音转成纪要。”
• “查一下上周产品会说了什么，把没完成的待办加到日历。”
• “会议结束自动入库开了吗？”
• “导出这场会议的 HTML 纪要。”

只是随口说“今天开了个会”而没有纪要/待办需求时，AI 不会强行整理。

Skill 里的硬规则

• 待办必须经用户确认才写日历；AI 先展示编号清单，问“哪些写入”。
• 相对时间（“下周三前”“月底”）必须换算成具体日期；不确定就反问。
• 先存原文再总结；不要把 AI 总结当 transcript。
• 不要用文件读写直接改 ~/.dsh/storages/*.json。
• 没装插件时不要假装有工具，提示安装套件。

怎么确认 Skill 生效

• 新开会话时，技能目录会多出 meeting-minutes-workflow。
• 直接对 AI 说“加载 meeting-minutes-workflow”，它会用 skill 工具读取并复述工作流。
• 如果没出现：确认会议纪要插件是启用状态，然后停用/启用一次插件或刷新页面。

---

工具参考

会议纪要工具

任务日历工具

---

会议自动入库

它监控什么

• 腾讯会议本机录制：读取腾讯会议客户端的本地录制数据库，发现已完成的本地录制后自动导入。
• 额外目录：通过 meeting_auto_ingest action=set_dirs 添加；支持 audio/video/txt/md/docx 文件。
• 云端“智能纪要”没有个人 API；自动入库抓的是本机文件。没有本地录制时，把导出的纪要文件放进监控目录即可。

状态与开关

让 AI 说：

看看会议自动入库状态。

会返回：是否启用、腾讯录制数据库是否可用、监控目录、已自动导入数量、扫描状态等。

常用操作：

meeting_auto_ingest action=enable
meeting_auto_ingest action=disable
meeting_auto_ingest action=scan
meeting_auto_ingest action=set_dirs dirs=["~/Downloads/meetings"]

自动导入后的状态

自动导入的会议带“自动入库/待整理”标记，不会自己总结；等你打开面板或让 AI 整理时再生成纪要。这样可以解决“会议很急、整理很慢”的时差。

---

数据、隐私与权限

数据位置

隐私

• 录音转写默认走本机 SenseVoice，音频不离开电脑（具体取决于 Harness 的 speech-to-text 配置）。
• AI 总结走当前默认模型；纪要文本会发给该模型。
• 自动入库只读本机文件；不会上传腾讯会议云端数据。
• 两个插件都不主动联网，除了调用 Harness 的 LLM/ASR 服务和任务日历的 loopback 接口。

权限

• 插件通过 plugin_manager 安装，运行在 Harness 宿主里。
• 任务日历接口监听 loopback（127.0.0.1），只接受本机请求。
• 删除任务不可撤销；AI 的 skill 要求删除前确认。

---

架构说明

会议纪要

lib/index.js        宿主入口：组装 store/asr/summarizer/calendar/autoIngest，
                    注册 HTTP 路由、工具和配套 Skill
lib/server.js       /dsh-meeting/* JSON API（面板使用）
lib/store.js        会议纪要持久化（JSON）
lib/asr.js          speechToText 适配（SenseVoice）
lib/audio.js        WAV 规范化/转码
lib/summarize.js    LLM 总结，标题优化
lib/calendar.js     调用任务日历 loopback API
lib/autoingest.js   腾讯录制数据库 + 监控目录
lib/tools.js        8 个 meeting_* 工具
lib/skill.js        配套 Skill 注册与内容
lib/client.js       浏览器端面板（录音、列表、纪要、待办、导出、自动入库）

浏览器端通过 dsh.client 声明被 Harness 的 client module system 发现，不需要额外 loader 行。宿主通过 ctx.webServer 提供 /dsh-meeting 路由。

依赖的宿主服务：tools、webServer；可选：speechToText、llm、skills。

任务日历

lib/index.js        宿主入口
lib/server.js       /dsh-task-calendar/* JSON API
lib/store.js        任务持久化（JSON）
lib/model.js        日期/提醒/状态模型
lib/tools.js        5 个 calendar_* 工具
lib/client.js       月历 + 甘特图面板

两个插件如何配合

会议纪要插件不直接读日历的 JSON，而是调用任务日历的 loopback HTTP 接口：

POST http://127.0.0.1:<port>/dsh-task-calendar/tasks

这样两个插件可以独立安装/升级；未安装任务日历时，会议纪要会明确提示而不是静默失败。

---

配置

会议纪要

• 标题：新建时可用默认/临时标题；总结时自动优化通用标题。
• 音频：wav/mp3/m4a/mp4/aac 等；非 16kHz 单声道 WAV 会先规范化。
• 语言：meeting_transcribe 的 language 默认 zh。
• 自动入库：见上一节。

任务日历

• 提醒默认：到期前 3/1 天、2 小时，开始前 30 分钟，逾期每天 9 点（以插件内为准）。
• 状态：todo/doing/done；优先级：high/normal/low。
• 时间支持自然语言（“明天 09:30”“下周三”），由工具解析成具体日期。

---

常见问题

安装后侧栏没有面板？

• 浏览器端插件需要刷新页面（⌘R）。
• 确认插件在 Plugins → Installed 里是启用状态。
• 检查 profile 是否同时装了独立插件和套件，导致重复/冲突。

输入 @zhangguitao666/meeting-suite 提示找不到？

• 确认网络能访问 npm registry。
• 确认 Harness 版本 ≥ 0.2.1-rc.2。
• 也可以改用插件市场索引安装。

录音转写失败？

• 确认 Harness 的 speech-to-text 服务可用（默认本地 SenseVoice）。
• 音频格式不支持时先转成 16kHz 单声道 WAV。
• 长音频会自动切片；失败时看插件日志里的具体错误。

待办没有写进日历？

• 先确认任务日历插件已安装并启用。
• AI 必须先让你确认待办；确认后再调 meeting_push_todos。
• 重复推送不会重复创建已写入的待办。

自动入库没反应？

• 腾讯会议必须开启了“本地录制”，且录制文件已完成。
• 用 meeting_auto_ingest action=status 看 tencentAvailable 和监控目录。
• 没有本地录制时，把导出的纪要文件放进监控目录，再 action=scan。

能离线用吗？

转写可以（本地 SenseVoice）；AI 总结需要模型服务。

---

开发与测试

使用 Harness 自带的 Node 24：

NODE="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/primary-runtime/dependencies/node/bin/node"

cd dsh-plugin-task-calendar
"$NODE" --test "test/*.test.mjs"

cd ../dsh-plugin-meeting-minutes
"$NODE" --test "test/*.test.mjs"

修改宿主代码后，在插件页停用/启用对应 bundle 重新加载；浏览器端改动刷新页面。lib/skill.js 的测试覆盖 skill 元数据和注册/注销。

---

发布流程（维护者）

1. 修改代码，按需提升版本：
   • dsh-plugin-meeting-minutes/package.json
   • meeting-suite/package.json（依赖版本也要同步）
2. 发布 npm（需要 npm 账号 2FA）：

   cd dsh-plugin-meeting-minutes && npm publish --access public
   cd ../dsh-plugin-task-calendar && npm publish --access public
   cd ../meeting-suite && npm publish --access public
   

3. 重新生成市场索引：

   node scripts/build-market-index.mjs \
     --repo https://github.com/zhangguitao666/meeting-suite
   

4. 提交并推送 market/index.json。
5. 在 Harness 的 Discover 里刷新，或卸载重装升级。

npm 发布若遇到网页 2FA 授权，按终端提示在浏览器确认即可；0.0.0-stage 是 staged publishing 占位版本，latest 仍是正式版本。

---

仓库结构

dsh-plugin-meeting-minutes/
  lib/index.js          宿主入口（工具/路由/自动入库/配套 Skill）
  lib/skill.js          配套 AI Skill 内容与注册
  lib/server.js         /dsh-meeting API
  lib/client.js         会议纪要面板
  lib/asr.js            语音转写适配
  lib/summarize.js      LLM 总结
  lib/autoingest.js     会议自动入库
  lib/tools.js          meeting_* 工具
  test/                 node --test 用例（含 skill 测试）

dsh-plugin-task-calendar/
  lib/index.js          宿主入口
  lib/client.js         月历 + 甘特图
  lib/tools.js          calendar_* 工具
  test/

meeting-suite/
  package.json          伞包：依赖两个插件并插入两行
  cordis.patch.yml      插件行插入
  index.js              无行插件占位入口
  locale/ icon.svg

market/index.json       插件市场格式 1 索引（npm 源）
scripts/build-market-index.mjs

---

版本记录

1.1.0

• 会议纪要插件新增配套 Skill meeting-minutes-workflow，安装即注册。
• Skill 覆盖：会议文本/录音/已有会议/待办确认/日历/导出/自动入库的完整路由与护栏。
• 套件伞包同步升级，依赖 dsh-plugin-meeting-minutes@1.1.0。

1.0.0

• 首次发布：会议纪要 + 任务日历 + 套件伞包。
• 实时录音转写、腾讯会议纪要导入、AI 纪要、待办写日历、自动入库。
• 插件市场索引（npm 源）。

---

许可

MIT © zhangguitao666