fuli-context 0.12.4 → 0.20.0-beta.0

package/docs/agent-conversations-and-collaboration.md

@@ -10,12 +10,18 @@ Neo4j Provider 的独立日志中；工作记忆继续保存经过整理的决
 | 压缩阈值 | 64 KB | 未折叠的消息原文超过阈值时，较早的消息折叠进摘要；可配 8–1024 |
 | 自动恢复预算 | 4000 UTF-8 字节 | 保守内容上限，不是计费 token；可配 512–16000 |
 | 自动恢复 | 摘要 + 最近消息 | 新 chat 恢复同一 Agent、同一项目的最近上下文 |
-| 摘要内容 | 最近 12 个任务结果 + 最近 40 条请求要点 | 请求要点取每条用户消息的首行 |
+| 摘要内容 | 最近 12 个任务结果 + 规则摘录 | 用户请求首行，以及用户与 Agent 消息中带决定、更正、未完成或方法标记的原句，附来源角色与序号；最多 6000 字节，省略数量可见 |
 | 原始记录保存 | gzip 压缩 | 压缩不删除原文，也不调用模型生成摘要 |
 
 压缩只看对话量，不看时间：闲置多久都不会丢失上下文。每个任务结束时的工作结果写入摘要；
 工具输出不自动注入恢复上下文。折叠后的原文仍在数据库，需要细节时用
 `read_agent_conversation` 分页补读，不生成虚构摘要。当前任务提示及宿主可见消息各有来源记录。
+摘录按固定关键词规则抽取，不理解语义：未带标记的决定会漏掉，带关键词的普通句子可能被误分类；
+它不是经核实的工作记忆，原文始终为准。细则见[项目 Agent 记忆](project-agent-memory.md)。
+自动恢复和 `resume_agent_conversation` 都把最近一次任务结果单独放在 `context.latest_checkpoint`
+（状态 + 结果摘要，从开头保留，超长时标 `truncated`），`context.summary` 标为 `summary_role: historical`，
+只含更早的结果和摘录：旧摘录里的 TODO 不代表当前未完成工作，未完成或中断的检查点也不会因此显示为完成。
+两者合计仍在恢复预算内（按 JSON 编码字节计，含转义）。交接只携带已保存的文本和引用，不转移本地文件、进程或原生工具状态。
 敏感凭据命中检测时整条内容替换为省略标记，因此“原始记录”是已过滤的可见记录。
 
 入口中的偏好保留完整指令，去掉重复证据包装。长期记忆只返回预览；更新前必须
@@ -49,6 +55,23 @@ Neo4j Provider 的独立日志中；工作记忆继续保存经过整理的决
 保留完整指令、画像分类和写作品味域。协作职责同时带上 Agent 自己的判断、品味、个性和期望。
 工作摘要、AR 配置的性格以及自动推断都不能伪装成人工确认的用户偏好。
 
+## 可选执行框架
+
+Agent 有明确计划时，通过 `record_project_agent_task_activity.executionPlan` 上报当前
+步骤快照：`steps` 中每步包含稳定的 `id`、`title`、`status`，可补充 `detail`。
+状态支持 `pending`、`in_progress`、`awaiting_review`、`completed`、`blocked`、`skipped`。
+后续沿用步骤 ID 并上报完整计划；省略字段表示本次没有更新，`steps: []` 明确撤回计划。
+没有计划时不强制生成，也不从模型内部思考推测步骤或百分比。
+
+Agent 主页的当前工作卡及任务执行详情展示最新计划、步骤状态和上报时间。Provider
+成功保存任务活动后，通过 SSE 通知页面读取变化任务；同一空间共用一条连接，不轮询。
+首次连接及重连同步最新记录，任务结束、详情收起或页面隐藏时取消订阅。断线或读取
+失败保留已显示内容并提示更新暂不可用。通知只携带任务 ID，沿用空间读取授权；任务
+内容仍由既有接口读取。当前个人 Provider 以单进程运行，通知暂存于该进程，重启后
+客户端重新同步数据库。保活心跳不读取任务库。调整保存在原有任务事件中，沿用授权、
+版本和幂等检查。
+步骤完成是 Agent 上报的进度，不会自动完成任务，也不替代测试或用户验收。
+
 ## 采集与失败恢复
 
 Codex 和 Claude Code 的 `UserPromptSubmit`、`Stop` 命令适配器读取宿主提供的当前
