歡迎與看板指南 / Welcome & posting guide

[aqua5230]

👋 歡迎來到 usage 的討論區！這裡是聊天、問問題、分享想法的地方。先花 30 秒看一下什麼東西該貼哪裡，可以幫大家更快找到你。

這裡（Discussions）適合什麼

• Q&A — 安裝、設定、使用上的疑問。「這個能不能搭 XXX 用？」「為什麼我的 Codex 區塊是空的？」
• Ideas — 想要的功能、改進建議，還不確定是不是 bug 的也先丟這。
• Show and tell — 你做的新面板、截圖、把 usage 接進自己工作流的心得。
• General — 其他不知道歸到哪的話題。

什麼時候開 Issue 而不是這裡

確定是 bug（程式壞了、行為不對）或要正式追蹤的功能需求，請開 Issue 並套用對應模板。Issue 是「待辦清單」，有頭有尾要被解決；Discussions 是開放聊天，不用被關掉。不確定的話貼這裡，需要再轉成 Issue。

⚠️ 隱私提醒：usage 會讀 ~/.claude/ 與 ~/.codex/ 底下的檔案。貼錯誤訊息或設定時，請勿貼狀態檔內容、session 紀錄、絕對路徑、專案名稱或花費數字——這些可能含有你的提示詞與專案資訊。修剪成能重現問題的最小片段即可。

專案怎麼運作

usage 目前由 maintainer（@aqua5230）維護，採仁慈獨裁模式：歡迎討論與 PR，最終合併決定權在 maintainer。詳見 CONTRIBUTING。

---

👋 Welcome to the usage Discussions! This is the place to chat, ask questions, and share ideas. A quick 30-second read on what goes where helps everyone find your post faster.

What belongs here (Discussions)

• Q&A — installation, setup, and usage questions. "Can it work with XXX?" "Why is my Codex section empty?"
• Ideas — features you'd like, improvements, or anything you're not sure is a bug yet.
• Show and tell — a panel you built, screenshots, how you wired usage into your workflow.
• General — anything that doesn't fit the above.

When to open an Issue instead

If it's clearly a bug (something broken or behaving wrong) or a feature request you want formally tracked, open an Issue with the matching template. Issues are a to-do list — they get resolved and closed; Discussions are open-ended chat. When in doubt, post here and we can promote it to an Issue.

⚠️ Privacy: usage reads files under ~/.claude/ and ~/.codex/. When pasting errors or config, do not paste status-file contents, session logs, absolute paths, project names, or cost figures — these may contain your prompts and project info. Trim to the smallest snippet that reproduces the issue.

How the project runs

usage is maintained by a single maintainer (@aqua5230) under a benevolent-dictator model: discussion and PRs are welcome, but the final merge call rests with the maintainer. See CONTRIBUTING.