diff --git a/docs/ai-deeplink-plugin-spec.md b/docs/ai-deeplink-plugin-spec.md deleted file mode 100644 index 2868e8751..000000000 --- a/docs/ai-deeplink-plugin-spec.md +++ /dev/null @@ -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/) - 规则: - - 只能取下表中的值(闭集,禁止臆造;不确定就不要加链接,写普通文字) - - 一个目的地在一段话里最多链一次,不要给同一名词重复加链接 - - 只链"页面/面板"这类导航目的地;不要给动作词(点击/保存/开启)加链接 - - 深链只把用户送到那一屏,页面内具体控件仍用文字说明 - ``` - -- 典型例子(供 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 表。