@@ -88,6 +111,35 @@ JSONL transcript。只支持各适配器明确识别的可见文本、工具调
 
 ## 小组长与借调
 
+组长负责拆分、统筹、集成和交付。`plan_agent_collaboration` 返回 `divisionPlan`，
+复用现有任职与派工，不额外调用模型生成分工：
+
+| 任务 | 默认工作包 | 开始条件 |
+| --- | --- | --- |
+| 小改动、只运行已有命令 | 延续一个工作包 | 当前上下文继续 |
+| 通常的实质性改动 | 主线实施 + 另一位 FLA 独立验收 | 验收等待稳定产物 |
+| 复杂且有明确独立边界 | 主线 + 一个独立工作包 + 独立验收 | 两个执行包可独立推进，验收等待两者产物 |
+
+`taskSize` 默认 `standard`；`small` 只用于低影响小修改，安全敏感或明显改变行为的
+工作仍需独立验收。`complex` 本身不制造第三个工作包，还需提供 `independentWork`
+的任务类型、无写入冲突或未解决依赖的边界及最多 3 条必要查询。强耦合实现保持在一起，
+独立验收可以顺序执行。验收请求不再为自己递归拆出验收者。
+
+调用者传入全部已知 `implementationAgentIds`；验收候选排除这些作者、当前主线负责人
+及本轮分配的执行者。实际作者变化后重新规划。先复用本项目合格人员，再走借调和已有
+AR 招募流程；不会为填满人数而自动创建身份。每个委派工作包返回派工参数、等待条件
+和理由，缺位仍遵守招聘确认政策，借调批准前不执行。
+
+主线复用已有上下文，委派只携带目标、范围、授权产物引用、验收条件与必要查询，
+不复制整段会话。派工从每个查询最多 3 个结果起步，缺什么再补什么。模型继续遵循
+用户策略、执行器锁和真实可用能力，由 Tonborg 在满足质量要求后考虑成本，不写死
+某个厂商或型号。组长将工作包与先后关系上报到已有执行框架，实际 worker、结果和
+Token 用量进入任务活动；未报告的用量保持未知，不用估计值冒充节省。
+
+新默认组长采用统筹职责；已有 Agent 的自定义职责不覆盖。普通任务入口与 MCP 指引
+都会送达同一分工规则，因此既有组长也适用。FULI 控制面提供计划和记录，由宿主实际
+派工，只有真实 worker 记录才表示已经分工执行。
+
 `plan_agent_collaboration` 用职责、能力、任务类型和工作负载推荐成员，优先本项目。
 目标组长通过 `request_agent_loan` 发起借调，来源组长在自己的项目上下文中通过
 `decide_agent_loan` 确认。数据库创建目标项目中的独立任职；任务完成、失败或取消
@@ -96,6 +148,22 @@ JSONL transcript。只支持各适配器明确识别的可见文本、工具调
 借调成功后仍需 `coordinate_project_agent_task` 明确参与者，再由已授权客户端实际
 启动 worker。控制面只提供计划、权限和记录，模型推荐、借调批准都不代表已执行。
 
