@spzxg/cli-ui 0.6.10 → 0.6.12

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Changelog
 
-## 0.6.10 — 本地候选，2026-11-06
+## 0.6.12 — 待发布，2026-11-06
+
+- CliChat 与节点 Chat 支持 CLI 子代理卡片，点击在右侧查看对应子 Chat 的公开消息、工具结果、状态和实时过程；支持历史读取、子代理切换及窄屏展示，关闭侧栏保留主对话草稿。
+- 展示范围以 CLI 实际提供的事件为准；Pi 需要子代理扩展。未增加直接控制子代理的功能。
+- 修复节点新建任务请求未完成时连续点击或回车后点击导致重复提交的问题；创建失败保留输入并显示错误。
+- 子代理过程读取需要配套 Center 与 Operator 节点接口；组件发布不会自动部署服务端，也不会修改节点的组件依赖。
+- 本地组件全量 978 项测试、类型检查、embed 与候选宿主构建通过；真实模型子代理端到端运行尚未验收。本版本由用户发布，目前未发布。
+
+## 0.6.11 — 2026-11-06
+
+- 仅隐藏普通对话、节点与群聊中消息下方的「引用」入口；引用回调、文件／看板引用、宿主追加引用和已有引用内容的展示与发送能力保留。
+- 修正测试环境的 localStorage 与 act 警告，补全上传测试的轮次响应，并增加渲染异常和执行入口隐藏回归。
+- 接入文档拆分简易模式（前端直传 token）与安全模式（推荐，由服务端注入令牌）；补齐配置默认值、字段与普通／节点／群聊／看板的实际适用范围。
+
+## 0.6.10 — 2026-11-06
 
 - 0.6.9 已在 npm 发布，本轮 Chat 修复改用 0.6.10 独立打包，不覆盖旧版本。
 - 修复一次性任务误读普通对话执行设置导致出现“此操作仅适用于普通对话／重新读取”：已有任务确认类型后再读取，非普通对话沿用任务配置并禁用设置入口。

package/README.md

@@ -12,12 +12,18 @@
 
 ## 快速开始
 
-0.6.10 的普通 `CliChat` 默认包含「＋、执行类型、智能体」。右下只显示一个主按钮，使用 32px 视觉圆形图标，保留 44px 点击区域。AI 回复期间空草稿显示停止，有内容且允许排队时切换为箭头，排队成功清空后恢复停止；已排队消息显示在输入框上方。停止处理中保持停止忙碌状态，并阻止 Enter 提交。手机最小适配宽度为 375px；窄屏和运行态仍显示执行模式图标、智能体下拉箭头，触屏不保留悬停底色。可按需显式关闭：
+0.6.12 的普通 `CliChat` 默认包含「＋、执行类型、智能体」。右下只显示一个主按钮，使用 32px 视觉圆形图标，保留 44px 点击区域。AI 回复期间空草稿显示停止，有内容且允许排队时切换为箭头，排队成功清空后恢复停止；已排队消息显示在输入框上方。停止处理中保持停止忙碌状态，并阻止 Enter 提交。手机最小适配宽度为 375px；窄屏和运行态仍显示执行模式图标、智能体下拉箭头，触屏不保留悬停底色。可按需显式关闭：
 
 ```tsx
 <CliChat config={{ composer: { fileUpload: false, executionMode: false, agentSelector: false } }} />
 ```
 
