Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
merge: 同步 main 并解决媒体计费集成冲突
liugaowei13e1ed9cf8ef
diff --cc apps/desktop/src/main/localDb/client/WorkerThreadTransport.tsindex 72c7b7448c,55658c3b72..8249822ab2--- a/apps/desktop/src/main/localDb/client/WorkerThreadTransport.ts+++ b/apps/desktop/src/main/localDb/client/WorkerThreadTransport.ts@@@ -1,5 -1,5 +1,6 @@@+ import { runPluginUsageTransaction } from '../worker/opHandlers/pluginUsageTx.js';import { runTaskTagsTransaction } from '../worker/opHandlers/taskTagsTx.js';+import { recordMediaSpend } from '../worker/opHandlers/mediaSpendTx.js';import { createAutoReviewIntentProjection } from '@cindy/maker-shared/auto-review-intent';import { batchAutoReviewProjection, readAutoReviewProjection } from '../autoReviewProjection.js';import { CLOSE_SHARED_TASKS_FOR_SESSION_SQL } from '../sharedTaskClosureSql.js';@@@ -25,8 -25,8 +26,9 @@@ const createAutoReviewIntentProjectionconst readAutoReviewProjection = ${readAutoReviewProjection.toString()};const batchAutoReviewProjection = ${batchAutoReviewProjection.toString()};const CLOSE_SHARED_TASKS_FOR_SESSION_SQL = ${JSON.stringify(CLOSE_SHARED_TASKS_FOR_SESSION_SQL)};+ const runPluginUsageTransaction = ${runPluginUsageTransaction.toString()};const runTaskTagsTransaction = ${runTaskTagsTransaction.toString()};+const recordMediaSpend = ${recordMediaSpend.toString()};// 旧版 inline worker fallback。默认运行时走 .vite/build/dbWorker.js;// 这段只作为打包路径回滚口保留,后续验证 macOS / Windows packaged 后删除。const { parentPort, workerData } = require('node:worker_threads');diff --cc apps/desktop/src/main/localDb/client/tx/types.tsindex 6735fe721a,c9f8d30127..10c6956ce5--- a/apps/desktop/src/main/localDb/client/tx/types.ts+++ b/apps/desktop/src/main/localDb/client/tx/types.ts@@@ -1,8 -2,8 +2,9 @@@ import type { PluginUsageTransaction, Pimport type { TaskTagRequest, TaskTagResult } from '@cindy/maker-shared';export type DbTxName =+ | 'usage.recordMediaSpend'| 'authorization.readProjection'+ | 'pluginUsage.execute'| 'taskTags.execute'| 'codex.importMessages'| 'claude.importMessages'diff --cc apps/desktop/src/main/localDb/ipc/messages.tsindex aee72f1cbe,7cec51a4f8..e9a412e5a4--- a/apps/desktop/src/main/localDb/ipc/messages.ts+++ b/apps/desktop/src/main/localDb/ipc/messages.ts@@@ -25,9 -25,9 +25,10 @@@ importimport { createId } from '@paralleldrive/cuid2';import { historyOutlineContent, historyOutlineContentStamp, withHistoryArtifacts } from './historyViewOutline';import { historyViewLeaves, isHistoryViewUnavailable } from '@cindy/maker-shared/message-window';+ import { projectMcpAppContent } from '@cindy/maker-shared/mcp-apps';import { getDbClient, getCurrentDbClientSnapshot } from '../client/current';+import type { DbClient } from '../client/DbClient';import type { ContextRebuildArgs } from '../client/tx/types';import { latestVisiblePreviewRow } from '../latestMessageText';import { messages, sessions } from '../schema';diff --cc apps/desktop/src/main/localDb/worker/opHandlers/tx.tsindex ef1151a7e0,9212bf884e..b5abbcdaf6--- a/apps/desktop/src/main/localDb/worker/opHandlers/tx.ts+++ b/apps/desktop/src/main/localDb/worker/opHandlers/tx.ts@@@ -1,5 -1,5 +1,6 @@@+ import { runPluginUsageTransaction } from './pluginUsageTx.js';import { runTaskTagsTransaction } from './taskTagsTx.js';+import { recordMediaSpend } from './mediaSpendTx.js';import { batchAutoReviewProjection, readAutoReviewProjectionTransaction } from '../../autoReviewProjection.js';import { CLOSE_SHARED_TASKS_FOR_SESSION_SQL } from '../../sharedTaskClosureSql.js';import { normalizeBotName } from '../../../../shared/botCreation.js';diff --cc apps/desktop/src/main/mcp-integrations/cindyProxyMedia.tsindex 59215b0d45,b0721918d3..86d554a3fe--- a/apps/desktop/src/main/mcp-integrations/cindyProxyMedia.ts+++ b/apps/desktop/src/main/mcp-integrations/cindyProxyMedia.ts@@@ -38,30 -39,6 +39,33 @@@ function getGatewayBaseUrl(): stringreturn effectiveXdGatewayBaseUrl();}- /** Only Gateway creates are billable. Polling and CDN downloads bypass accounting. */- const gatewayMediaFetch: typeof fetch = async (input, init) => {++/**++ * Only Gateway creates are billable. Polling and CDN downloads bypass accounting.++ * Keep Gateway 401 key-rejection reporting for all requests carrying Authorization.++ */++const gatewayMediaFetch = withCindyGatewayKeyRejectionReport(async (input, init) => {+ if (init?.method?.toUpperCase() !== 'POST') return fetch(input, init);+ let model = 'unknown';+ if (typeof init.body === 'string') {+ try {+ const body = JSON.parse(init.body) as { model?: unknown };+ if (typeof body?.model === 'string') model = body.model;+ } catch { /* The response header remains the authoritative model. */ }+ } else if (init.body instanceof FormData) {+ const value = init.body.get('model');+ if (typeof value === 'string') model = value;+ }+ const { prepareGatewayMediaBilling } = await import('../usage/gatewayMediaBilling.js');+ const recordBilling = await prepareGatewayMediaBilling({ model, sessionId: billingSession.getStore() });+ try {+ const response = await fetch(input, init);+ await recordBilling(response);+ return response;+ } finally {+ recordBilling.finish();+ }- };++});+/*** XD Gateway 图像/视频后端单例。lizi_art MCP 工具层已退役(2026-07-12),* 本服务不再对 agent 暴露工具,只作为 host 侧链路的后端:diff --cc docs/dev-rules/protocol-compatibility.mdindex 9ea4e6d2f3,8aa3878174..49c241ce31--- a/docs/dev-rules/protocol-compatibility.md+++ b/docs/dev-rules/protocol-compatibility.md@@@ -22,37 -65,63 +65,92 @@@ Gateway 边界对整块报价校验,�模型快照投影,成功刷新缺字段会移除旧展示;没有新权限、数据库迁移或独立价格缓存。两端可独立升级,完整展示需两端支持。字段只用于报价展示,不参与账单或调用授权。+## Gateway 媒体请求计费++此契约仅适用于 Cindy AI provider(内部 `providerId='xd'`),按实际供应商身份判断,+与模型名称无关;自定义及第三方 provider 不走此计费头读取和落账链路。+个人版与企业账号的返回结构一致,共用同一解析器,不按账号类型分支。++成功创建媒体请求的 `X-Nova-AIGateway-Billing` 是 Base64URL 编码的 JSON,`cost` 为有限的+非负数,`model` 可选;其它供应商字段忽略。费用直接采用此头,不从 token 或展示价目推算。+头本身没有币种,客户端在提交前捕获同账号 Gateway 的结算币种与数据库归属;币种未知、+头缺失或非法时不猜测金额。旧网关没有头时继续提供媒体结果,不补算历史费用。+仅原始创建响应记账,视频轮询、下载、已保存结果恢复不重复记账;响应正文或下载失败不撤回+已经收到的有效计费。每日总额、模型费用和 Host 可关联的任务费用原子更新。+正文读取与记账并行,读取完成即结束网络超时计时;本地记账等待不占用正文读取时间。+账号数据库关闭前等待已发出媒体请求的记账结束,成功、拒绝、网络失败及提交前退出均释放+对应等待。旧插件代办通过 Host 的同插件在途调用恢复任务上下文;没有此上下文的后台生成+只记日账与模型费用,不借用当前聚焦任务。++目录暂缺币种时复用同账号已确认的结算币种;从未确认或目录币种冲突时仍不猜测。+旧版 v9 缓存未保存冲突标记且账号币种为空时,不能区分缺省与混合币种;在新的目录声明前+不复用历史币种给媒体计费头标注币种。+任务内媒体费在提交前绑定真实用户消息,`agent_meta.mediaCosts` 按币种保存实际费用,+与日账及任务总额同一事务落库。响应下方沿用 `userTurnMoney` 累计,晚到费用刷新原轮,+不修改聊天分段 `turnCost` 或订阅估值。定时运行与累计费用同时读取用户消息媒体账本,+保留纯工具运行的费用,避免与助手消息费用重复累计。++用量模型行的 `agentKind` 追加 `media`,token 数为 0,不虚构聊天引擎或 token 用量。+同账号设备同步沿用 `usage-device-rows-v1`;新版保留此行,旧版可能忽略新类别的模型明细,+每日费用仍通过既有日账同步,无新增 channel、权限或数据库 migration。++ ## 群聊邀请公开链接++ device-link-server 的公开页 `<deviceLinkBase>/chat-invite/join#<token>[?app=cindy|cindycn|cindydev]`+ 与 Desktop 粘贴解析共用同一规则:口令为 43 位 base64url,只放在 fragment;URL 无 query、无用户信息;+ fragment 只允许一个闭集 `app` 提示,不允许额外 `#` / `?` 段;协议为 https,仅本机回环地址允许 http。+ 页面在电脑上唤起既有 `cindy://chat-invite/<token>`,手机不唤起。客户端解析见+ `packages/device-link/src/chatInvitation.ts`(`parseChatInvitationToken`),继续接受裸口令与+ `cindy://chat-invite/<token>`;链接主机只校验形状,从不作为请求地址,也不据此切换 Chat Server+ 或登录区域,口令只以请求正文发给当前账号的 Chat Server。++ 发布顺序:先发布接受 https 粘贴的客户端,并保留「伙伴 → + → 输入邀请链接…」;sh-dev、sh-prod、+ sgp-prod 都部署该页面后,才把 `createInvite` 生成的链接切换为 https。旧客户端点击 https 链接+ 经页面转到 `cindy://` 仍可用,但粘贴 https 链接需要新版客户端。Chat Server API 不变。++ ## 群消息附件的结构化投影++ Chat Server 群消息投影(Desktop IPC 与 `bot-group-chat` 远程资源共用 `BotGroupMessageView`)的+ `content` 不再包含 `[附件: 文件名]` 占位行,附件只在 `attachments` 里。尚未取到电脑的服务器附件也+ 保留一项,`url`、`path` 为 null,并带可选 `state: 'loading' | 'unavailable'`;取到后同一 `id` 换成+ 完整附件、`state` 缺省。新版手机解析该字段,在原位置显示「加载中」/「暂时无法加载」,点开说明状态而不当作+ 可打开的文件;旧手机忽略该字段,把这一项显示为带文件名的文件条,旧版 Markdown 回退仍为 `📎 文件名`。手机直连同样只从 media 块投影附件,正文不再拼 caption。给伙伴的上下文文本不变。+ 不改 channel、能力、服务端 schema、数据库或 Mobile 原生指纹。+## 手机直连群的设置管理+ ### 群解散与个人列表移除++ `GET /me` 明确声明 `groupLifecycleVersion: 1` / `conversationListStateVersion: 1` 才启用对应动作。+ 缺能力或旧副本拒绝时显示不可用,不回退为 archive 或兼容 delete。服务端合同及迁移由+ `xindong/cindy-server#921` 提供;该 PR 的实际启动迁移核验与部署仍为独立上线条件。++ `POST /conversations/:id/dissolve` 带 operationId 与正整数 expectedRevision,只允许 joined owner+ (包括合法伙伴主人代演),且 kind 必须是 group。`dissolved_at` 是不可撤销的终态,归档只是其+ 旧客户端只读兼容投影。保留原历史权限,停止现有执行与分工、失效邀请均由服务端事务负责;+ Desktop 收到终态后还会中止本机未完成的规划,沿原 lease 链停止执行;本机终止规划无需追加取消规划写入。++ `POST /conversations/:id/list-state` 带 operationId、hidden 与本人列表 expectedRevision(初始0)。+ 它只移除本人账号跨设备列表,不退出、不删历史、不停止其他人的执行。已退出者通过+ `GET /conversation-list-state` 获取状态,无需先读已无权限的群快照。启动及重连先取个人状态,+ 只合入更新的修订;成功回包或本人 human actor scope 的 `conversation.list.changed` 才清理本地+ 列表、选择与未读镜像,失败保留列表。手机同时订阅群和本人 human scope,代演不替换账号订阅。+ 同账号并发全量同步共用一次请求;普通聊天刷新复用已同步状态与事件,启动、重连及手机主动刷新重新读取。+ 同步失败不把缓存标记为已就绪。手机列表重新挂载时先纳入已有个人状态,直连离线也不恢复旧电脑回包。+ actor scope 遇到 RESET_REQUIRED 时,在在途读取完成后重新读取个人状态,再按服务端 head 续订;+ Desktop 与 Mobile 均受当前账号、socket 身份保护。个人移除成功时由仍挂载的聊天页完成返回列表,+ 设置面板因列表更新先卸载不会吞掉成功导航,离开页面后的旧回包也不能改变新页面。+ 手机收到跨设备本人 hidden 事件也由当前聊天页返回列表,本机回执与事件共用一次导航;+ 设置面板每次关闭/身份切换都会清空 busy,旧打开周期的请求不能覆盖新周期状态。+ Desktop 解散或变更期间遇到在途 heartbeat,会合并排队一次后续租约检查,避免漏掉权威终止。++ 现有 `bot-group-chat` 投影可选追加 supportsDissolve、supportsListRemoval、supportsGroupLeave、dissolvedAt;远程资源+ 动作 `dissolve` / `leave` / `hide` 分别转发相同的服务端动作。hide 的 opaque result 返回+ `{listState:{conversationId,hidden,revision}}`,手机按修订合入同一账号投影,阻止旧电脑列表复活。+ Desktop 既有群变化推送新增 list 类型及可选 listState;旧窗口忽略未知类型仍会刷新列表。+ 旧客户端与服务端可独立升级;完整行为要求服务端全副本及使用的客户端均支持。无新增 channel、+ SQLite schema、Mobile 原生依赖或 fingerprint 输入。+现有 `bot-group-chat` 数据可选追加 `supportsSettingsManagement`。仅服务器群的新版 Host声明该能力,手机读取最新群详情和已有成员角色后才开放管理。设置动作可带`expectedRevision`,Host 在调用服务前核验,群信息 PATCH 和归档继续携带该编辑版本给