mdocs 内置 两种 AI 能力模式,共用设置页里的 DeepSeek 配置。
最大区别是用户交互度:
| 🤖 智能助手 | ✍️ 帮写(Coding) | |
|---|---|---|
| 交互度 | 低:以结果为导向,正文侧偏 一次覆写(空文可直写;有正文需你点确认或改走帮写) | 高:以过程为导向,必须和你 交互审阅——分段提案、接受/拒绝,你拍板后才写回 |
| 你在干什么 | 提需求 →(必要时确认)→ 看结果 | 提需求 → 看 Diff → 逐段/整批决定 → 完成并写回 |
其他差异是为此服务的:
| 对比维度 | 智能助手(Ask / Normal) | 帮写(Coding) |
|---|---|---|
| 入口 | 左下角悬浮球(可拖动) | 编辑器顶栏「帮写」/ 欢迎页「AI 帮写」 |
| UI | 小浮层 | 全屏工作台(左对话、右 Markdown Diff) |
| 写回时机 | 确认后直接写服务端(覆写) | 在缓冲区改到满意,点「完成并写回」才进本地草稿 |
| 能力侧重 | 答疑、搜文、建空文档/文件夹、找位置、全文一键生成/重写 | 起草、改稿、润色、续写,精细控制每一段 |
| 会话 | 全局历史(不绑文档) | 按文档隔离 |
| 存储 | tenant/<id>/agent/session/ | tenant/<id>/agent/coding-session/ |
一句话: 要快、愿意一次覆写 → 智能助手;要和 AI 来回改、段段把关 → 帮写。
若你要用 Cursor / Claude 等外部 Agent 读写知识库、落开发契约,见 Agent 开发闭环。
左下角圆形 智能助手 入口(可拖动)。点击打开浮层 「mdocs 智能助手」,主编辑区仍保持打开。按住拖动可改位置(本地记住);挪过之后会出现「重置位置」。

浮层开场会说明分工:答疑用智能助手(可搜文、建空文档、帮你找位置);写 / 精细改正文请用顶栏「帮写」。
浮层内:
宽屏下,助手标题栏可切到 贴左:助手占左侧栏(替换原来的完整侧栏),正文居中。此时文档树会移到右侧纯目录轨(无品牌头 / 新建 / 访客脚),与正文挤占分宽。

目录可收起:右上角收起后,右缘只剩绿色吸附条「目录」,再点即可展开(带宽度动画)。偏好会记住。

浮窗模式或关闭助手后,目录回到左侧完整侧栏。
长会话会占满模型上下文。输入区旁有用量环;与 Skill 并排有 压缩上下文 按钮。

压缩失败不会改历史,本轮仍尽量用原记录继续;摘要块在时间线里显示为「上下文已压缩」,可展开查看。
点用量圆环可打开 上下文诊断:与圆环同源,分三桶查看 系统提示词 / 工具定义 / 会话历史,点条目可读正文。弹框固定尺寸,手机端全屏。
在插件市场安装 Engram 后,助手可经 MCP 跨会话记住决策 / gotcha / 约定(按访客隔离,数据在本机 tenant/<访客>/plugins-data/engram)。装机后会写入灵魂旁路 engram.md;适合「先搜再答」,不是文档仓库。
直接问,例如:
当文档已有实质内容,智能助手不会静默改写。你若要求覆写,助手会弹出选择卡,三选一:
需要和 AI 高交互地改正文(逐段看 Diff、接受/拒绝)时用 帮写。智能助手偏覆写结果;帮写偏过程协作。
打开一篇文档后,在编辑器顶栏工具条右侧(发布 / 删除附近)点击 帮写(带星标图标)进入全屏工作台。欢迎页也可点「AI 帮写」从空白开始。


| 区域 | 说明 |
|---|---|
| 顶栏 | 文档名;取消退出;完成并写回把已接受内容写回(已有文进本地草稿) |
| 左侧 · 对话 | 说明要写/改什么;助手可「读取帮写工作稿」再「设置帮写正文」更新提案;+ / 历史管理会话;与智能助手一样支持后台跑完(关掉工作台不掐断,重开可续) |
| 右侧 · 提案 | 红删绿增的分段 Diff;可 全部接受 / 全部拒绝,或逐段操作;也可切 纯编辑 手改;底部可在变更间跳转 |
帮写的核心不是「更能写」,而是 必须和你交互:
deepseek-v4-flash 或 deepseek-v4-pro
未配置 Key 时,入口可用但无法发送消息,浮层 / 帮写会提示去配置。
💡 快捷方式:直接点智能助手面板里的「配置」卡片,不用进设置页也能填 Key。
如果你用其他模型服务商(OpenAI、Anthropic、自建网关等),可以用自定义配置:
https://api.openai.com/v1)gpt-4o、claude-3-5-sonnet-20241022)anthropic 会自动识别)DeepSeek / 自定义配置都支持 思考强度(关 / 低 / 高 / 最大)与上述单轮超时。
~/.mdocs/secrets/agent-api-keys.json,文件权限 0600(仅本人可读写)同一页下方还可管理 Agent Skills(私人提示词宏):
list_user_skills / get_user_skill(读全文)/ create_user_skill(表单卡)/ update_user_skill(直接写入,带版本防覆盖)/ delete_user_skill落盘与会话历史只保存 skill 名称引用,不会把正文全文写进聊天记录;请求时再按名称展开进模型上下文。
可以直接问,例如:
助手会按需阅读 mdocs 用户手册 相关章节,也可在你有权阅读的范围内读取知识库文档。工具结果(搜索表、目录树、读文预览等)会出现在对话时间线中,默认折叠,展开可查看;历史会话重开后通常只保留文字、不再回放这些工具块。答完后通常会附带一两个可继续追问的示例。
tenant/<访客ID>/agent/session/ 下,刷新或重开浮层仍可续聊。tenant/<访客ID>/agent/runs/(与会话 transcript 分离),用于关面板后回放。若你在智能助手里要求写作,助手会根据文档状态决定:空文直接覆写,有正文则弹出选择卡。