kuaifan 39b9a72b16 refactor(ai-assistant): 用内联深链替代 driver.js 页面引导
「带我去」分步引导(driver.js + 四级元素定位 + show_guide)定位不稳、
二级菜单不可达、点高亮按钮触发跳转即被杀,体验差。改为 AI 回复正文里把
可定位的页面/面板渲染成可点深链 chip,点击直达那一屏。

- 新增深链目录:_meta/page-links.yaml(语义,供 AI 选择)+ deep-links.js
  (可执行映射,21 个无需运行时 id 的导航目的地),两端 id 一致性由
  tests/deep-links-parity.mjs 校验
- markdown.js 加 processDeepLinks:[文字](dootask://link/<id>) 合法 id →
  chip,非法 id → 纯文字(绝不渲染死链);复用现有 dootask:// 点击拦截链路
- DialogMarkdown 加 link 分支调 openDeepLink;system.vue 支持 query.tab
  初始化,系统设置二级 Tab 可深链直达
- 彻底移除 driver.js 引导:删 guide-renderer.js/guide.css、show_guide
  前端通道、aiGuideStarted 监听、driver.js 依赖
- 同步 ai-kb:改写 guide/start-guide 两 chunk、tool-binding 去 show_guide
- 插件侧 prompt 改动规格见 docs/ai-deeplink-plugin-spec.md(独立仓库实施)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 23:55:09 +00:00

42 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: ai-assistant.guide.concept
title: 什么是页面深链(带我去)
type: concept
feature: ai-assistant
scope: end-user
locale: zh
aliases:
- 操作引导
- 带我去
- 带我操作
- 页面深链
- 快捷跳转
related_tools: []
related_pages: []
prerequisites:
- 应用市场已安装 ai 插件
negative:
- 深链只负责把你送到对应页面/面板,不会自动帮你点击页面内的具体按钮或开关
- 需要运行时定位的目标(某条具体任务/对话)不通过深链,由 AI 直接帮你打开
last_verified: v1.7.90
---
# 什么是页面深链(带我去)
## 这是什么
当你问 AI「X 在哪里设置 / 怎么去 X」时AI 的回答里会把可定位的页面或面板(如「系统设置」「个人设置」「日历」)渲染成**蓝色可点击的链接**。点一下就**直接跳转到那一屏**,省去自己翻菜单。
## 怎么用
- 在 AI 助手浮窗里问操作类/“在哪”类问题
- 回答正文里出现蓝色链接词点击即跳转AI 浮窗会自动收起,避免遮挡)
- 到达目标页后,按回答里的文字说明完成剩下的操作
## 边界
- 深链把你送到**正确的页面/面板**;页面内具体那一行开关/按钮在哪,需要你按说明自己看一眼
- 不是每个名词都可点:只有命中系统内已登记目的地的词才会变成链接,其余按普通文字显示
- 打开某条具体任务/对话(需要具体 ID不走深链AI 会直接帮你打开
## 相关
- 如何使用:[[ai-assistant.start-guide.howto]]
- AI 操作页面的底层能力:[[ai-assistant.page-action.concept]]