# @harborppm/cli 中文文档

规范地址：https://npmcn.com/package/%40harborppm/cli/

版本：0\.117\.0
npm 元数据更新时间：2026-11-16T09:48:34.421Z
中文译文更新时间：2026-11-17T09:52:17.981Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40harborppm/cli
原文对照：https://npmcn.com/package/%40harborppm/cli/?lang=original
项目主页：https://harborppm.com/ai?utm_source=npm&utm_medium=package&utm_campaign=cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.7 MB，20 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-10-06T15:06:38.078Z
- 最新版本发布：2026-11-16T09:48:34.226Z
- 近 30 天下载量：17024（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：123（近 12 个月 123 个）

## 中文简介

从终点站出发的港站:一个全屏应用程序,装有一切,外加脚本和代理的命令.

## 安装

```sh
npm install @harborppm/cli
```

也可以使用：`pnpm add @harborppm/cli`、`yarn add @harborppm/cli`、`bun add @harborppm/cli`

## README

# 港务公司

[港湾](https://harborppm.com/?utm_source=npm&utm_medium=readme&utm_campaign=cli) 在终端:一个全屏应用程序 与整个港口, 命令脚本和代理.

```sh
npm install -g @harborppm/cli
harbor                          # the full-screen app (signs you in the first time)
harbor mine                     # or one command at a time
```

需要节点 22 或以后.

## 纽到港?

你可以从终端开始 你自己的港口是免费的30天,没有卡;在那之后,整个船员每月49美元,而不是每个座位.

```sh
npm install -g @harborppm/cli
harbor signup      # make your account in the browser (email or Google), then come back
harbor             # name your harbor and its first project, and you're in
```

`harbor signup` 打开港湾页面 **创建**; 请确认您在有时间时发送的信件中的电子邮件 。 你第一次跑的时候 `harbor` 在还没有港口的情况下,它会要求一个名字(Enter会接受一个建议),如果您愿意的话,第一个项目,然后打开它。 加入球队的港口? 打开他们寄给你的邀请函 `harbor` 打开他们的港口.

## 全屏应用

`harbor` 自己接管终点站,就像 `htop` 或者说 `lazygit`,在按下时将其还给 `q`它打开了港口的标记(地砖、H和三艘船,用半块划出),而你的港口则装满了货;之后边栏只放上屏幕。 然后说:

1.  **现在**:今天的焦点(`f` 增加或卸下你的任务,最多3个)和你的报到(`c`);什么是你,先晚; 谁在等你; 你的风险和问题.
2.  **收件箱**:和网站一样的pings:等待你,签注,提及. 输入打开一个;它被标记为已读.
3.  **项目**:每个组合、方案和项目及其健康。 项目在其板上开始(栏并列; `f` 财务报告和审定财务报表 `p` 仅显示某人的名片或一个优先级),其列表,或其预算和支出分类账(`v`); 空格选择你的牌或行,以及 `m` 移动、分配、日期、推后一周、确定优先或一并完成所有选择(`u` 全部放回去); `e` 修改其细节:铅、日期、预算、手持说明的健康. `P` 进行尸检:每个人都回答“失败了,发生了什么?” 单独5分钟,然后每个答案都变成了一种风险(即:`r`,折成已升起的`m`)或被排除在外(`l`) (中文(简体) ).
4.  **程序**:审查:方案最坏,首先是其牵头、结束日期、工作后期和优先矩阵位置; `m` 写下一个动作, `h` 以手作卫生(以手作卫生),或以手作迟到的工作, `o` 财务报告和审定财务报表 `p` 显示某人的或一个组合的。 方案同时显示其项目和里程碑(`m` 增加一个里程碑,一号空间,它的下一步行动和健康; `v` 逐个项目读取,每个项目都标有月份的栏目,按状态和最坏的风险来解开任务. 投资组合作为一个板子(方案、有风险、下一个里程碑和旁边的钱); `v` 逐项读取. `e` 在某个程序上,还命名了阻碍它的东西,它等待的东西,其影响和基线,其健康史以下,以及 `r` 阅读其状况报告。 一个里程碑可以等待项目,需要某人的签注(他们批准或要求修改). 一个项目的细节按月设定计划并等待什么;一个组合设定了优先矩阵的规则. `:` 然后,"新组合"就是一个.
5.  **风险**登记簿,最糟的第一; `t`, (中文(简体) ), `o` 财务报告和审定财务报表 `p` 缩小它的类型,所有者或组合, `a` 增加关闭的, `h` 在上面绘制热图 `c` 把它缩小到一个细胞。 输入网站每个字段(状况、所有者、可能性、影响、缓解、应急、解析、理由、说明、更新)的更改; `n` 记录风险、问题或决定.
6.  **人员**: 开业和晚工,以及今后四周与每个人的能力相矛盾; 输入改变他们的能力,角色,或者承诺给一个程序的时间.
7.  **路线图**:一个组合的方案和项目在几个月内,以其健康颜色, 用于里程碑.
8.  **历史**: 谁改变了组合、方案或项目的内容(`s` 选择哪个.
9.  **日历**:有每日任务和里程碑的月份;箭头会移动一天, `[` `]` 月, Enter 进入白天的任务.
10.  **简介** (单位:千美元)`0`: 网站每周简报为所有组合或一个组合撰写(`p`),每个保健机构有多少方案,开设的笔记; `f` 航运预测中的互换 `y` 复制显示的内容( 在允许应用程序复制的终端中); tmux 需要 `set-clipboard on`) (中文(简体) ).
11.  **机组人员** (单位:千美元)`C`谁在船上,每个人都能做什么。 所有者在编辑和观看(Enter)之间切换某人,通过电子邮件邀请(Enter)`i`),副本(`y`)或撤回(`w`)一个仍然出局的字母,使一个只读的共享链接到一个组合(`s`)并选择谁得到星期一的更新(`m`),并制作项目录取表(`f`) (中文(简体) ). 每个人都看到他们连接的应用程序(`d` 在浏览器中打开 Keep.
12.  **目标** (单位:千美元)`G`: 每一个组合的目标,其沿途有多远,在红色中偏离正轨,以及它们的关键结果. 输入后折叠一个打开的入球,读取它为什么重要,每个关键结果都算什么,以及谁最后一次移动它的数字,然后再折叠它关闭;它不会改变任何东西,因此一个取景者也可以读取. `n` 确定目标; `e` 目标重新命名,赋予它所有者,一个到期日或它为何重要,增加若干关键结果或算上一个方案或项目; `e` 在一个关键结果上移动; `d` 删除目标或密钥结果.
13.  **报告** (单位:千美元)`O`):报告页的仪表板,每张图都以条来标出其编号. `n` 制作一个仪表盘(第一个以几个图表开头), `a` 添加一个图表(它算什么,然后如何分割),输入重命名一个仪表板或图表,再分割一个图表或移动它, `[` `]` 移动一个, `d` 将取去.

`:` 也打开了三页,它们不是自己的屏幕. **最近删除** 列出过去30天删除的内容, Enter 带回一个(对于编辑,它首先说它所坐的位置也消失了). **工作表链接** 列出你的, `n` 制作一个程序(或所有者,整个港口)并复制,因为它只显示一次 `d` 关一关. **API 密钥** 列出您上次使用时的列表,以及 `d` 撤销一项; `n` 打开网站,其中新建键并显示一次.

任务也发生了变化:产权、地位、所有者、到期日(`2026-10-14`, (中文(简体) ), `today`, (中文(简体) ), `+3`,优先级,项目,它等待的是什么(键或词),它如何重复,注释,清单步骤,评论(`C` 改变或取出你的一个. `s` 在它下面添加一个子任务 `T` 保存为项目模板之一。 在一个项目上, `T` 从模板开始任务 `M` 打开其信件: 整个工程的一次对话, 其中 `n` 写道, `a` 回答光标中的信息(答案位于光标下), `e` 更改您的和 `d` 删除. `M` 在程序上同样打开程序的信息.

密钥 : `↑↓` (或 `j k`和 `←→` (或 `h l`移动,输入打开, Esc返回, `:` 找到任何东西(一个屏幕,“新项目”,一个项目或程序的名称), `/` 找到一个任务 通过它的键或字, `n` 做点新的, `e` 改变什么是开放, `[` `]` 移动一列牌, `x` 标记它做了, `d` 删除(它先询问), `u` 取消你最后的零钱, `H` 开关港口, `?` 全部列出.

它运行在与网站相同的引擎上:健康,任务密钥,限制和取消工作的方式相同,改变的是你去的时候除外(信头说,在你下线的时候持有),还有任何人在网站上或其他地方所做的改变,在几秒内出现. 它需要完全进入,其中 `harbor login` 问名; 第一次再次问名.

它有黑终端和光终端的颜色,通过询问终端的背景来选择(或读取) `COLORFGBG`);一个不说得到黑暗的终端. `harbor theme light` 或者说 `harbor theme dark` 解决它, `harbor theme auto` 回到问,和 `HARBOR_THEME` 运行一次.

`harbor help` 从最需要的十几个命令开始; `harbor help all` 列出每一个。 在有颜色的终端、有管子的终端或有管子的终端上也显示标记 `NO_COLOR` 设置,它是纯文本. `harbor --version` 说说你有哪个版本.

## 网站上

你的港口是同一个 [港务局](https://harborppm.com/today?utm_source=npm&utm_medium=readme&utm_campaign=cli)在同一个账户上签了字 所以和你们一起工作的人不需要终端 网站增加了团队分享的内容:

-   **你的船员**:通过电子邮件邀请人们 **人员**;它们看到相同的板子,风险和行进图,它们的变化会在几秒钟内到达您的终端.
-   **其他人的地位**:每周简报、一击状态报告和只供利益攸关方阅读的链接.
-   **申请表**: 将请求降入项目董事会的公共表格.
-   **GitHub 图像**: 用于命名任务密钥( RR-42) 的拉动请求在任务上显示并移动它.
-   **Claude和其他AI应用程序**,在 MCP 上连接 [hupppm.com/ai (中文(简体) )](https://harborppm.com/ai?utm_source=npm&utm_medium=readme&utm_campaign=cli)。 。 。 .

`harbor open RR-42` 在网站上打开一个任务(在右边的港口,即使浏览器还有一个打开), `harbor open Ridge` 一个项目,以及 `harbor open` 今天它自己打开. `harbor invite sam@example.com` 发送 萨姆,同样邀请信 人们页做(`--viewer` 让他们看看,但不改变任何东西;只有港口的主人可以邀请. `harbor calendar` 打印您的私人日历链接, 以添加到 Google 、 Apple 或 Outlook 日历中: 您的会议以外的到期日期、 里程碑和签出日期, 并保持更新( S)`--program NAME` 因为在一个节目里所有的事, `--new` 把链接换成新鲜的, `--off` )),以关闭. `harbor roadmap "Next steps"` 说明项目是否为公共路线图页并打印其链接; `--publish` 出版(现在,Next and Shipped,仅限任务标题,在无法猜测的链接上,在直播时保持不变), `--publish --dates` 增加每件物品发运之日(标题只是默认) `--off` 马上拿下来 只有港主才能出版. `harbor projects --json` 给每个项目的 `public` 财务报告和审定财务报表 `url`。 。 。 .

网站也有命令:打开 **底部的命令行** 在菜单中,按 `/`类型 `mine`, (中文(简体) ), `add "Call the mill" #ridge @sam --due fri` 或者说 `done RR-12`。 。 。 .

## 您的计划在您的仓库

`harbor init` 在代码工程中写出 `.harbor/` 文件夹位于寄存器顶端:项目中每个任务一个普通文件,其标题,状态,所有者,到期日,优先级及其所等待的内容,以及下面的注释. 手动编辑,在拉取请求中审查,像任何代码一样保留在git中.

```sh
harbor init "Cedar site"         # or its key: harbor init CS
$EDITOR .harbor/tasks/CS-4.md    # status: doing, owner: Sam, due: 2026-11-07…
harbor sync                      # sends the edits, brings the website's back
```

```md
---
title: Move checkout to the new API
status: doing
owner: Sam Rivera
due: 2026-11-07
priority: high
waits: [CS-2]
---

Old endpoints go away on Nov 20.
```

任何名称的新文件都是新任务 : `harbor sync` 添加并重命名于其密钥. 一个字段在文件里变了,而不是在网站上去到港;一个在两个地方都变了,都保留了网站的并说是这样. 删除一个文件不会删除任务(代之以标记它完成). 在新的克隆上运行 `harbor sync` 在编辑前. `harbor init --hook` 在每次承诺后增加一个 git 后承诺的钩子同步,以及 `--dry-run` 要么说它会做什么 不写或发送任何东西.

没有账户? `harbor init --local` 制作一个只生活在文件夹中的计划(其余在 `.harbor/plan.json`),以及 `harbor` 在那个文件夹里,打开它全屏,离线和免费。 后来, `harbor init PROJECT` 将其任务移至 hopppm.com 上的一个项目.

## 在你的贝壳提示中

`harbor prompt` 为您的提示打印几个字符 : `⚓ 2 today · 1 late`在珊瑚上工作很晚 完全没发现 它从不等待在网络上:它显示它保存的计数,并在背景中取出5分多时的新计数,或者在您更改任务后取出. `harbor prompt --init zsh` (或 `bash`, (中文(简体) ), `fish`, (中文(简体) ), `starship`打印线条,以加入你的外壳的设置,所以 `harbor prompt --init starship >> ~/.config/starship.toml` 单打独斗:

```zsh
# ~/.zshrc
setopt prompt_subst
RPROMPT='$(harbor prompt --shell zsh)'
```

## 不断更新

npm不更新全局安装本身,所以一天一次 `harbor` 问 npm 是否有更新版本, 以及您运行的任何命令`npm install -g @harborppm/cli@latest --prefer-online` 更新它。 剧本、管子或CI都写不出来 设定 `HARBOR_NO_UPDATE_CHECK=1` (或 `NO_UPDATE_NOTIFIER=1`)去关.

## 其他文本

任务标题,名称和笔记可以来自一个收件表,一个GitHub拉取请求或港口的任何人. 在命令或应用程序显示之前, `harbor` 取出终端将操作的控件字符( 逃避序列、 后空格、 文本方向覆盖), 因此标题不能设置剪贴板、 重命名窗口或隐藏周围的东西 . `--json` 保持数据准确,这些字符写作 `\u` 逃脱.

## 签名于

`harbor signup` 第一次访问:同样的签入,在开户时打开页面. `harbor login` 将 CLI 与 Harbor 注册, 并打开同一页 Claude 和其他应用程序使用: 它命名为 “ Harbor CLI ” , 并询问允许什么 。 选择 **只允许阅读** (或运行) `harbor login --read-only`如果它不应该改变什么。 登录保存在 `~/.config/harbor/credentials.json`,只有你才能读取, 并刷新自己30天.

`harbor logout` 忘在这台机器上 要结束它无所不在的接入,断开连接 **港务公司** 下级 **已连接的应用程序** 在港湾的菜单.

## 图标

```
harbor harbors                              the harbors you belong to
harbor whoami                               who you're signed in as, where, and which
                                            build of the site answers
harbor use HARBOR|none                      the harbor to work in when you're in several
harbor programs                             programs and their projects
harbor projects [words] [--program P]       projects with health and open work
harbor forecast [PROJECT] [--program P]     when projects will likely finish, from
                                            how fast their crews finish tasks
harbor try PROJECT --drop RL-4 --borrow Sam=3
                                            dry dock: the forecast with changes tried
                                            on a copy (--apply makes them, --save keeps
                                            them to show someone; harbor help try)
harbor why PROJECT|TASK|MILESTONE           what's holding it up: the line of task
                                            waits that sets its date, slack per link
harbor barnacles PROJECT                    work added since the plan was set: by
                                            week, by who, and the slip it explains
harbor baseline PROJECT [--set|--reset]     reads a project's baseline; --set commits
                                            its dates now (--dry-run says what)
harbor hill [--program P]                   where each project is on its hill
harbor hill PROJECT --at 0-100|top|done     move it: up to 50 is figuring it out,
                                            past 50 is getting it done
harbor mine                                 what's on you, late first, and the tasks
                                            others own that you're also on
harbor catchup [--since DATE]               while you were away: handed to you,
                                            decided without you, what moved
harbor clock [NAME] [--zone ZONE|here|none] [--hours 9-17]
                                            who's working now; set your (or NAME's) time zone and hours
harbor tasks [words] [--project P] [--assignee me|none|NAME] [--late] [--status S,S] [--all]
harbor show TASK                            one task in full: who's on it, its files, its
                                            web link and the date its owner's queue suggests
                                            (pilotDue in --json)
harbor files PROJECT [--kind image|doc|link]
                                            every file on a project's tasks, newest first,
                                            with the task each is on
harbor open [TASK|PROJECT]                  open it on the website (or Today)
harbor invite EMAIL [--viewer]              invite someone to your harbor by email
harbor calendar [--program P] [--new|--off] your private calendar link (.ics)
harbor roadmap PROJECT [--publish] [--off]  a project's public roadmap: read, publish or take it down
harbor shore PROGRAM [--url URL] [--on forecast,health,notes] [--off KINDS] [--test] [--remove]
                                            a program's Slack, Discord or Teams channel: the morning
                                            forecast, health changes and notes for later post there

harbor program "NAME" [--portfolio P] [--lead me|NAME] [--starts DATE]
                     [--ends DATE]
harbor project "NAME" --program P [--lead me|NAME] [--starts DATE]
                     [--ends DATE] [--budget N] [--from "DONE PROJECT"]
                                            --from: dead reckoning, its tasks due when
                                            they really finished in that project
harbor add "TITLE" --project P [--assignee me|NAME] [--also "NAME, NAME"] [--due DATE|pilot]
                   [--priority low|medium|high|urgent] [--status S] [--comment TEXT]
                   [--starts DATE] [--over-limit] [--literal] [--dry-run] [--unless-exists]
                                            no TITLE: one title a line from stdin
                                            --due pilot takes the earliest day the owner's queue
                                            suggests (their open work due first, weekly pace, time
                                            away, what it waits on, how long their similar tasks
                                            took); it needs an owner, and an empty queue gives
                                            their next working day. A date that won't hold says so
harbor start TASK | submit TASK | done TASK [--confirm] [--over-limit]
harbor edit TASK [--title T] [--assignee me|none|NAME] [--also "NAME, NAME"|none]
                 [--due DATE|pilot|none] [--starts DATE|none]
                 [--priority P] [--status S] [--notes TEXT]
                 [--repeat weekly|biweekly|monthly|never]
                 [--waits-on TASK,TASK|none] [--confirm] [--over-limit]
harbor comment TASK "TEXT"
harbor checkin "WHAT YOU'RE DOING" [--on-blocker]
harbor risk "TITLE" --project P|--program P [--impact 1-5] [--probability 1-5]
                   [--owner NAME] [--due DATE]
harbor issue "TITLE" --project P|--program P [--impact 1-5] [--owner NAME]
                    [--due DATE]
harbor decision "TITLE" --project P|--program P [--owner NAME] [--due DATE]
                       [--turned-down T] [--look-again DATE] [--supersedes "OLD"]
harbor risks [words] [--kind risk,issue,decision] [--project P] [--closed]
harbor raid "TITLE" [--status S] [--owner me|none|NAME] [--impact 1-5] [--probability 1-5]
                   [--due DATE|none] [--update TEXT] [--mitigation T] [--resolution T]
                   [--turned-down T] [--look-again DATE|none] …
                                            one risk, issue or decision in full, or change it
harbor review [WORDS] [--mine|--owner NAME] [--portfolio P] [--done]
                                            the review: programs worst first, with next moves
                                            (reads only; harbor submit moves a task to In review)
harbor thanks [TASK "LINE"] [--to NAME]     a one-line thanks for a task (--milestone, --decision);
                                            on its own, the thanks you were given in the last 30 days
harbor bridge                               run the review as a meeting: one project a screen,
                                            what changed since the last one, log decisions,
                                            actions and risks live, post the summary to chat
harbor bridge --list [--program P]          what changed since each program's last review, every
                                            item, as text (--json for agents); doesn't hold the meeting
harbor next-move PROGRAM "TEXT"             write a program's next move
harbor health --program P|--project P|--portfolio P STATE [--note WHY]
                                            set its health by hand (auto hands it back)
harbor brief [--portfolio P] [--all] [--say] the weekly brief (--all: every late and done task)
harbor report PROGRAM                       a program's status report, as Markdown
harbor export tasks PROJECT|risks|review [--all]
                                            a spreadsheet (CSV) to stdout
harbor import FILE [--project P] [--portfolio P] [--no-people]
                                            add tasks from a CSV file
harbor draft "WORDS" --project P|--program P|--portfolio P|--new program|portfolio [--add]
                                            Harbor's AI drafts tasks, projects or programs
harbor draft add                            add the draft shown last
harbor premortem PROJECT ["WHAT WENT WRONG"] [--start]
harbor voyage PROJECT ["YOUR LINE"]
harbor messages PROJECT ["TEXT"] [--limit N] | messages PROJECT --edit "TEXT" [--message ID]
harbor chat TASK|PROJECT|PROGRAM ["TEXT"] [--reply N] [--watch]
harbor chat @NAME [@NAME…] ["TEXT"] [--watch]
harbor chats
harbor note PROJECT ["NOTE"] [--opens DATE|--milestone NAME|--off-track]
harbor sound TASK [--answer DAYS|--ask NAMES|--settle DAYS] [--why TEXT]
harbor soundings [PROJECT]
harbor goals [PORTFOLIO]                    each portfolio's goals, off track first
harbor goal "GOAL" [--title T] [--owner NAME] [--due DATE|none] [--link WORK] [--unlink WORK]
            [--kr "KR" --at N|--target N [--start N] [--unit U]|--counts WORK]
harbor goal "TITLE" --new [--portfolio P] [--owner NAME] [--due DATE] [--why T]
harbor milestones [PROGRAM] [--project P] [--done]
harbor milestone "NAME" [--program P] [--due DATE] [--rename T] [--reached|--open]
                 [--signs-off NAME|none] [--approve|--changes NOTE]
harbor milestone "NAME" --new --program P --due DATE
harbor reports [DASHBOARD]                  the Reports page's dashboards, each chart as numbers
harbor ashore [--weeks N] [--country CODES|none] [--person NAME]
harbor limit PROJECT [COLUMN N|none]
harbor week [--next|--last|--week DATE] [--review]
harbor week TASK --day DAY [--hours N] | week TASK --off [--day DAY] | week --day-hours N
harbor init [PROJECT] [--hook] [--dry-run]  a project's tasks as files in this repository
harbor init --local [NAME]                  a plan in this folder alone, no account
harbor sync [--quiet] [--dry-run]           the files and the website, in step both ways
harbor handover PERSON [--to NAME] [--until DATE] [--note TEXT] [--keep ID,ID] [--confirm]
harbor handback PERSON
harbor fog [--project P]                    tasks nobody has touched for three weeks, longest first
harbor fog --sweep [--project P]            the same, one at a time: still needed, a new date, or drop it
harbor fog keep TASK                        it's still needed: out of the fog
harbor watch [--project P] [--bell]         a live ticker of the harbor's changes
harbor watch --once [--since TIME] [--json] the latest changes (or all since TIME), once, for scripts
harbor lifeboats [--program P]              work only one person knows, each with a second pair of hands
harbor lifeboats N [--person NAME]          adds that second pair of hands
harbor follow TASK|"RISK" --person NAME     someone follows it too
harbor convoys [PROGRAM]                    promises between programs, and how each stands
harbor convoy ask PROGRAM --to OTHER --by DATE "WHAT"
harbor convoy accept|decline|deliver|undeliver|move|withdraw CONVOY [--project P] [--note WHY] [--by DATE]
harbor salts PROJECT [--risk N|--task N|--put-away N]   what finished projects like it ran into
harbor rank PORTFOLIO [--order "A, B, C"|--clear]       which ship docks first
harbor agent [--agent NAME]
harbor agent report TASK "WHAT YOU DID" [--start] [--agent NAME]
```

`harbor handover Priya` 列出Priya携带的所有物品(开放任务、签售等待、她拥有的风险和问题、她领导的项目和计划), 在添加前不要动 `--confirm`。 。 。 . `--until DATE` 普丽娅在人身上表现的很出色 `harbor handback Priya` 不管是谁拿走的 都还给我. `--note` 将每项任务和风险作为评论.

`harbor fog` 列出三个星期以来没有人打开、移动、编辑或评论的开放任务,时间最长. `harbor fog --sweep` 一次一次在终点站穿行: `k` 仍然需要(清除雾), `d` 一个新的日期, `x` 放下枪, `s` 跳过, `q` 停下来 在板子上,在应用和网站上,这些卡显示暗了.

`harbor watch` 将一个狭小的分页或 tmux 面板转换成您港湾的活盘:卡片移动,评论,健康变化,每次发生时各有一行,在相同的活盘上更新网站使用的活盘. 你们自己所行的善功,是灿烂的; `--bell` 当你的东西改变, 敲响终端的钟 `--project` 保持到一个项目。 它从最近几起变化开始,从开始倾听的时间开始; `--since 14:30` (或日期)从那时开始,从这个计算机的时钟开始(`14:30Z` 或者说 `14:30 UTC` ),标题取出滴答时间所在的时区,而"港"则说出"自BST 2.30起"无所事事. GitHub 链接的更改为“ 通过 GitHub 完成 RR-4 ” , 正如 History 所做的那样 . `q` 停止; 管道或与 `--json` (一个JSON object a line) 它运行到它被杀死,和 `--once` 打印什么是那里和返回, 对于脚本。 港湾保留了最新的40个变化,所以 `--since` 后面说它从哪里开始.

`harbor convoys` 列出方案之间的承诺:一个方案一天前要求另一个方案,以及它的状况(等待答复,及时、迟到交付项目的预测,拒绝,交付); `harbor convoys Footwear` 将一个程序分割成它所等待的 以及其它程序所等待的. `harbor convoy ask "Member App" --to Footwear --by 2026-12-15 "Shoe photos"` 问; 询问的侧面回答 `harbor convoy accept "shoe photos" --project "Ridge Runner"`, (中文(简体) ), `decline … --note WHY` 或者说 `deliver`,请求方可以 `move … --by DATE` 或者说 `withdraw`一个车队是用它的话来命名的;当它们合身时,港湾列出两者.

`harbor salts "Ridge Runner"` 出现最多三道老盐:像它这样完成的项目遇到什么(风险成真、问题、航行日志线、任务很晚完成). `--risk 1` 把第一个放在登记簿上, `--task 1` 加上它作为一个任务, `--put-away 1` 停止显示它. `harbor rank "Summit Line"` 显示投资组合项目设置顺序、谁设置顺序以及最新的排名链接; `--order "Daypack, Ridge Runner"` 设置一个(该组合的开放式项目,首先对接)和 `--clear` 脱去. 排名链接成对的乘务员回答在组合页面上进行.

`harbor lifeboats` 列出只有一个人接触过的工作(一个项目、他们的一角、其他人等待的任务、他们面临的严重风险). `harbor lifeboats 2` 把那人放在2号线作为第二只手`--person NAME` (为他人); `harbor follow RR-4 --person Sam` 为了一项任务 追随不会接管工作. `harbor raid "DECISION" --still-stands "WHY"` 说一个决定 回来看看还站着.

机组特工:在"人"上放AI应用程序 添加一个特工,并像其他人一样分配任务. 一个通过CLI(如Claude Code)工作的特工运行 `harbor agent` 说明、清单和最新评论。 当它完成时, `harbor agent report RR-4 "Drafted 12 questions; two need Dana"` 作为代理商的评论添加了它的注释,并将任务移至In Review,并询问谁给了它任务来检查. 他们同意了,或者发回 一张纸条 `harbor agent` 首先显示。 经纪人从不记下自己的活儿.

`harbor week` 是你们自己的一周,只有你们看见它:星期一至星期五,你们每天担负的任务,每个星期的工时,与你们工作的工时相对应`--day-hours 8`; 第7个,除非你说),在一天的警告是太满了,而你的公开任务还没有一天(一个在检讨中等待别人,所以被排除在外). `harbor week RR-42 --day wed --hours 3` 星期三提出任务(`--next` 下个星期, `harbor week RR-42 --off` 周五(或 `--review`上面写着 你计划什么来对抗你完成什么 网站的"你周"是同一个计划,有拖放.

一个任务有一个主人( A)`--assignee`他们将因它而应答,而负其罪;他们中有谁能因它而应答`--also "Sam, Aya"`他们看见它下 同样在其中 `harbor mine` 和今天,并算为知道它. `harbor edit RR-4 --also none` 留给主人.

`harbor add --project Trail --comment "From Monday's call" < list.txt` 每行文件增加一行任务,每行注释(每个选项适用于每行); `--dry-run` 要求港湾在它丢掉的复制件上添加它们,所以它显示了每个任务的真实性(钥匙,列,所有者,优先级,日期,父母,里程碑),一个已经拥有标题的开放任务,以及它会拒绝的任何东西和原因;当某事被拒绝时,它退出 1 。 它显示的关键是预测,而不是持有: 中间的任何人的附加. `--unless-exists` 只有在项目没有由该名进行开放的任务时才添加标题(done任务没有被检查,所以每周的会合仍然会进入),所以再审的脚本不会加倍. `--json` 有干线的形状, 所以一个脚本读 两种方式相同: `tasks`,有一个条目带有其密钥的标题,一个跳过的名称 `skipped` 打开任务键为 `sameAs` (单独增加的一个标题也保留) `created`) (中文(简体) ).

`harbor add "Book the venue @Quinn by Friday !high #Website"` 如网站"新任务"所做的那样,用平话读取标题:它为Quinn增加了"订出会场",周五到期,高优先,在网站项目中,写出它所读的内容. 旗帜胜过文字(它们留在标题中), `--literal` 标题保持准确的打字,以及 `--due` 取同词(`--due "next friday"`, (中文(简体) ), `--due "in two weeks"`) (中文(简体) ). 在全屏应用中, `n` 以同样的方式读取新任务的标题.

`harbor limit RR` a. 显示一个棋盘的列一次需要多少任务; `harbor limit RR doing 8` 将1改为20,或 `none` 如果你拥有港口的话. `harbor projects --json` 搭载每块板 `limits` 我也一样.

`harbor premortem` 和你的船员一起进行尸检 `--start` 询问每个人"这是在结束日期之后,而这个项目失败了:发生了什么?",每个人单独添加答案5分钟,然后答案在项目的风险和问题分页上一起显示,每个分页在一击中成为了风险. 它自己打印出问题和答案 一旦一个项目完成, `harbor voyage` 打印其航行记录(计划按实际日期计算,最大滑行,实现的风险,谁关闭最多,以及船员的行),并添加你的. `harbor messages PROJECT` 读取一个工程的 Messages 标签, 整个工程的一次对话,以及 `harbor messages PROJECT "TEXT"` 写信给它; `@Name` 寄给那个人的收件箱. `harbor chat` 任何作品都一样: `harbor chat RR-42` 阅读任务的评论, `harbor chat Footwear` 一个程序的信息, `harbor chat Footwear "TEXT" --reply 2` 根据电文\[2\]作出的答复,以及 `--watch` 跟踪对话的直播, 打印新线; 在终端中, 键入一条线进行张贴 . `harbor chat @aya "TEXT"` 写一个直接消息(聊天页面), `harbor chat @aya @ben "TEXT"` 写信给一群人, `harbor chat @aya` 读取(和 `--watch` 随行)并 `harbor chats` 列出您的直接消息; 只有聊天中的人才能读取它. `harbor note` 留下一个注释,供日后在一个项目上使用:它会一直被密封(船员只看到它在那里,谁离开它)直到它的一天,直到程序的一个里程碑达到,或者直到项目关闭轨道,然后在项目上方和简报中打开. `harbor sound TASK --ask crew` 取出一个声音:它问你,任务的主人和任何已经开工的人,任务需要多少工作日(`--ask "Sam,Priya"` 选择谁。 每个人单独回答 `harbor sound TASK --answer 4 --why "…"`没有人看到其他人的数字,直到每个人都看到 `harbor sound TASK` 显示分布,当猜想接近时的估计数,或者当它们相距相去甚远时的"先谈这个" `--settle DAYS` 记录你同意的. `harbor soundings` 列出他们, 等待你的答案. `harbor goals` 列出每个组合的目标,首先偏离轨道,列出每个关键结果的进展. `harbor goal "TITLE" --new` 设置一个,和 `harbor goal "GOAL"` 读取或修改: `--owner`, (中文(简体) ), `--due`, (中文(简体) ), `--why`, (中文(简体) ), `--link "Ridge Runner"` 计算一个程序、项目或任务, `--kr "Stores signed" --target 40` 添加数字密钥结果 `--kr "Stores signed" --at 12` 移动它. `harbor milestones` 列出一个程序的里程碑,首先列出它们完成了多少任务,哪些人签了字,哪些人在等待; `harbor milestone "NAME" --new --program P --due DATE` 增加一个 `harbor milestone "NAME"` 移动( e)`--due`,重命名,勾选(`--reached`以便谁签署它`--signs-off`),或者,如果这是你的签名, `--approve`或问 `--changes`。 。 。 . `harbor reports` 打印报告页的仪表板,每个图表作为其数字. `harbor messages PROJECT --edit "TEXT"` 修改您的最新消息 . `harbor ashore` 列出今后八周的公共假日和休假时间; `--country US,GB` 规定港口的假日和假日 `--person NAME --country DE` 预测和每周的负载 算作休息日.

`harbor brief --say` 将简报变成BBC的"航运预报":每个节目一个区域,风能为后期工作,能见度为健康,对任何出轨的都发出狂风警告. 它印出预报,用你电脑自己的声音来表达`say` 在Mac, Windows的演讲上,或 `espeak-ng` 在 Linux 上,您可能需要安装。 与 `--json` 它印出预报,保持安静.

每个命令都用 `--json` 原始结果(拒绝后作为 `{"error": "…"}` 关于标准输出,仍然带有退出代码1),以及 `harbor COMMAND --help` 只显示命令。 状况是积压、待办、做、审查和完成。 A 类 `DATE` 是YYY-MM-DD吗, `today`, (中文(简体) ), `tomorrow`,或 `+N` 从今天起N天.

当您属于多个港口时,请说明: `--harbor NAME` 命令,或 `harbor use NAME` 一次(用你的签注保存); `harbor use none` 忘却. 也没有,命令要求而不是猜测, 所以没有什么东西在错误的港口降落。 全屏应用程序共享相同选择:打开了港口 `harbor use` 设置, 询问如果没有设置, 那么您在应用程序中切换到的港口将成为命令使用的港口 .

港湾挡住了应用软件中会隐藏的东西:完成一个仍在等待另一个任务的任务,或者越过一列的极限. CLI是这样说的,并给前进的旗帜起名(`--confirm`, (中文(简体) ), `--over-limit`) (中文(简体) ).

每一个变化都显示 港湾历史 作为你的, "通过港湾CLI"。 命令从不删除任何内容( E)`harbor sync` 包括:删除任务的文件带回了它;全屏的app可以,如网站所能,并先问.

## 另一个服务器

`harbor login --server https://your-harbor.example` (或 `HARBOR_SERVER`) (中文(简体) ). `HARBOR_CONFIG_DIR` 移动已保存的登录.

## 发展中国家

命令为平地节点而无依赖. 整个屏幕的应用是 `src/tui` 在寄存器中( 墨水反应),捆绑到 `dist/app.mjs` 以 `node cli/build.mjs`;"墨子"和"回想"是其唯一的依附关系. `npm test` 管理CLI对站港的测试; `e2e/cli.test.mjs` 财务报告和审定财务报表 `e2e/terminal-app.test.mjs` 驱使它与真实的.

## 许可证

麻省理工学院(见 `LICENSE`) (中文(简体) ). 其余港储处为私人.

## 常见问题

### @harborppm/cli 是什么？

从终点站出发的港站:一个全屏应用程序,装有一切,外加脚本和代理的命令\.

### 如何安装 @harborppm/cli？

在项目目录运行 npm install @harborppm/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 harbor，可以用 npx harbor 直接运行。

### @harborppm/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/harborppm\_\_cli 是否存在。

### @harborppm/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @harborppm/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @harborppm/cli 可以商用吗？

@harborppm/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @harborppm/cli 的下载量有多少？

根据 npm 官方下载统计，@harborppm/cli 在 2026/10/17 – 2026/11/15 这 30 天内被下载 17,024 次，日均约 567 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @harborppm/cli 还在维护吗？

最新版本 0\.117\.0 发布于 2026/11/16（1 天前）；至今共发布 123 个版本，其中过去 12 个月发布了 123 个；首次发布于 2026/10/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

