常见问题
我的数据存在哪里?
Section titled “我的数据存在哪里?”取决于运行模式:
- 桌面 Electron —— 主机用户目录
~/xinghan/,含data.xhdb(SQLite) 或 你配的 MongoDB 连接;用户配置app.json - Docker 容器 —— 容器内
/root/xinghan/卷;用docker volume持久化,docker rm不会丢
源代码里没有任何”上传到我们服务器”的逻辑 —— 数据完全在你掌控。
能多人协作吗?
Section titled “能多人协作吗?”可以但还在打磨中:
- 桌面单人 —— 一台机器一个用户,零延迟
- Docker 容器局域网 —— 一个团队连一个内网容器,基础多人编辑能跑
- 冲突解决 —— 走 Op 系统(每次写入是一条 funCall + reversion CAS), 并发同改一个单元格会拒绝后到的请求,不丢数据但需要重试
当前阶段不建议 50+ 人高并发场景。如果你那种规模 / 复杂权限需求强, 更适合等下个阶段或选其他工具(见 对比页)。
支持哪些数据库?
Section titled “支持哪些数据库?”- SQLite(默认)—— 单文件、零部署,适合个人 / 小团队
- MongoDB—— 用户自建实例,星汉容器加
mongodb_default网络访问, 适合中等规模或已经有 Mongo 基础设施的团队
两种引擎数据格式不同但前端 API 一致,可以从 SQLite 起步,数据涨了再 迁 MongoDB(迁移需要手工,没有自动工具)。
自动化能干哪些事?
Section titled “自动化能干哪些事?”节点参考页 有完整 20 种节点列表。常见组合:
- 定时 + 查表 + LLM —— 每天早 9 点统计任务发 AI 写总结,推到群里
- Webhook + 写表 —— 接 GitHub PR 事件自动建任务
- 记录变更 + 通知 —— 客户状态从「线索」变「成单」自动通知销售群
- HTTP 请求 + 写表 —— 定时从第三方 API 拉数据更新表
不能干的事:
- 浏览器 UI 自动化(没有 RPA 节点)
- 复杂工作流编排(如有限状态机、SAGA 这种)
跟 Airtable / Notion / 飞书多维表的区别?
Section titled “跟 Airtable / Notion / 飞书多维表的区别?”详见 对比页。核心差异:
- 数据所在地 —— 你的磁盘 vs 第三方
- 价格 —— 免费自托管 vs 按席位订阅
- 自动化深度 —— 内置同进程 LLM / Webhook vs 外挂式
当前完全免费(GitHub 开源)。后续可能:
- 桌面安装包永远免费
- Docker bundle 永远免费
- 可能推商业版(团队管理 / 高级权限 / 云托管),但开源版本会持续维护
短期内你不会因为商业策略变化丢功能。
是开源的吗?
Section titled “是开源的吗?”是的,仓库在 github.com/xinghan-editor/xinghan-editor, 许可证 MIT。
怎么反馈 bug / 提需求?
Section titled “怎么反馈 bug / 提需求?”按推荐顺序:
- GitHub Issues —— 长期跟踪的首选
- GitHub Discussions —— 不确定是 bug 还是讨论时
- 社区聊天(Discord / 微信群)—— 待开
提 bug 时如果能附 一段「复制 Markdown」按钮拿到的当前页内容 + 浏览器 DevTools Console 输出 给我们 ChatGPT / Claude,定位会快很多。
升级 / 数据迁移会丢东西吗?
Section titled “升级 / 数据迁移会丢东西吗?”- patch 版本(0.x.y → 0.x.y+1) —— schema 兼容,直接覆盖二进制
- minor 版本(0.x → 0.y) —— 可能有 schema migration,启动时自动跑,
建议先
cp -r ~/xinghan ~/xinghan.bak - major 版本(1.0 之前还没到)
我们承诺:任何 breaking 变更会在 changelog 单独标出 + 提前一个版本预告。