+项目组长始终是对话负责人，但这不代表适合执行。路由先在固定小组内按能力、任务类型、
+负载、同类任务历史和本项目执行连续性选执行者：组长合适就自己做，否则由最合适的成员执行（`project_team_member`），
+组长写入任务的协调人并接收汇报。小组无人合格时（`project_team_gap`）走现有 AR 招聘，
+遵循“招聘前确认”；合格成员只是当前客户端不可用时任务阻塞，不招聘替代者。
+任务入口仅返回 `execution_reason`/`execution_agent_id` 与操作指引，不创建任务、不招聘、不启动 worker。
+合格成员只是当前客户端不可用（`agent_unavailable`）时，任务仍由配置的组长协调并接收汇报，
+并行计划也不会从小组外补人；显式指定的协调人优先。
+
+`plan_agent_collaboration` 按与 Provider 相同的有效能力匹配专家：任务分配上的能力非空时取代档案能力，
+而不是合并。结果排除当前客户端不可用、分配未激活、来源项目组长本人（组长不可借调）的 Agent，
+只返回公开的角色与分配信息。每个候选附 `nextSteps`：`message_agent` 只是圆桌咨询（只读、advisory），
+跨项目执行需目标组长 `request_agent_loan`、来源组长 `decide_agent_loan` 批准，再用
+`coordinate_project_agent_task` 由授权运行时执行，结果回报组长。没有合格专家时返回 `recruitment`，
+指向现有 `coordinate_project_agent_task`（`staffingIntent: new_durable`）与同一 `idempotencyKey`，
+遵循“招聘前确认”；发现、消息与招聘都不算已执行的工作。
+
 ## 模型和验证
 
 自适应策略按简单、普通、复杂任务映射到 fast、balanced、deep。显式用户策略、

package/docs/agent-interface-architecture.md

@@ -78,6 +78,17 @@ currently project-assigned item globally accessible. Explicit project references
 inheritance and genuine personal-global knowledge keep their existing scope rules; records
 without scope metadata fail closed.
 
+Agent working-memory export (`export_project_agent_memory`, catalog read workflow
+`agent-memory`) returns generated Markdown for one scope from a fresh database read. It reuses
+the `get_project_agent_memory` authority, including host-injected source clients and the strict
+scope validator, takes no output path, writes no export file (existing authorized local
+directory snapshots may refresh), and is not offered to remote connectors. Its MCP result
+budget (512 KiB) holds the largest valid identity plus one memory layer; a result that would
+still be truncated fails explicitly instead of returning a partial file. Memory reads,
+checkpoints and task entry report directory status in the public `directorySnapshot` field;
+the generic MCP omission of internal `snapshot` keys is unchanged.
+The console route `GET /api/project-agents/:agentId/memory/export` uses owner inspection authority.
+
 ## Human-only boundaries
 
 The following operations intentionally remain local-user-only:

package/docs/client-connections.md

@@ -25,18 +25,40 @@ directory, or `--runtime-config FILE` for an explicit runtime configuration.
 `args` for clients with their own configuration editor. Paths with spaces remain
 individual JSON arguments; do not paste them as an unquoted shell command.
 
+### Client status
+
+**Settings → Client connection** also lists the supported local clients that
+FULI found and whether their FULI integration configuration is still in place:
+connected, changed, skills left without MCP, removed after an earlier
+connection, not connected, or unknown when a client's config, settings, hooks or
+their folder cannot be read or parsed. Only a missing file counts as removed. The view re-reads configuration on open, on manual refresh and every 15
+seconds while the card is open and the page is visible. It only describes
+configuration; it does not show whether a client is running or reachable, and it
+never reinstalls anything. FULI keeps only the latest status and the last five
+changes per client in `client-connection-observations.json` in its data
+directory; if that file is damaged, the history starts over. If it cannot be
+saved, the console keeps the history until FULI restarts and says it is unsaved.
+
 ## Claude Desktop and other chat apps
 
 `fuli setup` detects Claude Desktop (Windows and macOS) and adds a `fuli` entry to
 `claude_desktop_config.json`, keeping its other settings and servers and backing up the
 file first. Quit and reopen Claude Desktop afterwards; it only reads the file at launch.
 
