mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-20 04:57:51 +00:00
chore(docs): 取消跟踪 AI 深链插件规格文档
deeplink 方案主程序侧 + 插件侧(dootask-ai)均已落地,该跨仓库 改动规格使命完成,从版本控制移除,文件本地保留(docs/.gitignore)。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
a3d5bdf93c
commit
ac2d4c6c4f
@ -1,40 +0,0 @@
|
||||
# AI 内联深链 · 插件侧改动规格(dootask-ai,独立仓库)
|
||||
|
||||
> 本仓库(主程序)已完成:深链目录、前端渲染/执行、移除 driver.js 引导。
|
||||
> 本文是配套的 **AI 插件仓库** 改动规格——只有插件侧改完,AI 才会真正在回复里输出深链。
|
||||
> 在插件改动落地前,主程序侧深链链路可用 `window.__openDeepLink('setting_system')` 或手工构造回复文本验证。
|
||||
|
||||
## 背景
|
||||
原「带我去」分步引导(driver.js + `show_guide` MCP 工具)已下线。替代方案:AI 在回复正文里把"可定位的页面/面板"词包成 **标准 markdown 链接**,前端渲染成可点 chip,点击直达那一屏。
|
||||
|
||||
## 需要做的改动
|
||||
|
||||
### 1. 下线引导
|
||||
- 删除/注销 `show_guide` MCP 工具(工具定义 + 注册 + system prompt 里对它的说明)。
|
||||
- 删除 system prompt 里关于 ` ```ai-guide ` 围栏脚本(steps/target/pre_action)的全部指导。
|
||||
|
||||
### 2. 启用深链
|
||||
- 把主程序 `resources/ai-kb/_meta/page-links.yaml` 的目录(`id / title / aliases / description`)注入 system prompt。建议在 ingest ai-kb `_meta` 时一并读取,渲染成一张"可用深链 id 表"。
|
||||
- 在 prompt 中约定输出语法与硬约束:
|
||||
|
||||
```
|
||||
当回答涉及"某功能/设置在哪、怎么去某页面"时,把页面/面板名写成 markdown 链接:
|
||||
[显示文字](dootask://link/<id>)
|
||||
规则:
|
||||
- <id> 只能取下表中的值(闭集,禁止臆造;不确定就不要加链接,写普通文字)
|
||||
- 一个目的地在一段话里最多链一次,不要给同一名词重复加链接
|
||||
- 只链"页面/面板"这类导航目的地;不要给动作词(点击/保存/开启)加链接
|
||||
- 深链只把用户送到那一屏,页面内具体控件仍用文字说明
|
||||
```
|
||||
|
||||
- 典型例子(供 few-shot):
|
||||
- 问「在哪里设置端到端加密」→ 「……在 [系统设置](dootask://link/setting_system) 的消息相关里开启。」
|
||||
- 问「怎么改个人资料」→ 「打开 [个人设置](dootask://link/setting_personal) 即可修改。」
|
||||
|
||||
### 3. 性质
|
||||
- 与原「带我去」一样属**建议性**:AI 是否生成深链取决于是否遵循 prompt。
|
||||
- 前端已对**非法 id 做兜底**(渲染时退化为纯文字,绝不出现死链),故 prompt 约束 + 前端校验双保险。
|
||||
|
||||
## 与主程序的契约
|
||||
- id 闭集 = `page-links.yaml` 的 `links:` 键集合,当前 21 个;主程序 `deep-links.js` 与之逐一对应(CI 校验 `tests/deep-links-parity.mjs`)。
|
||||
- 新增/调整深链目的地时:先改主程序 `page-links.yaml` + `deep-links.js`(同一提交),再同步插件注入的 id 表。
|
||||
Loading…
x
Reference in New Issue
Block a user