create-windy 0.6.7 → 0.6.8

package/README.md

@@ -137,7 +137,7 @@ bun run windy update --dry-run
 bun run windy update
 ```
 
-`0.3.17` 是 Starter 更新的最低支持基线。更新器不检查 Git 工作区是否干净：只规划
+`0.6.6` 是 Starter 更新的最低支持基线。更新器不检查 Git 工作区是否干净：只规划
 目标版本实际变更的受管文件，从 source Project Lock 指向的精确 npm artifact 重建
 Base，并以 Base/Ours/Theirs 合并共享脚手架。未触及的业务修改不会进入更新判断；
 `package.json` 使用字段级合并；已发布 migration 只允许追加；冲突发生时不写项目，
@@ -146,7 +146,7 @@ Base，并以 Base/Ours/Theirs 合并共享脚手架。未触及的业务修改
 
 受管清单使用 schema v4：`hash` 冻结下游实际正文，`artifactHash` 在两者不同时记录
 公开模板基线；无正文的 missing tombstone 记住客户删除的 `project-owned` 路径。
-低于 `0.3.17` 的 Project Lock、旧清单 schema、损坏的 artifact lineage 或 recipe
+低于 `0.6.6` 的 Project Lock、旧清单 schema、损坏的 artifact lineage 或 recipe
 缺口都会在写文件前 fail closed，不提供旧状态的自动迁移路径。
 
 生成后的整个 `apps/web/src` 与整个 `apps/server/src/app` 都是 project-owned。普通

package/dist/cli.js

@@ -7716,82 +7716,17 @@ async function diagnoseProject(projectDirectory, repair = false) {
 }
 
 // src/update/recipes.ts
-var minimumSupportedUpdateVersion = "0.3.17";
+var minimumSupportedUpdateVersion = "0.6.6";
 var recipes = [
-  {
-    id: "starter-0.3.17-to-0.3.18",
-    from: "0.3.17",
-    to: "0.3.18"
-  },
-  {
-    id: "starter-0.3.18-to-0.3.19",
-    from: "0.3.18",
-    to: "0.3.19"
-  },
-  {
-    id: "starter-0.3.19-to-0.4.0",
-    from: "0.3.19",
-    to: "0.4.0"
-  },
-  {
-    id: "starter-0.4.0-to-0.4.1",
-    from: "0.4.0",
-    to: "0.4.1"
-  },
-  {
-    id: "starter-0.4.1-to-0.5.0",
-    from: "0.4.1",
-    to: "0.5.0"
-  },
-  {
-    id: "starter-0.5.0-to-0.5.1",
-    from: "0.5.0",
-    to: "0.5.1"
-  },
-  {
-    id: "starter-0.5.1-to-0.5.2",
-    from: "0.5.1",
-    to: "0.5.2"
-  },
-  {
-    id: "starter-0.5.2-to-0.6.0",
-    from: "0.5.2",
-    to: "0.6.0"
-  },
-  {
-    id: "starter-0.6.0-to-0.6.1",
-    from: "0.6.0",
-    to: "0.6.1"
-  },
-  {
-    id: "starter-0.6.1-to-0.6.2",
-    from: "0.6.1",
-    to: "0.6.2"
-  },
-  {
-    id: "starter-0.6.2-to-0.6.3",
-    from: "0.6.2",
-    to: "0.6.3"
-  },
-  {
-    id: "starter-0.6.3-to-0.6.4",
-    from: "0.6.3",
-    to: "0.6.4"
-  },
-  {
-    id: "starter-0.6.4-to-0.6.5",
-    from: "0.6.4",
-    to: "0.6.5"
-  },
-  {
-    id: "starter-0.6.5-to-0.6.6",
-    from: "0.6.5",
-    to: "0.6.6"
-  },
   {
     id: "starter-0.6.6-to-0.6.7",
     from: "0.6.6",
     to: "0.6.7"
+  },
+  {
+    id: "starter-0.6.7-to-0.6.8",
+    from: "0.6.7",
+    to: "0.6.8"
   }
 ];
 function resolveRecipeChain(sourceVersion, targetVersion) {
@@ -8246,7 +8181,7 @@ async function deriveDockerfilePlans(files, snapshots, paths, targetWorkspaceMan
       continue;
     const source = new TextDecoder().decode(dockerSource);
     if (!hasDockerfileCopyAnchors(source, target)) {
-      dockerPlan.conflict = "Dockerfile \u7F3A\u5C11 0.3.17 \u57FA\u7EBF\u7684 COPY \u951A\u70B9\uFF0C\u5DF2\u505C\u6B62\u81EA\u52A8\u8FC1\u79FB\u65E7\u683C\u5F0F";
+      dockerPlan.conflict = "Dockerfile \u7F3A\u5C11 0.6.6 \u57FA\u7EBF\u7684 COPY \u951A\u70B9\uFF0C\u5DF2\u505C\u6B62\u81EA\u52A8\u8FC1\u79FB\u65E7\u683C\u5F0F";
       continue;
     }
     let next;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-windy",
-  "version": "0.6.7",
+  "version": "0.6.8",
   "description": "创建单组织、单租户、私有部署优先的 Windy 企业 Dashboard Starter",
   "type": "module",
   "bin": {

package/template/.windy-template.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "templateCommit": "dcc27b44de561eb3b4e6f9aea7869ba0f4299a62",
-  "generatorVersion": "0.6.7",
+  "templateCommit": "47527e1bb3a2848bbb7d27eef7132c83b81d714d",
+  "generatorVersion": "0.6.8",
   "modules": [
     {
       "name": "system",

package/template/apps/agent-server/README.md

@@ -1,6 +1,6 @@
-# Southwind AI Agent Server
+# Windy Agent Server
 
-Python 3.12 Agent 运行时。HTTP 层只公开 Southwind AI 的 canonical Agent 契约；真实业务
+Python 3.12 Agent 运行时。HTTP 层只公开 Windy 的 canonical Agent 契约；真实业务
 Run 在内部通过 Google ADK 2.5 的 Runner、Session、LlmAgent 和 Event 执行，ADK 类型不会
 越过 `AgentEngineAdapter`。模型调用继续复用受治理的 OpenAI-compatible
 `/chat/completions` Provider。
@@ -64,12 +64,12 @@ HTTP。Provider 请求包含连接和总超时、响应大小限制、错误脱
 readiness。缺少 URL/Model 时回退
 未配置的 `AdkEngineAdapter` 并返回 unavailable，不调用模型。测试另使用
 `DeterministicEngineAdapter`。每个 ADK Tool 只声明 Operation 已允许的 Key；其执行
-函数只回调 Southwind AI Tool Host，并携带当前 Run 的 opaque Execution Grant。
+函数只回调 Windy Tool Host，并携带当前 Run 的 opaque Execution Grant。
 
 未设置 `AGENT_RUN_STORE_PATH` 时使用的 `InMemoryRunStore` **仅用于 deterministic
 测试**。配置路径后使用有界 SQLite Store，可在单副本重启后保留 Run/Event/Result 和
 cursor；多副本部署仍必须替换为共享 Store。Execution Grant 与 Tool 授权由
-Southwind AI Server 签发和复核，Agent Server 不能自行扩大 Operation 的
+Windy Server 签发和复核，Agent Server 不能自行扩大 Operation 的
 `allowedToolKeys`。
 
 每次实际 `/chat/completions` HTTP 调用前，Runtime 会对 Manifest 允许的输入 JSON

package/template/apps/server/src/data-access/drizzle-predicate.ts

@@ -3,12 +3,16 @@ import type { DataScopeQuerySpecification } from "./query-specification.js";
 
 export class DataScopeBindingError extends Error {}
 
+export interface DrizzleDataScopeColumn {
+  getSQL(): unknown;
+}
+
 export interface DrizzleDataScopeBinding {
-  readonly ownerId?: AnyColumn;
+  readonly ownerId?: DrizzleDataScopeColumn;
   readonly tenant?:
-    | { readonly mode: "column"; readonly column: AnyColumn }
+    | { readonly mode: "column"; readonly column: DrizzleDataScopeColumn }
     | { readonly mode: "fixed"; readonly tenantId: string };
-  readonly dimensions?: Readonly<Record<string, AnyColumn>>;
+  readonly dimensions?: Readonly<Record<string, DrizzleDataScopeColumn>>;
 }
 
 export function compileDrizzleDataScopePredicate(
@@ -28,13 +32,13 @@ export function compileDrizzleDataScopePredicate(
         if (tenant.tenantId === branch.tenantId) return undefined;
         continue;
       }
-      predicates.push(eq(tenant.column, branch.tenantId));
+      predicates.push(eq(drizzleColumn(tenant.column), branch.tenantId));
     }
     if (branch.kind === "owner") {
       if (!binding.ownerId) {
         throw new DataScopeBindingError("scope binding missing ownerId");
       }
-      predicates.push(eq(binding.ownerId, branch.ownerId));
+      predicates.push(eq(drizzleColumn(binding.ownerId), branch.ownerId));
     }
     if (branch.kind === "dimension") {
       const column = binding.dimensions?.[branch.dimension];
@@ -43,8 +47,14 @@ export function compileDrizzleDataScopePredicate(
           `scope binding missing dimension: ${branch.dimension}`,
         );
       }
-      if (branch.values.length) predicates.push(inArray(column, branch.values));
+      if (branch.values.length) {
+        predicates.push(inArray(drizzleColumn(column), branch.values));
+      }
     }
   }
   return or(...predicates) || sql<boolean>`false`;
 }
+
+function drizzleColumn(column: DrizzleDataScopeColumn): AnyColumn {
+  return column as unknown as AnyColumn;
+}

package/template/docs/architecture/ai-egress.md

@@ -72,7 +72,7 @@ OpenAI-compatible Adapter 只使用 Agent Server 启动配置的一个 Endpoint
 配置还必须通过 `AI_PROVIDER_HTTPS_HOST_ALLOWLIST` 的精确 Host 匹配；不支持通配符、
 scheme、port 或重复 Host。内网 HTTP 继续受既有私有地址校验约束。
 
-Southwind AI Server 向 Agent Server 只发送 Operation 的 policy mode 与 Deployment
+Windy Server 向 Agent Server 只发送 Operation 的 policy mode 与 Deployment
 Key。Agent Server 在发出模型请求前核对：
 
 1. policy 必须是 `configured-endpoint`；

package/template/docs/architecture/ai-runtime-readiness.md

@@ -12,7 +12,7 @@ deployment pin 和真实 `/health/ready` snapshot 投影新版 Operation；未
 
 ## 目标
 
-AI Runtime Readiness V1 为 Southwind Server、Module Operation Host 和各独立
+AI Runtime Readiness V1 为 Windy Server、Module Operation Host 和各独立
 Runtime 提供同一套失败关闭契约。它回答的是：
 
 > 当前这个 Operation 能否在一个已经过真实探测、身份和 release 均未漂移的
@@ -440,7 +440,7 @@ Readiness 不替代以下权威检查：
 - Provider egress、DLP 和 Tool network policy；
 - Run 幂等、取消、审计和输出校验。
 
-这些 Guard 仍由 Southwind Server 在每次执行的相应阶段重新检查。对未授权调用方，
+这些 Guard 仍由 Windy Server 在每次执行的相应阶段重新检查。对未授权调用方，
 Host 不应通过 readiness 暴露跨模块或跨租户的 Deployment 细节。
 
 Readiness 也不是 GPU、CPU、显存、队列或并发槽位的资源预留。resource limits 描述该

package/template/docs/architecture/ai-runtime.md

@@ -1,4 +1,4 @@
-# Southwind AI Runtime 架构
+# Windy AI Runtime 架构
 
 更新时间：2026-07-31。
 
@@ -18,7 +18,7 @@ Vision 已提供 `agent.vision` 的多图片受控输入、像素限制、逐次
 
 ## 目标
 
-Southwind AI 为生成项目提供可选的 AI Runtime。它统一治理模型 Deployment、业务 Operation、Feature Flag、RBAC Permission、License、Audit、Secret、用量和离线部署，但不自行重做通用 Agent Framework、LLM Router、OCR 引擎或语音模型。
+Windy 为生成项目提供可选的 AI Runtime。它统一治理模型 Deployment、业务 Operation、Feature Flag、RBAC Permission、License、Audit、Secret、用量和离线部署，但不自行重做通用 Agent Framework、LLM Router、OCR 引擎或语音模型。
 
 首期目标：
 
@@ -34,14 +34,14 @@ Southwind AI 为生成项目提供可选的 AI Runtime。它统一治理模型 D
 
 ## 核心决策
 
-1. Agent Runtime 是 Southwind AI 的官方可选底座能力，不是每个业务 Module 自行实现的功能。
+1. Agent Runtime 是 Windy 的官方可选底座能力，不是每个业务 Module 自行实现的功能。
 2. Agent Server 独立部署，首期使用 Python ADK；ADK 只属于内部 Implementation。
 3. 首个文本切片由 Agent Server 内置 OpenAI-compatible Adapter；需要多 Provider
    路由、fallback 与集中限流时，再引入独立自托管 LiteLLM Proxy。
 4. OCR 和文档解析由独立 Document AI Server 执行，不放入 Agent Server 或 LiteLLM。
 5. ASR、TTS 和 AI Dictation 由独立 Speech Server 执行；实时 Agent 会话由 Agent Server 编排。
 6. 文本 LLM、VLM 和 Agent 输出使用 SSE；实时音频/视频需要双向传输，使用 WebSocket。
-7. Southwind AI Server 是身份、Feature、Permission、License、数据范围、Tool 授权和 Audit 的事实源。
+7. Windy Server 是身份、Feature、Permission、License、数据范围、Tool 授权和 Audit 的事实源。
 8. 所有业务文件通过 `ArtifactRef` 传递，不在跨服务 DTO 中携带大型 Base64 文件或本地绝对路径。
 
 ## 总体拓扑
@@ -51,7 +51,7 @@ Southwind AI 为生成项目提供可选的 AI Runtime。它统一治理模型 D
         │
         │ AgentOperation / DocumentOperation / SpeechOperation
         ▼
-Southwind AI Server
+Windy Server
         ├── Feature / RBAC / License / Audit / Data Scope
         ├── AI Deployment Registry
         ├── Agent Tool Host
@@ -81,7 +81,7 @@ Southwind AI Server
 
 ## Module 与部署职责
 
-### Southwind AI Server
+### Windy Server
 
 拥有：
 
@@ -109,12 +109,12 @@ Southwind AI Server
 - ADK Runner、Workflow、Session、Checkpoint、Eval；
 - Agent、Workflow 和 Prompt Release；
 - Run 生命周期、取消、恢复和 canonical event；
-- ADK Event 到 Southwind AI Event 的转换；
+- ADK Event 到 Windy Event 的转换；
 - Agent Step、Prompt Version、Tool Call 和模型 attempt 的关联；
 - 开发环境 ADK Web；
 - 实时 Agent 会话编排。
 
-Agent Server 不直接访问业务 Repository。模型产生 Tool Call 只表示执行意图；每次真实 Tool 执行都必须回到 Southwind AI Tool Host，重新检查当前 Feature、License、Permission 和数据范围。
+Agent Server 不直接访问业务 Repository。模型产生 Tool Call 只表示执行意图；每次真实 Tool 执行都必须回到 Windy Tool Host，重新检查当前 Feature、License、Permission 和数据范围。
 
 ### LiteLLM Proxy
 
@@ -187,7 +187,7 @@ credential 删除 scope，缺少 credential 时如实保留 Host TTL cleanup pen
 Document、Speech 与 Embedding Interface 已分别由 `./document`、`./speech`、
 `./embedding` 子路径交付。
 
-npm Module 数量与部署进程数量是两个不同维度。Southwind Server、Agent Server、
+npm Module 数量与部署进程数量是两个不同维度。Windy Server、Agent Server、
 Document AI Server 和 Speech Server 仍独立部署：它们具有不同的协议、资源和故障域；
 业务侧则只学习一个稳定入口。`ai-client` 内部通过 Agent、Document、Speech Adapter
 隔离远端 Implementation，不能把 ADK、LiteLLM、PaddleOCR 或 Provider SDK 类型暴露给业务。
@@ -379,7 +379,7 @@ Endpoint 配置属于高风险管理动作，必须具备独立 Permission 和
 
 SSE 是单向 Server-to-Client 协议。创建、取消、审批、恢复和 Tool continuation 使用独立 HTTP command，不在 SSE 连接中反向发送。
 
-Southwind AI Server 与 Agent Server 之间使用本节定义的 canonical SSE；Agent Server 调用 LiteLLM 的文本 LLM/VLM 时使用 OpenAI-compatible SSE streaming。Provider 专有流协议在 LiteLLM Adapter 内终止，不能越过该 Seam。VLM 的图片或视频作为请求 Artifact 发送，模型的文本与结构化响应仍通过 SSE 返回。
+Windy Server 与 Agent Server 之间使用本节定义的 canonical SSE；Agent Server 调用 LiteLLM 的文本 LLM/VLM 时使用 OpenAI-compatible SSE streaming。Provider 专有流协议在 LiteLLM Adapter 内终止，不能越过该 Seam。VLM 的图片或视频作为请求 Artifact 发送，模型的文本与结构化响应仍通过 SSE 返回。
 
 实时语音和视频需要客户端与服务端同时发送媒体帧，因此使用 WebSocket，不属于本节 SSE 约束。
 
@@ -663,7 +663,7 @@ type DictationEvent =
 - 级联：ASR → ADK Agent/LLM → TTS；
 - 原生双向模型：音频/视频 ⇄ Realtime Model。
 
-客户端先向 Southwind AI Server 创建 Live Session 并通过 Guard，再使用短时、绑定 Session 和 audience 的凭证连接 Agent Server WebSocket。Tool Call 仍回到 Southwind AI Tool Host 二次授权。
+客户端先向 Windy Server 创建 Live Session 并通过 Guard，再使用短时、绑定 Session 和 audience 的凭证连接 Agent Server WebSocket。Tool Call 仍回到 Windy Tool Host 二次授权。
 
 首期不新增独立 Realtime Server。连接规模、电话线路、WebRTC 或媒体转码成为真实需求后，再把媒体数据面拆出。
 
@@ -703,7 +703,7 @@ published version 不可原地修改。每次 Run 固定：
 
 首期优先使用代码或 YAML、Git、Eval 和不可变 Release。只有出现非开发人员在线编辑的真实需求后，再扩展 diff、审批、回滚、fixture、route 对比和发布管理。
 
-生产 Trace 优先输出到客户本地 OTel Collector 与 Jaeger/Tempo。Southwind AI 控制面提供脱敏 Run 摘要和受权限保护的 Trace 入口，不复制 ADK Web。
+生产 Trace 优先输出到客户本地 OTel Collector 与 Jaeger/Tempo。Windy 控制面提供脱敏 Run 摘要和受权限保护的 Trace 入口，不复制 ADK Web。
 
 生产默认不持久化完整 Prompt、响应、音频、图片或 Tool 参数。明文诊断需要专门 Feature、Permission、加密、脱敏、TTL 和访问审计。
 
@@ -720,12 +720,12 @@ published version 不可原地修改。每次 Run 固定：
 | TTS  | 输入字符数、输出音频秒数、GPU 时间                    |
 | Live | Session 时长、输入/输出音频秒数、LLM token、Tool 次数 |
 
-每条事实标记 `provider-reported`、`estimated` 或 `unknown`；缺失不能记为零。成本绑定调用时的价格快照。LiteLLM 保存 Provider/Deployment 原始事实，Agent Server 保存 Run/Step 归属，Document AI 和 Speech Server 保存各自模态事实，Southwind AI 通过共享 invocation ID 汇总展示。
+每条事实标记 `provider-reported`、`estimated` 或 `unknown`；缺失不能记为零。成本绑定调用时的价格快照。LiteLLM 保存 Provider/Deployment 原始事实，Agent Server 保存 Run/Step 归属，Document AI 和 Speech Server 保存各自模态事实，Windy 通过共享 invocation ID 汇总展示。
 
 ## 安全与授权
 
 - 浏览器和普通业务前端不能直接使用 LiteLLM master key；
-- Southwind AI Server 在发起 Run 前执行 License → Feature → Permission Guard；
+- Windy Server 在发起 Run 前执行 License → Feature → Permission Guard；
 - Remote Runtime 只接受短时、限 audience、限 Operation、绑定 actor、run 和 expiry 的 Execution Grant；
 - Grant 不能携带长期有效的 Permission 列表作为授权事实；
 - Tool 执行、人工批准后的继续和后台重试都重新读取当前授权；
@@ -797,7 +797,7 @@ fail closed。开发 ADK Web 已作为 localhost-only 的受控调试入口交
 - 文本 LLM、VLM 和 Agent 输出统一通过 canonical SSE；
 - SSE 断线后使用 cursor 恢复，不重新执行模型调用；
 - Feature、Permission、License 任一拒绝都会 fail-closed；
-- 模型 Tool Call 不能绕过 Southwind AI Tool Host；
+- 模型 Tool Call 不能绕过 Windy Tool Host；
 - 同一 Run 能关联 Audit、ADK Trace、LiteLLM attempt 和 Usage；
 - 本地/内网模型可配置协议、主机、端口和 Base Path；
 - 完全断网环境仍可运行已配置的本地 LLM、OCR 和 Speech Operation；

package/template/docs/architecture/module-secret-resolution.md

@@ -221,14 +221,14 @@ Resolver 不会被调用。
 泄漏，但不能识别回调返回的其它未知凭据，也不能把故意通过网络或其它副作用发送凭据的
 恶意模块变成安全代码。这些边界必须继续通过代码审查、模块来源治理和网络策略控制。
 
-## 利剑 SMB / SFTP 接入
+## SMB / SFTP 业务模块接入示例
 
-利剑升级到包含该契约的 Windy 版本后，按以下方式接入，不需要修改 Windy 的配置
+业务项目升级到包含该契约的 Windy 版本后，按以下方式接入，不需要修改 Windy 的配置
 Registry 或 Agent Tool Runtime：
 
-1. 在拥有 SMB/SFTP 同步能力的利剑 Module Manifest 分别声明 password/private-key
+1. 在拥有 SMB/SFTP 同步能力的业务 Module Manifest 分别声明 password/private-key
    handle、稳定 connection/purpose，以及同基础 Key Feature、Permission 和审计动作；
-2. 在利剑 project-owned `server-composition.ts` 为每个声明添加
+2. 在项目的 project-owned `server-composition.ts` 为每个声明添加
    SDK 根导出的 `createModuleSecretBinding()`，生产 Resolver 指向客户批准的 Secret
    Store；
 3. Route/Service 在一次连接操作内使用

package/template/docs/architecture/report-staging.md

@@ -148,7 +148,7 @@ Starter 会同时裁剪 helper 源码、编译步骤和依赖。非官方镜像
 需要自行提供同一 helper；缺失或 RAR5 真实读取失败会返回
 `REPORT_STAGING_UNSUPPORTED_ARCHIVE`，不会回退旧 `bsdtar -x` 或其他外部命令。
 
-相较老 DSP/原先 `bsdtar` 直接解压，当前实现保留已由真实 probe 验证的 RAR5 streaming
+相较旧的外部命令直解压方案，当前实现保留已由真实 probe 验证的 RAR5 streaming
 reader，但把落盘所有权和逐 write 配额检查收回 Host，并用可严格解析的 framing 取代
 人类可读 listing。V1 callback 刻意不提供 seek/reopen；需要随机 seek 的 RAR4、ZIP 或
 其他格式会 fail closed，当前不承诺与通用 `archive_read_open_filenames` 格式等价。

package/template/docs/development/custom-login-page.md

@@ -30,13 +30,13 @@ export const loginPageComponent = defineLoginPageComponent(PlatformLoginPage);
 ## 完整业务页面
 
 将业务页面放在同一个 project-owned 目录，例如
-`apps/web/src/app/auth/SharpSwordLoginPage.vue`，然后只修改 selector：
+`apps/web/src/app/auth/ProjectLoginPage.vue`，然后只修改 selector：
 
 ```ts