-Chat apps load every tool schema into each conversation, so Claude Desktop gets the
-**chat profile** (`--tool-profile chat`): 20 tools for preferences, project knowledge,
-recording, completion checkpoints, conversation recovery and the Roundtable, about
-40 KB of schema instead of about 200 KB for all 141 tools. Management (executors,
-routing, publishing, recruitment) stays in the console. Its conversations are attributed
-to `claude`. For another chat-style client, print the same entry with
+Chat apps load exposed tool schemas into each conversation, so Claude Desktop and
+newly configured Claude Code connections get the **chat profile**
+(`--tool-profile chat`): 21 initial tools for preferences, project knowledge,
+recording, completion checkpoints, conversation recovery, the Roundtable and tool
+discovery. `list_agent_interfaces` defaults to a schema-free directory. Request one
+exact `toolName` to read its complete schema and expose that original named tool
+through `tools/list_changed`, then call the original name under the client's normal
+permissions. This also provides management, routing, publishing and recruitment on
+demand; discovery grants no permission. If the client does not refresh its tool list,
+reconnect using `fuli connect --profile full`. Generated full configuration keeps the
+explicit `--tool-profile full` choice so managed upgrades preserve it. Legacy Claude
+Code setup entries without an explicit profile migrate to chat; `alwaysLoad` remains
+enabled for its initial tools. Claude Desktop conversations are attributed to `claude`.
+For another chat-style client, print the same entry with
 `fuli connect --profile chat --source-application claude` (or the matching source).
 
 Claude Desktop has no lifecycle hooks, so task entry and the closing attribution line
@@ -52,6 +74,20 @@ Clients that only ask for a command can use `fuli mcp` if `fuli` is on their PAT
 Configuration export is read-only: it neither modifies client settings nor
 claims the client has connected successfully.
 
+When a turn receives no valid Hook context, `get_collaboration_preferences` is
+the task-entry fallback. Supply the actual native `sessionId` and current
+`taskPrompt`; it returns a fresh `taskContextToken` for the final checkpoint and
+recovers the selected role's latest saved result. Never guess a native ID or use
+an MCP process ID. Without the native ID or prompt, preferences remain available
+but `task_lifecycle.status=not_started` reports that checkpoint ownership was not
+established. An unfinished Provider task is not evidence of Hook delivery.
+
+Claude Code's blocked or unavailable entry output supplies the host's native ID
+when available and directs the Agent to this fallback. Transcript ownership
+guards stay intact: a fallback task-summary checkpoint does not prove that the
+native transcript tail was captured or that the Hook delivered task context.
+Hook execution, successful FULI entry and model receipt require separate evidence.
+
 ## What a compatible client needs
 
 - MCP **tool discovery and invocation**, using stdio or the remote transport

package/docs/project-agent-memory.md

@@ -49,7 +49,12 @@ Provider 读取已授权的员工和项目记录。切换客户端不会复制
 1. 根据当前目录解析项目：先匹配精确 ID，再允许唯一的大小写等价 ID。工作树以原仓库
    为准，不以任意工作树文件夹名覆盖原项目；多个候选或相近但不同的名字不猜测。
 2. 选择具有有效任职、允许当前客户端的员工，并恢复职责、项目简介、近期任务、工作记录和记忆。
-3. 开始持久化的任务上下文，返回 `taskContextToken` 和当前记忆 revision。
+   项目任务同时恢复同一员工的全局记忆：`memory` 是当前项目层，`global_memory` 是全局层
+   （项目为 `null`），两层各自校验空间、项目、员工和 scope，各自保留 revision；
+   任一层读取失败只把该层列入 `unavailable_components`，不隐藏另一层。全局任务只读取一次全局层；
+   `task_only` 员工两层都不读取。任务入口预览对每层分别限长并标注 `notesTruncated`。
+3. 开始持久化的任务上下文，返回 `taskContextToken` 和当前记忆 revision（只绑定任务所在层）。
+   任务检查点只写该层；全局层须用 `personalProjectId: null` 单独、显式写入，不自动复制项目内容。
 4. 如果任务入口尚无员工，协调时传入当前 token。新招的小组长可以接管同一任务；
    即使执行器阻塞，也能保留阻塞原因与下一步。
 
