@gitruck/cli 1.0.3 → 1.0.5

package/AGENT.md

@@ -306,6 +306,37 @@ gtrk oralcut "D:/素材/某条.mp4" --params-json '{"punctuation_breaks":{"。":
 
 ---
 
+## 6.5 反馈通道：`gtrk feedback` —— **告知协议，不是普通确认框**
+
+用户抱怨用得不顺手、或者你自己发现把事情办砸了/绕了远路，都可以上报一条。
+但这条通道有一条**协议要求**，与本 playbook 里其它 `-y` 场景**性质不同**：
+
+> **你替用户提交之前，MUST 先把将要发出的内容原样念给用户，得到同意，再加 `--disclosed` 重跑。**
+
+```
+gtrk feedback "<一句话说清哪里不顺手>" --command <命令名> [--category <类别>] [--quote "<用户原话>"]
+```
+
+- **不带 `--disclosed` 且不在真终端里 ⇒ 命令直接拒发**，零网络往返、非零退出，
+  并把「要念给用户的那段全文」打到 stderr（`--json` 时也在机读面的 `notice` 字段里）。
+  照着念、得到同意，再加 `--disclosed` 重跑即可。
+- ⚠️ **`-y` 不能替代那句声明。** `-y` 在别处的意思是「跳过交互提示」，
+  而这里缺的不是「有没有人按回车」，是「有没有告知过用户」——两件事。
+  加了 `-y` 结果**逐项相同**（有单测钉着）。
+- `--command` **必填**，只写命令名（可带至多两级子命令），**不要带参数**——参数里必然带路径。
+- 类别七档：`complaint`（抱怨吐槽）/ `env_unstable`（环境不稳）/ `confused`（用法困惑）/
+  `blocked`（使用受阻）/ `agent_self_detected`（**你自己搞砸了的自首**）/
+  `feature_request`（功能诉求）/ `other`。缺省 `other`。
+
+**MUST NOT**：
+- 把本机绝对路径、API Key、任何配置项塞进 `--context`（白名单只认那几个中性维度，
+  塞别的会被本地直接拒，不会静默丢弃）；
+- 因为「本地已经脱敏了」就认为内容安全 —— 脱敏的判据在服务端，本地那一遍只为让
+  **你念给用户的内容 = 实际发出的内容**；
+- 用 `-y` 或任何别的旗标去绕那道声明。
+
+---
+
 ## 7. 扩展（给改 CLI 的 agent）
 
 新增命令 = 写 `src/commands/<name>.ts` 的 `register<Name>(program)` + 在 `src/index.ts` 注册一行。

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 同合云 (Gitruck)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 同合云 (Gitruck)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.