| name | vision-beyond |
| description | 基于飞书 lark-cli，先从身份、OKR、审批、任务与近期活动建立可确认的工作地图，再从消息、会议、纪要和有权限文档中找到视野之外、值得关注的飞书信号，筛出可能影响判断或行动的 Top 5。用户说‘视野之外’‘我漏掉了什么’‘未读未回’‘没参加的会’‘可能没看的文档’或‘飞书信息雷达’时使用。 |
视野之外
核心目标
帮用户找到视野之外、值得关注的飞书信号。未读、未回、更新时间和阅读量只负责召回，用户确认的工作地图、责任关系、状态变化和证据强度共同决定排序。
开始前
- 读取当前安装的
lark-shared，并按需读取 lark-im、lark-drive、lark-doc、lark-calendar、lark-vc、lark-note、lark-minutes、lark-task、lark-approval、lark-okr。
- 执行
python3 scripts/doctor.py。支持 auth status --json --verify 的环境必须确认 verified=true；当前 CLI 构建若没有 auth 子命令，doctor 可以退回只读兼容探测。contact +get-user 代表当前用户已解析；task canary 只代表 user-context 可读。某个可选域缺权限时保留降级结果，不能把局部覆盖写成全量巡检。
- 所有用户历史数据使用
--as user。公司飞书、个人飞书及不同 profile 之间不得混用。
- 本 Skill 只读：不发送或回复消息，不标记已读，不编辑文档，不创建任务，不改日历，不处理或发起审批，不申请会议产物权限。
能力与最小授权见 references/capability-matrix.md，数据边界见 references/privacy.md。
首次激活
1. 配置报告节奏
缺少配置时，只询问报告时间和 IANA 时区。系统时区可以作为建议，最终值由用户确认。用当前 Agent 宿主支持的周期任务能力创建或更新每日巡检；宿主不支持自动任务时，给出手动运行说明，不伪造已创建的调度。
初始化私有状态：
python3 scripts/state.py init --report-time "17:30" --timezone "Asia/Shanghai"
示例时间只展示格式，不能代替用户选择。状态协议见 references/state-schema.md。
2. 建立工作地图
按 references/context-profile.md 读取：
- 当前用户可见身份与租户边界；
- 当前 OKR；缺权限时明确记录缺口；
- 当前审批待办、未读知会及相关任务；
- 最近 14 天用户发送的消息、参与的会议、编辑/评论/打开过的文档；
- 从这些证据归并出的 5–8 个议题草案。
每个议题都包含名称、为什么相关、证据来源、搜索词、置信度和缺失源。把草案交给用户做一次自然语言确认：保留、删除、改名、合并、补充、暂不关注。
工作地图确认前，不执行正式基线报告；用户明确指定的单次查询可以继续。
3. 执行 7 天基线
确认工作地图后扫描最近 7 个自然日。成功后记录运行点和不可逆候选指纹。后续每日窗口使用“上次成功运行点 → 本次计划运行点”；固定日报通常表现为前一天同一时刻至当天同一时刻。
时间边界必须由系统时间或 state.py window 计算，不能凭模型心算：
python3 scripts/state.py window
日常巡检
1. 确认身份和窗口
LARKSUITE_CLI_NO_UPDATE_NOTIFIER=1 \
LARKSUITE_CLI_NO_SKILLS_NOTIFIER=1 \
lark-cli auth status --json --verify
支持 auth status --json --verify 的环境只有在 verified=true 且用户身份可用时继续。当前 CLI 构建若没有 auth 子命令，以 python3 scripts/doctor.py 的兼容结果为准：contact +get-user 可进入只读巡检，task canary 代表 scope 清单未知的更弱模式。状态缺失或损坏时回到首次激活，不用旧报告充当本次结果。
2. 采集行动源
审批和任务先进入候选池：
lark-cli approval tasks query \
--params '{"topic":"1","page_size":100,"locale":"zh-CN"}' \
--as user --format json
lark-cli approval tasks query \
--params '{"topic":"17","page_size":100,"locale":"zh-CN"}' \
--as user --format json
lark-cli task +get-related-tasks --include-complete=false \
--as user --format json
topic=1 表示当前待办审批；结合审批定义、发起人、当前节点和表单摘要判断行动价值。topic=17 表示未读知会；旧积压按审批定义和业务对象聚合，只下钻排名靠前的实例。- 多年未完成任务只有在近期更新、接近截止或关联已确认议题时保留。
- 审批详情仅用于证据核验，禁止调用任何写操作。
3. 采集消息
先以工作地图的议题词做窄搜索，再补充 @我、私聊和含链接消息。时间使用带时区的 RFC3339：
lark-cli im +messages-search --as user --query "<TOPIC>" \
--start "<START>" --end "<END>" --page-size 50 --page-limit 4 \
--format json --no-reactions
lark-cli im +messages-search --as user --query "" --is-at-me \
--start "<START>" --end "<END>" --page-size 50 --page-limit 4 \
--format json --no-reactions
lark-cli im +messages-search --as user --query "" --chat-type p2p \
--start "<START>" --end "<END>" --page-size 50 --page-limit 4 \
--format json --no-reactions
对可能需要回复的消息，读取同一线程或私聊窗口的后续上下文。分页或线程不完整时，未回状态最高只能为 candidate。详细规则见 references/message-state.md。
广泛召回阶段使用 --no-reactions 控制请求量。若已授权 im:message.reactions:read，只对高位消息候选补充 reaction 聚合计数：
lark-cli im +messages-mget --as user \
--message-ids "<COMMA-SEPARATED-MESSAGE-IDS>" --format json
reaction 数量只作为弱关注线索，排序加分最多 3 分，不能单独进入 Top 5。当前用户的 reaction 最多支持“接触过”，不能替代复杂请求的正文回复或任务闭环。字段缺失不构成反向证据。细则见 references/reaction-signal.md。
4. 采集会议与会议产物
- 日历范围：
calendar +agenda --as user --start <START> --end <END>。
- 已结束会议：
vc +search --as user，至少带时间范围或参会人条件。
- 排名靠前的会议用
vc +detail 获取纪要入口，再按 note_id、minute_token 路由。
- 妙记无权限时停止下钻；智能纪要与妙记分别标记证据来源。
会议状态只使用可证实语言：
not_attended：参会快照能证明用户没有有效参会记录；no_minutes_view_evidence：没有证据表明用户看过纪要；not_opened：仅在接口明确返回用户打开状态时使用。
没有出现在日历中，不能直接推出用户没有参加。
5. 采集有权限文档
文档是一等候选源。并行执行“近期更新”和“窗口内新建”两条召回路径。对每个已确认议题先做主题搜索：
lark-cli drive +search --as user --query "<TOPIC>" \
--doc-types doc,docx,sheet,bitable,wiki,file --sort edit_time \
--page-size 20 --format json
lark-cli drive +search --as user --query "<TOPIC>" \
--created-since "<START_DATE>" --created-until "<END_DATE>" \
--doc-types doc,docx,sheet,bitable,wiki,file --sort create_time \
--page-size 20 --format json
drive +search --as user 只证明当前身份可发现该对象，无法证明覆盖全部可访问文档。update_time > last_open_time 可标为“更新后可能未看”；last_open_time 缺失或为零且议题高度相关，可标为“未发现本人访问证据”。- 日期过滤按自然日召回。返回后必须用
create_time 在内存中裁剪到精确的 <START> → <END> 窗口。
- 缺少打开字段、分页未完成或仅凭搜索缺失，只能标为
unknown。
--edited-since 描述用户编辑行为，不能充当“别人最近更新”的全局过滤器。- 先按工作地图相关性、标题、摘要、创建/更新时间和本人打开时间初排；最多对前 20 条相关文档调用聚合统计：
lark-cli drive file.statistics get --as user \
--file-token "<TOKEN>" --file-type "<TYPE>" --format json
- 当前自然日优先使用
uv_today，较早但仍在窗口内的新建文档使用生命周期 uv。uv 比 pv 更接近独立阅读人数。
- 用户已配置独立阅读人数门槛时遵循用户配置。没有配置时，在同日、同议题候选中做相对排名：至少 5 个候选时，只有独立阅读人数高于同批中位数且位于前 20% 才标为“多人阅读”；样本不足 5 个时要求至少 5 个独立访问者。
- 聚合统计调用返回
forbidden、not found、文件类型不支持或字段缺失时，不补写热度结论，保留更新时间与本人打开时间证据并降低置信度。
file.view_records 只能作为可选交叉验证，常受文档所有者权限限制；不能把调用失败写成“本人未读”。- 阅读量本身没有业务价值。候选仍须命中工作地图，并能说明变化、关系和下一步。
- 只有进入高位候选后才读取正文。
6. 合并、去重和排序
在内存中以消息、会议、纪要、文档和审批的稳定标识去重；持久化前只保存 SHA-256 指纹。跨来源属于同一变化时合并成一条，保留最强证据和必要链接。
按 references/ranking.md 评分，并执行三道门槛：
- 具体改变了什么；
- 为什么与当前用户有关；
- 用户现在需要阅读、回复、补会、处理审批，还是可以忽略。
任一问题无法简洁回答时降级或丢弃。
输出合同
正式报告只列一个跨来源 Top 5。分类、摘要和统计只能引用这 5 条，不得在后续章节新增第 6 条候选。高价值候选不足时少于 5 条，不凑数。
视野之外｜<START> → <END>
工作地图：<已确认议题；新增议题候选另行标记>
1. 【高｜可能未看｜已确认待回复】一句话说明发生了什么
与你有关：...
建议动作：阅读 / 回复 / 补会 / 看纪要 / 处理审批 / 暂不处理
证据：可点击来源；时间；必要的第二来源
置信度：高 / 中 / 低
...最多 5 条
覆盖说明：已覆盖域、缺失权限、分页截断、状态不确定性
本次无结果时：本窗口没有足够证据支持打扰你的内容
状态语言严格区分：
- “已确认未读”：接口或用户提供了明确阅读状态；
- “可能未读 / 可能未看”：相关且缺少消费证据；
- “已确认待回复”：明确请求，且完整后续上下文中没有用户回复；
- “可能待回复”：存在请求信号，但上下文不完整。
成功后写入最小状态
先对稳定标识做不可逆指纹：
printf '%s' '<SOURCE-STABLE-ID>' | python3 scripts/state.py fingerprint --source message
完成报告后再标记成功；失败或覆盖中断不能推进检查点：
printf '%s\n' '<HEX-FINGERPRINT>' | \
python3 scripts/state.py mark-success --at "<RFC3339>"
失败与降级
- 用户认证失败：停止读取，不切换 bot，不使用旧缓存。
- 某业务域缺权限：继续已授权域，并在覆盖说明中列出缺口。
- 消息搜索或文档搜索分页未完成：标记覆盖不完整。
- 会议产物无权限：只保留会议元信息，不申请权限。
- OKR 缺权限：工作地图标记为临时版本，不从群名推断目标。
- 审批知会过多：聚合后只核验高位候选，报告覆盖上限。
- 没有高价值候选：保持安静结论，不用低价值内容填满 Top 5。
永久边界
- 不把发送者职级、群规模、消息长度、reaction 数量或文档阅读量单独当作价值。
- 不把 AI 会议摘要未经原始证据核验地写成事实。
- 不把业务正文、人员标识、reaction ID、文档 token、会议 ID、审批实例号或授权材料写入状态、日志、仓库或长期记忆。
- 不声称“扫描了用户所有未读内容”；当前能力本质上是权限感知、议题驱动的高价值召回。
