滴答 AI 用户说明

当前版本：v20260825

滴答 AI 是一款面向开发者的本地智能编程助手，支持对话、Agent 自动改代码、Skills、MCP 工具扩展、联网检索与 SSH 远程执行等能力。

一、使用前必看

1. 模型服务需自备

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

2. 系统要求

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

3. 安装与启动

1. 解压发布包到任意目录（路径尽量不要含特殊字符）。
2. 双击运行程序。
3. 首次启动选择工作目录（您的项目文件夹）。
4. 打开「设置」，配置后端、模型与 API Key（如需要）。

二、运行日志与问题反馈

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

• 日志目录（Windows 典型路径）：

  %APPDATA%\DidaAI\滴答 AI\logs\

  文件名形如 didaai-20260825.log（按日期分文件）。
• 应用内查看：菜单 帮助 → 关于滴答 AI，可查看当前版本与日志目录路径。

反馈问题时请提供：

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

三、快速上手

1. 打开项目：文件 → 打开项目，选择代码所在目录。
2. 选择模型：标题栏或设置中刷新并选择已安装的模型。
3. 对话模式：直接输入问题，AI 基于当前项目上下文回答。
4. Agent 模式：顶部切换为 Agent，可自动读文件、改代码、执行命令（写文件等危险操作可在设置中要求确认）。
5. 联网：输入框旁「检索」菜单可开启联网，用于查文档与最新资料。
6. 智能检索：发送前按语义匹配项目内相关文件，减少无效搜索。

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

四、会话与标签

左侧会话列表支持：

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

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

五、Skills（技能）

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

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

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

六、MCP 服务器

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

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

七、SSH 远程 Agent

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

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

八、Rules 与 Git

• Rules：项目约定，写入 .didaai/rules 或通过「Rules 约定」编辑，会注入系统提示。
• Git 助手：工作目录需为 git 仓库；可通过项目菜单进入。

九、快捷键（常用）

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

十、隐私说明

• 对话与配置默认保存在本机。
• 使用云端 API 时，请求内容会发送至您配置的服务商，请遵守其服务条款。
• 本软件不会替您申请或存储第三方 API Key 到云端（Key 存于本地配置）。

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

← 返回首页