@@ -136,3 +141,113 @@ MCP 上下文有长度上限。被截断时必须显式补读完整记忆后再
 `begin_task_context` 和 `get_collaboration_preferences` 始终返回 `agent_receipt`，其中 `required: true` 和 `markdown` 构成统一的回复契约。宿主 Agent 必须在每次最终回复中原样显示一次这行身份与个人页面链接；问候、失败、没有可沉淀知识或关闭自动沉淀都不例外。无可用授权身份时返回 `FULI Agent：未选定`，不借用上次任务的身份。旧版本入口没有回执时应明确说明身份不可用。
 
 MCP 与 Hook 交付会为完整回执保留空间，其他上下文超长时也不截断回执；预算不足以容纳回执时返回明确错误。该要求通过共享 MCP 指令、入口说明和操作 Skill 交付；外部宿主最终生成的文字仍由该宿主负责遵守，Fuli 不伪称能拦截所有客户端输出。身份回执不证明模型工作者已经启动，也不证明知识或会话已经保存。
+
+## 全局 FLA 上下文
+
+FLA 身份、模型策略和执行器偏好属于个人空间，可以没有项目任职。项目仍需负责人。
+未匹配项目的会话显式选择 FLA（`projectAgentId` 或开头的 `@{agentId}`）时，直接恢复
+该 FLA 的全局对话与工作记忆，不创建会话项目或临时任职；同一宿主会话后续沿用全局身份。
+已明确解析出的项目仍走项目任职校验，无法访问时不会回退到全局。
+
+对话与记忆工具省略 `personalProjectId` 或传 `null` 表示精确的全局范围，绝不是所有项目。
+全局范围与每个项目分别保存对话、恢复策略、工作摘要及记忆 revision；后续任职不会迁移、
+合并或继承这些数据。全局读取不会自动加载任何项目任务或知识。已有项目记录保持兼容。
+全局写入仍检查个人空间权限、身份状态、客户端允许列表、任务 token 和记忆版本。
+
+主页和高级管理页的“对话与记忆”都提供“全局”选项；项目选项只来自有效任职，
+管理范围本身不会授予项目私有对话权限。无项目 FLA 的全局会话也支持跨客户端接续。
+
+## 检查工作记忆与压缩摘录
+
+“对话与记忆”展开后按所选范围（全局或某个项目）读取已有的
+`GET /api/project-agents/:id/memory`，显示当前 revision、来源客户端、时间、摘要、决定、
+未完成事项和下一步；没有检查点时明确显示为空，读取失败可重试，切换范围会丢弃旧响应。
+工作记忆是任务检查点保存的工作上下文，不等于人工确认的知识。这里只读，不提供编辑入口。
+
+对话超过压缩阈值后，较早消息按固定规则抽取原句，不调用模型，也不声称理解语义：
+
+- 用户消息的首行作为请求标题；用户与 Agent 消息中带有更正、决定、未完成或方法标记
+  （如 `Decision:`、`TODO`、`instead`、`决定`、`待办`、`方法`）的行按此分类保留。代码块与工具
+  输出不抽取。
+- 每条摘录记录来源角色与事件序号；去除首尾空白后完全相同的文本（区分大小写与内部空白）只保留一条并追加来源（保留首个与最近三个，
+  同一来源不重复），因此更新的说法与较早的说法并列出现，不会覆盖旧来源。被截断的摘录只是
+  前缀，不参与去重，避免把前缀相同的不同决定合并。
+- 单条摘录最多 240 UTF-8 字节，整体最多 6000 字节、80 条；超出时先移除最旧的请求标题，
+  再移除最旧的方法，最后才移除决定、更正与未完成事项。未抽取的行（含代码块中的代码行）
+  和被移除的行计入 `omitted`。
+- 恢复上下文时整段摘要（任务结果、旧请求、摘录）最多占预算的一半：任务结果单条按 240 字节
+  截断；超出时依次移除旧请求、请求标题与方法、最旧的任务结果，最后才移除决定、更正和未完成
+  事项。标题注明“不是经核实的工作记忆、原文仍保留”，并给出省略与截断数量。旧版纯文本摘要
+  按序列化后的 JSON 字节（含转义）裁去较早部分，保证整个恢复结果不超过预算。
+- 旧摘要中的 `notes`（首行请求）继续可读，新摘录追加在其后，不改写历史数据。
+
+阅读原文时首页返回同一份摘录，界面区分“自动摘录，未经核实”与工作记忆，显示来源序号、
+截断与省略说明；原文消息带同样的序号，可在现有分页历史中找回。规则无法识别未带标记的
+决定，也可能把带关键词的普通句子误分类；原文始终是依据。设计参考 Mem0 的抽取、合并去重和
+保留来源，以及 LongMemEval 关注的时间更新与弃权维度，仅作为合成测试的验收方向，并未运行
+这些公开基准。
+
+## 员工目录快照（第一阶段）
+
+每个长期员工（`memory_scope: reviewed_agent`）在 FULI 数据目录下有一个只为查看和交接生成的
+目录：`agents/<Provider>/<个人空间>/<员工>/`。三级目录名都是稳定 ID 的哈希，不受显示名、改名
+或不安全 ID 影响；不同 Provider、个人空间和同名员工互不重叠。只有通过 runtime config 打开的
+应用会生成快照，没有全局回退位置。
+
+- `AGENTS.md`：允许列出的身份与职责（名称、ID、工号、类型、状态、职责、能力、初始偏好、
+  性格与期望），不写分配列表、凭据、运行路径、会话或任务 token。
+- `MEMORY.md`：全局工作记忆；`projects/<项目哈希>/MEMORY.md`：各项目工作记忆。每个文件注明
+  范围、数据库 revision、生成时间，以及“由数据库生成、不是依据、修改不会导入”。没有记忆时
+  如实写明尚无记录。疑似含凭据的旧内容不写入文件。
+
+数据库始终是依据。快照在已授权的完整读取之后生成：`get_project_agent_memory` 写入所读范围；
+控制台的“对话与记忆”（`inspectProjectAgentMemory`）以本机所有者身份读取，同样补齐或重建所读
+范围，不套用员工的客户端白名单；任务入口写入本次已读取的全局层和项目层（在热路径预览裁剪之前），
+不额外读取其他项目。写入前用任务入口相同的范围校验检查整个视图和当前记录：员工、项目、空间或
+revision 不符时只刷新身份文件，不把内容写到所请求的范围下。
+`checkpoint_project_agent_memory` 在数据库提交成功后用返回的记录刷新；任务检查点不返回记忆
+内容，只把对应文件标记为 `stale`，下次授权读取时重新生成；较晚到达的旧标记不会撤销尚未
+读取的新 revision。快照不属于数据库事务。
+
+旧员工不需要迁移：首次授权读取时补齐目录，不写数据库、不改 revision、不改名或招聘。重复读取
+不改写未变化的文件；删除或手动修改的生成文件会按数据库重建；目录里其他文件保持原样。旧
+revision 不会覆盖已写入的新 revision（即使新文件已被删除）。
+
+文件 0600、目录 0700，原子替换；任何受管理路径是符号链接或非常规文件时拒绝写入。并发写入用
+目录内的短锁：已被占用时立即返回 `busy`，遗留超过 30 秒的锁会被清理。文件系统失败不会影响
+已成功的数据库读写。工作记忆读取、记忆检查点、任务检查点（`agent_memory` 内）和任务入口
+（`project_agent_context` 内）的结果，包括通过 MCP 返回时，都用公开字段 `directorySnapshot`
+报告目录状态；MCP 对内部 `snapshot` 字段的通用屏蔽保持不变。`directorySnapshot` 只包含 `status`（`current`、`stale`、`newer_present`、
+`busy`、`unsafe_path`、`unavailable`）、相对 `path` 和每个文件的范围、revision 与状态，不含
+绝对路径或原始错误。
+
+## 导出工作记忆（第二阶段）
+
+“对话与记忆”的工作记忆标题旁有一个导出按钮，只下载当前所选范围（全局或一个已分配项目）
+的 Markdown。Agent 使用只读工具 `export_project_agent_memory`，所有者控制台使用
+`GET /api/project-agents/:agentId/memory/export`，二者共用同一个导出边界：
+
+- 每次导出都重新从数据库读取，从不读取目录快照或用户修改过的文件；快照不存在也不代表
+  任何结论。读取结果先经过与任务入口相同的严格范围校验（外层、当前记录、每条历史的员工、
+  项目、空间、范围和 revision），任一不符即拒绝，不生成 Markdown。
+- 内容只有允许列出的身份字段和所选范围的一层记忆，注明范围、数据库 revision、记录时间、
+  生成时间，以及“由数据库生成、不是依据、修改不会导入”。不含原始对话、token、任务或会话 ID、
+  完整分配列表或运行路径；疑似凭据的内容被隐去。结果只返回建议文件名和 Markdown 文本，
+  不接受输出路径参数，也不写导出文件；记忆内容按纯文本返回。MCP 为该工具单独预留 512 KiB，
+  足以容纳最大的合法身份资料（含 UTF-8 与 JSON 转义）和一层记忆；万一仍超出，会明确报错，
+  而不是返回被截断的半个文件。
+- Agent 工具沿用 `get_project_agent_memory` 的权限：活动的长期员工、可信宿主注入的来源客户端
+  必须在白名单内，调用方不能自报来源；项目必须由 Provider 校验分配，不会隐式读取其他项目。
+  该工具不在远程连接器的允许列表中。控制台按现有所有者检查权限导出，只要求长期员工。
+- 导出时会顺带刷新可选的目录快照；快照目录不可写不影响导出，结果也不声称已在本机保存。
+- 界面在请求期间禁用按钮并显示进度；切换范围、员工或收起面板后才返回的结果会被丢弃，
+  不会下载错误范围；失败时说明并可重试。
+
+### 升级说明
+
+从 0.12.4 升级不需要迁移，现有数据库保持不变：员工 ID、工号、资料、各项目工作记忆的历史与
+revision 以及访问 token 都沿用。目录在首次授权读取时才补齐。0.12.4 没有全局工作记忆，升级后
+全局层为空，直到第一次检查点。删除生成目录或文件后，下次读取会按数据库重新生成；手动修改的
+Markdown 永远不会导入。目录权限出错时不影响读写和导出，修复权限后下次读取即可恢复。以上
+升级结果目前只在一条路径上验证过（已发布的 0.12.4 → 新 Provider，同一隔离 Neo4j），并非
+覆盖所有旧版本。

