码头（Dockling）是免费、开源的 macOS 程序坞扩展栏：在系统程序坞旁边摆上实时小组件、应用分组和文件夹，也可以直接用它替代程序坞。界面全部是简体中文。
Dockling (码头) is a free, open-source Dock shelf for macOS. Put live widgets, app groups and folders right next to the system Dock, or use it in place of the Dock. The interface is in Simplified Chinese.
第一次打开时 macOS 会拦一下（应用未经 Apple 公证）。看看怎么打开First launch: macOS asks once because Dockling is not notarized. How to open it
需要 macOS 26 · 无需账号 · 不追踪 · MIT 许可Requires macOS 26 · No account · No tracking · MIT License
所有截图都是应用自己的界面，由仓库里的截图工具在 macOS 上实际拍摄。Every screenshot is the real app, captured on macOS by the screenshot tool in the repository.
按用途分成几类，每一类都可以自由组合。点按小组件会打开详情面板，显示更多内容和操作。
Grouped by what they are for, and free to combine. Click any widget to open a panel with more detail and actions.
常用应用、刚下载的文件和要来回拖动的文件都放在手边，不用再打开访达翻找。
Keep favourite apps, fresh downloads and files in transit right next to the Dock, no Finder digging.
今天的日程、待办和专注节奏放在眼前，一眼就知道接下来要做什么；想安静做事时还有环境音和收音机。
Today's schedule, to-dos and focus rhythm in plain sight, plus ambient sounds and radio for heads-down time.
不用打开控制中心或活动监视器，常用的开关和系统状态就在扩展栏上。
Common switches and system status without opening Control Centre or Activity Monitor.
随手就要用的小工具：找回刚才拷贝的内容、换算单位、翻译一句话、看看天气和行情。
Little tools you reach for all day: clipboard history, conversions, translation, weather and prices.
看看喜欢的图片，随时截图，最近的截图和取到的颜色都能直接拖走或拷贝。
Rotate favourite photos, take screenshots, and drag away recent shots or copy picked colours.
盯着 Codex 的额度和进度，也顺手看看 GitHub 项目的星标、议题和拉取请求。
Keep an eye on Codex limits and progress, plus stars, issues and pull requests on GitHub.
近几个版本加入的小组件和改进。带“下一版”标记的已经合并，会随下一个版本发布。
Widgets and improvements from the last few releases. Items marked “Next” are merged and ship in the next release.
5 小时和每周额度两个圆环、重置时间、用量预测；圆点显示 Codex 正在工作、等你确认还是已完成。
Rings for the 5-hour and weekly limits, reset times and a burn-down forecast, plus a dot that shows whether Codex is working, waiting for you or done.
未来 7 天、未来 10 天和多城市样式，带气温范围条和降水概率。
7-day, 10-day and multi-city layouts with temperature bars and chance of rain.
猫耳复古收音机，内置中国之声等电台，可搜索 Radio Browser 目录、收藏、定时关闭。
A cat-eared retro radio with built-in Chinese stations, Radio Browser search, favourites and a sleep timer.
倒数日和正数日，支持每年重复和农历，详情是带“今天”红线的时间线。
Count down or count up, yearly or by the lunar calendar, on a timeline with a red line for today.
小熊猫跟着今天喝的水装满，达标冒星星；柴犬、橘猫、企鹅、水獭、章鱼是赞助者角色。
A red panda fills up with what you drink today; a shiba, cat, penguin, otter and octopus are supporter characters.
macOS 本机翻译，免费、不用密钥，文字不离开这台 Mac；把文字拖到卡片上就地翻译。
On-device macOS translation: free, no key, your text never leaves the Mac. Drop text on the card to translate.
最近 7 天圆点、连续天数、本月热力图，点一下就打卡。
Seven-day dots, streaks and a monthly heat map. One click to check in.
读取系统日历，周一到周日 7 列显示本周日程，今天高亮。
Your system calendar as seven columns, Monday to Sunday, with today highlighted.
价格、24 小时涨跌和走势线，人民币或美元计价，红涨绿跌可切换。
Price, 24-hour change and a sparkline in CNY or USD, with your choice of up/down colours.
单独调节每个应用的音量（0 到 150%）或静音。
Set each app's volume from 0 to 150%, or mute it.
屏幕顶部的胶囊提示：音量、亮度和会议倒计时，默认关闭。
A capsule at the top of the screen for volume, brightness and meeting countdowns. Off by default.
农历、节气、传统节日，调休和放假前一天提醒。
Lunar dates, solar terms and festivals, with a heads-up before make-up workdays and holidays.
雨声、海浪、风声、篝火和几种噪音，可混合播放，定时渐弱停止。
Rain, waves, wind, campfire and noise colours, mixed together, with a fade-out timer.
只属于码头的待办清单，不需要任何权限，回车添加、点勾完成。
A to-do list of Dockling's own. No permissions, Return to add, tick to finish.
显示废纸篓大小，垃圾多了会有苍蝇绕着飞，鼠标一挥就吓跑。
Shows how full the Trash is. Leave it too long and flies start circling; wave the pointer to shoo them.
模拟、翻页、像素、大号数字、秒圈、中文等表盘；玻璃、磨砂、深色等扩展栏外观。
Analogue, flip, pixel, big digits, seconds ring and Chinese clock faces; glass, frosted, dark and more shelf looks.
详情面板和更多扩展栏组合。标注“示例数据”的截图使用小组件库自带的示例，其余为拍摄时的实时读数。
Detail panels and more shelf setups. Shots marked “sample data” use the widget library's built-in examples; the rest are live readings.
提供 .dmg 和 .zip（Dockling-版本号.dmg / .zip），在 GitHub Releases 下载最新版。
Available as .dmg and .zip (Dockling-version.dmg / .zip) from GitHub Releases.
系统要求：macOS 26。码头读取系统程序坞自身的偏好设置，并基于当前 SDK 绘制界面，不提供更早系统版本的构建。Requirements: macOS 26. Dockling reads the Dock's own preferences and draws with the current SDK, so there are no builds for older systems.
从 GitHub Releases 下载最新版，免费。Get the latest build from GitHub Releases. It is free.
只有第一次需要在设置里点“仍要打开”。怎么做First time only: click Open Anyway in System Settings. How
码头没有程序坞图标，也没有主窗口；设置、小组件库和布局切换都在菜单栏图标里。Dockling has no Dock icon and no main window. Settings, the widget library and layouts live in its menu bar icon.
码头使用 ad-hoc 签名：没有 Apple 开发者证书，也没有经过公证。下载的文件本身没有问题，只是首次打开时会被门禁（Gatekeeper）拦下。只需要处理一次。
Dockling is ad-hoc signed, with no Apple Developer certificate and no notarization. The download is fine, but Gatekeeper stops it the first time. You only need to do this once.
如果 macOS 仍然拒绝打开，或提示应用“已损坏”，请在“终端”中移除下载文件的隔离属性：If macOS still refuses, or says the app is damaged, remove the quarantine flag in Terminal:
xattr -dr com.apple.quarantine /Applications/Dockling.app启动后请看菜单栏：码头是辅助型应用，没有程序坞图标，也不会打开窗口。如果双击后似乎什么都没发生，其实它已经正常启动了。After launch, look in the menu bar: Dockling is an agent app with no Dock icon and no window. If nothing seems to happen, it is already running.
免费，而且开源（MIT 许可）。所有功能都免费；赞助者只额外解锁专属配色、表盘和喝水角色这类外观，码头不联网验证，全凭诚信。
Yes, and open source under the MIT License. Every feature is free. Supporters only get cosmetic extras such as shelf colours, clock faces and water characters, unlocked on the honour system with no online check.
码头使用 ad-hoc 签名：没有 Apple 开发者证书，也没有经过公证，所以首次打开时会被门禁（Gatekeeper）拦下。下载的文件本身没有问题，源码全部公开，也可以自己构建。处理方法见首次打开。
Dockling is ad-hoc signed, with no Apple Developer certificate and no notarization, so Gatekeeper stops it the first time. The download itself is fine, the source is public, and you can build it yourself. See First launch.
只在用到时才请求，不用的小组件不需要：自动化（正在播放、邮件）、日历和提醒事项（打开对应面板时）、麦克风（录音）、录音权限（应用音量）、完全磁盘访问权限（废纸篓大小）、辅助功能（剪贴板点按即粘贴）、通知（久坐和喝水提醒）。
Only when a widget needs it, and never for widgets you do not use: Automation (Now Playing, Mail), Calendars and Reminders (when you open those panels), Microphone (Recorder), audio recording (Per-app volume), Full Disk Access (Trash size), Accessibility (paste on click from Clipboard) and Notifications (stand-up and water reminders).
都保存在你的 Mac 本地，没有账号，也不收集统计。只有少数小组件需要联网：天气（MET Norway、Open-Meteo）、汇率、加密货币（CoinGecko）、股票、GitHub、Codex 用量（只发给 chatgpt.com）、收音机，以及假期安排更新和检查更新。翻译使用 macOS 本机翻译，文字不离开这台 Mac。
It stays on your Mac. There is no account and no analytics. Only a few widgets go online: weather (MET Norway, Open-Meteo), currency, crypto (CoinGecko), stocks, GitHub, Codex usage (sent to chatgpt.com only) and radio, plus holiday-schedule updates and update checks. Translation uses on-device macOS translation, so your text never leaves the Mac.
没有关系。码头是开源项目 Docket（nparashar150，MIT）的非官方简体中文本地化和扩展分支；Docket 的灵感来自独立开发者的付费应用 Dockset。码头与 Dockset 及上游 Docket 均无关联，也未获得其认可。如果你想要打磨完善、有售后支持的正式产品，请购买 Dockset。
None. Dockling is an unofficial Simplified Chinese localization and extension of the open-source Docket (by nparashar150, MIT), which was itself inspired by Dockset, a paid app by an independent developer. Dockling is not affiliated with or endorsed by Dockset or upstream Docket. If you want a polished, supported product, buy Dockset.
请到 GitHub 提交 Issue，中文或英文都可以。附上 macOS 版本、码头版本和截图会很有帮助。
Open an issue on GitHub, in Chinese or English. Your macOS version, Dockling version and a screenshot help a lot.
码头完全免费、开源，是我用下班和周末时间做的。如果它让你的 Mac 用起来更顺手，欢迎请我喝杯咖啡，金额随意，国内可用微信或支付宝，海外可用 Ko-fi；不方便赞助也没关系，分享给朋友或在 GitHub 上点个星，同样是很大的鼓励。
Dockling is free and open source, built in evenings and at weekends. If it makes your Mac nicer to use, a coffee of any size is welcome on Ko-fi, by PayPal or card. If not, sharing it or starring it on GitHub helps just as much.
