LifeOS LocalIntelligence DailyBrief 工作流完全指南一键聚合家乡八类本地信息的每日简报机制【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS导读DailyBrief 是 LifeOS 中 LocalIntelligence 技能 的主控工作流它负责把家乡城市的八类本地信息——建设许可、犯罪、商业、官员、立法、选举、逮捕、新闻——一次性全部抓取写入统一的 JSON 摘要文件latest.json并在对话中按类别汇总播报。读完本文你将掌握 DailyBrief 的完整执行链路家乡地址如何解析、Refresh.ts编排器如何并发调用八个 fetcher、--fillAI 补缺模式如何工作、意图关键词如何映射为命令行标志以及最终摘要文件的落盘结构与 Pulse 仪表盘的消费方式。DailyBrief 在 LocalIntelligence 中的定位LocalIntelligence 是一个对任意美国城市通用的政务情报聚合器围绕{city, state}必要时含county运行不针对单一城市做硬编码。它由以下部分组成9 个 WorkflowDailyBrief.md是编排入口其余 8 个News、Crime、Arrests、Elections、Legislation、Officials、Business、Construction各自负责单类目查询13 个 Tools包括家乡解析器Hometown.ts、编排器Refresh.ts、AI 补缺器ClaudeFill.ts、用户自定义源UserSources.ts、8 个 fetcher 以及历史回填工具Backfill.ts1 个 References 文档DataSources.md 收录了所有通用数据源的 URL 模式与可用性说明。DailyBrief 的工作流文档对其使命的概括是Run the master daily civic digest for the principals hometown. Calls every fetcher, writeslatest.json, summarizes the top items in chat.为委托人家乡运行每日政务摘要调用全部 fetcher写入latest.json并在对话中汇总前几条要闻。前置条件Hometown 解析与委托人身份文件DailyBrief 的第一步是解析家乡地址这是唯一的城市信息来源。整个技能没有任何硬编码城市字符串——所有 workflow 和 fetcher 都通过 Tools/Hometown.ts 的readHometown()在运行时解析。解析规则如下源码HOMETOWN_RE正则从~/.claude/LIFEOS/USER/PRINCIPAL/PRINCIPAL_IDENTITY.md仓库内的模板见 PRINCIPAL_IDENTITY.md中读取Quick Reference区的**Hometown:**行期望的行格式为- **Hometown:** City, ST (ZIP zip, County County)例如- **Hometown:** Austin, TX (ZIP 78701, Travis County)ST可以是两位 USPS 州代码也可以是完整州名源码内置了 50 州 华盛顿特区的STATE_NAME_TO_CODE映射表(ZIP zip, County County)为可选但推荐zip支持5 位与9 位 ZIP4格式county用于拼接更精确的地点描述解析结果同时生成citySlug/stateSlugkebab-case 化供模板化 URL 使用例如 Patch RSS 的https://patch.com/state-slug/city-slug/feed见 FetchNews.ts 的fetchNews实现。身份文件路径可通过环境变量LIFEOS_PRINCIPAL_IDENTITY覆盖默认值为上述路径。如果文件中没有**Hometown:**行readHometown()会抛出NoHometownError附带写入示例行的提示信息DailyBrief 随即展示 setup-help 消息并退出进程退出码为 2绝不凭空捏造城市。执行流程Procedure逐步拆解DailyBrief 文档给出的标准流程共 5 步下面结合源码逐一展开。第 1 步解析家乡通过Tools/Hometown.ts解析家乡。若缺失则输出配置帮助消息并退出——这正是NoHometownError的语义。第 2 步运行 Refresh.ts 编排器核心命令为bun run ~/.claude/skills/LocalIntelligence/Tools/Refresh.ts [--force] [--summary] [--json]Tools/Refresh.ts 是整个技能的编排中枢它完成三件事a八路并发抓取将 8 个 fetcher 注册进fetchers映射表construction / crime / business / officials / legislation / elections / arrests / news并通过Promise.allSettled并发执行——一个数据源挂掉不会拖垮整个摘要。每个 fetcher 的失败由runOne()捕获并转换为{ items: [], source_status: unavailable, errors: [...] }的结果对象而不是抛异常。b结果归并汇总sources_used返回ok的源、sources_failed返回unavailable的源以及带源标签的errors列表组装成Digest对象。Digest的结构定义在 Tools/Types.tsinterface Digest { meta: { city: string; state: string; county?: string; zip?: string generated_at: string sources_used: string[]; sources_failed: string[]; errors: string[] backfilled?: boolean } construction: FetchResult; crime: FetchResult; business: FetchResult officials: FetchResult; legislation: FetchResult; elections: FetchResult arrests: FetchResult; news: FetchResult }c落盘persist()写入按日命名的时间戳文件详见下文输出产物一节。值得注意的加载顺序源码注释明确说明内置 fetcher → 用户配置源UserSources.ts→ AI 补缺ClaudeFill.ts仅当使用--fill时——确定性数据永远优先于模型研究结果。第 3 步读取 latest.json摘要落盘后DailyBrief 读取~/.claude/LIFEOS/MEMORY/DATA/LocalIntelligence/latest.json这是 Pulse 仪表盘 LOCAL 标签页消费的主路径。第 4 步汇总播报在对话中按类别总结每类前 3 条每条包含日期与来源链接。例如 News 类会展示标题、Patch来源、发布日期与原文 URL这些字段正是Item接口的title / source / url / date / summary。第 5 步暴露错误如果meta.errors中有内容必须点名失败的数据源不得隐藏。这是一个死源永不抹空白摘要契约的另一半数据可以缺但失败必须可观测源码中每个错误都带[section]前缀标签。意图到命令参数的映射Intent-to-Flag MappingDailyBrief 文档定义了一张用户说什么 → 用什么标志的意图映射表用于 Agent 将自然语言请求路由到对应执行模式用户说标志效果refresh、now、latest--force即使今日摘要已存在也重新执行summary only--summary跳过编排器直接读取现有 latest.jsonjson only--json输出原始 JSON不做对话汇总结合源码需要说明一个关键实现细节当前Refresh.ts的 CLI 入口import.meta.main分支将process.argv.slice(2)解析为Set实际识别的是--fillAI 补缺模式并把--force / --summary / --json留作工作流层面的语义约定——即由 Agent 根据意图决定是重新跑编排器、直接读已有文件还是原样输出 JSON。因此这张映射表应当理解为Agent 编排层的路由契约而底层二进制当前真正承诺的开关是--fillbun run ~/.claude/skills/LocalIntelligence/Tools/Refresh.ts --fill--fill模式在确定性 fetcher 跑完后由 Tools/ClaudeFill.ts 派生一个启用了WebSearch, WebFetch的claude --print子进程对仍然为空的类别做一次性网络调研。所有模型输出必须通过validateSection()的确定性校验必填字段、URL 形态^https?://...、每节上限 10 条才能进入摘要非法或疑似虚构条目会被丢弃并计入dropped计数写入meta.errors。模型填充永远只能补不能覆盖已有确定性数据。Pulse 的每日 cron 与仪表盘Refresh按钮均使用--fill裸调用保持纯确定性。输出产物与数据落盘DailyBrief 文档规定了三类输出文件~/.claude/LIFEOS/MEMORY/DATA/LocalIntelligence/YYYY-MM-DD_city_state_digest.json软链~/.claude/LIFEOS/MEMORY/DATA/LocalIntelligence/latest.json对话每节前 3 条 如有则列出meta.errors结合 Refresh.ts 的persist()实现这里有三点比文档更细化的实现事实双份 latest.json 而非单一软链当前实现用writeFile在两个位置各写入一份物理副本——USER/CUSTOMIZATIONS/SKILLS/LocalIntelligence/latest.jsonPulse 模块的优先读取路径与MEMORY/DATA/LocalIntelligence/latest.json历史兼容回退路径。源码注释记载了一次事故2026-05-03 至 2026-07-16 期间只写了旧路径导致仪表盘静默展示了两个半月的过期摘要。因此两份都要写、永不删除其一是负载关键逻辑。No-clobber 保护totalItems(digest) 0的全空运行fetcher 宕机 fill 失败只写按日命名的历史文件绝不覆盖已有内容的 latest.json。否则某天清晨 6 点的坏运行就会把仪表盘刷成空白。按日文件构成历史序列Week/Month/Year 视图聚合这些按日文件Tools/Backfill.ts 还可以用--days 365深窗回填把用户源自带历史记录按真实日期分布到过往的摘要文件中回填日标记meta.backfilled: true。persist()的返回值还提供了一份机器可读的执行摘要含sources_used、sources_failed、user_sources_merged、claude_filled、total_items与latest_skipped_no_clobber便于 Agent 在对话中报告执行结果。一个典型的latest.json内容结构字段源自Digest/Item类型{ meta: { city: Austin, state: TX, county: Travis, zip: 78701, generated_at: 2026-09-15T10:00:00.000Z, sources_used: [news, officials, business], sources_failed: [construction], errors: [construction: Patch returned 404 for https://patch.com/tx/austin/feed] }, news: { items: [ { title: Austin council to vote on density bonus ordinance, source: Patch, url: https://patch.com/texas/austin/..., date: 2026-09-14T00:00:00.000Z, summary: The ordinance would allow taller buildings near transit corridors. } ], source_status: ok } }运行环境、通知与前置依赖运行时脚本为#!/usr/bin/env bun需在安装 bun。语音通知DailyBrief 启动时通过localhost:31337的 LifeOS 通知端点播报curl -s -X POST http://localhost:31337/notify \ -H Content-Type: application/json \ -d {message: Running DailyBrief in LocalIntelligence} \ /dev/null 21 并在对话中输出一行Running **DailyBrief** in **LocalIntelligence**...。Pulse 集成技能写 JSON、Pulse 读 JSON。Pulse 模块~/.claude/LIFEOS/PULSE/modules/local-intelligence.ts只读latest.json对外提供GET /api/local-intelligence与POST /api/local-intelligence/refresh仪表盘 LOCAL 标签页Observability/src/app/local/page.tsx按九个区块渲染各类目。每日刷新由PULSE.toml中的[[job]]在0 6 * * *触发Refresh.ts。边界情况与常见坑以下要点提炼自 SKILL.md 的 Gotchas 清单与 DailyBrief 直接相关没有 Hometown 行 不抓取所有 workflow 输出配置帮助消息并以退出码 0 结束不虚构城市empty≠unavailableempty表示源返回 200 但没有匹配条目小城镇常见unavailable表示 4xx/5xx 或 DNS 失败——两者在仪表盘上渲染不同的空状态Census 建设许可调查是月度数据不要承诺今天的许可建设类目天然是中延迟信号OpenStates 只覆盖州议会不覆盖市议会市政立法走 Granicus/Legistar 的 URL 模式尽力发现覆盖率为 best-effort聚合器搜索按相关度而非时间排序Google News RSS 可能返回十年前的文章用户源必须同时使用when:Nd查询运算符与max_age_days双保险Google News 链接是重定向 URL且标题以 Headline - Publication 结尾应设置strip_title_suffix: true把出版物提升为条目的 source 字段CivicPlus 等市政网站常硬性封锁爬虫Akamai 403不要直接接线其内容改由 Google News 查询获取。小结DailyBrief 的价值在于把分散在十几个没人看的网站上的家乡信息收敛成一个文件 一段对话摘要Hometown.ts提供唯一的城市事实源Refresh.ts以Promise.allSettled保证单源故障不拖垮整体UserSources.ts与ClaudeFill.ts形成确定性数据优先、AI 兜底补缺的加载次序双份latest.json no-clobber 保护确保 Pulse 仪表盘永远读到最新且有内容的摘要。对于想要在 LifeOS 中落地每日家乡简报的开发者本文覆盖的命令、意图映射与数据契约均已给出可验证的源码路径可直接在此基础上继续深入。【免费下载链接】LifeOS⛰️ The Life Operating System — an intent engineering platform that moves you from your current state to your ideal state, in life and work.项目地址: https://gitcode.com/GitHub_Trending/pe/LifeOS创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考