-import SharpSwordLoginPage from "./SharpSwordLoginPage.vue";
+import ProjectLoginPage from "./ProjectLoginPage.vue";
 import { defineLoginPageComponent } from "@/pages/auth/login-page-extension";
 
-export const loginPageComponent = defineLoginPageComponent(SharpSwordLoginPage);
+export const loginPageComponent = defineLoginPageComponent(ProjectLoginPage);
 ```
 
 业务 SFC 使用 Vue 3 Composition API 和 TypeScript。认证提交必须复用

package/template/docs/license/license-offline-activation-code.md

@@ -50,8 +50,8 @@ W1 是同一份 `SignedLicenseV1` 的离线传输编码，用于客户电脑没
 
 下表由当前固定 V1 测试向量测得。`完整编码字符`包含 `W1`、段分隔连字符和校验字符；Base32 本身不包含易混的 `I/L/O/U`。V1 现在只携带单一 License 版本标记，不再包含数量可变的能力列表。
 
-| 样本                         | canonical JSON 字节 | 段数 | 完整编码字符 |
-| ---------------------------- | ------------------: | ---: | -----------: |
+| 样本                     | canonical JSON 字节 | 段数 | 完整编码字符 |
+| ------------------------ | ------------------: | ---: | -----------: |
 | 仓库固定 V1 版本标记向量 |                 673 |   20 |          519 |
 
 因此 W1 仍然只是无 U 盘、无摄像头时的兜底入口，不能承诺 150～300 字符。仅 64 字节 ED25519 签名转为 Base32 就需要约 103 个数据字符，V1 还签入客户、项目、合同、设备、时间、公钥 ID 和 License 版本等完整展示字段。

package/template/docs/platform/agent-runtime.md

@@ -3,7 +3,7 @@
 更新时间：2026-07-26。
 
 Windy 的 Agent Runtime 是可选平台能力。业务模块声明稳定的 AI Operation 和允许调用的
-Tool；Southwind AI Server 负责身份、Feature、Permission、License、Scope、Execution
+Tool；Windy Server 负责身份、Feature、Permission、License、Scope、Execution
 Grant 与审计；独立 Agent Server 只负责模型循环、canonical event 和受限 Tool Host
 回调。业务模块不选择 Provider、模型、Endpoint 或凭据。
 
@@ -94,7 +94,7 @@ host.registerAiOperationHandlers([
 放进返回值。`prepare` 只负责把已经过宿主 Guard 的类型化输入转成指令和用户消息。
 
 Tool handler 仍通过 `registerToolHandlers` 注册。模型提出 Tool Call 后，Agent Server
-携带短时 opaque grant 回调 Southwind AI Server；受限 Tool Host 会验证：
+携带短时 opaque grant 回调 Windy Server；受限 Tool Host 会验证：
 
 1. grant 是否绑定当前 Run、Operation、Actor 且未过期；
 2. Tool 是否属于 Operation 的 `allowedToolKeys`；
@@ -106,7 +106,7 @@ Tool 请求不能携带权限列表、License、Scope 或“已授权”标志
 
 ## 跨进程 Limits 契约
 
-Manifest 的 Operation limits 同时包含输入、执行时间和输出上限。Southwind AI Server
+Manifest 的 Operation limits 同时包含输入、执行时间和输出上限。Windy Server
 在调用远端 Agent Server 前先执行文本输入与 Artifact 声明的 `maxInputBytes` 校验；
 跨进程请求逐字段发送 Agent Server 需要再次执行的时长、输入、输出、图片数量与像素
 上限。禁止通过展开 Manifest 对象透传 limits：TypeScript 的结构类型不会在运行时
@@ -293,7 +293,7 @@ Operation 契约。
 
 ## 客户端协议
 
-浏览器继续使用 `@southwind-ai/ai-client` 访问同源 Southwind AI Server：
+浏览器继续使用 `@southwind-ai/ai-client` 访问同源 Windy Server：
 
 ```text
 POST /api/agent/runs

