[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-Doriandarko--kimi-writer":3,"tool-Doriandarko--kimi-writer":61},[4,18,26,36,44,52],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",143909,2,"2026-04-07T11:33:18",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":77,"owner_email":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":87,"forks":88,"last_commit_at":89,"license":90,"difficulty_score":32,"env_os":91,"env_gpu":92,"env_ram":93,"env_deps":94,"category_tags":99,"github_topics":77,"view_count":10,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":100,"updated_at":101,"faqs":102,"releases":103},2817,"Doriandarko\u002Fkimi-writer","kimi-writer","AI writing agent powered by kimi-k2-thinking - autonomously creates novels and stories with deep reasoning","kimi-writer 是一款基于 kimi-k2-thinking 模型打造的自主 AI 写作智能体，能够独立规划并执行小说、书籍及短篇故事集的创作任务。它主要解决了长篇幅创作中逻辑连贯性难维持、上下文易丢失以及人工干预频繁等痛点，让创作者从繁琐的架构搭建中解放出来，专注于创意本身。\n\n这款工具特别适合科幻作家、网文作者、内容创作者以及希望探索 AI 叙事潜力的开发者使用。其核心亮点在于强大的深度推理能力与智能化的上下文管理机制：kimi-writer 不仅能实时流式展示思考与写作过程，还具备自动压缩上下文、断点续写（恢复模式）及令牌用量监控功能，确保在长达 20 万令牌的窗口内稳定运行。通过内置的项目创建、文件写入等工具，它能自动管理工作空间，将抽象的灵感转化为结构完整的章节文件。无论是从零开始生成一部科幻小说集，还是在中途中断后继续未完的故事，kimi-writer 都能以高度自治的方式高效完成，是辅助长篇内容生产的得力助手。","# Kimi Writing Agent\n\nAn autonomous agent powered by the **kimi-k2-thinking** model for creating novels, books, and short story collections.\n\n## Features\n\n- 🤖 **Autonomous Writing**: The agent plans and executes creative writing tasks independently\n- 📚 **Multiple Formats**: Create novels, books, or short story collections\n- ⚡ **Real-Time Streaming**: See the agent's reasoning and writing appear as it's generated\n- 💾 **Smart Context Management**: Automatically compresses context when approaching token limits\n- 🔄 **Recovery Mode**: Resume interrupted work from saved context summaries\n- 📊 **Token Monitoring**: Real-time tracking of token usage with automatic optimization\n- 🛠️ **Tool Use**: Agent can create projects, write files, and manage its workspace\n\n## Installation\n\n### Prerequisites\n\nWe recommend using [uv](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) for fast Python package management:\n\n```bash\n# Install uv (if you don't have it)\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n```\n\n### Setup\n\n1. Install dependencies:\n\n**Using uv (recommended):**\n```bash\nuv pip install -r requirements.txt\n```\n\n**Or using pip:**\n```bash\npip install -r requirements.txt\n```\n\n2. Configure your API key:\n\nCreate a `.env` file with your API key:\n```bash\n# Copy the example file\ncp env.example .env\n\n# Edit .env and add your API key\n# The file should contain:\nMOONSHOT_API_KEY=your-api-key-here\n```\n\n**Optional:** Set custom base URL (defaults to https:\u002F\u002Fapi.moonshot.ai\u002Fv1):\n```bash\n# Add to your .env file:\nMOONSHOT_BASE_URL=https:\u002F\u002Fapi.moonshot.ai\u002Fv1\n```\n\n## Usage\n\n### Fresh Start\n\nRun with an inline prompt:\n```bash\n# Using uv (recommended)\nuv run kimi-writer.py \"Create a collection of 5 sci-fi short stories about AI\"\n\n# Or using python directly\npython kimi-writer.py \"Create a collection of 5 sci-fi short stories about AI\"\n```\n\nOr run interactively:\n```bash\nuv run kimi-writer.py\n# or: python kimi-writer.py\n```\nThen enter your prompt when asked.\n\n### Recovery Mode\n\nIf the agent is interrupted or you want to continue previous work:\n```bash\nuv run kimi-writer.py --recover output\u002Fmy_project\u002F.context_summary_20250107_143022.md\n# or: python kimi-writer.py --recover output\u002Fmy_project\u002F.context_summary_20250107_143022.md\n```\n\n## How It Works\n\n### The Agent's Tools\n\nThe agent has access to three tools:\n\n1. **create_project**: Creates a project folder to organize the writing\n2. **write_file**: Writes markdown files with three modes:\n   - `create`: Creates a new file (fails if exists)\n   - `append`: Adds content to an existing file\n   - `overwrite`: Replaces the entire file content\n3. **compress_context**: Automatically triggered to manage context size\n\n### The Agentic Loop\n\n1. The agent receives your prompt\n2. It reasons about the task using kimi-k2-thinking\n3. It decides which tools to call and executes them\n4. It reviews the results and continues until the task is complete\n5. Maximum 300 iterations with automatic context compression\n\n### Context Management\n\n- **Token Limit**: 200,000 tokens\n- **Auto-Compression**: Triggers at 180,000 tokens (90% of limit)\n- **Backups**: Automatic context summaries every 50 iterations\n- **Recovery**: All summaries saved with timestamps for resumption\n\n## Project Structure\n\n```\nkimi-writer\u002F\n├── kimi-writer.py        # Main agent\n├── tools\u002F\n│   ├── __init__.py       # Tool registry\n│   ├── writer.py         # File writing tool\n│   ├── project.py        # Project management tool\n│   └── compression.py    # Context compression tool\n├── utils.py              # Utilities (token counting, etc.)\n├── requirements.txt      # Python dependencies\n├── env.example           # Example configuration\n├── .gitignore            # Git ignore rules\n└── README.md             # This file\n\n# Generated during use:\noutput\u002F                   # All AI-generated projects go here\n├── your_project_name\u002F    # Created by the agent\n│   ├── chapter_01.md     # Written by the agent\n│   ├── chapter_02.md\n│   └── .context_summary_*.md  # Auto-saved context summaries\n└── another_project\u002F\n    └── ...\n```\n\n## Examples\n\n### Example 1: Novel\n```bash\nuv run kimi-writer.py \"Write a mystery novel set in Victorian London with 10 chapters\"\n```\n\n### Example 2: Short Story Collection\n```bash\nuv run kimi-writer.py \"Create 7 interconnected sci-fi short stories exploring the theme of memory\"\n```\n\n### Example 3: Book\n```bash\nuv run kimi-writer.py \"Write a comprehensive guide to Python programming with 15 chapters\"\n```\n\n## Advanced Features\n\n### Real-Time Streaming\nWatch the agent think and write in real-time:\n- 🧠 **Reasoning Stream**: See the agent's thought process as it plans\n- 💬 **Content Stream**: Watch stories being written character by character\n- 🔧 **Tool Call Progress**: Live updates when generating large content (shows character\u002Fword count)\n- ⚡ **No Waiting**: Immediate feedback - no more staring at a blank screen\n\n### Iteration Counter\nThe agent displays its progress: `Iteration X\u002F300`\n\n### Token Monitoring\nReal-time token usage: `Current tokens: 45,234\u002F200,000 (22.6%)`\n\n### Graceful Interruption\nPress `Ctrl+C` to interrupt. The agent will save the current context for recovery.\n\n## Tips for Best Results\n\n1. **Be Specific**: Clear prompts get better results\n   - Good: \"Create a 5-chapter romance novel set in modern Tokyo\"\n   - Less good: \"Write something interesting\"\n\n2. **Let It Work**: The agent works autonomously - it will plan and execute the full task\n\n3. **Recovery is Easy**: If interrupted, just use the `--recover` flag with the latest context summary\n\n4. **Check Progress**: Generated files appear in real-time in the project folder\n\n## Troubleshooting\n\n### \"MOONSHOT_API_KEY environment variable not set\"\nMake sure you have created a `.env` file in the project root with your API key:\n```bash\nMOONSHOT_API_KEY=your-actual-api-key-here\n```\n\n### \"401 Unauthorized\" or Authentication errors\n- Verify your API key is correct in the `.env` file\n- Make sure you're using the correct base URL: `https:\u002F\u002Fapi.moonshot.ai\u002Fv1`\n- Get your API key from: https:\u002F\u002Fplatform.moonshot.cn\u002F\n\n### \"Error creating project folder\"\nCheck write permissions in the current directory\n\n### Agent seems stuck\nThe agent can run up to 300 iterations. For very complex tasks, this is normal. Check the project folder to see progress.\n\n### Token limit issues\nThe agent automatically compresses context at 180K tokens. If you see compression messages, the system is working correctly.\n\n## Technical Details\n\n- **Model**: kimi-k2-thinking\n- **Temperature**: 1.0 (optimized for this model)\n- **Max Tokens per Call**: 65,536 (64K)\n- **Context Window**: 200,000 tokens\n- **Max Iterations**: 300\n- **Compression Threshold**: 180,000 tokens\n\nYou can customize this as you please. \n\n## License\n\nMIT License with Attribution Requirement - see [LICENSE](LICENSE) file for details.\n\n**Commercial Use**: If you use this software in a commercial product, you must provide clear attribution to Pietro Schirano (@Doriandarko).\n\n**API Usage**: This project uses the Moonshot AI API. Please refer to Moonshot AI's terms of service for API usage guidelines.\n\n## Credits\n\n- **Created by**: Pietro Schirano ([@Doriandarko](https:\u002F\u002Fgithub.com\u002FDoriandarko))\n- **Powered by**: Moonshot AI's kimi-k2-thinking model\n- **Repository**: https:\u002F\u002Fgithub.com\u002FDoriandarko\u002Fkimi-writer\n\n## Star History\n\n\u003Cpicture>\n  \u003Csource\n    media=\"(prefers-color-scheme: dark)\"\n    srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_kimi-writer_readme_b41afc200790.png&theme=dark\"\n  \u002F>\n  \u003Csource\n    media=\"(prefers-color-scheme: light)\"\n    srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_kimi-writer_readme_b41afc200790.png\"\n  \u002F>\n  \u003Cimg\n    alt=\"Star History Chart\"\n    src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_kimi-writer_readme_b41afc200790.png\"\n  \u002F>\n\u003C\u002Fpicture>\n\n","# 基米写作代理\n\n一款由 **kimi-k2-thinking** 模型驱动的自主代理，用于创作小说、书籍和短篇故事集。\n\n## 功能\n\n- 🤖 **自主写作**: 代理可独立规划并执行创意写作任务\n- 📚 **多种格式**: 可创建小说、书籍或短篇故事集\n- ⚡ **实时流式输出**: 随着生成过程实时展示代理的推理与写作内容\n- 💾 **智能上下文管理**: 在接近令牌限制时自动压缩上下文\n- 🔄 **恢复模式**: 可从保存的上下文摘要中恢复中断的工作\n- 📊 **令牌监控**: 实时跟踪令牌使用情况，并自动优化\n- 🛠️ **工具使用**: 代理可以创建项目、编写文件并管理其工作空间\n\n## 安装\n\n### 先决条件\n\n我们推荐使用 [uv](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) 进行快速的 Python 包管理：\n\n```bash\n# 如果尚未安装 uv，请先安装\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n```\n\n### 设置\n\n1. 安装依赖项：\n\n**推荐使用 uv:**\n```bash\nuv pip install -r requirements.txt\n```\n\n**或使用 pip:**\n```bash\npip install -r requirements.txt\n```\n\n2. 配置您的 API 密钥：\n\n创建一个包含您的 API 密钥的 `.env` 文件：\n```bash\n# 复制示例文件\ncp env.example .env\n\n# 编辑 .env 并添加您的 API 密钥\n# 文件内容应为：\nMOONSHOT_API_KEY=your-api-key-here\n```\n\n**可选:** 设置自定义基础 URL（默认为 https:\u002F\u002Fapi.moonshot.ai\u002Fv1）：\n```bash\n# 添加到您的 .env 文件中：\nMOONSHOT_BASE_URL=https:\u002F\u002Fapi.moonshot.ai\u002Fv1\n```\n\n## 使用方法\n\n### 新建项目\n\n通过内联提示运行：\n```bash\n# 推荐使用 uv\nuv run kimi-writer.py \"创作5篇关于人工智能的科幻短篇故事集\"\n\n# 或直接使用 python\npython kimi-writer.py \"创作5篇关于人工智能的科幻短篇故事集\"\n```\n\n或者以交互模式运行：\n```bash\nuv run kimi-writer.py\n# 或：python kimi-writer.py\n```\n然后在提示时输入您的指令。\n\n### 恢复模式\n\n如果代理被中断，或您想继续之前的工作：\n```bash\nuv run kimi-writer.py --recover output\u002Fmy_project\u002F.context_summary_20250107_143022.md\n# 或：python kimi-writer.py --recover output\u002Fmy_project\u002F.context_summary_20250107_143022.md\n```\n\n## 工作原理\n\n### 代理的工具\n\n代理拥有三种工具：\n\n1. **create_project**: 创建项目文件夹以组织写作内容\n2. **write_file**: 以三种模式编写 Markdown 文件：\n   - `create`: 创建新文件（若文件已存在则失败）\n   - `append`: 向现有文件追加内容\n   - `overwrite`: 替换整个文件内容\n3. **compress_context**: 自动触发以管理上下文大小\n\n### 代理循环\n\n1. 代理接收您的提示\n2. 使用 kimi-k2-thinking 对任务进行推理\n3. 决定调用哪些工具并执行\n4. 检查结果，并持续进行直到任务完成\n5. 最多 300 次迭代，并自动压缩上下文\n\n### 上下文管理\n\n- **令牌限制**: 200,000 个令牌\n- **自动压缩**: 当达到 180,000 个令牌时触发（占限制的 90%）\n- **备份**: 每 50 次迭代自动保存一次上下文摘要\n- **恢复**: 所有摘要均按时间戳保存，以便后续恢复\n\n## 项目结构\n\n```\nkimi-writer\u002F\n├── kimi-writer.py        # 主代理程序\n├── tools\u002F\n│   ├── __init__.py       # 工具注册表\n│   ├── writer.py         # 文件写入工具\n│   ├── project.py        # 项目管理工具\n│   └── compression.py    # 上下文压缩工具\n├── utils.py              # 工具函数（令牌计数等）\n├── requirements.txt      # Python 依赖项\n├── env.example           # 示例配置文件\n├── .gitignore            # Git 忽略规则\n└── README.md             # 本文件\n\n# 使用过程中生成的内容:\noutput\u002F                   # 所有 AI 生成的项目都会存放于此\n├── your_project_name\u002F    # 由代理创建\n│   ├── chapter_01.md     # 由代理编写\n│   ├── chapter_02.md\n│   └── .context_summary_*.md  # 自动保存的上下文摘要\n└── another_project\u002F\n    └── ...\n```\n\n## 示例\n\n### 示例 1: 小说\n```bash\nuv run kimi-writer.py \"撰写一部以维多利亚时代伦敦为背景的10章悬疑小说\"\n```\n\n### 示例 2: 短篇故事集\n```bash\nuv run kimi-writer.py \"创作7篇相互关联的科幻短篇故事，探讨记忆的主题\"\n```\n\n### 示例 3: 书籍\n```bash\nuv run kimi-writer.py \"编写一本包含15章的Python编程综合指南\"\n```\n\n## 高级功能\n\n### 实时流式输出\n实时观看代理的思考与写作过程：\n- 🧠 **推理流**: 观看代理在规划任务时的思维过程\n- 💬 **内容流**: 逐字逐句见证故事的创作\n- 🔧 **工具调用进度**: 在生成大量内容时提供实时更新（显示字符\u002F单词数）\n- ⚡ **无需等待**: 即时反馈——不再需要盯着空白屏幕发呆\n\n### 迭代计数器\n代理会显示其进度：`第 X 次迭代\u002F300次`\n\n### 令牌监控\n实时显示令牌使用情况：`当前令牌数：45,234\u002F200,000（22.6%）`\n\n### 优雅中断\n按下 `Ctrl+C` 即可中断。代理会保存当前上下文以便后续恢复。\n\n## 获得最佳效果的技巧\n\n1. **明确具体**: 清晰的提示能带来更好的结果\n   - 好的：`创作一部以现代东京为背景的5章爱情小说`\n   - 不太好的：`写点有趣的东西`\n\n2. **放手让其工作**: 代理会自主规划并完成整个任务\n\n3. **轻松恢复**: 如果被中断，只需使用 `--recover` 标志配合最新的上下文摘要即可恢复\n\n4. **检查进度**: 生成的文件会实时出现在项目文件夹中\n\n## 故障排除\n\n### 提示“未设置 MOONSHOT_API_KEY 环境变量”\n请确保在项目根目录下创建了一个包含您的 API 密钥的 `.env` 文件：\n```bash\nMOONSHOT_API_KEY=your-actual-api-key-here\n```\n\n### 出现“401 Unauthorized”或认证错误\n- 请确认 `.env` 文件中的 API 密钥是否正确\n- 确保使用正确的基础 URL：`https:\u002F\u002Fapi.moonshot.ai\u002Fv1`\n- 您可以从 https:\u002F\u002Fplatform.moonshot.cn\u002F 获取 API 密钥\n\n### “创建项目文件夹时出错”\n请检查当前目录的写入权限\n\n### 代理似乎卡住了\n代理最多可运行 300 次迭代。对于非常复杂的任务，这是正常现象。请查看项目文件夹以了解进展情况。\n\n### 令牌限制问题\n代理会在 180,000 个令牌时自动压缩上下文。如果您看到压缩提示，则说明系统正在正常工作。\n\n## 技术细节\n\n- **模型**: kimi-k2-thinking\n- **温度**: 1.0（针对此模型优化）\n- **每次调用的最大令牌数**: 65,536（64K）\n- **上下文窗口**: 200,000 个令牌\n- **最大迭代次数**: 300\n- **压缩阈值**: 180,000 个令牌\n\n您可以根据需要进行自定义。\n\n## 许可证\n\nMIT 许可证，附带署名要求——详情请参阅 [LICENSE](LICENSE) 文件。\n\n**商业使用**：如果您将本软件用于商业产品中，必须明确注明作者为 Pietro Schirano (@Doriandarko)。\n\n**API 使用**：本项目使用了 Moonshot AI 的 API。请参阅 Moonshot AI 的服务条款以获取 API 使用的相关指南。\n\n## 致谢\n\n- **创建者**：Pietro Schirano ([@Doriandarko](https:\u002F\u002Fgithub.com\u002FDoriandarko))\n- **技术支持**：Moonshot AI 的 kimi-k2-thinking 模型\n- **仓库地址**：https:\u002F\u002Fgithub.com\u002FDoriandarko\u002Fkimi-writer\n\n## 点星历史\n\n\u003Cpicture>\n  \u003Csource\n    media=\"(prefers-color-scheme: dark)\"\n    srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_kimi-writer_readme_b41afc200790.png&theme=dark\"\n  \u002F>\n  \u003Csource\n    media=\"(prefers-color-scheme: light)\"\n    srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_kimi-writer_readme_b41afc200790.png\"\n  \u002F>\n  \u003Cimg\n    alt=\"点星历史图表\"\n    src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_kimi-writer_readme_b41afc200790.png\"\n  \u002F>\n\u003C\u002Fpicture>","# Kimi Writer 快速上手指南\n\nKimi Writer 是一个基于 **kimi-k2-thinking** 模型的自主写作智能体，能够独立规划并执行小说、书籍或短篇故事集的创作任务。\n\n## 环境准备\n\n- **操作系统**：Linux \u002F macOS \u002F Windows (需安装 Python 环境)\n- **Python 版本**：建议 Python 3.8+\n- **依赖管理工具**：推荐使用 [uv](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) 以获得更快的包安装速度（国内网络环境下若下载缓慢，可配置国内镜像或使用 pip 替代）\n\n## 安装步骤\n\n### 1. 安装依赖管理工具 uv（推荐）\n\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n```\n\n> 注：如无法访问上述地址，可直接使用系统自带的 `pip` 进行后续操作。\n\n### 2. 安装项目依赖\n\n克隆项目后进入目录，执行以下命令安装依赖：\n\n**使用 uv（推荐）：**\n```bash\nuv pip install -r requirements.txt\n```\n\n**或使用 pip：**\n```bash\npip install -r requirements.txt\n```\n\n### 3. 配置 API 密钥\n\n在项目根目录下创建 `.env` 文件并填入你的 Moonshot AI API Key：\n\n```bash\n# 复制示例配置文件\ncp env.example .env\n\n# 编辑 .env 文件，填入真实的 API Key\n# 文件内容应包含：\nMOONSHOT_API_KEY=your-api-key-here\n```\n\n> 获取 API Key 请访问：https:\u002F\u002Fplatform.moonshot.cn\u002F\n\n## 基本使用\n\n### 方式一：直接通过命令行提示词启动\n\n运行以下命令，智能体将自动开始创作：\n\n```bash\n# 使用 uv 运行（推荐）\nuv run kimi-writer.py \"Create a collection of 5 sci-fi short stories about AI\"\n\n# 或直接使用 python\npython kimi-writer.py \"Create a collection of 5 sci-fi short stories about AI\"\n```\n\n### 方式二：交互式运行\n\n输入命令后，根据提示输入你的创作需求：\n\n```bash\nuv run kimi-writer.py\n# 或\npython kimi-writer.py\n```\n\n运行后，生成的内容将实时保存在 `output\u002F` 目录下的项目文件夹中，你可以随时查看进度。","一位独立科幻作家计划在两周内完成一部包含五个相互关联短篇的系列小说，但受限于构思复杂度和写作速度，项目一度停滞。\n\n### 没有 kimi-writer 时\n- **构思与写作割裂**：需要手动在大纲、人物小传和正文间切换，难以保持长篇幅逻辑的一致性，常出现前后设定冲突。\n- **上下文记忆丢失**：写到第三个故事时，往往遗忘第一个故事埋下的伏笔或细节，导致需要反复翻阅前文，打断创作心流。\n- **中断恢复困难**：一旦因电脑故障或灵感枯竭被迫中断，重新梳理剧情脉络和未完成任务耗时极长，容易产生弃坑念头。\n- **格式整理繁琐**：完成初稿后，需花费大量时间手动分章、创建文件并统一排版，挤占了核心创作时间。\n\n### 使用 kimi-writer 后\n- **自主闭环创作**：kimi-writer 接收“创作 5 篇关联科幻短篇”指令后，自动规划整体架构并连续执行写作，确保世界观深度统一。\n- **智能上下文管理**：内置的压缩机制在接近令牌限制时自动总结前情，让 AI 在撰写后续章节时能精准呼应前文伏笔，无需人工干预。\n- **无缝断点续写**：利用恢复模式（Recovery Mode），即使进程意外中断，也能通过保存的时间戳摘要立即从断点处继续，完美衔接剧情。\n- **自动化工程交付**：Agent 直接调用工具创建项目文件夹，按章节自动生成格式规范的 Markdown 文件，交稿即成品。\n\nkimi-writer 将作家从繁琐的结构维护和格式工作中解放出来，使其能专注于核心创意的打磨，实现高质量长文本的自动化产出。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FDoriandarko_kimi-writer_32d0a307.png","Doriandarko","Pietro Schirano","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FDoriandarko_7146aa01.jpg","Passionate AI engineer on a mission to democratize AI tools.\r\n\r\nFounder at MagicPath 🎨✨\r\n\r\nmagicpath.ai","MagicPath",null,"pietro.schirano@gmail.com","skirano","magicpath.ai","https:\u002F\u002Fgithub.com\u002FDoriandarko",[83],{"name":84,"color":85,"percentage":86},"Python","#3572A5",100,555,114,"2026-04-03T12:35:27","NOASSERTION","Linux, macOS, Windows","不需要本地 GPU（基于 API 调用）","未说明",{"notes":95,"python":96,"dependencies":97},"该工具通过 API 调用 Moonshot AI 的 kimi-k2-thinking 模型，无需本地部署大模型。必须配置 MOONSHOT_API_KEY 环境变量。推荐使用 uv 进行依赖管理。支持断点续传功能，中断后可通过 --recover 参数恢复任务。","未说明 (需支持 uv 或 pip)",[98],"未说明 (详见 requirements.txt)",[35,13],"2026-03-27T02:49:30.150509","2026-04-07T20:01:55.453982",[],[]]