+只隐藏权限和智能体选择、保留附件按钮时，使用 `config={{ composer: { executionMode: false, agentSelector: false } }}`。两个开关均可单独关闭；关闭后不显示对应入口，不保留灰色占位。默认可操作需要配套服务提供执行设置接口，并且当前对话允许修改设置；一次性任务沿用任务设置，运行中和保存中暂时不可修改。
+
+所有 Chat 模式均不再显示消息下方的「引用」按钮；文件预览、看板引用、宿主追加引用和已有引用内容的展示与发送能力保留。
+
+完整 config 清单以中枢 API 文档的「界面配置」为准：普通 Chat／List 支持对应的完整配置。Operator Chat 当前仅消费 `composer: false`、`fileUpload`、`executionMode`、`agentSelector`；Operator List 不透传顶层 config。群聊由 `group` 适配器控制，不消费顶层 config；看板使用独立 props，不能用 Chat 的 config 配置。
+
 `createCenterClient` 自动对接配套中枢的 `GET /api/execution-config`、`GET/PATCH /api/jobs/:id/execution-config?task_id=...`。升级时先在中枢执行随仓库提供的 Prisma migration，再部署支持原子执行配置的节点和中枢。组件包本身不会迁移数据库。配置保存只适用于普通对话；已有一次性任务的暂停／继续保持原协议。旧中枢可以继续聊天，但无法使用新配置选择。
 
 自定义 `ConversationBackend` 实现 `getExecutionConfig`、`setExecutionConfig` 即可使用默认菜单，无需自建 `composerToolbar`。能力列表由服务端返回，不在组件中写死模型或权限。新对话选择通过 `NewConversationOptions.executionConfig` 随首轮提交；自定义 `createConversation(text, options)` 回调需转发第二个参数中的设置。宿主提供的 `group` 是多发言人群聊，执行目标仍由群适配器管理。
