{"id":22316438,"url":"https://github.com/nullsora/kotodama","last_synced_at":"2025-10-20T04:43:03.955Z","repository":{"id":266099606,"uuid":"884713956","full_name":"nullsora/kotodama","owner":"nullsora","description":"A Third-party Client For Onebot (QQ) ","archived":false,"fork":false,"pushed_at":"2024-12-11T14:37:44.000Z","size":13570,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-11T15:41:27.480Z","etag":null,"topics":["electron","onebot","qq","typescript","vue"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nullsora.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}},"created_at":"2024-11-07T08:59:56.000Z","updated_at":"2024-12-11T14:38:29.000Z","dependencies_parsed_at":"2024-12-02T15:52:56.266Z","dependency_job_id":null,"html_url":"https://github.com/nullsora/kotodama","commit_stats":null,"previous_names":["nullsora/kotodama"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullsora%2Fkotodama","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullsora%2Fkotodama/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullsora%2Fkotodama/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullsora%2Fkotodama/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nullsora","download_url":"https://codeload.github.com/nullsora/kotodama/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236451141,"owners_count":19150806,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["electron","onebot","qq","typescript","vue"],"created_at":"2024-12-03T23:06:31.701Z","updated_at":"2025-10-14T06:30:48.021Z","avatar_url":"https://github.com/nullsora.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\n\u003c!-- 项目 LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/nullsora/kotodama\"\u003e\n    \u003cimg src=\"resources/icon.png\" alt=\"Logo\" width=\"80\" height=\"80\"\u003e\n  \u003c/a\u003e\n\n\u003ch3 align=\"center\"\u003eKotodama\u003c/h3\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![AGPL-3.0 License][license-shield]][license-url]\n\n  \u003cp align=\"center\"\u003e\n    好看的 (?) 第三方Onebot客户端实现\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/nullsora/kotodama\"\u003e\u003cstrong\u003e浏览文档 »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/nullsora/kotodama\"\u003e查看 Demo\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/nullsora/kotodama/issues\"\u003e反馈 Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/nullsora/kotodama/issues\"\u003e请求新功能\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- 目录 --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003e目录\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#关于本项目\"\u003e关于本项目\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#构建工具\"\u003e构建工具\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#开始\"\u003e开始\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#依赖\"\u003e依赖\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#安装\"\u003e安装\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#构建\"\u003e构建\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#使用方法\"\u003e使用方法\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#特性支持\"\u003e特性支持\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#贡献\"\u003e贡献\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#许可证\"\u003e许可证\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#致谢\"\u003e致谢\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003c!-- 关于本项目 --\u003e\n\n## 关于本项目\n\nKotodama 是一个基于 Onebot 标准的第三方客户端实现。\n\n\u003cimg src=\"resources/screenshot.png\" alt=\"screenshot\" width=\"100%\"\u003e\n\n\u003e [!IMPORTANT]\n\u003e 本项目目前仍在开发中，部分功能可能尚未完善或不可用。\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e)\u003c/p\u003e\n\n### 构建工具\n\n- [Electron](https://www.electronjs.org/)\n- [Electron-Vite](https://electron-vite.org/)\n- [TypeScript](https://www.typescriptlang.org/)\n- [Vue.js](https://vuejs.org/)\n- [PrimeVue](https://primevue.org/)\n- [UnoCSS](https://unocss.dev/)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- 开始 --\u003e\n\n## 开始\n\n如果你并非开发者，你可以直接下载最新的版本并且运行。\n\n[![Release](https://img.shields.io/github/v/release/nullsora/kotodama?style=for-the-badge)][release-url]\n\n这是一份在本地构建项目的指导的例子。\n要获取本地副本并且配置运行，你可以按照下面的示例步骤操作。\n\n### 依赖\n\n- 安装pnpm _(可选)_\n  ```sh\n  npm install pnpm@latest -g\n  ```\n\n### 安装\n\n1. 克隆本仓库\n   ```sh\n   git clone https://github.com/nullsora/kotodama.git\n   ```\n2. 安装依赖\n   ```sh\n    pnpm install\n   ```\n3. 进行开发\n   ```sh\n   pnpm dev\n   ```\n\n### 构建项目\n\n- 构建icon\n\n  ```sh\n  pnpm build:icon\n  ```\n\n  只需要在第一次构建时运行一次，之后不需要再运行。\n\n- 选择你的平台进行打包\n\n  ```sh\n  pnpm build:unpack\n  pnpm build:win\n  pnpm build:linux\n  pnpm build:mac\n  ```\n\n- 你可以在 `dist` 文件夹中找到构建好的文件\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003e返回顶部\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- 使用方法 示例 --\u003e\n\n## 使用方法\n\n- 在使用之前，你需要有一个可用的Onebot后端。因为使用了一些非Onebot标准的API，所以对[NapCat](https://github.com/NapNeko/NapCatQQ)或[LLOnebot](https://github.com/LLOneBot/LLOneBot)的支持是最好的。\n\n  同时，你需要在Onebot后端中启用ws正向连接。\n\n\u003e [!WARNING]\n\u003e 使用最新 (9.9.16.x) 版本的 QQ 配合 LiteloaderQQNT 出现了[强制下线现象](https://github.com/LiteLoaderQQNT/LiteLoaderQQNT/issues/1032)，谨慎升级QQ。\n\n- 打开软件，输入Onebot服务器地址和token (如果存在), 点击连接\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003e返回顶部\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- 特性支持 --\u003e\n\n## 特性支持\n\n- 🍬 特性\n  - [x] 聊天分组 (为了这碟醋才包的饺子)\n  - [x] 本地表情 (很好啊)\n  - [x] 多图展示 (想关自己关)\n- [ ] 基础功能\n  - [x] 连接 Onebot 服务器\n  - [ ] 聊天功能\n    - [x] 置顶聊天\n    - [ ] 联系人管理，群管理等\n    - [x] 群公告\n    - [ ] 群文件\n    - [ ] 群相册\n    - [ ] 精华消息\n  - [x] 消息展示\n    - [x] 文本\n    - [x] QQ表情\n    - [x] 图片\n    - [x] 动画表情\n    - [x] 语音\n    - [x] 视频\n    - [x] @某人\n    - [x] 猜拳\n    - [x] 骰子\n    - [ ] ~~戳一戳~~\n    - [ ] ~~分享链接~~\n    - [x] 分享联系人 (支持json格式的分享)\n    - [x] 分享位置 (支持json格式的分享)\n    - [x] 引用/回复\n    - [x] 聊天记录\n    - [ ] ~~XML消息~~ (NTQQ也不用啊)\n    - [x] JSON消息\n    - [x] 文件\n    - [x] Markdown\n  - [ ] 消息发送\n    - [x] 文本\n    - [x] QQ表情\n    - [x] 图片\n    - [x] 动画表情 (你收藏的那些)\n    - [ ] 语音 (你真的有电脑上发语音的需求吗)\n    - [x] 视频\n    - [x] @某人\n    - [x] 猜拳\n    - [x] 骰子\n    - [ ] ~~戳一戳~~\n    - [ ] ~~分享链接~~\n    - [ ] 分享联系人\n    - [ ] 分享位置\n    - [x] 引用/回复\n    - [ ] 聊天记录\n    - [ ] ~~XML消息~~\n    - [ ] ~~JSON消息~~\n    - [x] 文件\n- [x] 个性化\n  - [x] Light / Dark Mode 切换\n  - [x] 自定义主题色 / 背景\n\n到 [open issues](https://github.com/nullsora/kotodama/issues) 页查看所有请求的功能 （以及已知的问题）。\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- 贡献 --\u003e\n\n## 贡献\n\n贡献让开源社区成为了一个非常适合学习、互相激励和创新的地方。你所做出的任何贡献都是**受人尊敬**的。\n\n如果你有好的建议，请复刻（fork）本仓库并且创建一个拉取请求（pull request）。你也可以简单地创建一个议题（issue），并且添加标签「enhancement」。不要忘记给项目点一个 star！再次感谢！\n\n1. 复刻（Fork）本项目\n2. 创建你的 Feature 分支 (`git checkout -b feature/AmazingFeature`)\n3. 提交你的变更 (`git commit -m 'Add some AmazingFeature'`)\n4. 推送到该分支 (`git push origin feature/AmazingFeature`)\n5. 创建一个拉取请求（Pull Request）\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- 许可证 --\u003e\n\n## 许可证\n\n根据 AGPL-3.0 许可证分发。打开 [LICENSE](LICENSE) 查看更多内容。\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003e回到顶部\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- 致谢 --\u003e\n\n## 致谢\n\n- @柴油动力轮椅 - 为本项目绘制了图标\n- [Animista](https://animista.net/) - 提供了部分动画效果\n- [霞鹜文楷](https://github.com/lxgw/LxgwWenKai)\n- [Vite](https://vitejs.dev/)\n- [Pinia](https://pinia.vuejs.org/)\n- [unocss-preset-scrollbar](https://github.com/unocss-community/unocss-preset-scrollbar)\n- [VueDraggablePlus](https://vue-draggable-plus.pages.dev/)\n- [markdown-it](https://markdown-it.github.io/markdown-it/)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003e返回顶部\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN 链接 \u0026 图片 --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/nullsora/kotodama.svg?style=for-the-badge\n[contributors-url]: https://github.com/nullsora/kotodama/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/nullsora/kotodama.svg?style=for-the-badge\n[forks-url]: https://github.com/nullsora/kotodama/network/members\n[stars-shield]: https://img.shields.io/github/stars/nullsora/kotodama.svg?style=for-the-badge\n[stars-url]: https://github.com/nullsora/kotodama/stargazers\n[issues-shield]: https://img.shields.io/github/issues/nullsora/kotodama.svg?style=for-the-badge\n[issues-url]: https://github.com/nullsora/kotodama/issues\n[license-shield]: https://img.shields.io/github/license/nullsora/kotodama.svg?style=for-the-badge\n[license-url]: https://github.com/nullsora/kotodama/blob/main/LICENSE\n[release-url]: https://github.com/nullsora/kotodama/releases/latest\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnullsora%2Fkotodama","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnullsora%2Fkotodama","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnullsora%2Fkotodama/lists"}