Housen Browser 安装与使用说明

感谢参与内测 · 请按下面步骤操作

适用于 0.1.x

← 返回产品页下载 PDF 版（可转发 / 可离线）

先看这一句 安装时 Windows 会弹一个「未知发布者」的警告 —— 那是正常的，不是病毒。按第二节操作即可，全程 1 分钟。

1下载

打开产品页，点页面上的「下载」按钮。

下载得到一个文件：housen-browser-<版本号>-setup.exe，大小约 96 MB。

文件名里的数字就是版本号（例如 housen-browser-0.1.3-setup.exe），换新版本时这个数字会变，不影响安装。

2安装

① 双击安装包

Windows 会弹出这样一个窗口：

Windows 安全中心

Windows 已保护你的电脑

未知发布者

不运行更多信息

不要点「不运行」。

② 点「更多信息」

窗口会展开，「不运行」右边会多出一个 「仍要运行」 按钮。

③ 点「仍要运行」

安装就开始了。

为什么会有这个提示？ Windows 对所有没有购买「代码签名证书」的软件都会这样提示。它针对的是「未知发布者」，不是病毒报警。我们正在申请证书，之后的新版本就不会再弹了。

④ 关于安装位置（两件容易误以为出错的事）

它不会问你装到哪个目录，直接装到你的用户文件夹：

C:\Users\<你的用户名>\AppData\Local\Programs\housen-browser\

装完会自动启动。

这两点都是正常行为，不是出错。
想卸载：Windows「设置 → 应用」里找到 Housen Browser 卸载即可。

⑤ 如果双击后完全没反应

右键安装包 → 属性 → 底部若有 「解除锁定」 勾选框 → 勾上 → 确定 → 再双击。

（这是 Windows 对「从网上下载的文件」的额外拦截。）

3首次启动

不需要注册，也不需要登录 —— 打开就能用。
首次启动会自动联网激活，免费试用 7 天。
试用期内功能与付费版完全相同，没有任何限制。
7 天从「第一次打开」那天开始算。

首次启动需要能上网 要连授权服务器激活。如果公司/学校网络有限制，请先确认这台电脑能访问：license.haoshengduok.top

4怎么保存网站、怎么分组

先理解一件事：在 Housen 里，一个网站 = 一个「账号」 这里的「账号」不是指登录 Housen —— 它指的是一个独立的浏览器身份（独立的 Cookie 和登录状态）。
所以同一个网站你可以存好几份，每份登录不同的号，互相完全隔离、不用来回退出登录。

① 新建分组（按公司 / 项目分）

点侧边栏右上方那个 + 按钮
输入分组名称（比如「A 公司」）
回车或点「确定」

② 往分组里加网站

鼠标移到分组名上（比如「A 公司」）—— 右边会浮出三个小按钮 ✏️ 🗑️ +
点那个 +
填名称（自己认得出就行，比如「抖音」）和 url（要带 https://）
点「添加」

url 一定要写全 比如 https://www.xiaohongshu.com —— 少了 https:// 打不开。

③ 用的时候怎么操作

单击某个网站 = 切过去（保留它当前的页面现场）
双击某个网站 = 直接回到它绑定的网址

④ 改名字 / 换分组 / 删除

鼠标移到某个网站上，右边会出现 ✏️ 和 🗑️：

✏️ —— 改名字、改网址、换到别的分组
🗑️ —— 删除

（删除分组时，组里的网站不会被删，会自动移进「其他账号」。）

⑤ 懒得分组？

直接加在「其他账号」里就行 —— 在侧边栏下半部分的空白处点右键，会直接冒出「名称 / url」输入框。

小技巧：换电脑 / 重装前先备份 侧边栏右上角的 ⋯ 菜单里有 「导出账号备份」 —— 会把你的分组和网站清单导成一个文件，在新机器上用 「导入账号备份」 一键还原。（只带清单，登录状态需要在新机器上重新登一次。）

5试用到期后怎么购买

到期后软件会锁定，并弹出提示框，里面有 「刷新授权」 按钮。

购买步骤：

点左下角的 「我的账号」
如果还没注册，先切到 「注册」 标签注册一个账号
登录后就能看到 「购买 / 续费」，选套餐
用微信扫码支付
支付成功后自动解锁 —— 不用重启，也不用找客服

