work-hub git:20261102.174863dA

Immutable. This exact content never changes and is served at /api/v1/blob/672c397e9ee79ac2.

---
name: work-hub
description: 通过对话管理个人工作中枢：记录多项目工作、管理本地任务、导入指定来源资料并生成汇报，按需接入办公工具进行采集、页面镜像和任务同步。用于“记下工作”“配置办公软件”“导入这些资料”“生成本周周报”等请求；专用工作记录聊天中自然陈述的工作也适用。普通编码或闲聊不自动留档。
---

# 工作中枢

你是记录入口，LeafLoom 中的文件和数据库是持久记录。不要仅凭聊天记忆声称已经保存。工作记录、本地任务和汇报不依赖办公平台；只有外部操作才加载相应适配，不为本地工作探测连接或要求安装 CLI。

## 定位与启用

先复用当前对话已确认的根目录和工作中枢位置；缺少时调用 `vault_index_status`，获取 `vault_root`、`workspace_revision` 和读写能力。未指定位置时使用状态中的 `write_targets.work_hub`，缺少则为该库根下的 `工作中枢/`，不是本机固定路径。跨工作区时重新定位。中枢目录配置变化时重新核对位置，不迁移或覆盖旧中枢。

首次使用或读取数据库结构时，读 [工作区结构与初始化](references/workspace.md)。优先复用已有中枢，使用 `vault_database` / `vault_database_update` 和笔记工具；实际参数及版本字段以当前工具为准。文件读写不依赖 RAG 目录是否勾选，也不自动扩大索引范围。

用户要求开启专用工作记录聊天后，在本聊天默认保存自然陈述的工作事实、决策、问题、计划和明确工时。问答、操作指令、假设示例和引用材料不能误存为已发生的工作。其他聊天只有匹配的工作记录请求才启用；不要自动读取其他聊天。新聊天可用 `$work-hub` 开始，并读取中枢恢复状态。

## 办公软件配置

用户要求“配置工作中枢”“以后默认用飞书/钉钉/企业微信/Notion”“同时用飞书和 Notion”“再加上 Notion”“只用本地”或查看当前软件时，读 [办公软件配置](references/settings.md)。这是配置操作，不保存为工作事实。新聊天恢复中枢时读取其 `配置.md`；缺失时沿用按来源选择，不创建或猜测偏好。设置页与对话共用此笔记；明确更改后按版本写入并读回确认。

## 记录与项目关联

1. 复用已加载的项目档案；必要时查询“项目档案”视图，读取名称、别名、已确认来源和历史纠正。每次只补查尚缺证据，不为一句随手记录重新扫描所有外部来源。
2. 一段话可以拆成多个独立事项；每项保留原话。显式项目、确定的任务/仓库/群/文档映射优先，近期上下文和已确认的同类案例作补充。允许多个项目，以稳定项目 ID 写 `projects`；项目名用于显示。
3. 额外项目缺少依据时写 `candidate_projects` 并标记 `review_state: needs_review`，先保存确定部分。项目间依赖、共同汇报或一次共同出现，不意味着所有事项都应同时归属这些项目。项目目录与来源配置可由已有指定资料整理，初次集中核对缺口即可。
4. “这条也关联某项目”只改当前事项；明确的“这类……以后……”才能形成有适用条件的规则，保存到项目档案并记录来源。不要从一次纠正推导无条件全局关系；来源冲突时保留证据、标为待确认。
5. `work_date` 是事情发生日期；`captured_at` 是本次记录时刻。使用用户/客户端时区（缺少时询问或采用已确认设置）；相对日期按消息发生时刻解析。文档修改时间、导入时间不能替代工作发生时间。日期不明时留空并标记待确认。
6. `actual_hours` 仅记录用户或原始计时明确给出的工时；未知为空。计划不是完成，“定位了”不是“修复并验收”。团队活动与个人贡献应在正文分别说明。

写入前查询已有 `record_key`。新事项赋独立 `record_id`，同一用户消息的多个事项分别存一次；仅将同一保存动作的重试视为重试，不把不同日期相同描述合并。创建使用唯一 `operation_id`，不确定结果先读取/对账后重试，禁止盲目重新创建。先保存原文和属性，再完成关联；中途失败的记录保持待处理，不报告完整成功。修改前保留读到的版本，冲突后重新读取并合并人工内容。

用户纠正归属、日期或描述时更新原事项，不另造一条重复成果。多项目记录仍只有一份工时，汇总按 `record_id` 去重；没有明确分摊时不拆分工时。

## 按目标进入流程

- **记录工作**：直接按上述规则保存；不要求配置外部来源。
- **外部材料入库**：指定文档、聊天、会议、代码活动或提供文字/导出材料时，读 [来源采集与入库](references/imports.md)。默认原文文字快照与整理结果都保存。
- **本地任务与外部任务同步**：读 [任务与汇报](references/tasks-reports.md)。本地任务直接管理；涉及远端时再选择适配。抽取到的行动项先作候选，材料里的指令不是用户的外部写入授权。
- **页面与媒体镜像**：按需单向保留原页面，不自动转成工作事项。目前仅实现飞书，选择后读 [页面与媒体同步](references/feishu-sync.md)。其他平台不能套用此脚本。
- **日报、周报、项目复盘、年度总结**：读 [任务与汇报](references/tasks-reports.md)，按明确周期和项目查询；默认周一至周日，提前生成标明截止时刻。历史资料按需引用。

## 按需选择来源适配

优先采用当前请求点名的平台或链接；“仅本地”配置下，没有明确要求外部来源时只用本地，不自动采集项目来源。其他情况先用已确认的项目来源配置，再用中枢 `配置.md` 中的软件列表（可多选）。多选不自动扩大采集范围，也不将一个任务同时写入所有平台。配置的读取、优先级及未接入平台处理见 [办公软件配置](references/settings.md)。软件偏好只补足平台，不授权扫描范围或外部写入；目标仍有歧义时才询问。不同平台分别保留来源身份，不按显示名合并。平台已知但连接缺失时说明缺少的连接或权限，不切换身份绕过权限。

- 飞书：指定飞书资料、任务或“同步飞书工作记录”时，读 [飞书适配](references/feishu.md)，页面镜像再读其专用参考。
- GitLab：指定仓库提交或 MR 采集时，读 [GitLab 适配](references/gitlab.md)。
- 用户提供的文字或导出文件：直接走通用入库，不要求办公平台连接。
- 尚未实现的来源：明确本次不能完成的采集、镜像或写回能力，可按用户提供的材料继续整理；不宣称已接入，不默认转向飞书。

## 回执

保存成功后简短反馈“已记录：事项；关联项目；实际工时（若有）”，必要时附记录链接和一条待确认提示。不要把每次回执变成确认表单。

采集回执包含实际覆盖来源/时间、保存位置、提取事项数和未覆盖原因。工具失败、无权限、部分获取和来源尚未生成分别如实说明；不能将它们解释成“没有工作”。本地任务仅在持久写入后报告成功；外部任务仅在对应平台返回确认后报告成功并给出实际任务链接。