Skip to content

v0.1.0 · 榫卯 Tenon

Choose a tag to compare

@minzzj minzzj released this 25 Oct 09:48
· 29 commits to main since this release

榫卯 Tenon v0.1.0 · 2026-10-25

把设备、软件与 AI 串成一条可查的任务链的自建中枢。只回答三个问题:这台机器能做什么、这件事办到哪一步、数据出了哪道门。

这次交付了什么

  • 中枢:零 npm 运行时依赖的 Node.js 服务(server/),追加式哈希链事件账本 + 启动重放索引;能力注册表、任务引擎、影响预览、通道、体检、审计导出。
  • 节点:node-agent/(Windows 真实运行;脚本同构支持 Linux/macOS,未实机验证),能力插件 image.crop(纯 JS PNG 居中裁剪)/ file.hash / file.delete / printer.mock。
  • 桌面控制台:9 个页面(总览/设备/能力/任务/消息/体检/审计/演练/设置),SSE 实时刷新,首屏只读、写操作令牌登录。
  • 手机页 /m:一句话 → 五段草案 → 确认/拒绝 → 回执;断网时读本机缓存并显示「数据截至 HH:mm」。
  • 六项能力全部落地:自动发现、能力视图、任务代办(不可逆逐次确认)、影响预览(确定/可能/未知)、消息回传(摘要+链接)、部署与体检。

真实验收(不是纸面测试)

  • 单元测试:146 条全部通过(0 失败),8 个测试文件。
  • 真实浏览器:8/8 条验收全部通过;证据截图 19 张,见仓库 docs/测试证据/。
  • 关键实测:断开被 3 条任务引用的设备 → 275ms 内三处降级「待确认」;影响预览 确定 3 / 可能 1 / 未知 1,取消后业务状态零变化;强杀重启 4 次 boot / 3 次 crashRecovery、无重复执行、哈希链与 seq 连续、缺口显式标记;双实例第二实例只读(423)。
  • AI:DeepSeek 真实接入(provider=deepseek,tokens 392/108),无 key 时规则引擎降级。

快速开始

git clone https://github.com/minzzj/tenon.git
cd tenon
node server/start.js      # 中枢:http://127.0.0.1:7410(首次生成 data/secrets.json 与操作令牌)
node node-agent/agent.js  # 另一个窗口:本机节点
# 浏览器打开 http://127.0.0.1:7410 ,用启动日志里的操作令牌登录
# 手机端(同一局域网):http://<电脑IP>:7410/m

Windows 也可直接双击 scripts/启动.cmd。重置演示数据:node scripts/seed-demo.js --fresh。

边界(诚实说明)

  • 微信/邮件为适配器接口 + 模拟通道,真实通道需 webhook / SMTP 凭据;界面明确标注「模拟通道」。
  • 手机为桌面 Chrome 的 /m 布局验证,未用真机;物理拔网线未做(用「断网演练」开关);macOS/Android 原生节点、真实打印机、企业机房高可用未实机验证。

许可证

CC BY-NC-SA 4.0(署名—非商业性使用—相同方式共享):允许下载、运行、修改、非商业分享;分发修改版须沿用同一许可证;不允许商用。法律文本见 LICENSE,中文参考见 LICENSE.zh-CN.md,商用说明见 COMMERCIAL.md。

完整文档:README.md / README.zh-CN.md / docs/。