v0.9.5 - AI 自主工具、Threads 讨论重构与模板界面优化 : docmd docs

docmd v0.9.5 带来了自主 AI 助手 Agent 工具套件与扩充至 200k 的上下文窗口、全新重构的 Threads 协作讨论插件（包含右侧停靠标签与内联评论预览卡片）、Default 与 Summer 模板的界面体验优化，以及 OpenAPI 多项目工作区路径解析。

自主 MCP 客户端工具套件：直接在浏览器端为 AI 助手接入了 5 项核心客户端工具：
- get_site_structure：读取完整的站点版本树（当前及历史版本）、语言列表、多项目边界及页面层级。
- search_documentation：支持在文档站点内进行全文检索与语义向量检索。
- read_documentation_page：从任何页面拉取结构化清晰的 Markdown 文本内容。
- navigate_to_page：智能平滑导航访客至目标章节与小节。
- copy_code_snippet：直接提取代码块与命令至访客剪贴板，并带有明确视觉反馈。
无截断上下文窗口（默认 200k 字符）：移除了先前硬编码的 15,000 与 40,000 字符限制，引擎现在将完整的检索文档上下文（默认最高 200,000 字符）传递给大模型，保障技术解释与配置示例的完整性。
可配置 contextWindow：在 plugins.ai 配置中新增了 contextWindow（或 contextLimit）参数，方便项目针对特定 Token 配额进行弹性定制。
代码块渲染优化：助手 Markdown 代码块增加了语法高亮、语言徽标以及一键复制按钮。
Cloud 中继遥测与日志去重修复：修复了工具自主循环调用期间将内部多轮检索重复计入 Cloud 查询分析的问题，并彻底清除了长问题中出现的孤立引号前缀。

侧边栏重新打开持久性保证：放弃易出错的 DOM 节点移位逻辑，重构为基于内存数据的安全渲染与 CSS 驱动的状态隐藏（body.tc-panel-open .threads-thread--inline）。无论如何关闭或重新打开讨论面板，帖子卡片始终完好保留。
无刷新评论与回复交互：新增讨论、回复以及状态标记操作全部改为纯前端即时原地刷新，彻底免去整页重新加载。
全新行内评论预览卡片：高亮文字正下方新增精致的行内讨论卡片，附带高亮文本引用标签（"..."）以及 “侧边栏打开” 快捷链接，点击平滑滚动并高亮侧边栏卡片。
右侧停靠滑入标签：将悬浮按钮 .threads-fab 改造为右侧居中停靠的滑块标签（top: 50%; right: 0），彻底消除与返回顶部按钮（.summer-totop）及底部 AI 助手界面的布局重叠。
线条风格现代化图标：全量更新插件图标为 Lucide/Feather 2px 细线描边 SVG（messages-square、quote、external-link、reply、trash、plus、check、x），与 docmd 整体风格高度统一。
Summer 与默认模板原生融合：完美继承 Default 与 Summer 模板的设计令牌（--summer-surface、--summer-border、--summer-accent 等）。
标题悬停操作体验：重构了标题旁的 “+ 发起讨论” 按钮，默认隐藏并在鼠标悬停或键盘聚焦时平滑显现，消除视觉干扰。

多项目工作区路径解析：优化了在复杂工作区和子项目场景下的规范文件查找（例如子站点目录内的 assets/docmd-api.json）。插件现会自动检索当前 Markdown 所在目录、项目边界根目录以及工作区根目录。
下载按钮遵守配置：下载按钮正确遵循 download: true 配置，并生成相对于根路径的下载链接。
内联 OpenAPI 规范支持：标记为 ```openapi 的代码块现在可直接解析内联嵌入的 JSON 或 YAML 规范文本，无需依赖独立的外部文件。
精确的错误诊断：当规范文件路径缺失或无法找到时，开发构建期间将显示清晰的 .oa-error 提示框。

requiresLiveServer 插件清单声明：依赖实时本地开发服务器 RPC 通信的插件（例如协同编辑、热文件持久化或 @docmd/plugin-threads 讨论插件），现可在插件描述符 (PluginDescriptor) 及包清单 (package.json#docmd.requiresLiveServer) 中声明 requiresLiveServer: true。
静态构建资源自动精简：在执行静态生产构建（docmd build）时，docmd 会自动省略这些插件的前端脚本、样式与元数据标签，同时完整保留 Markdown 容器与语法解析器，确保最终静态部署站点零冗余、零报错、保持极简轻量。
通用 Live 服务器可用性检测 (docmd.isLive() 与 docmd.ping())：在 @docmd/api 浏览器客户端及开发服务器中内置了全套状态检测机制。客户端可通过 docmd.isLive() 同步检查 WebSocket 活跃状态，或通过 await docmd.ping() 触发内置的 system:ping 进行端到端健康检查。

多语言一致性：在英语 (en)、德语 (de)、西班牙语 (es) 和中文 (zh) 之间完全同步了发行说明、Cloud AI 中继指南与导航树。

本页内容