@builderx/teampulse
TeamPulse — 团队记忆插件。把会议纪要、文档、聊天记录收进本地库，按需带引用召回，换 AI 也不丢。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:BuilderX-Club/teampulse#d4bb225ec3e9ff35e9c82429cb18c95599ce5b8dTeampulse 以 @builderx/teampulse 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
装一个插件，让你的团队记忆留在自己手里。
TeamPulse 是一个 DeepSeek Harness（DSH）插件。它做一件很窄但很硬的事：
把团队的会议纪要、技术文档、群聊记录收进本地数据库，需要时按关键词召回，每条结果都带可回溯的引用。
【d783055c2438f#0】产品评审会 2026-10-14（meeting · 2026-10-14T14:00:00+08:00）
决议：十一月底前完成用户系统重构，由张三负责。
待办：张三 输出用户系统重构方案，截止 2026-10-20
会议纪要这件事，已经不缺工具了：
它们都能把一场会总结得很好。但它们都缺三样东西：
| 缺什么 | 后果 |
|---|---|
| 跨源 | 会议定了什么、文档里写了什么、群里又改了什么，没人拼在一起 |
| 引用 | AI 给的结论无从核对，团队不敢真用 |
| 归属 | 数据在平台里，换个 AI 就没了 |
TeamPulse 只补这三样。不重复做大厂已经做好的事。
插件里没有一行 prompt。
决议、待办、摘要这些结构化提取，交给 DSH 里的模型自己做——它比任何内嵌模板都强，而且换模型不用改代码。
插件只负责模型做不到的事：落库、索引、给出可引用的原文。
DSH 版本迭代快。插件一旦 import @deepseek-ai/dsh-tools，宿主一升级就可能跑不起来。
所以这个插件：
ctx.tools.register(definition) 这个最稳定的契约一个 SQLite 文件，默认 ~/.dsh/teampulse/team.db。
# 从本地目录安装
dsh plugin --profile default add /path/to/dsh-teampulse
# 之后正常启动
dsh web --profile default
或者用 patch 覆盖层临时加载（开发时方便）：
# cordis.yml
- insert:
- id: teampulse
name: '/absolute/path/to/dsh-teampulse/index.js'
config:
dbPath: '~/.dsh/teampulse/team.db'
可选配置项：
config:
dbPath: '~/.dsh/teampulse/team.db' # 库文件位置
chunkSize: 900 # 单片段字符数
chunkOverlap: 120 # 相邻片段重叠
maxHits: 12 # 单次检索默认返回条数
maxChunkChars: 4000 # 单片段硬上限
team_remember — 入库把这段产品评审会的纪要存起来，标题「产品评审会 2026-10-14」，
时间是 2026-10-14T14:00:00+08:00，标签 产品、权限
| 参数 | 必填 | 说明 |
|---|---|---|
content | 二选一 | 正文全文。会议纪要直接贴，不要先摘要 |
filePath | 二选一 | 从本地文件读取正文 |
title | ✅ | 标题 |
source | meeting / doc / chat / note / text | |
sourceRef | 会议号、文档 URL、群名，便于回溯原处 | |
author | 作者/记录人 | |
occurredAt | ISO 8601，用于时间过滤 | |
tags | 标签数组 |
返回 docId（d + 内容哈希前 12 位）和片段数。
同一正文重复入库会自动去重，返回已有 docId——这样周报里不会出现三遍同一个决定。
team_recall — 检索之前谁提过用户权限的方案？
| 参数 | 必填 | 说明 |
|---|---|---|
query | ✅ | 关键词或短句。中文建议 2~8 字 |
limit | 返回条数，默认 12，上限 50 | |
source | 只看某类来源 | |
since / until | 时间范围过滤 |
每条结果都带 citation: "d783055c2438f#0" —— 指向库中具体片段。
team_docs — 看看有什么我的团队记忆里都存了什么？
列出已入库的文档（按入库时间倒序），带 docId、来源、时间、片段数。 回答「存过哪些会议」这类问题时用它，比空转检索更直接。
team_forget — 删除把 d783055c2438f 这份删掉
| 参数 | 说明 |
|---|---|
docId | 删单份。不传则清空全部 |
confirm | 清空全部时必须传 true |
这是「数据在你手里」的兑现——不是你信我，是你随时能删。
清空全部需要显式确认，防止模型自作主张把记忆清空。
你：把这段会议纪要存起来，标题「产品评审会 10/14」，来源 meeting
Agent：[调 team_remember] 已入库：产品评审会 10/14 ...
你：这周定了什么？谁欠什么活？
Agent：[调 team_recall 查"决议""待办"]
基于检索结果整理：
- 用户系统重构 11 月底前完成（【d783...#0】）
- 张三欠一份重构方案，10/20 到期（【d783...#0】）
关键是那些方括号引用——每条结论都能点回原文。
你：用户权限这事到底怎么定的？
Agent：[多次 team_recall]
会议里说参考 RBAC（【d783...#0】）
文档里定的是 RBAC + ABAC 混合（【a1b2...#1】）
结论：会议提的方向，文档细化为混合模型
这是大厂工具做不到的——它们只看得见自己生态里的数据。
SQLite FTS5 + trigram 分词。
这是关键：默认的 unicode61 分词器切不了中文（会把整句当一个词）。trigram 按三字符窗口建索引，中文能正常匹配。
代价是 trigram 要求查询词 ≥ 3 字符。所以 team_recall 对 1~2 字的短查询自动降级为 LIKE 扫描。
按字符数切，但在窗口后 40% 范围内优先找自然断点：
\n\n > \n > 。！？； > . ! ? ;
中文没有空格，纯按长度切会把句子拦腰截断，检索出来的片段读着别扭。
相邻片段保留 120 字重叠，避免关键信息正好落在切口上。
docId#seq
docId = d + 正文 SHA-256 前 12 位 —— 内容相同则 ID 相同，天然幂等seq = 片段在该文档内的序号这个 ID 是稳定的：同样的内容，无论在谁的机器上入库，ID 都一样。
# 纯逻辑测试（不依赖 DSH，直接跑）
node test/smoke.mjs
# 集成测试（真实 Cordis + 真实 tools 注册表加载插件）
# E2E（真实 dsh CLI 装进临时 profile → 配置合成 → 真实 dispatch → 查盘）
DSH_REPO=/path/to/deepseek-harness node test/integration.mjs
DSH_REPO=/path/to/deepseek-harness node test/e2e.mjs
DSH_REPO 指向你的 deepseek-harness 源码 checkout（需要已 pnpm install 并 build 过）。没设置时这两个测试会直接退出并提示。
当前状态：
| 测试 | 数量 | 结果 | 内容 |
|---|---|---|---|
| smoke | 27 | ✅ | 切分、FTS、去重、过滤，自带桩 |
| integration | 52 | ✅ | 真实 Cordis 加载 + 四工具全链路 |
| e2e | 14 | ✅ | CLI 安装 + dispatch 管道 + 落盘 |
明确写下来，免得越做越散：
@tencent-adm/tencent-meeting-mcp，插件不重复造v0.1（当前）
team_remember / team_recall / team_docs / team_forgetv0.2
team_recall 支持按 docId 精确取全文v0.3
MIT