package/graph-provider/fuli_graph/agent_conversation_models.py

@@ -22,7 +22,7 @@ class ConversationPolicy(StrictModel):
 
 class ConversationScope(StrictModel):
     personal_space_id: str = Field(min_length=1, max_length=128)
-    personal_project_id: str = Field(min_length=1, max_length=128)
+    personal_project_id: str | None = Field(default=None, min_length=1, max_length=128)
     agent_id: str = Field(min_length=1, max_length=128)
     source_application: SourceApplication | None = None
 

package/graph-provider/fuli_graph/app.py

@@ -879,6 +879,9 @@ def create_app(settings: Settings | None = None) -> FastAPI:
             Query(min_length=1, max_length=128),
         ] = None,
         limit: Annotated[int, Query(ge=1, le=200)] = 100,
+        session_id: Annotated[str | None, Query(min_length=1, max_length=256)] = None,
+        work_kind: Annotated[str | None, Query(min_length=1, max_length=128)] = None,
+        workflow: Annotated[str | None, Query(min_length=1, max_length=128)] = None,
     ) -> CollaborationContextResult:
         return await store.collaboration_context(
             actor,
@@ -886,6 +889,9 @@ def create_app(settings: Settings | None = None) -> FastAPI:
             personal_project_id,
             limit,
             project_agent_id,
+            session_id,
+            work_kind,
+            workflow,
         )
 
     @application.get('/v1/spaces/{space_id}/graph', response_model=GraphResult)