套餐	价格	折算
月付	99 元	99 元 / 月
季付	207 元	69 元 / 月（省 30）
年付	468 元	39 元 / 月（省 60）

试用期没到期也能提前买 随时可以买，买的时长会在你现有到期日之后直接叠加，不浪费。

一个账号绑定一台电脑。

6换电脑怎么办

在旧电脑上：账号区 → 解绑本机（旧电脑回到「设备试用」状态）
在新电脑上登录同一个账号即可

⚠️ 7 天内最多解绑 2 次。

7对接 AI 智能体（本地 API）

Housen 内置了一个本地 HTTP 接口。你自己的脚本、或者 AI 智能体（Claude、GPT 之类）可以通过它直接驱动这个浏览器：开网页、点按钮、填表单、截图、抓数据。

它是「本地」的，数据不出你的电脑 这个接口只监听 127.0.0.1（本机）—— 局域网里别的电脑连不上。
而且你不去调它，它不会有任何动作。

① 连接信息：端口 + Token

每次启动 Housen 会随机生成一对端口和Token，写在这个文件里：

%APPDATA%\housen-browser\api-info.json

在文件管理器的地址栏里粘贴 %APPDATA%\housen-browser 就能打开。文件内容长这样：

{
  "port": 10921,
  "token": "elec_mu0vyg4m_nmtqzs50",
  "timestamp": "2026/9/14 14:52:37"
}

这两个值每次启动都会变 脚本里不要写死 —— 每次从 api-info.json 里读。想固定端口，见下面第 ⑤ 条。

② 先测一下通不通

curl http://127.0.0.1:10921/api/status \n  -H "Authorization: Bearer elec_mu0vyg4m_nmtqzs50"

返回一段 JSON 就说明通了（端口和 Token 换成你自己文件里的）。

③ 常用接口

想干什么	接口
看浏览器状态	`GET /api/status`
列出所有标签页	`GET /api/tabs`
新开一个页面 / 跳转	`POST /api/navigate`
点击页面元素	`POST /api/click`
输入文字	`POST /api/type`
在页面里跑一段 JS	`POST /api/evaluate`
截图	`POST /api/screenshot`
抓取页面数据	`POST /api/extract`
列出所有账号	`GET /api/accounts`
切换账号	`POST /api/switch-account`
定时任务	`POST /api/tasks`
读页面 console 日志	`GET /api/console`

完整清单和每个接口的参数，见随附的《Housen API 文档》。

④ 怎么让智能体用上

把上面那两个值（端口和 Token）告诉它就行 —— 它就是靠这两个值调接口的。一般的做法是：在智能体的工具/插件配置里，把 http://127.0.0.1:<端口> 填成服务地址，把 Token 填成鉴权头。

⑤ 想固定端口（可选）

默认端口每次随机。如果你希望它固定不变，可以设环境变量：

HOUSEN_API_PORT=38514

不设这一项完全没问题 —— 大部分人都是从 api-info.json 读的。

三个安全提醒

Token 就是钥匙 —— 拿到它的人可以操控你的浏览器。别贴到公开的仓库、群聊、截图里。
接口默认只对本机开放（127.0.0.1），局域网里别的机器连不上。保持这样最安全。
⚠️ 环境变量 HOUSEN_BIND_ALL=1 会把它开放到整个局域网 —— 同网段的任何人都能连上并操控你的浏览器。除非你非常清楚在做什么，否则不要设。

8常见问题

杀毒软件 / 安全软件报警怎么办？

这是没有代码签名导致的误报，不是病毒。请选择「允许」或「信任」。

如果不放心，可以把安装包传到 virustotal.com 自己扫一遍。

提示「无法连接授权服务器」怎么办？

说明这台电脑连不上授权服务器。常见原因：

公司 / 学校网络有防火墙限制
开了 VPN 或代理，把这条访问挡掉了 → 临时关掉再试
网络本身不通

已付费的客户断网后仍可继续用 7 天；超过 7 天没联网会锁定，联网后自动恢复。

一个账号能用在几台电脑上？

一台。想在第二台用，先在第一台「解绑」。

我的收藏 / 书签能导入导出吗？

导入书签：付费版可用，一次最多 100 个；试用版不支持。
导出收藏夹：付费版专属功能。

怎么联系你们？

邮箱：erik@haoshengduok.top