diff --git a/docs/content/docs/backend/code-map.mdx b/docs/content/docs/backend/code-map.mdx index 3bd717ae6..6ab2baed8 100644 --- a/docs/content/docs/backend/code-map.mdx +++ b/docs/content/docs/backend/code-map.mdx @@ -13,10 +13,10 @@ description: 从产品功能快速定位主要代码入口 | 功能 | 页面入口 | 主要协作模块 | | --- | --- | --- | -| 首页与导航 | `web/src/pages/home/`、`web/src/layouts/user-layout.tsx` | `components/layout/`、`router.tsx` | +| 首页与导航 | `web/src/pages/home/`、`web/src/layouts/user-layout.tsx` | `components/layout/workspace-sidebar-nav.tsx`、`workspace-sidebar-checkin.tsx`、`workspace-sidebar-storage-meter.tsx`、`router.tsx` | | 创作工作台 | `web/src/pages/create/index.tsx` | `creation-workspace.tsx`、`creation-conversations.ts`、`creation-types.ts`、`creation-assets.ts`、`creation-references.ts` | | 登录注册 | `web/src/pages/auth/` | `stores/use-user-store.ts`、`services/api/auth.ts`、后端 `internal/auth/` | -| 积分与计费 | `web/src/pages/wallet/`、`pages/admin/components/platform-finance-panel.tsx` | `services/api/wallet.ts`、后端 `internal/app/finance.go`、`repository/finance.go` | +| 积分与计费 | `web/src/components/layout/workspace-wallet-modal.tsx`、`pages/admin/components/platform-finance-panel.tsx` | `services/api/wallet.ts`、`services/api/payments.ts`、后端 `internal/app/finance.go`、`internal/app/payment.go`、`payment-plugins/`、`plugin-packages/official-payment-*` | | 任务中心 | `web/src/pages/tasks/` | `services/api/task-center.ts`、`services/api/task-text-stream.ts` | | 我的素材 | `web/src/pages/assets/` | `stores/use-asset-store.ts`、`services/image-storage.ts` | | 技能库 | `web/src/pages/skills/` | `services/api/skills.ts`、`services/skill-runtime.ts`、`components/skills/skill-runtime-picker.tsx` | diff --git a/docs/content/docs/overview/features.mdx b/docs/content/docs/overview/features.mdx index 5308b1ee4..6ebc88215 100644 --- a/docs/content/docs/overview/features.mdx +++ b/docs/content/docs/overview/features.mdx @@ -5,6 +5,25 @@ description: 当前项目已实现的核心工作台能力与使用入口 # 功能清单 +## 工作区签到加油站 + +积分功能开启且后台「每日签到积分」大于 0 时,首页侧栏容量条上方固定显示领取卡片:标题为「{站点品牌名}加油站」,副文案为今日可领积分,黑色按钮「立即领取」。未领取时一直显示;当天领取成功后立即消失。关闭积分、签到积分为 0,或未登录时不显示。卡片用白底、黑按钮和青绿积分数字,不套浅蓝舞台底。 + +### 相关实现 + +- `web/src/components/layout/workspace-sidebar-checkin.tsx`:侧栏领取卡片。 +- `POST /api/wallet/checkin`:每日签到入账,同一天不可重复领取。 + +## 工作区账号容量 + +登录后,首页侧栏左下角用户头像上方显示账号文件容量进度:已用容量、剩余容量和总容量,细进度条表示已用比例。用量达到 70% 变为警告色,达到 90% 或已满变为危险色。点击进入素材库;资产页页头仍展示同一用量。收起侧栏时保留细进度条,悬停可看到已用、剩余与总容量。统计包含素材文件和 Agent 会话附件。 + +### 相关实现 + +- `web/src/components/layout/workspace-sidebar-storage-meter.tsx`:侧栏容量进度。 +- `web/src/pages/assets/asset-storage-usage.tsx`:资产页同一查询。 +- `GET /api/resources/storage-usage`:账号已用字节与配额总容量。 + ## 云端 Agent(写入与生成仍待真实环境验收) 浮窗支持移动、调整大小和浏览器偏好恢复;后端支持逐轮对话、可信历史、取消、Skills 快照、画布摘要/精读、审批后的画布写入及媒体生成。运行中可插话(下一步生效,不打断正在飞的调用);多步任务可用 `plan_update` 维护待办清单并在输入框上方展示,未完成项会催办;`request_approval` 下首次 ≥2 项清单会先确认,`auto` 直接建立。`ask_user` 可弹出选项并结束本轮。个人记忆由 `remember_lesson` 写入待审,用户在「设置 → Agent 记忆」自己批准、添加、导出导入,并可用自己的文本模型手动或按日/周/月压缩相近条目。系统提示只带已批准记忆的索引(标题+适用场景),完整做法由 `recall_lessons` 按 topic/关键词取;管理员可按用户查看和删除,不能代批。只读模式不能写记忆。终态旧轮次按其冻结合同保留为不可变历史,新消息使用当前合同创建新轮,不篡改父运行;旧合同下仍活动或待审批的运行不会被新版服务恢复执行。生成由预算和独立审批控制,画布写入使用内容快照哈希;未开放外部 MCP。系统行为策略以版本化资源发布,用户/项目/画布可编辑常驻偏好;偏好正文固定在运行快照并按层只读,不整段塞入 system prompt,也不能提权或跳过审批。节点创建、更新字段、摘要投影和连线限制来自服务端能力 registry;能力卡同时描述用途、适用场景、不适用场景、维护代价和可用动作,由 Agent 结合镜头数量、连续性、逐镜审查和交接需求自主选择,不强制所有任务使用分镜。分镜脚本支持结构化创建、分页读取及按真实行 ID 追加、修改和删除;普通文本和 Markdown 不会被宣称为具备镜头级维护能力的分镜表。图片、视频和音频节点可安全修改标题与下一版提示词草稿,既有媒体、已提交提示词和任务状态不会被草稿编辑覆盖;媒体模型按生成模式和真实参考节点从统一目录筛选。审批和执行记录明确展示目标节点、类型、修改字段、名称变化及连线两端,前端不再依靠内部 ID 猜测;这些预览不替代服务端归属、快照、Capability、锁、预算与调用哈希校验。真实模型计费与浏览器联调仍待验收。 @@ -261,6 +280,16 @@ SEO 标题、描述、可选关键词会投影到浏览器 metadata、Open Graph - `web/src/pages/canvas/use-canvas-node-operations.ts`:候选节点筛选、流程/网格布局选择和位置提交。 - `web/src/lib/canvas/canvas-layout.ts`:媒体泳道、拓扑流程、网格、行列排列和对齐算法。 +## 积分充值支付插件 + +积分中心在线充值通过 `yingce.payment/v1` 支付插件接入。宿主只保存订单、加密配置、回调入账和对账;渠道协议由插件包提供。当前官方包包括微信支付 Native、支付宝电脑网站支付和虎皮椒聚合支付,包内同时带有 macOS、Linux、Windows 的 amd64/arm64 可执行文件,宿主启动时按本机系统选择。管理员在插件中心开放插件后,到支付设置填写渠道密钥即可出现在用户积分中心弹窗。扫码区固定白底深色码点;虎皮椒 `url_qrcode` 是现成二维码图片,钱包直接展示,不再二次编码。用户顶栏积分、账户卡片、命令面板、画布余额和 `/wallet` 回跳都打开同一弹窗,不再进入独立钱包页。 + +### 相关实现 + +- `plugin-packages/official-payment-xunhupay/`:虎皮椒聚合支付插件包与 RPC 入口。 +- `backend/payment-plugins/xunhupay.go`:虎皮椒下单、查单、验签与关单适配。 +- `docs/content/docs/plugins/payment-plugin-runtime.mdx`:支付插件运行时协议。 + ## 剪辑成片(时间线编辑器) “剪辑成片”是项目详情里的时间线编辑器入口(`/projects/:id/editor`),用于把已就绪的分镜视频编排成一段可播放、可导出的成片。它运行在浏览器本地时间线模型之上,通过后端任务队列完成语音转写与成片导出,编辑器本身不直接触碰原始媒体大文件。 diff --git a/docs/content/docs/progress/pending-test.mdx b/docs/content/docs/progress/pending-test.mdx index 884000ab6..9ce79d654 100644 --- a/docs/content/docs/progress/pending-test.mdx +++ b/docs/content/docs/progress/pending-test.mdx @@ -5,6 +5,86 @@ description: 当前项目已实现功能的手工验证清单与未确认边界 # 待测试 +## 创作参数弹窗表面色(2026-09-17) + +画幅 / 清晰度 / 时长弹窗改用工作台 `--user-surface-raised`,选中块用 `--user-control-pressed`,不再画 1px 描边。待登录后打开视频生成设置: + +- [ ] 暗色下弹层颜色贴近输入条,四周没有细线框,只靠阴影浮起。 +- [ ] 选中的画幅、清晰度是实心底块,比例图标是色块不是空心线框。 +- [ ] 时长弹窗同样没有描边;浅色主题也没有细线框。 + +## 积分中心改为弹窗(2026-09-17) + +独立 `/wallet` 页面已删除。顶栏积分、账户卡片充值、命令面板「积分中心」、画布顶栏余额,以及访问 `/wallet` 或支付回跳,都应打开同一「积分中心」弹窗,并回到首页。待登录工作台后: + +- [ ] 打开 `/wallet` 不再出现积分超市整页,而是弹出积分中心;刷新后停留在首页。 +- [ ] 顶栏积分胶囊、侧栏账户「充值 / 兑换」、⌘K 搜索「积分中心」、画布顶栏余额都打开同一弹窗,不离开当前页(`/wallet` 访问除外,会回到首页)。 +- [ ] 支付渠道回跳 `/wallet?paymentOrder=` 后弹出积分中心并展示支付结果。 + +## 对话工具条上移与输入区收紧(2026-09-17) + +开始对话后,镜头时间线 / 画布中继续收到工作台顶栏,底部提示词面板变矮,视频/图片/文本横排在录音按钮左侧。待登录后发一条消息: + +- [ ] 对话页不再单独占一行工具条;顶栏中间能看到「镜头时间线」「画布中继续」、新建和历史。 +- [ ] 底部输入框明显变矮;模式切换在录音左侧,能看到「视频 / 图片 / 文本」文字。 +- [ ] 消息区右侧不是浏览器自带宽滚动条,而是细轨道;窄屏仍能切换模式、打开镜头列表和历史。 + +## 对话开始后输入区加宽与圆角底板(2026-09-17) + +开始对话后,消息列和底部输入框从 820px 加宽约 30% 到 1066px;输入框圆角后不再垫一块更黑的矩形底。待登录后发一条消息: + +- [ ] 对话列、顶栏和底部输入框明显变宽,但仍居中,窄屏仍吃满左右边距。 +- [ ] 暗色下输入框四角只看到圆角卡片,背后没有一块尖角黑底。 + +## 首页默认图片生成(2026-09-17) + +- [ ] 新会话打开首页 `/`,模式页签默认选中「图片」,而不是「视频」。上次手动切到视频后刷新,仍应恢复视频。 + +## 侧栏签到加油站(2026-09-17) + +积分开启且签到奖励大于 0 时,首页侧栏容量条上方出现领取卡片。待登录工作台后: + +- [ ] 未领取时固定显示「{后台品牌名}加油站」和今日可领积分数,点「立即领取」后积分到账,卡片消失。 +- [ ] 当天已领取、关闭积分或签到积分为 0 时不出现该卡片。 +- [ ] 卡片为白底黑按钮、积分数青绿,侧栏本身不是浅蓝底。 +- [ ] 收起侧栏后仍能领取;在积分中心弹窗外完成签到后回到首页,侧栏卡片也应消失。 + +## 侧栏账号容量进度(2026-09-17) + +登录后首页侧栏左下角用户头像上方展示账号文件容量。待登录工作台后: + +- [ ] 展开侧栏时能看到已用容量、剩余容量、总容量和进度条;数字为真实配额,不是占位。 +- [ ] 收起侧栏后头像上方仍有细进度条,悬停能看到剩余/总容量。 +- [ ] 用量到 70% 变警告色,到 90% 或已满变危险色;点进度条进入资产页,两边数字一致。 +- [ ] 未登录不显示该进度;接口失败时可重试。 + +## Agent 生成失败闭环与快照补全(2026-09-17) + +媒体任务失败不再把整轮 Agent 判死;漏传画布快照由服务端补当前内容哈希;没有长期偏好层时本轮不暴露 `agent_profile_read`。待登录画布后: + +- [ ] 让 Agent 生成一条视频,在审批通过后若上游 503 / 失败:节点应变 error,对话应继续,Agent 能用人话说明失败,而不是整轮「执行失败」。 +- [ ] 同一轮先建文本节点再生成视频,即使模型没带 `snapshotHash`,也应能进入审批而不是报「缺少画布快照」。 +- [ ] 未设置用户/项目/画布偏好时,Agent 不应连打三次空的偏好读取;设置了用户偏好后才应读取该层。 +- [ ] 已提交的失败任务不得自动再扣费重提。 + +## 虎皮椒聚合支付插件(2026-09-17) + +新增官方支付插件 `official-payment-xunhupay`(渠道 ID `xunhupay-aggregate`),不把虎皮椒协议写入宿主。待管理员在插件中心确认插件已开放后,到「财务 / 支付」填写 APPID、APPSECRET 和公网地址并启用渠道: + +- [ ] 插件中心支付分类能看到「虎皮椒聚合支付」,停用后钱包不再出现该渠道。 +- [ ] 配置保存后用户积分中心可选该渠道;扫码(默认)或 `checkoutMode=redirect` 跳转收银都能创建订单。旧库重启后应自动补上 `plugin_version` 列,不再 500。 +- [ ] 支付成功回调返回纯文本 `success` 后积分入账;查单可补单;未支付订单可关闭。 +- [ ] 错误 APPSECRET、伪造回调或金额不一致不得入账。 +- [ ] 暗色主题下扫码区是白底黑码,微信 Native 可直接扫;虎皮椒展示网关返回的二维码图片,扫码应进入支付而不是再看到一张二维码图。 + +## 支付插件跨平台可执行文件(2026-09-17) + +官方支付包内同时带有 macOS、Linux、Windows 的 amd64/arm64 产物,宿主按本机 `GOOS/GOARCH` 选择,不再把 Linux ELF 当成 macOS/Windows 入口。待在对应系统上启用任意官方支付插件后: + +- [ ] macOS(Apple Silicon 或 Intel)开启渠道后可保存配置并创建充值订单,不再出现「支付插件可执行文件或其运行时加载器不可用」。 +- [ ] Linux amd64/arm64 与 Windows amd64/arm64 同样能启动对应 `backend/provider-*`,错误 APPSECRET 仍应失败而不是进程起不来。 +- [ ] 只有 Linux 产物的旧包在 macOS/Windows 上应提示格式或架构不兼容,而不是误报加载器缺失。 + ## 管理后台独立设计系统(2026-09-17) 管理后台改为独立 token / Ant 主题 / 壳层控件,不再消费用户端皮肤和 `WorkspacePage`。待管理员登录后核对: