{"id":50619763,"url":"https://github.com/zhuzhaoyun/molio","last_synced_at":"2026-06-16T17:00:55.401Z","repository":{"id":362711138,"uuid":"1259108597","full_name":"zhuzhaoyun/Molio","owner":"zhuzhaoyun","description":"墨流 (molio): Local-first AI writing \u0026 publishing tool — notes, writing, formatting in one flow.本地优先的 AI 写作与发布工具——知识库、写作、排版，一条工作流串联。","archived":false,"fork":false,"pushed_at":"2026-06-10T14:24:05.000Z","size":4546,"stargazers_count":10,"open_issues_count":3,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T14:24:29.442Z","etag":null,"topics":["ai-native","ai-writing","claude-code","llm-wiki","local-first"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zhuzhaoyun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-04T07:45:17.000Z","updated_at":"2026-06-10T11:40:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zhuzhaoyun/Molio","commit_stats":null,"previous_names":["zhuzhaoyun/molio"],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/zhuzhaoyun/Molio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhuzhaoyun%2FMolio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhuzhaoyun%2FMolio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhuzhaoyun%2FMolio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhuzhaoyun%2FMolio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zhuzhaoyun","download_url":"https://codeload.github.com/zhuzhaoyun/Molio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zhuzhaoyun%2FMolio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34415248,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-native","ai-writing","claude-code","llm-wiki","local-first"],"created_at":"2026-06-06T10:00:57.400Z","updated_at":"2026-06-16T17:00:55.395Z","avatar_url":"https://github.com/zhuzhaoyun.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Molio (墨流)\n\n\u003e 知识工作者的本地 AI 工作台：管理知识库 → 调用本地 AI 写作 → 一键排版发布，全程数据不出境\n\n**[English](README_EN.md)** | 中文\n\nMolio 将知识库管理、AI 辅助写作和多平台发布串联为一体，是一款**本地优先**的桌面应用。所有数据存储在本地，通过编排 Claude Code、OpenAI Codex、Gemini CLI、Qwen Code 等本地 AI 运行时完成文档创作，内容无需上传到云端。\n\n## 核心功能\n\n- **知识库管理** — 基于类 LLM_Wiki 的自管理知识库，支持文件树浏览、创建、编辑、删除，自动构建可检索的知识网络\n- **AI 辅助写作** — 通过本地 AI 运行时进行文档创作，支持多轮对话、工具调用、流式输出\n- **多运行时编排** — 支持 Claude Code / OpenAI Codex / Gemini CLI / Qwen Code，一键切换\n- **项目上下文加载** — AI 进程自动加载项目目录下的 `CLAUDE.md`、内置的 `wiki_prompt` 以及文档结构\n- **Markdown 排版** — 集成 [doocs/md](https://github.com/doocs/md) 排版引擎，支持微信公众号等平台格式化\n- **多平台发布** — 配合 [doocs/cose](https://github.com/doocs/cose) 一键发布到 30+ 内容平台\n- **本地优先，数据私有** — 所有数据存储在本地，AI 运行时直接调用本地 CLI，文档内容无需上传云端\n\n## 界面预览\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003cimg src=\"docs/img/main.png\" alt=\"首页\" width=\"100%\" style=\"border-radius: 8px;\" /\u003e\n      \u003cbr/\u003e\n      \u003csub\u003eAI 对话：选择 Agent 发送消息，支持流式响应\u003c/sub\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003cimg src=\"docs/img/wiki_knowledge.png\" alt=\"知识库\" width=\"100%\" style=\"border-radius: 8px;\" /\u003e\n      \u003cbr/\u003e\n      \u003csub\u003eVault 文件树管理，Markdown 渲染与浏览\u003c/sub\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003cimg src=\"docs/img/Layout%20.png\" alt=\"排版编辑器\" width=\"100%\" style=\"border-radius: 8px;\" /\u003e\n      \u003cbr/\u003e\n      \u003csub\u003e左右分栏实时预览，主题/字体/颜色可调\u003c/sub\u003e\n    \u003c/td\u003e\n    \u003ctd width=\"50%\" align=\"center\"\u003e\n      \u003cimg src=\"docs/img/publish.png\" alt=\"多平台发布\" width=\"100%\" style=\"border-radius: 8px;\" /\u003e\n      \u003cbr/\u003e\n      \u003csub\u003e一键同步到 30+ 内容平台\u003c/sub\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 技术栈\n\n| 层级 | 技术 |\n|------|------|\n| 前端 | React 19 + Vite 6 + TypeScript |\n| 后端 | Hono + Node.js + SQLite (better-sqlite3) |\n| 桌面 | Electron 40 + electron-builder |\n| 构建 | pnpm workspace monorepo |\n| 测试 | node:test (内置) |\n\n## 项目结构\n\n```\nMolio/\n├── packages/\n│   └── contracts/       @molio/contracts — 共享类型定义\n├── apps/\n│   ├── daemon/          @molio/daemon   — Hono HTTP 服务端 (API + SSE)\n│   ├── web/             @molio/web      — Vite + React 前端\n│   └── desktop/         @molio/desktop  — Electron 桌面壳\n└── package.json         monorepo 根配置\n```\n\n## 快速开始\n\n### 前置要求\n\n- **Node.js** \u003e= 22\n- **pnpm** \u003e= 9\n- 至少安装一个 AI 运行时 CLI：\n  - [Claude Code](https://claude.ai/claude-code)\n  - [OpenAI Codex CLI](https://github.com/openai/codex)\n  - [Gemini CLI](https://github.com/google-gemini/gemini-cli)\n  - [Qwen Code](https://github.com/QwenLM/qwen-code)\n\n### 安装与运行\n\n```bash\n# 克隆项目\ngit clone https://github.com/zhuzhaoyun/Molio.git\ncd Molio\n\n# 安装依赖\npnpm install\n\n# 启动开发环境 (daemon + web)\npnpm dev\n\n# 或分别启动\npnpm dev:daemon   # 仅后端 :3100\npnpm dev:web      # 仅前端 :5173\n```\n\n### 构建桌面应用\n\n```bash\n# 一键构建 + 生成未打包版本\npnpm desktop:run\n\n# 或完整打包为安装程序\npnpm package\n\n# 仅生成未打包目录 (不生成安装包)\npnpm package:dir\n```\n\n### 测试与类型检查\n\n```bash\npnpm test         # 运行所有测试 (node:test)\npnpm typecheck    # 全量类型检查\npnpm build        # 构建所有子包\n```\n\n## 常见问题\n\n### macOS 提示\"已损坏，无法打开\"\n\n这是 macOS Gatekeeper 的安全提示，因为 Molio 目前**未经过 Apple 公证**（需要 Apple Developer Program 年费 $99）。这不是应用本身的问题，请按以下任一方法解决：\n\n**方法一（推荐）**：右键点击应用 → 选择\"打开\" → 点击\"打开\"按钮（只需第一次）\n\n**方法二**：打开终端，运行：\n```bash\nsudo xattr -d com.apple.quarantine /Applications/Molio.app\n```\n\n之后即可正常双击打开。\n\n## 用户交流群\n\n\u003cimg src=\"docs/img/qrcode.png\" alt=\"用户交流群二维码\" width=\"200\" /\u003e\n\n## 致谢\n\nMolio 的诞生离不开以下优秀开源项目的启发与支持：\n\n- **[WeKnora](https://github.com/Tencent/WeKnora)** — 知识库管理平台，为 Molio 的知识库管理模块提供了设计参考\n- **[multica](https://github.com/multica-ai/multica)** — 开源 Agent 管理平台，启发了 Molio 的多运行时编排与 Agent 交互设计\n- **[doocs/md](https://github.com/doocs/md)** — 微信 Markdown 编辑器，Molio 的文档排版与多平台格式化能力基于其核心渲染引擎 `@md/core` 构建\n- **[doocs/cose](https://github.com/doocs/cose)** — 全平台内容分发扩展，Molio 的多平台发布能力由其平台适配器层提供支持\n\n感谢这些项目的作者和社区，让 Molio 能站在巨人的肩膀上快速成长。\n\n## License\n\n[Modified Apache 2.0](LICENSE) — 基于 Apache License 2.0，附加商业使用限制条款。内部使用和非商业场景完全免费，商业托管/嵌入需获取商业授权。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhuzhaoyun%2Fmolio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzhuzhaoyun%2Fmolio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzhuzhaoyun%2Fmolio/lists"}