首页 / mdhouse
笔记和文档，尽在一个浏览器标签页。AI 写下问题——你点一下就能回答。
把它指向一个文件夹——笔记、一个仓库，或者装满仓库的整个目录——就能得到一个飞快的页面：文件树、即时搜索， 还有由 git 驱动、实时更新的最近改了什么视图。不导入、不建索引、不上传；除非你明确允许， 它绝不往文件夹里写任何东西。
▸ 安装
bun install -g mdhouse # bun 1.4+ required▸ 启动
mdhouse ~/notes ~/src -p # serve folders, -p = save them for every later start, start in background
mdhouse service install # starts now and at every login, serving the saved folders- 打开 http://127.0.0.1:7777
mdhouse --rw <folder>——添加一个新文件夹，并允许 在页面上编辑和回答- 更多内容见 运行说明
📖 你写的一切，都在这里读
- ⚡ 实时推送，不靠轮询
- 磁盘上的文件一改，页面就通过 WebSocket 跟着变。在编辑器里改也好，让 agent 改也好， 你只管看。
- 🔥 ♨️ 新鲜度一目了然
- 🔥 表示最近十分钟内改过，♨️ 表示最近一小时内，之后颜色在一周内逐渐褪成灰色。 新东西一眼就能看到。
- 🌿 内置 Git
- 谁在什么时候改了什么、昨天以来有哪些新内容、每个文件最近的提交。commit、pull、push 都是一个按钮的事。
- ⊟ 好读的 diff
- 改动直接叠加在渲染后的文档上——新增标绿、删除标红——读起来和文档本身一样轻松。
- 🖋 渲染到位
- GitHub 风格 Markdown，外加 alert、脚注、mermaid 图表、代码高亮、front matter； 图片、PDF 和视频直接内嵌。和 GitHub 一样好，甚至更好。
- 📁 所有文件夹，一棵树
- 所有仓库都在一个侧边栏里；遵循
.gitignore，每个文件都有自己的 URL。 - 🔍 什么都能搜
- 文件名边输边搜；全文搜索由 ripgrep 提供——点开结果直接定位到那一行。
- 🕐 Recent 和 Mine
- 所有内容里最近的改动，以及你自己的改动，未提交的排在最前。
👾 你和 AI 共用的工作台
agent 写的是普通的 .md 文件；mdhouse 把里面的标记变成按钮。
文件本身就是对话——没有会丢的聊天记录，放到 GitHub 上照样好读。
- ❓ AI 提问，你来点
- 它的问题会变成按钮。输入答案后写回文件；AI 读到后接着干活。
- 💡 AI 建议，你拍板
- ✓ 同意或 ✗ 取消，点一下就行。多个选项会变成单选按钮。
- 🔴 🟠 ⚪ 问题分级
- AI 找出问题并标注严重程度；一栏计数条可以统计和筛选。修哪些，由你挑。
- 🎯 指哪打哪
- 标出你接下来想完成的条目；AI 只做这些。
- ✅ 完成情况看得见
- 修好的条目变绿并折叠起来，对应的提交就在旁边。
- 📌 定了就不再翻
- 已定的规则醒目显示，下面附上被否掉的方案——无论人还是 AI，都不会再翻旧账。
任何 AI 都能用
agent-markup.md 是写给 AI agent 看的，不是给人看的：一个自包含的页面，教会 agent 使用 mdhouse 推荐的标记——问题、提议、 选项、带严重程度的问题项、决定和 id——这样它写出来的内容在页面上渲染成按钮，在 GitHub 上依然是普通 Markdown。 把任意 agent 指向它，说一句“照这个做”：
use https://github.com/parf/mdhouse/blob/main/doc/agent-markup.md and do a reviewClaude Code 有现成的 skill——/ask-questions、
/resolve-questions、/find-issues、/fix-issues——让它从仓库里
复制过来就行。给人看的指南是
问与答。
🗨 和 agent 聊当前页面
只要 agent-bus 在运行，mdhouse 就会在文档旁打开一个聊天面板。 你可以就当前页面和 AI agent 对话；它读的是同一个文件，每个页面都有自己的对话历史。
- 文档就是工作区——聊天只负责把 agent 引到文档上。agent 修改文件，页面实时跟进， 你在页面上作答，再点 “Updated” 交还给它。
- 常用的下一步，一键完成——重新读取、处理 🎯 条目、带入已有回答、 做 review。
- 页面可以归某个 agent——agent 把自己的总线名写进文件； 否则由你选一个，或者由默认 agent 来回答。
- agent 那边什么都不用改——这就是一条普通的 agent-bus 消息，agent 像回复任何对端一样 回复。
mdhouse --agent-bus # local bus
mdhouse --agent-bus http://host:6767 # remote bus, over TCP with a token详细说明（包括通过 ssh 转发 socket、无需 token 的方式）： Agent Bus 集成。
🔒 本地运行，安全可靠
- 默认只读——只在用
--rw提供的文件夹里写入。 - 小而受检的写入——勾一个选项、一条回答、标题下的一段内容。每次只动它自己的那几行； 如果文件在此期间被改过，写入会被拒绝，你写的内容会保留下来。
- 数据不出本机——默认绑定
127.0.0.1，除非你传入--host；不复制、不上传任何内容 （访问控制）。 - 浅色、深色主题都有，手机上也好用。