package/graph-provider/fuli_graph/collaboration_context.py

@@ -1,5 +1,6 @@
 from collections import defaultdict
 from math import isfinite
+import re
 
 from fastapi import HTTPException
 
@@ -12,7 +13,7 @@ from .models import (
 )
 from .personal_project_access import authorize_personal_project
 from .project_agent_access import authorize_project_agent
-from .provider_values import json_object, native_datetime as _native_datetime
+from .provider_values import json_object, native_datetime as _native_datetime, preference_qualifiers
 
 
 async def read_collaboration_context(
@@ -22,6 +23,9 @@ async def read_collaboration_context(
     personal_project_id: str | None = None,
     limit: int = 100,
     project_agent_id: str | None = None,
+    session_id: str | None = None,
+    work_kind: str | None = None,
+    workflow: str | None = None,
 ) -> CollaborationContextResult:
     space = await store.authorize(actor, space_id, 'reader')
     if space['kind'] != 'personal':
@@ -37,18 +41,13 @@ async def read_collaboration_context(
             personal_project_id,
         )
     if project_agent_id:
-        if not personal_project_id:
-            raise HTTPException(
-                status_code=422,
-                detail='project Agent preferences require a personal project',
-            )
         agent = await authorize_project_agent(
             store,
             actor,
             space,
             personal_project_id,
             project_agent_id,
-            require_memory=True,
+            require_memory=True, allow_global=True,
         )
         project_agent_id = agent['agent_id']
     project_scopes = await _project_scopes(
@@ -105,6 +104,9 @@ async def read_collaboration_context(
         *edges,
         *(item for item in nodes if item.id not in edge_endpoint_ids),
     ]
+    scoped_items = [item for item in items if _applies_to_task(item, session_id, work_kind, workflow)]
+    task_scope_excluded_count = len(items) - len(scoped_items)
+    items = scoped_items
     items.sort(key=_sort_key)
     if len(items) > limit:
         truncated = True
@@ -178,6 +180,8 @@ async def read_collaboration_context(
         project_preferences=project_preferences,
         agent_preferences=agent_preferences,
         effective_preferences=effective_preferences,
+        task_scope_excluded_count=task_scope_excluded_count,
+        task_scope_filtered=True,
         conflicts=[*global_conflicts, *project_conflicts, *agent_conflicts],
         overridden_global_ids=overridden_global_ids,
         overridden_inherited_ids=overridden_inherited_ids,
@@ -187,6 +191,32 @@ async def read_collaboration_context(
     )
 
 
+def _applies_to_task(item, session_id, work_kind, workflow):
+    qualifiers = {**item.attributes, **json_object(item.attributes.get('preference_qualifiers')),
+                  **item.preference_qualifiers}
+    conditions = [
+        (qualifiers.get('sessionId', qualifiers.get('session_id', qualifiers.get('sessionIds', qualifiers.get('session_ids', _legacy_session(item.instruction))))), session_id),
+        (qualifiers.get('workKind', qualifiers.get('work_kind', qualifiers.get('workKinds', qualifiers.get('work_kinds')))), work_kind),
+        (qualifiers.get('workflow', qualifiers.get('workflows')), workflow),
+    ]
+    for condition, actual in conditions:
+        values = [condition] if isinstance(condition, str) and condition.strip() else (
+            condition if isinstance(condition, list) and condition and
+            all(isinstance(value, str) and value.strip() for value in condition) else None
+        )
+        if values and actual and actual not in values:
+            return False
+    return True
+
+
+def _legacy_session(instruction):
+    # Read compatibility only; provenance/ambiguous business prose never scopes.
+    match = re.match(r'^仅(?:在|适用于)\s*(?:Codex|Claude Code|Cursor)\s*会话\s+'
+                     r'([a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12})'
+                     r'\s*(?:中|的|后续|[，,：:])', instruction or '')
+    return match[1] if match else None
+
+
 async def _project_scopes(store, space, personal_project_id):
     if not personal_project_id:
         return {}
@@ -436,6 +466,7 @@ def _preference_item(
         preference_project_id=project_id,
         preference_agent_id=agent_id,
         attributes=attributes,
+        preference_qualifiers=preference_qualifiers(attributes),
         weight=weight,
         reason=reason,
         confirmation_basis=basis,