jjAgent
能力参数部署jPhonejMap帮助联系

帮助中心

从这里开始。

快速开始、部署清单、jPhone 配对、jMap 使用、常见问题与更新日志。找不到答案，直接发邮件。

Start

快速开始

当前完整可用的是 X86 形态。ARM 与 Cloud 仍在规划，不建议按生产环境直接采用。

你不需要学新 App：微信、钉钉、电话都能找到它；jPhone 用来随身看状态与通信。

  1. 确认形态与边界是否需要电话、HomeKit、多用户；电话套件默认安装，可以后加。
  2. 准备主机与网络PVE 主机、存储、局域网；电话另备 EG25 与独立供电 Hub。
  3. 部署服务按形态安装运行时、能力网关、Agent、推送与控制台；先装必选层，其他按需开启。
  4. 局域网首启用同一局域网的浏览器打开控制台，完成命名、密钥与通道配置。
  5. 接入人与设备绑定微信 / 钉钉，生成 jPhone 开户二维码，按需接入 HomeKit 与电话。

首启向导必须通过局域网浏览器完成；不要在外网暴露未初始化的控制台。

Install

装什么，先装什么

jAgent 按四个层级安装。先装必选，其他用得到再开；电话硬件缺失时只影响电话/短信，其他能力照常。

默认安装 · 必选

  • 阿里百炼（对话与语音模型）
  • OSS 或 NAS / 本地存储
  • iCloud 日历 + 联系人
  • FreeSWITCH（通话状态机）
  • 微信或钉钉（至少一个）
  • 电话 / 短信（EG25 + SIM）

必选层提供 44–53 个工具，取决于你选微信、钉钉，还是两个都开。

默认安装 · 按需开启

  • 邮件、滴滴、高德、麦当劳
  • COROS 训练与 FIT 解析
  • 钉钉（第二个 IM 通道）
  • SSR / VPN（网络组件）

按需层共 106 个工具；不开就不加载对应工具面。

单独安装 · 开源

  • TeslaMate（车辆数据，Docker）
  • HomeClaw（HomeKit 桥，本地）

单独安装层共 16 个工具，依赖特定环境，按需部署。

自建对接

  • 阿里云账单
  • jMap 路书
  • 经营数据（授权账号）

自建对接层共 19 个工具；对接的是接口，原系统可以继续独立使用。

查看完整分层与 197 个工具清单

Deploy

部署清单

上线前逐项确认。更完整的拓扑与形态对比见 部署方案。

硬件

  • 主机满足形态要求；存储按录音、附件与备份容量规划。
  • 电话套件使用独立供电 Hub；EG25 突发电流约 2A，禁止用 Mac USB 口直供。
  • 标准 SIM 卡，确认当地运营商与 VoLTE 可用。

网络

  • 局域网内为盒子保留固定地址（DHCP 保留或静态 IP）。
  • 外网访问使用 WireGuard 或端口映射，并为所有 HTTPS 入口配置证书。
  • 开启时间同步；证书、令牌与审计都依赖正确时钟。

安全

  • 活凭据只放在部署环境或密钥文件，不写进仓库。
  • 首启完成后立即设置控制台口令，并收紧管理入口。
  • 按角色裁剪工具面；写操作默认不进入电话查询链路。

备份

  • 配置、联系人、日历与台账定期导出；录音单独规划保留周期。
  • 升级前做一次完整备份，并确认回滚路径可用。

jPhone

jPhone 配对

jPhone 目前为 TestFlight 内测，未上架 App Store。配对前确认手机与盒子在同一局域网，或已配置可用的外网访问。

  1. 同一局域网手机与盒子连同一个 LAN；外网使用先配置 WireGuard 或端口映射。
  2. 生成开户二维码控制台首启向导末步生成，包含 SIP 参数、设备 token 与推送注册。
  3. 扫码并测试jPhone 扫码开户，设置转接策略，拨一通测试电话确认双向音频。

常见问题

  • 扫码失败：确认手机能访问盒子的 HTTPS 地址，证书有效；局域网内不要用公网域名回环。
  • 没有声音：检查 SIP 注册状态、TLS 证书与通话路由；确认 FreeSWITCH 与电话腿在线。
  • 收不到推送：确认系统通知权限、APNs 注册与设备 token 未吊销。
  • 转接不生效：检查当前策略档位、时段与号码规则；必要时切换临时策略验证。

jMap

jMap 使用

jMap 是独立的路书应用，可以单独登录使用，也可以经 jAgent 的 MCP 能力被 AI 读取与修订。

新建一本路书

  • 登录 jMap，新建路书，填写标题与起始日期。
  • 按天添加条目：名称、时间、地点、指标与备注。
  • 也可以粘贴 Markdown：标题行视为一天，其余行解析为活动。

分享

  • 生成 /s/… 只读链接，对方无需登录即可查看。
  • 链接只读，不能编辑；停止分享后链接失效。
  • jMap 不提供公开目录，路书默认私有。

AI 修订

  • AI 先读取路书，拿到当前 rev 作为 baseRev。
  • 提交 patch 时如果服务端版本已变化，会返回冲突，需要重新读取。
  • 写入成功后生成新 revision，书主可在版本历史回滚。

FAQ

常见问题

