[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-OasAIStudio--symphony-ts":3,"tool-OasAIStudio--symphony-ts":61},[4,18,26,36,44,53],{"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 真正成长为懂上",149489,2,"2026-04-10T11:32:46",[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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"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":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":75,"owner_email":76,"owner_twitter":77,"owner_website":75,"owner_url":78,"languages":79,"stars":88,"forks":89,"last_commit_at":90,"license":91,"difficulty_score":10,"env_os":92,"env_gpu":93,"env_ram":92,"env_deps":94,"category_tags":100,"github_topics":75,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":101,"updated_at":102,"faqs":103,"releases":104},6257,"OasAIStudio\u002Fsymphony-ts","symphony-ts","Typecript version of https:\u002F\u002Fgithub.com\u002Fopenai\u002Fsymphony","Symphony-ts 是 OpenAI Symphony 项目的非官方 TypeScript 实现，旨在将软件开发任务转化为独立、自动化的执行流程。它通过连接你的项目追踪系统（如 Linear），为每个待办议题自动创建隔离的工作空间，并在其中调度编码智能体完成具体任务，最后为操作者提供清晰的运行时监控界面，支持重试与流程控制。\n\n这一工具主要解决了多任务并行开发时的环境冲突与状态管理难题，确保每个任务在纯净、独立的沙箱中运行，互不干扰，同时让开发者能直观掌握智能体的工作进度与结果。\n\nSymphony-ts 特别适合需要高效利用 AI 辅助编程的软件开发团队、技术负责人及 DevOps 工程师使用。其独特亮点在于基于 `WORKFLOW.md` 的声明式配置机制，用户只需简单定义工作流即可启动服务；同时提供实时的 Web 仪表盘，通过服务器发送事件（SSE）技术在浏览器中动态更新任务状态，实现了从任务拉取到代码交付的全链路自动化与可视化。需要注意的是，由于涉及自动化代码执行，该工具建议在受信任的安全环境中部署使用。","# Symphony-ts\n\n**This project is an unofficial TypeScript implementation of [OpenAI Symphony](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fsymphony).**\n\nSymphony-ts turns project work into isolated, autonomous implementation runs: it reads work from\nyour tracker, creates a dedicated workspace for each issue, runs a coding agent inside that\nboundary, and gives operators a clean surface for runtime visibility, retries, and control.\n\n> [!WARNING]\n> Symphony is intended for trusted environments.\n\n![Symphony demo showing Linear issue tracking alongside the Symphony observability dashboard](.github\u002Fmedia\u002Fdemo.png)\n\n## Running Symphony\n\n### Requirements\n\n- Node.js `>= 22`\n- a repository with a valid `WORKFLOW.md`\n- tracker credentials such as `LINEAR_API_KEY`\n- a coding agent runtime that supports app-server mode, such as `codex app-server`\n\n### Install\n\n```bash\nnpm install -g symphony-ts\n```\n\nVerify the CLI is available:\n\n```bash\nsymphony --help\n```\n\n### Quickstart\n\n1. Go to the repository you want Symphony to operate on.\n2. Create `WORKFLOW.md` in that repository.\n3. Export `LINEAR_API_KEY`.\n4. Start Symphony from that repository root.\n\n```bash\ncd \u002Fpath\u002Fto\u002Fyour-repo\nexport LINEAR_API_KEY=your-linear-token\nsymphony .\u002FWORKFLOW.md --acknowledge-high-trust-preview --port 4321\n```\n\nIf you do not pass a path, Symphony defaults to `.\u002FWORKFLOW.md`:\n\n```bash\nsymphony --acknowledge-high-trust-preview --port 4321\n```\n\nYou can also run without global install:\n\n```bash\nnpx symphony-ts .\u002FWORKFLOW.md --acknowledge-high-trust-preview --port 4321\n```\n\nSymphony does not generate `WORKFLOW.md` for you. It expects a repository-owned workflow file and,\nby default, reads `.\u002FWORKFLOW.md` from the current working directory.\n\n\u003Cdetails>\n\u003Csummary>Agent setup prompt\u003C\u002Fsummary>\n\n```text\nSet up and start Symphony in this repository.\n\nRequirements:\n- create or update WORKFLOW.md for Linear\n- use LINEAR_API_KEY from the environment or tell me exactly which variable is missing\n- install symphony-ts and start Symphony with the required --acknowledge-high-trust-preview flag\n- if startup fails, stop and report the exact failing step and command\n```\n\n\u003C\u002Fdetails>\n\n### `WORKFLOW.md` template\n\n```md\n---\ntracker:\n  kind: linear\n  api_key: $LINEAR_API_KEY\n  project_slug: your-linear-project-slug\nworkspace:\n  root: ~\u002Fcode\u002Fsymphony-workspaces\ncodex:\n  command: codex app-server\nserver:\n  port: 4321\n---\n\nYou are working on Linear issue {{ issue.identifier }}.\nImplement the task, validate the result, and stop at the required handoff state.\n```\n\nThis is the only example `WORKFLOW.md` you need to get started. Copy it into your repository root\nas `WORKFLOW.md`, then change these fields before starting Symphony:\n\n- `tracker.project_slug`\n- `workspace.root`\n- `codex.command`\n\nIf you want the dashboard, keep `server.port` in the workflow or pass `--port` on the CLI.\nThe web dashboard now opens with a server-rendered snapshot and continues updating live in the\nbrowser over server-sent events.\n\nIf your agent workflow needs access to environment variables from the launching shell, configure\nCodex to inherit them in `codex.command`, for example:\n\n```yaml\ncodex:\n  command: codex --config shell_environment_policy.inherit=all app-server\n```\n\nIf your agent must push branches, open PRs, or call external APIs during a turn, also configure a\nturn sandbox policy that explicitly allows network access instead of relying on a minimal\n`workspaceWrite` sandbox object.\n\nIf a specific external CLI still does not see the credentials it needs in your environment, provide\nthat tool's credential via environment variables before launching Symphony.\n\nFor a complete reference covering every supported field with defaults and inline documentation, see\n[docs\u002FWORKFLOW.template.md](docs\u002FWORKFLOW.template.md).\n\n### What You Get\n\nOnce Symphony is running, it will:\n\n- poll your tracker for eligible work\n- create a dedicated workspace per issue\n- run your coding agent inside that workspace\n- expose a local dashboard and JSON API when `--port` or `server.port` is set\n- keep retry, reconciliation, and cleanup state visible to operators\n\n### Develop\n\nTo develop Symphony itself you will need:\n\n- Node.js `>= 22`\n- pnpm `>= 10`\n- Codex CLI with `codex app-server` support\n\n```bash\npnpm install\npnpm build\nnode dist\u002Fsrc\u002Fcli\u002Fmain.js --help   # verify the build\n```\n\nRun checks:\n\n```bash\npnpm test           # run all tests once\npnpm test:watch     # watch mode\npnpm typecheck      # TypeScript type check only\npnpm lint           # Biome lint check\npnpm format         # Biome auto-format\n```\n\n### Run From Source\n\nIf you are developing Symphony itself rather than using the published CLI:\n\n```bash\npnpm install\npnpm build\nnode dist\u002Fsrc\u002Fcli\u002Fmain.js --acknowledge-high-trust-preview\n```\n\nSee [docs\u002FDEV_GUIDE.md](docs\u002FDEV_GUIDE.md) for a full walkthrough including Linear setup, `WORKFLOW.md` configuration, and troubleshooting.\n\n## Roadmap\n\n| Item | Status |\n| --- | --- |\n| Implement Symphony and Linear integration | ✅ Complete |\n| Support more platforms such as GitHub Projects | 🟡 Planned |\n| Support a local board GUI | 🟡 Planned |\n| Support more coding agents such as Claude Code scheduling | 🟡 Planned |\n\nIf there is a platform you want Symphony to support, open an issue and let us know.\n\n## What Symphony Does\n\nSymphony is a long-running service that:\n\n- monitors your tracker for eligible work\n- creates deterministic, per-issue workspaces\n- renders repository-owned workflow prompts from `WORKFLOW.md`\n- runs coding agents in isolated execution contexts\n- handles retries, reconciliation, and cleanup\n- exposes structured logs and an operator-facing status surface\n\nIn a typical setup, Symphony watches a Linear board, dispatches agent runs for ready tickets, and\nlets the agents produce proof of work such as CI status, review feedback, and pull requests. Human\noperators stay focused on the work itself instead of supervising every agent turn.\n\n## Why Teams Use It\n\n- to turn tracker tickets into autonomous implementation runs\n- to isolate agent work by issue instead of sharing one mutable directory\n- to keep workflow policy inside the repository\n- to operate multiple concurrent agents without losing observability\n- to introduce a higher-level operating model for AI-assisted engineering\n\n## Contributing\n\nIf you are extending this TypeScript implementation, keep changes aligned with the upstream product\nmodel in [`SPEC.upstream.md`](SPEC.upstream.md) and follow the repository workflow documented in\n[`AGENTS.md`](AGENTS.md).\n\n## License\n\nThis repository is licensed under [`Apache-2.0`](LICENSE). See [`NOTICE`](NOTICE) for attribution\ninformation related to the upstream OpenAI Symphony project and this unofficial TypeScript\nimplementation.\n","# Symphony-ts\n\n**本项目是 [OpenAI Symphony](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fsymphony) 的非官方 TypeScript 实现。**\n\nSymphony-ts 将项目工作转化为隔离、自治的实现运行：它从你的任务跟踪工具中读取任务，为每个问题创建一个专用的工作空间，在该边界内运行编码代理，并为操作人员提供清晰的运行时可见性、重试和控制界面。\n\n> [!WARNING]\n> Symphony 适用于受信任的环境。\n\n![Symphony 演示：Linear 问题跟踪与 Symphony 可观测性仪表板并排显示](.github\u002Fmedia\u002Fdemo.png)\n\n## 运行 Symphony\n\n### 要求\n\n- Node.js `>= 22`\n- 包含有效 `WORKFLOW.md` 文件的仓库\n- 任务跟踪工具的凭据，例如 `LINEAR_API_KEY`\n- 支持应用服务器模式的编码代理运行时，例如 `codex app-server`\n\n### 安装\n\n```bash\nnpm install -g symphony-ts\n```\n\n验证 CLI 是否可用：\n\n```bash\nsymphony --help\n```\n\n### 快速入门\n\n1. 前往你希望 Symphony 运行的仓库。\n2. 在该仓库中创建 `WORKFLOW.md` 文件。\n3. 导出 `LINEAR_API_KEY`。\n4. 从该仓库根目录启动 Symphony。\n\n```bash\ncd \u002Fpath\u002Fto\u002Fyour-repo\nexport LINEAR_API_KEY=your-linear-token\nsymphony .\u002FWORKFLOW.md --acknowledge-high-trust-preview --port 4321\n```\n\n如果你未指定路径，Symphony 默认使用 `.\u002FWORKFLOW.md`：\n\n```bash\nsymphony --acknowledge-high-trust-preview --port 4321\n```\n\n你也可以不进行全局安装而直接运行：\n\n```bash\nnpx symphony-ts .\u002FWORKFLOW.md --acknowledge-high-trust-preview --port 4321\n```\n\nSymphony 不会为你生成 `WORKFLOW.md` 文件。它期望仓库拥有自己的工作流文件，默认情况下会从当前工作目录读取 `.\u002FWORKFLOW.md`。\n\n\u003Cdetails>\n\u003Csummary>代理设置提示\u003C\u002Fsummary>\n\n```text\n在此仓库中设置并启动 Symphony。\n\n要求：\n- 为 Linear 创建或更新 WORKFLOW.md\n- 使用环境中的 LINEAR_API_KEY，或明确告诉我缺少哪个变量\n- 安装 symphony-ts 并以所需的 --acknowledge-high-trust-preview 标志启动 Symphony\n- 如果启动失败，请停止并报告确切的失败步骤和命令\n```\n\n\u003C\u002Fdetails>\n\n### `WORKFLOW.md` 模板\n\n```md\n---\ntracker:\n  kind: linear\n  api_key: $LINEAR_API_KEY\n  project_slug: your-linear-project-slug\nworkspace:\n  root: ~\u002Fcode\u002Fsymphony-workspaces\ncodex:\n  command: codex app-server\nserver:\n  port: 4321\n---\n\n您正在处理 Linear 问题 {{ issue.identifier }}。\n实现该任务，验证结果，并在达到所需的交接状态时停止。\n```\n\n这是你开始所需的所有 `WORKFLOW.md` 示例。将其复制到你的仓库根目录命名为 `WORKFLOW.md`，然后在启动 Symphony 之前更改以下字段：\n\n- `tracker.project_slug`\n- `workspace.root`\n- `codex.command`\n\n如果你想使用仪表板，请在工作流中保留 `server.port`，或者在 CLI 中传递 `--port`。Web 仪表板现在会以服务器渲染的快照打开，并通过服务器发送事件在浏览器中持续实时更新。\n\n如果你的代理工作流需要访问启动 shell 中的环境变量，可以在 `codex.command` 中配置 Codex 继承这些变量，例如：\n\n```yaml\ncodex:\n  command: codex --config shell_environment_policy.inherit=all app-server\n```\n\n如果你的代理在一次运行中必须推送分支、打开 PR 或调用外部 API，还应配置一个明确允许网络访问的运行沙盒策略，而不是依赖于最小化的 `workspaceWrite` 沙盒对象。\n\n如果某个特定的外部 CLI 仍然无法在其环境中看到所需的凭据，请在启动 Symphony 之前通过环境变量为该工具提供凭据。\n\n有关涵盖所有支持字段、默认值和内联文档的完整参考，请参阅 [docs\u002FWORKFLOW.template.md](docs\u002FWORKFLOW.template.md)。\n\n### 你能获得什么\n\n一旦 Symphony 运行起来，它将：\n\n- 定期轮询你的任务跟踪工具以查找符合条件的任务\n- 为每个问题创建一个专用的工作空间\n- 在该工作空间内运行你的编码代理\n- 当设置了 `--port` 或 `server.port` 时，暴露本地仪表板和 JSON API\n- 保持重试、协调和清理状态对操作人员可见\n\n### 开发\n\n要开发 Symphony 本身，你需要：\n\n- Node.js `>= 22`\n- pnpm `>= 10`\n- 具备 `codex app-server` 支持的 Codex CLI\n\n```bash\npnpm install\npnpm build\nnode dist\u002Fsrc\u002Fcli\u002Fmain.js --help   # 验证构建是否成功\n```\n\n运行检查：\n\n```bash\npnpm test           # 运行所有测试一次\npnpm test:watch     # 监视模式\npnpm typecheck      # 仅进行 TypeScript 类型检查\npnpm lint           # Biome 代码风格检查\npnpm format         # Biome 自动格式化\n```\n\n### 从源码运行\n\n如果你正在开发 Symphony 本身，而不是使用已发布的 CLI：\n\n```bash\npnpm install\npnpm build\nnode dist\u002Fsrc\u002Fcli\u002Fmain.js --acknowledge-high-trust-preview\n```\n\n请参阅 [docs\u002FDEV_GUIDE.md](docs\u002FDEV_GUIDE.md)，其中包含完整的操作指南，包括 Linear 设置、`WORKFLOW.md` 配置和故障排除。\n\n## 路线图\n\n| 项目 | 状态 |\n| --- | --- |\n| 实现 Symphony 与 Linear 的集成 | ✅ 已完成 |\n| 支持更多平台，如 GitHub Projects | 🟡 计划中 |\n| 支持本地看板 GUI | 🟡 计划中 |\n| 支持更多编码代理，如 Claude Code 调度 | 🟡 计划中 |\n\n如果你希望 Symphony 支持某个特定平台，请提交一个问题告诉我们。\n\n## Symphony 的作用\n\nSymphony 是一种长期运行的服务，它：\n\n- 监控你的任务跟踪工具以查找符合条件的任务\n- 为每个问题创建确定性的专用工作空间\n- 从 `WORKFLOW.md` 中渲染仓库拥有的工作流提示\n- 在隔离的执行环境中运行编码代理\n- 处理重试、协调和清理工作\n- 暴露结构化日志和面向操作人员的状态界面\n\n在典型的设置中，Symphony 会监视 Linear 看板，为准备就绪的问题分配代理运行，并让代理生成工作证明，例如 CI 状态、评审反馈和拉取请求。人工操作人员可以专注于实际工作，而不必监督每个代理的运行。\n\n## 团队为何使用它\n\n- 将任务跟踪工具中的问题转化为自治的实现运行\n- 按问题隔离代理工作，而不是共享一个可变的目录\n- 将工作流策略保留在仓库内部\n- 在不丢失可观测性的前提下同时运行多个代理\n- 引入更高层次的 AI 辅助工程运营模式\n\n## 贡献\n\n如果你正在扩展这个 TypeScript 实现，请确保更改与上游产品模型保持一致，具体请参阅 [`SPEC.upstream.md`](SPEC.upstream.md)，并遵循仓库中记录的工作流程，详见 [`AGENTS.md`](AGENTS.md)。\n\n## 许可证\n\n本仓库采用 [`Apache-2.0`](LICENSE) 许可证。有关与上游 OpenAI Symphony 项目及此非官方 TypeScript 实现相关的署名信息，请参阅 [`NOTICE`](NOTICE)。","# Symphony-ts 快速上手指南\n\nSymphony-ts 是 OpenAI Symphony 的非官方 TypeScript 实现。它能将项目任务（如 Linear Issue）转化为独立的自动化编码运行：为每个问题创建专用工作区，在隔离环境中运行编码代理，并提供可视化的操作面板。\n\n> **⚠️ 警告**：Symphony 仅适用于受信任的开发环境。\n\n## 1. 环境准备\n\n在开始之前，请确保满足以下系统要求和前置依赖：\n\n*   **Node.js**: 版本 `>= 22`\n*   **代码仓库**: 包含有效的 `WORKFLOW.md` 配置文件\n*   **任务追踪凭证**: 例如 `LINEAR_API_KEY` (需先在 Linear 后台生成)\n*   **编码代理运行时**: 支持 `app-server` 模式的代理，例如 `codex app-server`\n\n## 2. 安装步骤\n\n你可以通过 npm 全局安装，或使用 npx 直接运行。\n\n### 方式一：全局安装（推荐）\n\n```bash\nnpm install -g symphony-ts\n```\n\n验证安装是否成功：\n\n```bash\nsymphony --help\n```\n\n### 方式二：临时运行（无需安装）\n\n```bash\nnpx symphony-ts --help\n```\n\n## 3. 基本使用\n\n### 第一步：配置工作流文件\n\n在项目根目录下创建名为 `WORKFLOW.md` 的文件。Symphony 不会自动生成此文件，你需要根据以下模板进行修改：\n\n```md\n---\ntracker:\n  kind: linear\n  api_key: $LINEAR_API_KEY\n  project_slug: your-linear-project-slug\nworkspace:\n  root: ~\u002Fcode\u002Fsymphony-workspaces\ncodex:\n  command: codex app-server\nserver:\n  port: 4321\n---\n\nYou are working on Linear issue {{ issue.identifier }}.\nImplement the task, validate the result, and stop at the required handoff state.\n```\n\n**必须修改的字段：**\n*   `tracker.project_slug`: 你的 Linear 项目标识。\n*   `workspace.root`: 代理工作区的存储路径。\n*   `codex.command`: 根据你的代理工具调整命令（如需继承环境变量，可配置为 `codex --config shell_environment_policy.inherit=all app-server`）。\n\n### 第二步：设置环境变量\n\n导出你的 Linear API 密钥：\n\n```bash\nexport LINEAR_API_KEY=your-linear-token\n```\n\n### 第三步：启动 Symphony\n\n进入项目根目录并运行以下命令启动服务：\n\n```bash\ncd \u002Fpath\u002Fto\u002Fyour-repo\nsymphony .\u002FWORKFLOW.md --acknowledge-high-trust-preview --port 4321\n```\n\n如果不指定文件路径，默认读取当前目录下的 `.\u002FWORKFLOW.md`：\n\n```bash\nsymphony --acknowledge-high-trust-preview --port 4321\n```\n\n### 第四步：查看运行状态\n\n启动成功后：\n1.  Symphony 将开始轮询你的任务追踪器（如 Linear）。\n2.  为符合条件的任务创建独立工作区并运行编码代理。\n3.  打开浏览器访问 `http:\u002F\u002Flocalhost:4321`，即可看到实时更新的可视化仪表盘（Dashboard），监控任务执行、重试及清理状态。","某中型 SaaS 团队的后端负责人正试图利用 AI 代理批量处理 Linear 看板中积压的数十个独立功能优化任务。\n\n### 没有 symphony-ts 时\n- **环境冲突频发**：人工为每个任务切换分支或创建临时目录时，常因依赖版本不一致或残留文件导致“在我机器上能跑”的诡异报错。\n- **上下文污染严重**：AI 代理在处理不同需求时容易混淆历史对话或读取错误的代码片段，导致生成的代码逻辑张冠李戴。\n- **过程黑盒难控**：管理者无法实时查看多个并行任务的执行进度，一旦某个任务卡死或陷入循环，只能手动中断并重新排查日志。\n- **协作效率低下**：开发人员需花费大量时间手动配置 API 密钥、初始化工作区及监控运行状态，而非专注于代码审查。\n\n### 使用 symphony-ts 后\n- **天然隔离保障**：symphony-ts 自动为每个 Linear 议题创建独立的沙箱工作区，彻底杜绝了依赖冲突和文件残留问题。\n- **精准上下文聚焦**：工具将议题描述精准注入专属空间，确保 coding agent 仅基于当前任务边界进行编码，逻辑准确率显著提升。\n- **全景可视可控**：通过内置的 Web 仪表盘，负责人可实时观测所有任务的运行快照、重试状态及输出日志，异常任务一键干预。\n- **流程自动化闭环**：只需配置一次 `WORKFLOW.md`，symphony-ts 即可自动轮询 tracker、调度 agent 并汇报结果，实现从需求到代码的无人值守流转。\n\nsymphony-ts 通过将杂乱的并发开发任务转化为标准化、隔离且可视的自动化流水线，让团队真正实现了可信环境下的大规模 AI 辅助交付。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FOasAIStudio_symphony-ts_4f4a3efd.png","OasAIStudio","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FOasAIStudio_80235097.jpg","",null,"hello@oasai.studio","oasaistudio","https:\u002F\u002Fgithub.com\u002FOasAIStudio",[80,84],{"name":81,"color":82,"percentage":83},"TypeScript","#3178c6",98.2,{"name":85,"color":86,"percentage":87},"JavaScript","#f1e05a",1.8,484,29,"2026-04-07T06:46:43","Apache-2.0","未说明","不需要",{"notes":95,"python":93,"dependencies":96},"该项目是 OpenAI Symphony 的非官方 TypeScript 实现，无需 GPU 或 Python 环境。运行前需在仓库根目录创建 WORKFLOW.md 配置文件，并设置线性追踪器（Linear）的 API 密钥。由于涉及自主代码执行，仅限在受信任的环境中运行。开发时需使用 pnpm 进行构建和测试。",[97,98,99],"Node.js >= 22","pnpm >= 10 (仅开发需要)","codex app-server (或支持 app-server 模式的编码代理)",[13,52],"2026-03-27T02:49:30.150509","2026-04-10T20:34:10.396684",[],[105,110,115,120,125,130,135],{"id":106,"version":107,"summary_zh":108,"released_at":109},189198,"v0.1.8","## 变更内容\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F48 中修复了标识符变更后的工作区路径漂移问题\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fcompare\u002Fv0.1.7...v0.1.8","2026-03-13T03:29:06",{"id":111,"version":112,"summary_zh":113,"released_at":114},189199,"v0.1.7","## 变更内容\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F34 中优化了 README 入门流程\n* 由 @Aubrey-M-ops 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F35 中更新了文档和开发指南\n* 文档：由 @Aubrey-M-ops 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F37 中重写 AGENTS.md，以反映当前仓库状态\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F38 中添加了实时仪表板更新功能\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F39 中使仪表板 UI 与上游可观测性工具保持一致\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F40 中重构了仪表板服务器模块\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F41 中添加了 Apache 2.0 许可证元数据\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F43 中澄清了工作流的身份验证和网络要求\n* 修复：由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F47 中解决了协调过程中工作进程缺失的问题\n\n## 新贡献者\n* @Aubrey-M-ops 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F35 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fcompare\u002Fv0.1.5...v0.1.7","2026-03-10T03:26:56",{"id":116,"version":117,"summary_zh":118,"released_at":119},189200,"v0.1.6","## 变更内容\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F34 中优化了 README 入门流程\n* 由 @Aubrey-M-ops 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F35 中更新了文档和开发指南\n* 文档：由 @Aubrey-M-ops 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F37 中重写 AGENTS.md，以反映当前仓库状态\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F38 中添加了实时仪表板更新功能\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F39 中使仪表板 UI 与上游可观测性保持一致\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F40 中重构了仪表板服务器模块\n\n## 新贡献者\n* @Aubrey-M-ops 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F35 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fcompare\u002Fv0.1.5...v0.1.6","2026-03-07T09:12:53",{"id":121,"version":122,"summary_zh":123,"released_at":124},189201,"v0.1.5","**完整更新日志**: https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fcompare\u002Fv0.1.4...v0.1.5","2026-03-06T16:11:39",{"id":126,"version":127,"summary_zh":128,"released_at":129},189202,"v0.1.3","## 变更内容\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F21 中添加 README 顶部横幅\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F29 中添加上游信息\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F30 中澄清 README 路线图中的平台示例\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F31 中修复 Linear 候选查询的兼容性问题\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fcompare\u002Fv0.1.2...v0.1.3","2026-03-06T15:13:01",{"id":131,"version":132,"summary_zh":133,"released_at":134},189203,"v0.1.2","**完整更新日志**: https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fcompare\u002Fv0.1.1...v0.1.2","2026-03-06T14:03:40",{"id":136,"version":137,"summary_zh":138,"released_at":139},189204,"v0.1.0","## 变更内容\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F1 中添加工作流配置解析器\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F2 中添加严格提示渲染功能\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F3 中实现工作区路径安全性\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F5 中实现工作流监听与重载功能\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F4 中添加工作区钩子运行器\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F6 中添加 Linear 跟踪器适配器\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F7 中添加 Codex 应用服务器客户端\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F8 中添加结构化日志记录和运行时快照功能\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F11 中添加 linear_graphql 动态工具\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F12 中添加编排器核心\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F13 中添加编排器验证流程\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F15 中添加代理运行器\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F16 中添加可观测性仪表板服务器\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F17 中添加可观测性后续测试\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F18 中集成编排器与代理运行时\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F19 中添加 README 文件\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F20 中完成 CLI 运行时宿主\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F23 中添加 CLI 运行时集成测试\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F24 中扩展一致性测试矩阵\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F25 中完成任务 18 集成加固\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F26 中添加发布自动化和包元数据\n* 由 @Octane0411 在 https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fpull\u002F27 中使验收修复与规范保持一致\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002FOasAIStudio\u002Fsymphony-ts\u002Fcommits\u002Fv0.1.0","2026-03-06T13:55:59"]