@@ -47,7 +53,12 @@ import "@spzxg/cli-ui/styles.css";
 </CliCenterProvider>
 ```
 
-组件请求同源的 `/api/center`（可以用 `baseUrl` 改），由代理转到中枢并注入令牌：
+组件可按实际项目选择两种接入方式：
+
+- **简易模式（非安全模式）**：直接传 `token`，例如 `<CliChat baseUrl="https://cli.xgjktech.com.cn" token="产品线 token" jobId="job_xxx" />`。令牌会暴露在浏览器配置和 API 请求中，页面使用者能够查看和复用。跨域时必须由入口／网关允许当前来源和 `Authorization` 等请求头；中枢应用当前未内置 CORS，不能只传 token 就绕过浏览器限制。
+- **安全模式（推荐）**：前端不传产品线 token，业务后端／代理检查当前用户的 Job／Task 访问权并注入令牌。组件缺省请求同源 `/api/center`；接入方或 AI 可按现有技术栈复用业务后端、BFF、网关或服务端路由，不强制采用 Nginx，也不要求重复新建代理服务。
+
+下面 Nginx 片段只说明转发，假设已有入口完成业务用户授权；单独复制它不能替代鉴权：
 
 ```nginx
 location /api/center/ {
@@ -77,7 +88,7 @@ location /api/center/ {
 
 - **发消息**：新对话 `POST /api/jobs`（`mode: "conversation"`），之后每条 `POST /api/jobs/:id/messages`。
 - **收消息**：`GET /api/jobs/:id/stream`（SSE 长连接）推送 Agent 的输出、工具调用、提问和状态变化。
-- **只依赖两样东西**：能访问中枢，以及带上产品线令牌（经同源代理）。
+- **只依赖两样东西**：能访问中枢，以及带上产品线令牌（安全模式由服务端注入，简易模式直接传入）。
 
 `callback.url` 是中枢推给**业务后端**的，浏览器收不到，组件也用不到。只有后端想把每轮结果存下来、即使没人开着页面也要存时才需要配。页面上想在一轮结束时做点什么，用组件的 `onTurnEnd` / `onConversationEnd`：它们是组件从实时流里算出来的，不配 callback 也会触发，载荷字段与中枢回调体相同。
 
@@ -338,7 +349,7 @@ export default function App() { return <OperatorWorkspace />; }
 
 `src/operator.base.css` 是共享样式源，`src/operator.css` 是 `css:sync` 的生成结果；根工程 `app/globals.css` 只导入包的样式。迁移与备份清单见仓库的 `docs/CLI_UI_MERGE.md`。
 
-`0.6.9` 已发布，本地此次候选版本为 `0.6.10`，不能覆盖重发旧版本。发布前须通过组件测试、嵌入构建、真实工程构建和浏览器回归；不要运行会连带发布其他共享包的批量脚本。配套 Skill/MCP 各自为 `0.1.1` 本地候选，版本独立。
+当前源码为 `0.6.12` 待发布版本，由用户执行发布；已发布的 `0.6.11` 不可覆盖重发。发布后可用 `npm view @spzxg/cli-ui@0.6.12 version` 确认可用性。发布前须通过组件测试、嵌入构建、宿主构建和相关浏览器回归；不要运行会连带发布其他共享包的批量脚本。配套 Skill/MCP 使用独立版本。
 
 
 ### 文件、对话与浏览器看板联动
@@ -429,7 +440,7 @@ Web Component 发出 `cli-files-change`、`cli-files-watch`、`cli-board-context
 
 `workspace.readFile()` 对自定义后端也校验实际字节数并及时响应取消，后端仍应正确实现 AbortSignal 以释放内部资源。浏览器重连、接管交还和切换任务不等待或重放旧会话输入。当前看板为只读预览，文件编辑由 AI／服务端执行，再通过事件刷新和交付给业务方。
 
-当前本地候选版本 `0.6.10`，已发布版本为 `0.6.9`，更新记录见随包 `CHANGELOG.md`。当前候选见 [0.6.10 版本验收](../../docs/CLI_UI_0610_VERSION_VALIDATION_2026-11-06.md)，三项 Chat 修复见 [修复验收](../../docs/CLI_UI_069_CHAT_FIX_VALIDATION_2026-11-06.md)，默认控件与执行配置历史验收见 [0.6.8 验收记录](../../docs/CLI_UI_068_DEFAULT_CONTROLS_VALIDATION_2026-11-06.md)；原件上传历史验收见 `docs/CLI_UI_UNIFIED_UPLOAD_VALIDATION_2026-11-05.md`。本地打包不等于 npm 或生产服务已更新。
+当前源码为 `0.6.12` 待发布版本，上一已发布版本为 `0.6.11`；更新记录见随包 `CHANGELOG.md`，本次说明见 [0.6.12 发布说明](../../docs/CLI_UI_0612_RELEASE_2026-11-06.md)。0.6.10 历史验收见 [版本验收](../../docs/CLI_UI_0610_VERSION_VALIDATION_2026-11-06.md)，三项 Chat 修复见 [修复验收](../../docs/CLI_UI_069_CHAT_FIX_VALIDATION_2026-11-06.md)，默认控件与执行配置历史验收见 [0.6.8 验收记录](../../docs/CLI_UI_068_DEFAULT_CONTROLS_VALIDATION_2026-11-06.md)；原件上传历史验收见 `docs/CLI_UI_UNIFIED_UPLOAD_VALIDATION_2026-11-05.md`。本地打包不等于 npm 或生产服务已更新。
 
 ### v0.6.5 文件和业务交付加固
 
@@ -475,3 +486,9 @@ HTML默认直接原样预览，包括超过2MiB或大小未知的文件；通过
 HTML完整原貌预览要重组完整文档；网络只取缺块，更新后在沙箱iframe中替换完整修订并尽量恢复滚动。任意100MiB复杂DOM在手机上的排版成本不能由增量传输消除，超大样本的桌面测试不等于所有手机设备的性能保证。HTML自身脚本继续被阻止，相对资源按原有鉴权文件链路加载。
 
 **需要配套升级中枢和独立节点服务端的 `file-sync/*` 接口。** 内置适配器遇到旧服务端会明确报不支持，不静默改回重复全量拉取。自定义BoardBackend未提供fileSync时保留原来的有限读取兼容行为。本次没有发布npm、部署或数据库变更。
+
+### 0.6.12：CLI 子代理过程
+
+主 Chat 中点击 CLI 子代理卡片，在右侧打开该子代理的 Chat，查看公开消息、工具调用、结果与状态；支持实时更新和历史读取。关闭侧栏不停止任务，也不会清除主 Chat 草稿。窄屏使用模态侧栏。Center 业务子任务仍切换到各自会话，不使用该侧栏。
+
+需要配套 Center 子代理代理接口及 Operator 子代理记录接口。Claude、Codex、Grok 的可展示范围取决于实际协议，Pi 需要子代理扩展；未提供的过程不会伪造成完整记录。本轮未提供直接向子代理发送消息或重启的操作。