哪些是必选？哪些可以后装？
必选层：百炼、存储（OSS / NAS / 本地盘）、iCloud 日历 + 联系人、FreeSWITCH、微信或钉钉、电话 / 短信（EG25 + SIM）。邮件、滴滴、高德、麦当劳、COROS 按需开启；TeslaMate、HomeKit 单独安装；账单、jMap、经营数据走自建对接。
不用 OSS 可以吗？
可以。存储可以用 NAS 或本地盘；OSS 只是可选对象存储，适合需要外网访问、备份或静态资源托管的场景。数据主权的默认落点是本地或你自己的 NAS。
怎么和它说话？
三种方式：微信 / 钉钉里发文字或语音；直接拨电话（外线经 EG25，内线经 jPhone）；在 jPhone 里看状态、通信与策略。不需要打开一个新的聊天 App。
一定要有公网吗？
不一定。局域网内可以完整使用；需要在外网访问 jPhone 或控制台时，再配置 WireGuard 或端口映射，并为入口配置 TLS 证书。
电话一定要 EG25 吗？
不。电话套件默认安装，但硬件可选；没有 EG25 + SIM 时，电话相关工具自动裁剪，控制台电话页自适应隐藏，其他能力不受影响。
数据会上传到云端吗？
记录、录音与联系人默认留在本地或你自己的云账号。调用第三方能力时，只发送完成当前任务所需的最小参数；jPhone 推送为零内容载荷。
支持哪些消息通道？
微信、钉钉与邮件。微信支持多角色、独立会话与独立工具权限；钉钉走本机登录态；邮件支持多账号、搜索、阅读、回复与附件。
可以只用 Cloud 吗？
Cloud 目前为规划形态，尚未对外交付。目标是能力层容器化上云，电话默认不适用，需要时用跨网远端腿把蜂窝接进来。
jPhone 什么时候上架 App Store？
时间未定。当前通过 TestFlight 内测，名额与可用功能以邀请说明为准。可以在 jPhone 页面发邮件申请。
AI 能做的事怎么控制？
每个角色有独立的 token 与工具面；写操作默认被拒绝，电话查询链路只拿只读工具；能力调用全程记录，便于回溯。
怎么备份和迁移？
控制台提供配置导出 / 导入能力（按版本可用）。录音、附件等大文件建议单独规划存储与保留周期；升级前先做完整备份并验证回滚。
第三方服务挂了怎么办？
每个能力模块独立降级。某个上游不可用，只影响它自己；核心、电话链路与其他模块继续运行，工具面会自动裁剪。
为什么工具数量会变？
197 个工具是 2026-10-20 的注册表快照（195 个挂载 + 2 个内置）。新增、下线或替换上游都会改变数量，以实际版本为准。

Privacy

隐私说明

本站是纯静态产品介绍页：不加载访问统计、不写 Cookie、不使用第三方字体或 CDN。页面上的邮件链接会打开你的邮件客户端，是否发送由你决定。

产品侧的数据原则

  • 数据落在用户自己的设备或 NAS；OSS 是可选的；录音等敏感数据默认不离开本地。
  • 第三方能力按需调用，只发送完成当前任务所需的最小参数。
  • 推送只唤醒，不携带短信、来电号码或通话摘要。
  • 角色级权限与审计，写操作默认不进电话查询链路。

如需了解某一项数据的具体流向，可以发邮件询问：abcjxp@126.com。

Changelog

更新日志

按产品里程碑整理。版本号用于对外说明，不对应仓库内部的变更编号。

  1. v0.92026.10.19

    jPhone 内测版

    • 状态、通信、策略、设置四个 Tab
    • 零内容 APNs 推送、扫码开户、设备吊销
    • 来电、代接与短信统一时间线
  2. v0.82026.10.18

    钉钉通道

    • 钉钉消息、未读、搜索、日历、文件与日报接入
    • 微信、钉钉、邮件三类通道统一到同一套 Agent 权限
    • 通道状态可查询，异常可降级
  3. v0.72026.10.15

    域名与证书自动化

    • OSS 自定义域名证书自动续期与部署
    • 证书哨兵覆盖在役 HTTPS 入口
    • 续期与部署全链实测，站点零中断
  4. v0.62026.10.11

    电话套件与三形态定稿

    • 套件 = EG25 电话腿 + FreeSWITCH + jPhone
    • X86 现役；ARM 与 Cloud 进入规划
    • 组件化挂载与 fail-soft 降级规则
  5. v0.52026.10.10

    能力面扩容

    • 麦当劳 35 个工具接入，支持点餐、优惠券与订单
    • 能力面进一步扩容，角色级工具面同步更新
    • 电话查询链路增加写操作拒绝
  6. v0.42026.10.06

    jMap 接入

    • 路书 MCP 6 个工具：列表、读取、按天、搜索、创建、修订
    • 只读分享链接与 revision 冲突保护
    • AI 可读可改，书主可回滚
  7. v0.32026.09.29

    多角色微信代理

    • 每个角色独立会话与工具权限
    • 微信通道状态与消息路由
    • 家庭场景下的隔离与降级
  8. v0.22026.09.20

    统一查询路由

    • 电话 AI 的专业查询去 LLM 化
    • 按意图路由到只读工具
    • 写操作默认拒绝，降低误调用
  9. v0.12026.09.11

    首个可用版本

    • 电话 AI、微信代理、cap-hub 与控制台
    • 通话摘要、短信与审计
    • 定时推送与基础运维

Contact

仍然需要帮助？

发邮件到 abcjxp@126.com，说明你的形态、版本与遇到的问题。通常 1–2 个工作日内回复。