@validflow/ccneed-cli 0.1.4 → 0.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -101,10 +101,13 @@ The [Agent Skill](skills/ccneed/SKILL.md) covers the remaining commands, includi
|
|
|
101
101
|
| 💬 Find conversations | `ccneed threads list` |
|
|
102
102
|
| 🚀 Start research | `ccneed run "Your question" --kb-id KB_ID` |
|
|
103
103
|
| 📚 Explore knowledge bases | `ccneed kb list` |
|
|
104
|
+
| 📊 Check a knowledge base's data mix | `ccneed kb stats --kb-id KB_ID` |
|
|
104
105
|
| ➕ Create a knowledge base in the browser | `ccneed kb create` |
|
|
105
106
|
| 📎 List or upload your own files | `ccneed files list` / `ccneed files upload ./research-brief.pdf` |
|
|
106
107
|
| 🗂️ View or add conversation resources | `ccneed threads resources` / `ccneed threads append` |
|
|
107
108
|
| 🕘 Review task history | `ccneed tasks list --thread-id THREAD_UUID` |
|
|
109
|
+
| 🔎 Follow a research turn | `ccneed tasks get --thread-id THREAD_UUID --turn-id TURN_UUID` |
|
|
110
|
+
| ⏳ Wait for a result or question | `ccneed tasks watch --thread-id THREAD_UUID --turn-id TURN_UUID --timeout 60s` |
|
|
108
111
|
| 🚪 Sign out | `ccneed auth logout` |
|
|
109
112
|
|
|
110
113
|
Knowledge-base and file bindings can be added, but not removed. Use `ccneed <command> --help` for the required arguments.
|
package/checksums.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.1.
|
|
2
|
+
"version": "0.1.5",
|
|
3
3
|
"assets": {
|
|
4
|
-
"ccneed-0.1.
|
|
5
|
-
"ccneed-0.1.
|
|
6
|
-
"ccneed-0.1.
|
|
7
|
-
"ccneed-0.1.
|
|
8
|
-
"ccneed-0.1.
|
|
9
|
-
"ccneed-0.1.
|
|
4
|
+
"ccneed-0.1.5-linux-amd64": "3f59d9bf14e51f378097f899f9fed6799fa67bc9b78b3dd5702230fdbc72c628",
|
|
5
|
+
"ccneed-0.1.5-linux-arm64": "9bc4876e9caa85ff7b4f862c4d9d9300b4f4f415c4eb7dd69e8a65810f23122e",
|
|
6
|
+
"ccneed-0.1.5-darwin-amd64": "5bc5a388c470f96b803c923e1b8c89e4360cb6c42e426c028d4686a73b65c58c",
|
|
7
|
+
"ccneed-0.1.5-darwin-arm64": "63a0eaf4e442144260534118b629122f425db011140e7fe00985f3221d4be33b",
|
|
8
|
+
"ccneed-0.1.5-windows-amd64.exe": "e05fd6c1b7fd575bf8241146a7dbe83ff02247ed6e3d4a7c928865752b6c0f5b",
|
|
9
|
+
"ccneed-0.1.5-windows-arm64.exe": "047b8dd4270ba655f83e5783ea72c7900a9999c038a1cf8247712524f09e3c1d"
|
|
10
10
|
},
|
|
11
|
-
"skill_sha256": "
|
|
11
|
+
"skill_sha256": "b72d69b63ee8772ef3a8cbe30c3eaa02cd32702ff9c47a75f656250cbdee4d0f"
|
|
12
12
|
}
|
package/package.json
CHANGED
|
@@ -7,11 +7,14 @@
|
|
|
7
7
|
```bash
|
|
8
8
|
ccneed kb list
|
|
9
9
|
ccneed kb get --kb-id 7
|
|
10
|
+
ccneed kb stats --kb-id 7
|
|
10
11
|
ccneed kb create
|
|
11
12
|
```
|
|
12
13
|
|
|
13
14
|
`list/get` 显示归属当前用户的采集状态、已发布数据和可选择性。绑定前检查 `can_select`；不可选时说明 `disabled_reason` 或采集状态，不自行猜测可用。
|
|
14
15
|
|
|
16
|
+
`stats` 只返回已发布、可分析内容的总数、平台与情绪分布、最多八个主话题，以及同环境的 `web_url`。它不返回帖子正文、单条来源或批量数据。用于选库和判断覆盖范围；如果用户要研究结论，仍需 `ccneed run ... --kb-id 7` 交给 CCNeed 云端分析。需要在网页浏览具体内容时，把 `web_url` 交给用户，不通过其他网页接口绕过 CLI 的聚合边界。采集中的数据尚未发布时，统计可能暂时为零，不把零解释为采集失败。
|
|
17
|
+
|
|
15
18
|
`kb create` 只返回 `status: website_required` 和当前 origin 的官网入口 `url`，**没有创建知识库或启动采集**。向用户展示链接，把意图优化、平台/配额选择和确认交给网页；完成后重新 `kb list/get` 获取真实 ID 和状态，不伪造知识库。
|
|
16
19
|
|
|
17
20
|
## 文件：先上传，再绑定
|
|
@@ -23,7 +26,7 @@ ccneed files upload ./research-brief.pdf
|
|
|
23
26
|
|
|
24
27
|
列表 `--limit` 范围 1–500，关注 `has_more_possible`，不宣称完整历史。上传只接受非空普通支持文件，最大 100 MiB，不跟随符号链接；支持 csv、txt、md、json、ipynb、pdf、docx、xlsx 及 png/jpg/jpeg/webp/gif。
|
|
25
28
|
|
|
26
|
-
|
|
29
|
+
这里上传的是用户自己的文件。成功返回 `library_file_id`、`display_name`、`size_bytes`、`status`，**尚未绑定会话或启动任务**。接收未知先查 `files list`/网站核对，不自动重传制造重复资料。
|
|
27
30
|
|
|
28
31
|
开启会话时用第一句话绑定已有资源：
|
|
29
32
|
|
|
@@ -50,7 +50,18 @@ ccneed tasks get --thread-id THREAD_UUID --turn-id TURN_UUID
|
|
|
50
50
|
ccneed tasks watch --thread-id THREAD_UUID --turn-id TURN_UUID --timeout 60s
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
两者返回目标回合的 `status`、`cloud_status`、公开 `answer`、`answer_truncated`、`pending_action`、`artifacts`、`artifacts_has_more`，并保留会话/回合标识。`watch` 额外返回 `stop_reason
|
|
53
|
+
两者返回目标回合的 `status`、`cloud_status`、公开 `answer`、`answer_truncated`、`pending_action`、`artifacts`、`artifacts_has_more`、`progress` 和 `web_url`，并保留会话/回合标识。`watch` 额外返回 `stop_reason`。`web_url` 是当前登录环境中这个会话的网页入口；用户想仔细查看完整分析过程时，优先建议打开这个链接。
|
|
54
|
+
|
|
55
|
+
`progress.events` 只含本轮的安全里程碑（`seq`、时间、阶段、状态、固定摘要），不含原始工具输入输出、知识库正文或思维链。`get` 默认返回最近 20 条，按 `seq` 升序展示；如需从首条顺序读取，用 `--after-seq 0`；需要更多历史时，用返回的 `next_before_seq` 继续向前翻页；只要新增进度时，记住最新的 `next_after_seq`，稍后再查询。两个游标不能同时使用，`--limit` 范围 1–100：
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
ccneed tasks get --thread-id THREAD_UUID --turn-id TURN_UUID --limit 20
|
|
59
|
+
ccneed tasks get --thread-id THREAD_UUID --turn-id TURN_UUID --after-seq 0
|
|
60
|
+
ccneed tasks get --thread-id THREAD_UUID --turn-id TURN_UUID --before-seq 120
|
|
61
|
+
ccneed tasks get --thread-id THREAD_UUID --turn-id TURN_UUID --after-seq 140
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
没有新增事件时，`progress.events` 可以为空；仍以同一响应的 `status`、`pending_action` 和产出判断任务当前状态，不把空事件误认为完成。`after-seq` 返回空页时保留原游标，下次继续查；多轮会话先用 `tasks list --thread-id` 选定 `turn_id`，不要跨轮复用游标。`watch` 返回截止时最近的一页进度，不是持续向宿主 Agent 推送的事件流。
|
|
54
65
|
|
|
55
66
|
- `waiting_user`：立即把待确认项交给用户，不继续等待。
|
|
56
67
|
- `completed`：交付这一轮的公开回答与关联产出；`answer_truncated` 为真时不能声称回答完整。
|