Skip to content

fix(home): 首页 AI 卡片改称平台助手,并按文档口径指向右缘助手面板 (#1002) - #1005

Merged
yinlianghui merged 1 commit into
mainfrom
claude/issue-1002-home-card-depersonalization
Aug 6, 2026
Merged

fix(home): 首页 AI 卡片改称平台助手,并按文档口径指向右缘助手面板 (#1002)#1005
yinlianghui merged 1 commit into
mainfrom
claude/issue-1002-home-card-depersonalization

Conversation

@yinlianghui

Copy link
Copy Markdown
Collaborator

Fixes #1002

src/pages/home.page.tsai_briefing 卡片是 PR #1001 全站去人格化之后、src/
与维护者文档中仅存的最后一处退役人格,而且它不是文档,是用户今天就能看到的界面文案。

改了什么

-          label: 'Today with Copilot',
+          label: 'Today with the AI Assistant',
           properties: {
-            title: 'Ask the Sales Copilot',
+            title: 'Ask the AI Assistant',
             description:
-              'Open the floating Copilot (bottom-right) and ask "what should I focus on today?" — it sees your live pipeline, schema, and accounts.',
+              'Open the assistant panel from the right edge of the page and ask "what should I focus on today?" — it sees your live pipeline, schema, and accounts.',

两处漂移,都按 #612 评论区维护者 2026-08-04 的方案 A 拍板与随后的架构定调处理:

  1. 人格sales_copilot 已由 refactor(ai): skills-only AI surface — real Actions instead of 10 fictional tools, retire the two agents #512 退役,ADR-0063 §2 把应用面收敛为 skills-only;
    AI 能力由 objectstack-ai/cloud 侧的 agent 承载,应用只定义领域 skills。卡片因此
    不能再指向一个本应用不包含的实体。裸 "Copilot"(label 与 description 里各一处)
    一并中性化——文档侧 docs: align README/copilot pages with the shipped skills-only surface (#589) #611 保留 AI Copilot 作为文档区名,那条界线不适用于界面卡片。
  2. 入口:卡片写「the floating Copilot (bottom-right)」,而
    content/docs/ai-copilot/index.mdx 的现行口径是「the chat panel the platform opens
    from the right edge of every page」(docs: align README/copilot pages with the shipped skills-only surface (#589) #611 / PR docs: 全站去人格化 Copilot 称呼,并把版本号钉到 manifest (#612) #1001 落地)。两种说法指向同一个
    入口却互相矛盾,按文档口径统一。

卡片的功能语义原样保留:同一张卡、同一个位置、同一个建议问句、同一句「它能看到你的实时
管道、schema 与客户」。

语言包

没有对应键,取值链是字面量直通产物。 翻译契约里 pages.strict() 的四个键
label / description / title / subtitle,其中 title / subtitle
test/i18n-references.test.ts 的注释对应的是 page:header(header 实例无稳定 id,
页面名是唯一能够到它的键)。卡片 title / description 没有任何翻译位——语言包写不进去
(strict 会拒),运行时也无处可读。四个语言包 pages.sales_home_page 现有的
label/description/title/subtitle 与本次改动无关,故未动。

这个缺口本身另立 #1004 记录(实测 12 处,首页占 10 处;对照组是 dashboards.widgets
——同样按 id 定位的组件,那边翻译面)。

验证

六道门在共享锁内串行,全绿:

结果
pnpm validate exit 0(5 条既有 author-time 警告,与本改动无关)
pnpm typecheck exit 0
pnpm lint exit 0(13 warning / 14 suggestion,均既有)
pnpm hygiene exit 0,✓ no raw control bytes(257 + 454 文件)
pnpm build exit 0,Artifact: dist/objectstack.json
pnpm test exit 0,77 files / 1822 passed / 1 skipped

dist 产物核对(新串进产物、旧串归零):

"Ask the Sales Copilot"  => 0      "Ask the AI Assistant"                => 1
"Sales Copilot"          => 0      "Today with the AI Assistant"         => 1
"Today with Copilot"     => 0      "Open the assistant panel from the …" => 1
"floating Copilot"       => 0
"bottom-right"           => 0
产物中任何 "Copilot" 残留 => 0

既有守卫零回退docs-drift / i18n-references / metadata-references /
skills-integrity / source-hygiene-scan-surface 五个文件 120 断言全绿。

反向验证(方向先定后跑:红→绿,普通禁字规则的常规方向):把三行旧文案原样放回,
新 pin 的 3 条断言里 2 条转红——["Sales Copilot", "Copilot"] 被 title/label 命中,
以及 expected 'open the floating copilot (bottom-rig…' not to contain 'floating'
第 3 条「卡片仍在页面上」的防空转断言保持绿(它本来就该绿)。改回后 30/30 全绿。

新增的 pin 与它覆盖的东西

test/metadata-references.test.ts 新增 live UI copy does not name a retired copilot persona (#1002),与既有的两条退役 agent 守卫同族。三条断言:卡片仍可达(防空转)、
文案不含人格名、入口不再写 floating/bottom-right 且写了 right edge。

这条 pin 只钉这一张卡片,是刻意的:换一张卡片、换一个视图的 emptyState、换一条
skill 的 description,同样的人格照样进得来。把扫描面扩到 src/ 全部用户可见字符串
title/label/description/help)会碰公共措辞面、需要单独裁定(裸 Copilot 算不算
违规、豁免机制怎么设),按本单裁定不在此做——已立 #1003 记录。

边界


Generated by Claude Code

…the home card

The `ai_briefing` card on `sales_home_page` still read "Ask the Sales
Copilot" and pointed at "the floating Copilot (bottom-right)". Both are
wrong in live UI copy a user sees today:

- The `sales_copilot` agent was retired in #512 and ADR-0063 §2 made the
  app surface skills-only. Per the maintainer's 2026-08-04 ruling on
  #612 (Option A) plus the architecture note that followed it, AI
  capability is implemented by agents in objectstack-ai/cloud and HotCRM
  contributes domain skills — so the card named an entity this app does
  not contain.
- The entry point contradicted the docs: `content/docs/ai-copilot/index.mdx`
  documents "the chat panel the platform opens from the right edge of
  every page" (#611 / PR #1001), not a floating bottom-right widget.

Card behaviour, position and functional promise are unchanged; only the
name and the directions moved. Card copy has no locale keys — the
translation contract exposes page label/description/title/subtitle only
— so the value chain is the literal in `home.page.ts` straight into
`dist/objectstack.json`, which now carries zero occurrences of
"Copilot" in any spelling.

Pinned in `test/metadata-references.test.ts` alongside the other retired
-agent guards. The pin is deliberately scoped to this one card: a
scan-surface rule over every user-visible string in `src/` is a separate
question and is filed on its own.

Refs #1002.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VHrPAGEgFDoHjphqYG4BMa
@vercel

vercel Bot commented Aug 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
hotcrm Ignored Ignored Aug 6, 2026 6:19pm

Request Review

@yinlianghui
yinlianghui marked this pull request as ready for review August 6, 2026 18:23
@yinlianghui
yinlianghui added this pull request to the merge queue Aug 6, 2026
Merged via the queue into main with commit acc37e6 Aug 6, 2026
2 checks passed
@github-actions github-actions Bot added ci/cd CI plumbing and the verification pipeline metadata Declarative metadata — schema, security posture, UI surfaces labels Aug 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci/cd CI plumbing and the verification pipeline metadata Declarative metadata — schema, security posture, UI surfaces

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Home page still ships a card titled "Ask the Sales Copilot" — a retired persona in live UI metadata, outside every docs guard's scan surface

2 participants