package/template/docs/platform/document-ai-runtime.md

@@ -4,7 +4,7 @@
 
 Windy 的 Document AI 是可选的独立故障域。业务模块声明稳定的
 `kind=document` Operation，并先把当前 Actor 有权读取的业务资源换成短时
-`ArtifactRef`；Southwind Server 完成 Feature、RBAC、License、数据范围、业务对象绑定
+`ArtifactRef`；Windy Server 完成 Feature、RBAC、License、数据范围、业务对象绑定
 和审计后，才把任务交给 Document Server。未安装或未配置 Document Server 时，对应
 Operation 稳定返回 `CAPABILITY_UNAVAILABLE`，普通业务和文本 Agent 仍可启动。
 
@@ -103,7 +103,7 @@ Repository 证明当前 Actor 可访问真实资源并绑定该文件时才会
 
 ## HTTP 与事件协议
 
-浏览器通过同源 Southwind Server 调用：
+浏览器通过同源 Windy Server 调用：
 
 ```text
 POST /api/document/runs
@@ -131,7 +131,7 @@ fail closed；Adapter 的单源 multipart 字段为 `file`，多源字段为重
 
 ### Output Artifact 握手
 
-Output Sink 启用时，Southwind Host 在调用 Runtime 前冻结：
+Output Sink 启用时，Windy Host 在调用 Runtime 前冻结：
 
 - 预分配的 `runId`；
 - 不含 credential 的 Sink Descriptor，包括 scope、output kind、部署/Release/Offer/

package/template/docs/platform/speech-ai-runtime.md

@@ -16,7 +16,7 @@ Agent 启动。
    Repository 回查 `resourceId`、`fileId` 与当前 Actor 的真实关系。
 2. 模块路由调用 `context.aiArtifacts.issue(...)` 换取加密、短时、opaque
    `ArtifactRef`。
-3. `@southwind-ai/ai-client/speech` 只把 Artifact 与领域选项提交到同源 Southwind
+3. `@southwind-ai/ai-client/speech` 只把 Artifact 与领域选项提交到同源 Windy
    Server。
 4. Server 重新检查 Feature、Permission、License、数据范围、能力摘要和 Artifact
    元数据，并按 Actor + Operation 作用域化幂等键。

package/template/docs/platform/vision-ai-runtime.md

@@ -12,7 +12,7 @@ Windy 的首个 Vision 切片在现有 Agent canonical Run 上增加受治理的
 
 - 浏览器和业务模块只提交平台签发的 opaque `ArtifactRef`，不能提交 URL、Base64、
   BlobStore Key、宿主路径、模型名或 Provider Endpoint。
-- Southwind Server 在 Feature、Permission、License、数据范围通过后重新打开资源，
+- Windy Server 在 Feature、Permission、License、数据范围通过后重新打开资源，
   校验 MIME、字节数与 SHA-256，再为 Agent Server 轮换短时引用。
 - Agent Server 只从固定 `AI_ARTIFACT_URL` 内网入口读取图片，拒绝调用方 URL。
 - 只接受 JPEG、PNG、WebP；解码后强制检查图片数量、总字节与单图像素。

package/template/docs/product/built-in-roles.md

@@ -21,6 +21,14 @@ Starter 首次安装提供四个稳定角色。角色 ID 和 code 是升级契
 
 ## 安全边界
 
-当前 `dataScope` 和 `departmentIds` 已持久化，但 Repository 查询级的数据范围 Guard 仍是产品缺口。为避免默认角色越权写入，部门负责人基线暂不授予 `system.user.manage` 或 `system.department.manage`。在部门及下级查询约束和越权测试完成前，不应通过 seed 扩大该角色的写权限；管理员仍可按部署需求显式配置自定义角色。
+`dataScope` 和 `departmentIds` 已持久化，用户、示例工单、Agent Tool、导出与受支持的
+后台路径已经接入 Repository 级查询范围强制。列表、总数、详情、更新和删除把同一 scope
+predicate 下推到查询，缺少 nominal `ScopeContext` 或 ownership 绑定时 fail closed；完整
+边界见[Repository 级 Data Scope 强制](../architecture/data-scope-query-enforcement.md)。新增
+Repository 或异步资源仍必须显式登记 `dataAccess`，不能因已有基础设施而默认视为已覆盖。
+
+部门负责人基线继续不授予 `system.user.manage` 或 `system.department.manage`。这是最小
+权限的产品默认值，不是用前端隐藏替代服务端 Guard；管理员可按部署需求显式配置自定义
+角色，最终仍受 Feature、Permission 和 Repository scope 共同约束。
 
 用户敏感字段策略将 `system.user.read`、`system.user.reveal` 和 `system.user.export` 分为三类能力。普通读取只能取得服务端脱敏结果；明文查看与治理导出即使由超级管理员执行，也必须重新授权并写入关键审计。客户端提交的角色 code、权限数组或展示模式不是授权来源。