@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/zh-CN/template-brain.md

@@ -0,0 +1,324 @@
+---
+title: "大脑"
+description: "由引用的机构记忆、可审查的源代码摄取和可重用的工作区集成支持的干净的公司聊天。"
+---
+
+# 大脑
+
+大脑是干净的公司聊天，由引用的机构记忆支持。人们问
+简单的英语问题；大脑通过认可的公司知识进行回答
+链接回 Slack 线程、会议、记录、问题或 Webhook 捕获
+支持答案。
+
+大脑摄取批准的 Slack 频道、剪辑录音、Granola Team-space
+注释、GitHub 问题/PR 以及通用脚本/Webhook 有效负载。它存储原始数据
+捕获、提炼持久的事实/决策/流程，并路由敏感的或
+低可信度记忆在成为公司知识之前经过审查。
+
+产品表面有意保持简单：**询问**是主要聊天
+经验，而**来源**、**评论**和**知识**是管理/支持
+用于连接数据、批准提案和检查引用内存的界面。
+
+```an-diagram title="From source to cited answer" summary="Brain ingests approved sources into raw captures, distills durable memory, gates it through review, and only then answers with citations."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-card\"><span class=\"diagram-pill\">Sources</span><small class=\"diagram-muted\">Slack · Granola · GitHub · Clips · webhooks</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Raw captures<br><small class=\"diagram-muted\">deduped, redacted</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Distill<br><small class=\"diagram-muted\">facts · decisions · processes</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">Review</span><small class=\"diagram-muted\">sensitive / low-confidence queue</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><span class=\"diagram-pill ok\">Knowledge</span><small class=\"diagram-muted\">approved, atomic</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Ask</span><small class=\"diagram-muted\">cited answer</small></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.diagram-flow .diagram-card{display:flex;flex-direction:column;gap:4px;padding:10px 12px}.diagram-flow .diagram-box{display:flex;flex-direction:column;gap:4px}.diagram-flow .diagram-arrow{font-size:20px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;gap:14px;padding:18px;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px'><h1 style='margin:0'>Ask company memory</h1><span class='wf-pill accent'>42 approved memories</span><span class='wf-pill'>3 sources</span><div style='flex:1'></div><button>Sources</button><button>Review</button></div><div class='wf-card' style='display:flex;align-items:center;gap:10px'><span data-icon='search' aria-label='Search'></span><strong style='flex:1'>Why did we choose usage pricing?</strong><button class='primary'>Ask</button></div><div class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Answer</strong><p style='margin:0'>The team chose usage pricing after pilots showed seat counts undercounted automation value.</p><div style='display:flex;gap:8px;flex-wrap:wrap'><span class='wf-pill accent'>Pricing RFC</span><span class='wf-pill'>Launch retro</span><span class='wf-pill'>Sales notes</span></div></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:8px'><strong>Source timeline</strong><div class='wf-box'>May 3 · Decision captured</div><div class='wf-box'>May 8 · Customer evidence added</div><div class='wf-box'>May 12 · Legal note approved</div></div></div>"
+}
+```
+
+当您打开应用程序时，**询问**位于最前面和中心位置 - 干净的聊天超过审核
+公司内存。 **来源**、**评论**和**知识**与它并列
+用于连接数据、批准提案和检查引用的管理界面
+条目。
+
+## 何时采摘
+
+当您的团队希望代理回答诸如“我们为什么这样做”之类的问题时，请使用 Brain
+这个产品决策？”、“这个正在开发的功能如何工作？”或“什么
+在这个过程中发生了变化？”包含返回源对话、会议的链接，
+或问题。
+
+Brain 和 Dispatch 是互补的，但执行不同的工作：
+
+- **Brain 拥有公司内存。**它摄取来源、审查原始捕获，
+  从引用的证据中提炼出持久的事实/决策/过程、答案，以及
+  向代理公开经认可的知识。
+- **Dispatch 拥有工作区控制平面。**它集中消息传递，
+  秘密、重复性作业、批准、A2A 编排和分发
+  并批准工作区范围的资源。
+
+在多应用工作区中，Dispatch 可以通过 A2A 将问题发送至 Brain，并且
+可以授予 Brain 共享提供者凭据。大脑仍然是专家
+批准源摄取、审查、检索并引用 Company Brain 答案。
+Brain 将只读、引用支持的检索公开为其公共 A2A 功能
+因此 Dispatch 和同级应用程序可以询问公司内存问题 - A2A 代理
+卡片是公共发现元数据，而检索仍然发生在 Brain 内部
+经过身份验证的操作界面。
+
+## 你可以用它做什么
+
+- **询问引用的问题。**询问是主要的产品表面：干净的聊天
+  审查了公司内存，包括来源健康状况、审查计数和建议
+  问题保持次要。每个答案都链接回 Slack 线程，
+  支持它的会议、问题或捕获。
+- **连接批准的源。**配置手动、通用 Webhook、Clips、Slack，
+  格兰诺拉麦片和 GitHub 来源。默认情况下，来源是组织共享的，因此公司
+  内存对整个工作区很有用。
+- **发布前进行审核。**提出的回忆将获得一流的审核路线
+  审阅者编辑措辞、检查证据/源链接并批准或
+  拒绝。高可信度、非敏感条目可立即发布；
+  公司级或敏感条目作为提案排队。
+- **检查引用的知识。**知识路线显示蒸馏的、原子的
+  包含种类、主题、实体、置信度、确切证据引用的条目，以及
+  取代链接。
+- **重用工作区集成。**脑源可以重用共享工作区
+  连接授予而不是重新输入提供者令牌。来源页面
+  在可重复使用的连接授权和提供者旁边显示大脑源记录
+  准备就绪。
+- **将批准的内存镜像为环境上下文。**规范批准的条目可以
+  镜像到 `context/company-brain/...` 下的工作区资源，以便其他
+  应用程序可以将它们用作上下文。两个流程都在
+  资源被写入或删除。
+
+## 开始使用
+
+现场演示：[brain.agent-native.com](https://brain.agent-native.com)。
+
+1. **尝试演示。** 打开询问并选择 **开始演示**。大脑种子很小
+   产品决策语料库，运行信任检查，并提出引用的问题
+   您可以在添加之前查看答案、引用、评论和未找到的行为
+   真实的公司数据。
+2. **添加一个来源。**从单个 Slack 频道、Granola Team-space 开始
+   提要、GitHub 存储库、剪辑导出或通用脚本 Webhook。保留
+   范围很小，直到引用和评论质量看起来不错。
+3. **发布前进行审阅。**使用审阅来检查证据、编辑措辞，
+   并仅批准持久的公司内存。
+4. **从源头询问。**使用“询问”来提出应基于的问题
+   经过认可的知识，而不是原始聊天日志。
+
+对于公开演示，种子语料库演示了产品决策召回，
+引文链接、取代行为、评论门控、编辑、个人内容
+排除，以及在不连接真实工作空间的情况下诚实的未发现行为。
+
+### 有用的提示
+
+- “我们对年度定价做出了什么决定？在哪里讨论过？”
+- “查找最新的入职流程变更并引用来源。”
+- “总结一下 GitHub 讨论对于发布计划的意义。”
+- “审查待处理的内存提案并标记任何过于模糊而无法发布的内容。”
+- “哪些源已过时或同步失败？”
+
+## 对于开发者
+
+本文档的其余部分适用于任何分叉 Brain 模板或扩展它的人。
+
+### 快速入门
+
+```bash
+npx @agent-native/core@latest create my-brain --standalone --template brain
+cd my-brain
+pnpm install
+pnpm dev
+```
+
+打开应用程序并选择**开始演示**即可查看引用的内存，而无需连接真实的工作区。
+
+### 数据模型
+
+Brain 有意使用 SQL 文本搜索和代理查询扩展 - 有
+无需矢量数据库，因此模板可在 SQLite 之间保持可移植性，
+Postgres、Neon、D1、Turso 和类似主机。应用程序状态反映
+当前路线、过滤器和所选 ID，以便代理始终了解当前
+导航和选择。
+
+Brain 的模式位于 `templates/brain/server/db/schema.ts` 中。八张桌子：
+
+| 表                       | 它包含什么                                                                                                      |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------- |
+| `brain_sources`          | 连接器配置 - 提供商、允许列出的频道/存储库、同步光标、审核状态、`ingest_token_hash`、`status`、`last_synced_at` |
+| `brain_source_shares`    | 按来源共享授予（查看者/编辑者/管理员）                                                                          |
+| `brain_raw_captures`     | 带有 `external_id` 重复数据删除密钥、`content_hash`、种类和蒸馏状态的脚本、通道导出、注释和 Webhook 导入        |
+| `brain_knowledge`        | 精炼的原子条目 - 种类（决策/事实/过程/...）、主题、实体、证据引用、置信度、`publish_tier`、取代链接             |
+| `brain_knowledge_shares` | 按知识共享授予                                                                                                  |
+| `brain_proposals`        | 待审项目 - 建议创建/更新/存档并包含证据和审阅者注释                                                             |
+| `brain_proposal_shares`  | 每项提案的股份授予                                                                                              |
+| `brain_sync_runs`        | 同步审核日志 - 提供商、状态、统计信息 JSON、错误、开始/结束时间戳                                               |
+| `brain_ingest_queue`     | 后台蒸馏队列 - 操作、状态、优先级、重试计数、`run_after`                                                        |
+
+```an-schema title="Brain data model" summary="Connectors produce raw captures; distillation turns captures into reviewable knowledge; proposals gate sensitive entries. Sync runs and the ingest queue track background work."
+{
+  "entities": [
+    { "id": "sources", "name": "brain_sources", "note": "Connector config", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "provider", "type": "text", "note": "slack / granola / github / clips / webhook" },
+      { "name": "ingest_token_hash", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "last_synced_at", "type": "timestamp", "nullable": true }
+    ] },
+    { "id": "source_shares", "name": "brain_source_shares", "note": "viewer / editor / admin", "fields": [
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" }
+    ] },
+    { "id": "captures", "name": "brain_raw_captures", "note": "Ingested raw payloads", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" },
+      { "name": "external_id", "type": "text", "note": "dedupe key" },
+      { "name": "content_hash", "type": "text" },
+      { "name": "kind", "type": "text" }
+    ] },
+    { "id": "knowledge", "name": "brain_knowledge", "note": "Distilled atomic entries", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "kind", "type": "text", "note": "decision / fact / process" },
+      { "name": "topic", "type": "text" },
+      { "name": "entities", "type": "json" },
+      { "name": "confidence", "type": "real" },
+      { "name": "publish_tier", "type": "text" }
+    ] },
+    { "id": "knowledge_shares", "name": "brain_knowledge_shares", "fields": [
+      { "name": "knowledge_id", "type": "id", "fk": "brain_knowledge.id" }
+    ] },
+    { "id": "proposals", "name": "brain_proposals", "note": "Pending review items", "fields": [
+      { "name": "id", "type": "id", "pk": true },
+      { "name": "op", "type": "text", "note": "create / update / archive" }
+    ] },
+    { "id": "proposal_shares", "name": "brain_proposal_shares", "fields": [
+      { "name": "proposal_id", "type": "id", "fk": "brain_proposals.id" }
+    ] },
+    { "id": "sync_runs", "name": "brain_sync_runs", "note": "Sync audit log", "fields": [
+      { "name": "source_id", "type": "id", "fk": "brain_sources.id" },
+      { "name": "status", "type": "text" },
+      { "name": "stats", "type": "json" }
+    ] },
+    { "id": "ingest_queue", "name": "brain_ingest_queue", "note": "Background distillation queue", "fields": [
+      { "name": "operation", "type": "text" },
+      { "name": "status", "type": "text" },
+      { "name": "priority", "type": "int" },
+      { "name": "run_after", "type": "timestamp", "nullable": true }
+    ] }
+  ],
+  "relations": [
+    { "from": "sources", "to": "captures", "kind": "1-n", "label": "ingested into" },
+    { "from": "knowledge", "to": "captures", "kind": "n-n", "label": "evidence" },
+    { "from": "knowledge", "to": "proposals", "kind": "1-n", "label": "gated by" },
+    { "from": "sources", "to": "sync_runs", "kind": "1-n", "label": "audited by" }
+  ]
+}
+```
+
+### 密钥actions
+
+按区域分组（`templates/brain/actions/`）：
+
+- **源管理** — `create-source`、`update-source`、`delete-source`、`get-source`、`list-sources`、`sync-source`、`sync-due-sources`、`run-slack-pilot`、`test-slack-connection`
+- **捕获摄取** — `import-capture`、`import-transcript`、`list-captures`、`get-capture`、`mark-capture-distilled`、`resanitize-captures`
+- **蒸馏** — `enqueue-distillation`、`enqueue-captures-distillation`、`claim-distillation`、`retry-distillation`、`list-distillation-queue`
+- **知识与复习** — `write-knowledge`、`get-knowledge`、`list-knowledge`、`set-knowledge-canonical`、`preview-canonical-resource`、`list-proposals`、`review-proposal`、`approve-proposal`、`reject-proposal`、`update-proposal`
+- **搜索和检索** — `ask-brain`、`search-knowledge`、`search-everything`
+- **设置** — `get-brain-settings`、`update-brain-settings`、`set-settings`、`get-settings`
+- **评估和演示** — `seed-demo-data`、`run-demo-eval`、`run-retrieval-eval`
+- **上下文和导航** — `view-screen`、`navigate`
+- **提供商 APIs** — `provider-api-catalog`、`provider-api-docs`、`provider-api-request`
+
+### 连接源
+
+Brain 首先从授予的工作区连接解析提供者凭据，
+然后来自向后兼容的 Brain-local 或注册的保管库凭证。
+Brain 源凭证不会回退到部署级别环境变量。
+如果共享提供程序已存在，请授予 Brain 访问权限，而不是复制
+在特定于大脑的设置中使用相同的秘密。
+
+**Slack.** 创建范围为特定通道 ID 的源。连接器
+验证每个配置的对话，拒绝 DM 和 MPIM，并存储光标
+状态，以便每次同步都从上次停止的位置恢复。安全的推出流程
+每个 Slack 源卡都可以让您**测试**凭证和允许列表，而无需
+阅读历史记录，运行一个小上限的**安全试点**示例，**查看捕获**，
+并在任何内容变得可查询之前在**审核队列**中进行批准。授予
+机器人仅处理源需要的范围（凭据验证、允许列表
+验证、允许列出的频道历史记录和持久的永久链接）。
+
+**格兰诺拉麦片。** 创建具有轮询窗口和页面大小的源。格兰诺拉麦片
+企业 API 密钥公开团队空间笔记，而不是私人笔记或文件夹。大脑
+存储笔记摘要、文字记录、与会者、日历元数据和来源
+URL 作为蒸馏前的原始捕获物。
+
+**GitHub.** 创建范围为已批准的存储库的源。连接器
+使用稳定的源 URL 导入有界问题和拉取请求上下文，可以
+像 Slack 或会议上下文一样进行提炼。这是大脑上下文摄取，而不是
+Analytics 风格的 GitHub 报告的替代品。
+
+**Clips 和通用 webhooks。** Brain 公开了 Clips 的签名 Webhook 和
+`/api/_agent-native/brain/ingest` 的通用转录本/捕获导入。创建
+具有 `sourceKey` 的源接收不记名令牌，然后发送
+`RawCapturePayload` 与 `Authorization: Bearer <ingestToken>`。通用来源
+对通话记录、客户研究、导入使用相同的有效负载形状
+注释，或任何其他可以生成有界捕获的来源。
+
+```an-api title="Signed ingest webhook" summary="Clips and generic transcript/capture imports post a RawCapturePayload with a per-source bearer token."
+{
+  "method": "POST",
+  "path": "/api/_agent-native/brain/ingest",
+  "summary": "Import a raw capture from Clips or a generic source",
+  "auth": "Bearer <ingestToken> issued per source via its sourceKey",
+  "request": {
+    "contentType": "application/json",
+    "example": "RawCapturePayload — bounded transcript / capture body"
+  },
+  "responses": [
+    { "status": "200", "description": "Capture accepted and queued for distillation" },
+    { "status": "401", "description": "Missing or invalid ingest bearer token" }
+  ]
+}
+```
+
+Slack、Granola 和 GitHub 源可以选择进入后台 `autoSync`
+审核质量得到证实后进行投票。
+
+### 隐私和门控
+
+大脑是为公司记忆而设计的，而不是个人监视：
+
+- Slack 同步仅读取显式配置的通道并拒绝 DM/MPIM。
+- Granola 同步读取 Granola 的 API 公开的团队空间笔记，非私有
+  笔记或私人文件夹。
+- 默认情况下，原始捕获是从列表/搜索界面中编辑的；审稿人
+  并且蒸馏流程仅在需要时请求预览或原始内容。
+- 源配置可能需要在提炼的知识变得持久之前进行审查
+  公司内存。
+- 设置控制默认发布层，公司层知识是否需要
+  批准、引用要求、电子邮件编辑和连接器错误
+  通知。
+
+### 自定义它
+
+大脑遵循代理原生四区域契约——通过编辑改变行为
+匹配区域，客服人员可以为您进行以下编辑：
+
+- `templates/brain/app/routes/` — UI 表面：提问、搜索、知识，
+  查看、来源、设置和团队路线。
+- `templates/brain/actions/` — 每个代理可调用的操作（导入、源
+  管理、试点报告、提炼、提案审查、引用检索，
+  导航/上下文）。使用 `defineAction` 添加新文件以公开新的
+  能力。
+- `templates/brain/.agents/skills/` — 针对大脑的蒸馏指导
+  和检索。当您向客服人员传授新的工作流程时更新或添加技能。
+- `templates/brain/AGENTS.md` — 顶级代理指南。添加专业时更新
+  功能。
+- `templates/brain/server/db/schema.ts` — 数据模型。仅附加迁移；
+  路由、过滤器和选定的 ID 镜像到代理的 `application_state`
+  上下文。
+
+要求代理为您进行更改 - 它可以编辑自己的源。请参阅
+[Self-Modifying Code](/docs/key-concepts#agent-modifies-code).
+
+## 下一步是什么
+
+- [**Dispatch**](/docs/dispatch) — 工作区控制平面
+- [**Dispatch template**](/docs/template-dispatch) — 脚手架协调应用
+- [**Workspace**](/docs/workspace) — 跨应用共享资源
+- [**A2A Protocol**](/docs/a2a-protocol) — 跨应用委托

package/docs/content/locales/zh-CN/template-calendar.md

@@ -0,0 +1,194 @@
+---
+title: "日历"
+description: "由代理支持的日历，具有 Google Calendar 同步和 Calendly 风格的预订链接。通过简单的英语安排、查找时段并管理可用性。"
+---
+
+# 日历
+
+代理驱动的日历应用程序。连接您的 Google Calendar，客服人员就可以读取您的日程安排、查找空闲时段、创建活动并管理 Calendly 风格的预订链接 - 全部采用简单的英语。它用您拥有的一个应用程序取代了 Google Calendar + Calendly 组合。
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:530px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 18px;border-bottom:1.4px solid var(--wf-line)'><button>Week</button><button>Today</button><button>‹</button><button>›</button><div style='flex:1'></div><strong>May 3-9, 2026</strong><div style='flex:1'></div><button class='primary'>New Event</button></div><div style='display:grid;grid-template-columns:56px repeat(7,minmax(0,1fr));grid-template-rows:36px repeat(5,72px);gap:7px;padding:14px;flex:1'><div></div><strong>Sun 3</strong><strong>Mon 4</strong><strong>Tue 5</strong><strong>Wed 6</strong><strong>Thu 7</strong><strong>Fri 8</strong><strong>Sat 9</strong><small class='wf-muted'>7 AM</small><div class='wf-box' style='opacity:.45'></div><div></div><div></div><div></div><div></div><div></div><div></div><small class='wf-muted'>9 AM</small><div class='wf-box'>All-hands</div><div class='wf-box'>Eng standup</div><div class='wf-box'>Eng standup</div><div class='wf-box'>Eng standup</div><div></div><div class='wf-box'>Planning</div><div></div><small class='wf-muted'>11 AM</small><div class='wf-box'>Design review</div><div></div><div class='wf-box'>Design crit</div><div class='wf-box'>Roadmap</div><div class='wf-box'>Friday demo</div><div></div><div></div><small class='wf-muted'>1 PM</small><div></div><div class='wf-box'>1:1</div><div class='wf-box'>Focus block</div><div></div><div></div><div class='wf-box'>All-hands</div><div></div><small class='wf-muted'>3 PM</small><div></div><div></div><div></div><div class='wf-box'>Skip-level</div><div></div><div></div><div></div></div></div>"
+}
+```
+
+当您打开应用程序时，活动日历视图是主表面。客服人员仍然知道您正在查看哪一天、哪一周或哪一天的活动，因此您可以说“安排在这一天与 Alex 进行 30 分钟的通话”，而无需说明所有内容。
+
+```an-diagram title="How a scheduling request flows" summary="Whether you click in the calendar or ask the agent, the same actions read live from Google Calendar and write back to the same view."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">You click<br><small class=\"diagram-muted\">drag, toolbar, shortcuts</small></div><div class=\"diagram-node\">You ask the agent<br><small class=\"diagram-muted\">\"find a 1-hour slot next week\"</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">list-events · check-availability · create-event</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Google Calendar<br><small class=\"diagram-muted\">live, multi-account</small></div><div class=\"diagram-box\">SQL<br><small class=\"diagram-muted\">bookings · availability</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">Calendar view updates live</div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## 你可以用它做什么
+
+- **在日、周或月视图中查看您真实的 Google Calendar**，并叠加多个帐户。
+- **订阅 ICS 源**（HR 休息时间、会议安排、团队日历）- 只读，混合到同一视图中。
+- **通过时区支持设置每周可用性** - 代理在查找空闲时段时使用此功能。
+- **在 `/book/{slug}` 上创建公共预订链接**，用于“15 分钟介绍”或“30 分钟演示”等内容。配置持续时间、自定义字段以及要使用的会议工具。
+- **向工作人员询问任何与日程相关的事情**：“周四下午我有空吗？” “下周找一个 1 小时的时段，并在上面加上‘与 Alex 一起制定计划’。” “暂停我的演示预订链接。”
+- **与队友分享预订链接**，以便他们也可以管理它们。
+
+## 开始使用
+
+现场演示：[calendar.agent-native.com](https://calendar.agent-native.com)。
+
+首次打开应用程序时：
+
+1. 点击“**设置**”。
+2. 点击 **连接 Google Calendar** 并批准。
+3. （可选）如果您想要叠加个人 + 工作，请连接更多 Google 帐户。
+4. 打开主视图 - 将加载您的真实日历。
+
+要创建您的第一个预订链接：
+
+1. 点击侧边栏中的**预订链接**。
+2. 点击**新预订链接**，设置标题和持续时间。
+3. 分享公开的 URL - 访问者从您的可用插槽中进行选择。
+
+或者直接询问客服人员：“创建一个带有姓名字段的 15 分钟介绍预订链接。”
+
+### 有用的提示
+
+- “今天我的日历上有什么？”
+- “周四下午我有空 30 分钟吗？”
+- “下周找一个 1 小时的时段，并添加“与 Alex 一起制定计划”。”
+- “将此活动重新安排到周五下午 2 点。” （选择事件时）
+- “切换到日视图并跳转到下周一。”
+- “在 15 分钟时创建一个名为“15 分钟介绍”的预订链接，并带有注释字段。”
+- “暂停我的‘30 分钟演示’预订链接。”
+- “周五下午我有空。”
+- “本月我有哪些关于‘发布’的会议？”
+
+代理将实时查询 Google Calendar 的任何时间表问题 - 它永远不会猜测。
+
+## 对于开发者
+
+本文档的其余部分适用于任何派生日历模板或扩展它的人。
+
+### 快速入门
+
+使用日历模板创建新工作区：
+
+```bash
+npx @agent-native/core@latest create my-app --standalone --template calendar
+cd my-app
+pnpm install
+pnpm dev
+```
+
+打开 `http://localhost:8082`（默认日历开发端口）。
+
+要在开发中连接 Google Calendar，请打开“设置”视图，粘贴 [Google Cloud Console](https://console.cloud.google.com/) 中的 `GOOGLE_CLIENT_ID` 和 `GOOGLE_CLIENT_SECRET`，然后单击“连接 Google Calendar”。 OAuth 重定向 URI 在开发中是 `http://localhost:8082/_agent-native/google/callback`。令牌存储在`oauth_tokens` SQL表中并自动刷新。
+
+### 主要功能
+
+**实时日历视图。**日、周和月视图直接从连接的 Google 帐户读取，可选的只读 ICS Feed 分层到同一时间表中。
+
+**可用性和空闲时段搜索。**每周可用性规则、时区支持和现有事件都提供 UI 和代理使用的相同可用性操作。
+
+**预订链接。**公共 `/book/{slug}` 页面收集姓名、电子邮件、自定义字段、会议首选项和取消/重新安排令牌。
+
+**可共享管理。**预订链接默认是私有的，但可以通过共享actions的框架与团队成员共享。
+
+**内嵌活动预览。**客服人员可以在聊天中嵌入紧凑的活动卡，其中包含标题、时间、地点、与会者和跳回按钮。
+
+### 与代理合作
+
+代理看到您正在查看的内容。当前日历视图、所选日期和所选事件作为 `current-screen` 块包含在每条消息中，因此您可以说“此事件”或“今天”，它会正确解析。
+
+在幕后，代理会调用 actions，如 `list-events`、`check-availability`、`create-event`、`navigate` 和 `update-availability`。由于事件存在于 Google Calendar 中，因此代理始终查询 API 而不是猜测 - 如果不先运行脚本，它不会返回空结果。
+
+### 数据模型
+
+在`templates/calendar/server/db/schema.ts`中定义。仅非事件数据存储在本地：
+
+- `bookings` — 从公共预订页面确认的预约。存储姓名、电子邮件、开始、结束、副标题、可选注释、自定义字段响应、会议链接、用于公共管理的 `cancelToken` URL 以及 `confirmed` 或 `cancelled` 状态。
+- `booking_links` — Calendly 样式链接定义。 Slug、标题、描述、主要 `duration`、可选 `durations` 列表、`customFields`、`conferencing`、`color` 和 `isActive` 标志。使用框架的`ownableColumns`，因此适用共享系统。
+- `booking_slug_redirects` - 重命名链接时会记住旧的 slugs，以便现有的公共 URL 继续工作。
+- `booking_link_shares` — 分享预订链接的赠款。
+
+```an-schema title="Calendar data model" summary="Only non-event data is stored locally — events live in Google Calendar. Booking links use ownableColumns so the sharing system applies."
+{
+  "entities": [
+    {
+      "id": "booking_links",
+      "name": "booking_links",
+      "note": "Calendly-style link definitions (ownable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "slug", "type": "string", "note": "public page at /book/{slug}" },
+        { "name": "title", "type": "string" },
+        { "name": "description", "type": "string", "nullable": true },
+        { "name": "duration", "type": "int", "note": "primary duration in minutes" },
+        { "name": "durations", "type": "json", "nullable": true, "note": "alternative durations" },
+        { "name": "customFields", "type": "json", "nullable": true },
+        { "name": "conferencing", "type": "string", "note": "Google Meet / Zoom / custom" },
+        { "name": "color", "type": "string", "nullable": true },
+        { "name": "isActive", "type": "bool", "note": "pause without deleting" }
+      ]
+    },
+    {
+      "id": "bookings",
+      "name": "bookings",
+      "note": "Confirmed appointments from public booking pages",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "slug", "type": "string", "fk": "booking_links.slug" },
+        { "name": "name", "type": "string" },
+        { "name": "email", "type": "string" },
+        { "name": "start", "type": "datetime" },
+        { "name": "end", "type": "datetime" },
+        { "name": "notes", "type": "string", "nullable": true },
+        { "name": "customFields", "type": "json", "nullable": true, "note": "custom field responses" },
+        { "name": "meetingLink", "type": "string", "nullable": true },
+        { "name": "cancelToken", "type": "string", "note": "powers /booking/manage/{token}" },
+        { "name": "status", "type": "enum", "note": "confirmed | cancelled" }
+      ]
+    },
+    {
+      "id": "booking_slug_redirects",
+      "name": "booking_slug_redirects",
+      "note": "Keeps old public URLs working after a link is renamed",
+      "fields": [
+        { "name": "oldSlug", "type": "string", "pk": true },
+        { "name": "linkId", "type": "id", "fk": "booking_links.id" }
+      ]
+    },
+    {
+      "id": "booking_link_shares",
+      "name": "booking_link_shares",
+      "note": "Share grants for booking links",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "linkId", "type": "id", "fk": "booking_links.id" },
+        { "name": "principal", "type": "string", "note": "user or org" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "booking_links", "to": "bookings", "kind": "1-n", "label": "has bookings" },
+    { "from": "booking_links", "to": "booking_slug_redirects", "kind": "1-n", "label": "has old slugs" },
+    { "from": "booking_links", "to": "booking_link_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+可用性规则和每用户配置位于设置表中，由 `calendar-availability` 键入。 Google OAuth 代币位于框架 `oauth_tokens` 表中。临时 UI 状态（当前视图、日期、选定事件）位于 `navigation` 键下的 `application_state` 中。
+
+### 自定义
+
+应用程序的每个部分都是可编辑的源代码。从这里开始：
+
+- `templates/calendar/actions/` — 每个代理可调用的操作。添加包含 `defineAction` 的新文件，以向代理和前端公开新功能。关键文件：`check-availability.ts`、`create-event.ts`、`list-events.ts`、`create-booking-link.ts`、`update-availability.ts`、`add-external-calendar.ts`、`navigate.ts`、`view-screen.ts`。
+- `templates/calendar/app/routes/` — UI。 `_app._index.tsx`是日历，`_app.availability.tsx`是日程编辑器，`_app.booking-links._index.tsx`和`_app.booking-links.$id.tsx`管理预订链接，`_app.bookings.tsx`列出预订，`_app.settings.tsx`是设置，`book.$slug.tsx`加`meet.$username.$slug.tsx`是公共预订页面。
+- `templates/calendar/server/db/schema.ts` — 添加带有 Drizzle 的列或表。保持代码与方言无关，以便模板在 SQLite、Postgres、Turso、D1 和 Neon 上运行。
+- `templates/calendar/AGENTS.md` — 代理指令。当您向代理教授新功能或约定时更新此内容。
+- `templates/calendar/.agents/skills/` — 代理遵循的详细模式。相关skills：`event-management`、`availability-booking`、`real-time-sync`、`storing-data`、`delegate-to-agent`、`frontend-design`。
+- `templates/calendar/shared/api.ts` — 服务器和客户端使用的共享 TypeScript 类型（`AvailabilityConfig`、`BookingLink`、`ExternalCalendar` 等）。
+
+如果您添加功能，请记住更新所有四个区域：UI、操作、技能或 AGENTS.md 条目，以及代理需要查看的任何应用程序状态。这就是使代理和 UI 保持平等的原因。