Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

merge: 同步 main 并解决媒体计费集成冲突

liugaowei13e1ed9cf8ef
diff --cc apps/desktop/src/main/localDb/client/WorkerThreadTransport.ts
index 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 createAutoReviewIntentProjection
const 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.ts
index 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, P
import 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.ts
index 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 @@@ import
import { 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.ts
index 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.ts
index 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(): string
return 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.md
index 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 和归档继续携带该编辑版本给