dots-agent - 会主动找活干、自己攒技能的智能体

dots-agent 是一个智能体项目，仓库由维护者 duyongan 托管在 GitHub 上，采用 MIT 许可证。按项目自述，它的定位是「一个会主动发现任务、主动积累技能的智能体」：不是等人一条条下指令，而是按固定节奏自己找活干，并把干过的流程总结成可复用的技能存下来。它面向的是希望把一批琐碎事务交给一个常驻进程处理、同时又想保留人工审批闸门的用户。安装后提供的命令是 dots，据项目说明有两种用法：命令行，或者 Windows 桌面窗口。

维护者与状态

仓库地址为 duyongan/dots-agent，维护者为 duyongan。仓库创建于 2026-10-15，最后一次提交在 2026-10-20，最新正式 release 为 v1.2.0，发布于 2026-10-20。截至 2026-11-06，仓库星标数为 205。

从时间线看，这是一个相当新的项目：创建到最新 release 之间只有数天，版本号已经走到 v1.2.0。这意味着接口和配置格式仍可能变化，采用前建议先对照仓库中的说明确认当前行为。

主要能力

以下内容均来自项目自述（README），属于维护者的描述，未经独立验证。

• 主动值守循环：据项目说明，它按固定间隔跑一轮，每轮自己判断该做什么，不需要用户每次喊话。界面顶栏会显示「每 60s 一轮」这类状态，间隔来自配置项 [dot] tick_seconds。
• 目标队列：一件要做的事被建模为「目标」，项目自述列出七种状态，包括待批准、排队中、在跑、停下等你、待复核、完成、失败。其中「待复核」用于智能体声称完成但没有给出证据的情况——没有证据的结论不会直接算完成。
• 技能积累：智能体干活时会自己总结可复用流程，每份技能是一个目录，内含 SKILL.md。据项目说明，技能库采用渐进披露：每轮只有「名字 + 描述」进入系统提示，正文等真正用到时才读取，因此描述被限制在 60 字符以内。
• 审批闸门：哪些动作需要人工批准由配置决定，例如 send_email = "ask" 表示挂起等人批，run_shell = "deny" 表示永不执行；没有写到的动作一律按 ask 处理，即默认从严。挂起的审批超过设定时长（默认 72 小时）会自动按拒绝处理。
• 对话与后台任务分离：据项目说明，交互终端里直接打字就是对话，带上下文、可追问；但对话不算目标，不进目标列表，后台循环也不会碰它。要让一件事在后台慢慢跑，需要用 /goal 或新建目标。
• 桌面窗口：Windows 桌面版把日常操作收进一个窗口，包含顶栏状态与值守开关、待批横幅、目标/技能/活动三栏监控区、对话区，以及一个展开后是中文按钮的命令抽屉。它和命令行版共用同一份配置、同一个数据库、同一个工作区。
• 自检与体检：dots doctor 逐项检查配置、依赖、模型、工作区可写、数据库、审批通道、技能库、成本上限等；dots selftest 则不联网、不调模型，跑一遍模块自检与测试。

使用入口

项目仓库：duyongan/dots-agent。

据项目说明，命令行版可通过 pip 安装，装完即可使用 dots 命令：

pip install dots-agent

也可以不安装，直接在仓库里运行：

git clone https://github.com/duyongan/dots-agent
cd dots-agent
python -m dots serve

首次使用需要生成配置并体检。项目自述推荐写一份全局配置，这样换目录不用重新初始化：

dots init --global
dots doctor
dots goal "把 inbox 里的东西整理成一份报告"
dots serve --web

Windows 桌面版方面，据项目说明，安装包按用户安装、不需要管理员权限，自带嵌入式 Python 和全部依赖，机器上没装过 Python 也能运行；日常使用是双击 dots.exe，安装器只装一次。项目特别提示：后端找不到 dot.toml 会直接退出，界面顶栏显示「后端已停」、按钮全部变灰，因此第一次使用前应先在终端里生成全局配置。

许可与限制

许可证为 MIT。

项目自述中提到的已知限制与适用边界包括：

• 桌面版目前仅面向 Windows：安装包、%LOCALAPPDATA% 安装路径、Windows 卸载入口等描述都指向 Windows 环境。
• 启动有等待期：据项目说明，桌面版启动时后端导入依赖约需 10 秒，这段时间输入框和按钮是灰的，并非卡死；在后端就绪前发出的命令会堆在管道里，顺序不可控。
• 对话不是流式输出：发送后显示「正在想…」，慢模型下可能要等十几秒才出整段回答。
• 列表有截断：目标列表最多显示最近 60 条，活动面板最多显示最近 120 行，界面里最多保留最近 300 条消息用于显示。
• 部分功能不在界面里：常驻循环加只读网页活动视图、干跑模式等仍需用命令行，项目自述给出的理由是避免再起一个 worker 抢同一个数据库。
• 技能整理会真的删改文件：dots curate 会合并重复、删除没价值的技能，项目说明会先弹确认，且技能少于 2 份时不会创建目标。
• 需要自备模型配置：dots init 会探测环境变量里的模型 key，没探到就要手填配置文件的 [model] 段。

以上能力与限制均出自项目自述，实际行为请以仓库当前代码与文档为准。