滴答 AI 用户说明

当前版本：v20261019

滴答 AI 是一款面向开发者的本地智能编程助手，支持对话、计划后再改代码、Agent、内联 Diff、模型路由、Tab 补全、长期记忆、增强 @ 引用，以及完整 Y++ / YStudio 开发文档。数据默认留在本机。

一、使用前必看

1. 模型服务需自备

本软件不附带 AI 模型，也不提供 API 额度。您需要自行准备以下之一：

方式	说明
Ollama（推荐本地）	安装 Ollama，启动后在本机运行；在滴答 AI「设置」中选择 Ollama 后端并挑选模型（如 `qwen2.5:7b`）。
OpenAI 兼容 API	在「设置」中填写 Base URL、API Key 与模型名称，适用于各类兼容 OpenAI 接口的服务。

2. 系统要求

Windows 10 / 11（64 位）
建议 8 GB 及以上内存（使用本地大模型时建议更高）
可访问模型服务（本机 Ollama 或网络 API）

3. 安装与启动

下载并运行 Windows 安装包，按向导完成安装。
从开始菜单或桌面快捷方式启动程序。
首次启动选择工作目录（您的项目文件夹）。
打开「设置」，配置后端、模型与 API Key（如需要）。

二、运行日志与问题反馈

程序启动后会自动在本地写入运行日志，便于排查崩溃或异常。

日志目录（Windows 典型路径）：
```
%APPDATA%\DidaAI\滴答 AI\logs\
```
文件名按日期分开，形如 didaai-日期.log。
应用内查看：菜单 帮助 → 关于滴答 AI，可查看当前版本与日志目录路径。

反馈问题时请提供：

版本号：v20261019
操作系统与简要复现步骤
日志目录中最新的 .log 文件

三、快速上手

打开项目：文件 → 打开项目，选择代码所在目录。
选择模型：标题栏或设置中刷新并选择已安装的模型。
对话模式：直接输入问题，AI 基于当前项目上下文回答。
计划模式：先给出可编辑计划，确认后再执行，适合步骤较多的任务。
Agent 模式：可自动读文件、改代码、执行命令。写文件可在设置中要求确认。
联网：输入框旁「检索」菜单可开启联网，用于查文档与最新资料。
智能检索：发送前按语义匹配项目内相关文件，减少无效搜索。

更详细说明请使用应用内 帮助 → 使用帮助，或返回首页查看功能详解。

四、计划、预览与回退

计划模式：顶部模式选「计划模式」。此时只输出计划，不改文件。可在弹窗中修改，点「开始执行」后切到 Agent。
改动预览：本轮改过的文件集中查看差异，可全部接受、拒绝单个文件，或全部拒绝。
撤销本轮：把本轮写入过的文件恢复到改动前。
检查点：预览里可回退到某一次写入之前，更早的改动会保留。不依赖 Git，记录在本机。
多 Agent：改代码类任务会先调研、再修改、最后验证。调研阶段不改文件，验证阶段才执行命令。
危险命令：删除、强制推送、清空仓库、格式化磁盘等操作会标为高危，必须您确认后才会执行。
执行过程：对话气泡列出工具步骤；命令会显示已用时间。切到其他窗口时，标题栏仍显示当前工具，较长命令结束后可收到系统通知。

五、编辑器与提交

选中代码右键：在编辑器或代码块中选中代码，可解释、重构、写测试，或生成提交说明。
问题面板：项目菜单 → 问题面板。从终端和工具记录里整理编译错误，可把单条或全部交给 Agent 修复。
Git 助手：工作目录需已是 Git 仓库。可查看状态与差异，由 AI 生成提交说明；确认后才会提交。也可生成 PR 描述并填入对话，不会自动推送。

六、会话与标签

左侧会话列表支持：

置顶会话：右键 → 置顶会话
设置标签：右键 → 设置标签
- 新建标签：创建如「写作」「学习」「项目」等分类
- 无标签：清除当前会话标签
- 点击标签名称即可应用到当前会话
- 管理标签子菜单：对「写作」「学习」「项目」等标签进行重命名或删除
重命名 / 删除会话：右键对应菜单项

标签筛选框右键也可对当前选中的标签进行重命名或删除。

七、Skills（技能）

Skills 是可复用的 Markdown 说明文档，在匹配用户意图时自动注入 Agent 提示。

项目级：<工作目录>/.didaai/skills/*.md
用户级：应用配置目录下的 skills/*.md
入口：项目菜单 → 技能 (Skills)

建议在文档开头写明适用场景、步骤与注意事项。

八、MCP 服务器

MCP（Model Context Protocol）用于把外部工具接入 Agent。

打开 设置 → MCP。
添加服务器：
- HTTP：地址填 127.0.0.1:6666 或完整 URL（仅主机:端口时默认请求 /mcp）
- stdio：填写本地启动命令（如用命令行启动的 MCP 服务）
保存后自动连接；Agent 中工具名形如 mcp_<ID>__<工具名>。

九、SSH 远程 Agent

启用后，命令在远程主机执行，本地仍读写工作区文件。

设置 → Agent → SSH，或项目 → SSH 远程 Agent
需配置主机、端口、用户、私钥与远程工作目录
建议配置密钥登录

十、Rules

项目约定写入 .didaai/rules，或通过项目菜单「Rules 约定」编辑。约定会带入对话，让回答更贴合本仓库。

十一、快捷键（常用）

快捷键	功能
Ctrl+N	新建会话
Ctrl+O	打开文件
Ctrl+,	设置
Ctrl+L	聚焦输入框
F1	快捷键指南

完整列表见应用内 帮助 → 快捷键指南。

十二、检查更新

启动后如官网有更新版本，会提示您。也可随时打开 帮助 → 检查更新，或在「关于」里检查。有新版本时打开下载页，需自行下载替换，不会自动安装。

十三、隐私说明

对话、代码与配置默认保存在本机。
使用云端 API 时，请求内容会发送至您配置的服务商，请遵守其服务条款。
API Key 只存在本地配置中。
检查更新只读取官网的版本信息，不上传项目内容。

如有疑问，请附上版本号 v20261019 与运行日志联系发布者。

← 返回首页