@validflow/ccneed-cli 0.1.3 → 0.1.4

package/README.md

@@ -78,27 +78,20 @@ Use my CCNeed knowledge base to research iPhone 18 discussions and bring me a PD
 Ask me before making any choice that needs my confirmation.
 ```
 
-Or use the CLI directly. For each new research conversation, choose an existing knowledge base **or** upload your own file, then bind the chosen resource when creating the conversation. You can bind both. Replace example IDs with values returned by your commands:
+Before creating a research conversation, choose a knowledge base. If you need a new one, this command returns a website link to create it:
 
 ```bash
-ccneed kb list
-ccneed threads create --title "iPhone 18 research" --kb-id 7
-ccneed run "Analyze iPhone 18 discussions in the bound knowledge base and prepare a report" --thread-id THREAD_UUID
+ccneed kb create
 ```
 
-If you need a new knowledge base, run `ccneed kb create`, complete the crawl setup on the returned website, then use `ccneed kb list` / `ccneed kb get --kb-id 7` to find an available ID. CCNeed handles collection, cleaning, and analysis-ready data in the cloud; you do not need to manage its internal CSV files.
-
-If you want to start from your own file instead, run `ccneed files upload ./research-brief.pdf`, then `ccneed threads create --title "Brief analysis" --file-id FILE_UUID`. Uploading alone does not bind the file. Creating a conversation does not start a task; `run` does. A task may use your CCNeed credits.
-
-`run` returns immediately while the cloud task continues. You can watch the same turn, respond to a confirmation request, and retrieve its results:
+Start the conversation with your first question and the knowledge-base ID. To bind a file too, upload it first and use the returned file ID:
 
 ```bash
-ccneed tasks watch --thread-id THREAD_UUID --turn-id TURN_UUID --timeout 60s
-ccneed artifacts list --thread-id THREAD_UUID
-ccneed artifacts export-pdf --thread-id THREAD_UUID --artifact-id ARTIFACT_UUID --output ./report.pdf
+ccneed files upload ./research-brief.pdf
+ccneed run "Research iPhone 18 discussions and prepare a report" --kb-id KB_ID --file-id FILE_ID
 ```
 
-For an editable Markdown report, use `ccneed artifacts download` instead. `watch` timing out does not cancel the cloud task; you can check again later. For all options, run `ccneed <command> --help` or read the [Skill](skills/ccneed/SKILL.md).
+The [Agent Skill](skills/ccneed/SKILL.md) covers the remaining commands, including tasks, files, confirmations, and reports.
 
 ### At a glance
 
@@ -106,6 +99,7 @@ For an editable Markdown report, use `ccneed artifacts download` instead. `watch
 | --- | --- |
 | 💳 Check credits and subscription | `ccneed account credits` / `ccneed account overview` |
 | 💬 Find conversations | `ccneed threads list` |
+| 🚀 Start research | `ccneed run "Your question" --kb-id KB_ID` |
 | 📚 Explore knowledge bases | `ccneed kb list` |
 | ➕ Create a knowledge base in the browser | `ccneed kb create` |
 | 📎 List or upload your own files | `ccneed files list` / `ccneed files upload ./research-brief.pdf` |

package/checksums.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.1.3",
+  "version": "0.1.4",
   "assets": {
-    "ccneed-0.1.3-linux-amd64": "c683cb727accd8ac4c793569a3f452692d1e9f3e6d9a395fba4447fc3be18a02",
-    "ccneed-0.1.3-linux-arm64": "daabaed5d65e856fb9abc3f7e55595b2df1939407bab2feda1725c58737b26c0",
-    "ccneed-0.1.3-darwin-amd64": "d8671a89dda03aa05cb75638f306e8c238661a24221c444ca686e39cbe6718a8",
-    "ccneed-0.1.3-darwin-arm64": "e58a2bd696178558ae93dca17250cb4e34d8cdaea2e997958d5613cd5ab5eb6c",
-    "ccneed-0.1.3-windows-amd64.exe": "608080b7005abab462ad583629c24875986b4787f70a2d3be8fef511e817a22d",
-    "ccneed-0.1.3-windows-arm64.exe": "e401eb937ac440bb2afa1e65890285e98ba3f2beee009980be877e176f88f4d5"
+    "ccneed-0.1.4-linux-amd64": "300a7decaa467ca7d251dbf3f22283995f99052f2fbd442f0c0f3d62ed4002a8",
+    "ccneed-0.1.4-linux-arm64": "ade335a5f04f3dbc36239db7530257aac78c8bdcf07ae763caa01efbe6982bce",
+    "ccneed-0.1.4-darwin-amd64": "88bac9cb584a47450353a72b14bf002d38ee547795580cc8bc4d831b8252f25c",
+    "ccneed-0.1.4-darwin-arm64": "4557644d4603d7bf7c82bf9390bfc53f909f7444eee8d367cf43dc73cd525ecf",
+    "ccneed-0.1.4-windows-amd64.exe": "9fdf9f557d725ffce455994627f57e29e958deffca26642a64fc699e4b94d4c3",
+    "ccneed-0.1.4-windows-arm64.exe": "1e5d4d7dd1d6d7e9582bcba73e206dd6f3decb14aeb369c5354299c8dd006247"
   },
-  "skill_sha256": "0a2d489141583b7346aa7ba0cc87ef927019fbe6c5499d3d54742f4cd81d318c"
+  "skill_sha256": "f8bbf7224061a373750c6d3d4bbda884b6e816e1caa2df3a7de438f6c12592cc"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@validflow/ccneed-cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "private": false,
   "description": "CCNeed cloud agent command-line integration",
   "license": "MIT",

package/skills/ccneed/SKILL.md

@@ -15,10 +15,10 @@ CLI 与本 Skill 已正式发行；**部分云端命令仍取决于 CCNeed 正
 | --- | --- |
 | 登录、验证或退出登录、处理凭证错误、切换开发环境 | [认证与环境](references/auth.md) |
 | 查看积分、订阅、近期使用记录 | [账号查询](references/account.md) |
-| 选择/创建会话，提交、查询或观察回合，回答 HITL | [会话与任务](references/tasks.md) |
+| 开启或选择会话，提交、查询或观察回合，回答 HITL | [会话与任务](references/tasks.md) |
 | 选择知识库、上传/绑定文件，查看 findings/reports、下载报告 | [资源与产出](references/resources.md) |
 
-通常顺序：官网授权 → 上传/选择资料 → 选择或创建会话 → 提交回合 → 有界观察 → 必要时交给用户确认 → 查看本轮结果/下载报告。只执行用户此次要求的步骤，不自动创建付费任务。
+通常顺序：官网授权 → 上传/选择资料 → 用首句开启会话并绑定资料 → 有界观察 → 必要时交给用户确认 → 查看本轮结果/下载报告。已有会话则用真实 `thread_id` 继续；只执行用户此次要求的步骤，不自动创建付费任务。
 
 ## 调用约定
 

package/skills/ccneed/references/resources.md

@@ -25,10 +25,10 @@ ccneed files upload ./research-brief.pdf
 
 这里上传的是用户自己的文件；知识库爬取后用于云端分析的内部 CSV 不需要用户提供。成功返回 `library_file_id`、`display_name`、`size_bytes`、`status`，**尚未绑定会话或启动任务**。接收未知先查 `files list`/网站核对，不自动重传制造重复资料。
 
-初始绑定在创建会话时选择已有资源：
+开启会话时用第一句话绑定已有资源：
 
 ```bash
-ccneed threads create --kb-id 7 --file-id FILE_UUID
+ccneed run "分析这些资料并生成报告" --kb-id 7 --file-id FILE_UUID
 ```
 
 `--kb-id` 和 `--file-id` 可重复或逗号分隔；不要把本地文件路径传给 `--file-id`。先确认用户要分析的资料，不按同名文件自动绑定。

package/skills/ccneed/references/tasks.md

@@ -2,24 +2,24 @@
 
 以下命令已随 CLI 发行并有本地契约测试；具体云端能力仍取决于正式服务接口是否上线。示例中的 `THREAD_UUID`、`TURN_UUID`、`REQUEST_UUID`、`ACTION_ID` 必须替换成当前环境真实返回的标识，不能照抄或从会话标题推导。
 
-## 选择或创建会话
+## 开启或选择会话
 
 ```bash
 ccneed threads list --view active --limit 50
-ccneed threads create --title "博主分析"
+ccneed run "分析已选资料并生成报告" --kb-id KB_ID
 ```
 
 `--view` 为 `active` 或 `archived`，`--limit` 范围 1–200，仅显示近期窗口。标题用来帮助用户选择，后续调用以真实 `thread_id` 为准；同名会话有歧义时问用户。
 
-创建可以附加已有 `--kb-id`、`--file-id`，详见 [资源与产出](resources.md)。创建本身不启动任务；用户要求新会话才创建。创建接收状态未知时先查列表/网站，不能盲目再创建。
+开启新会话时把第一句话和已有 `--kb-id`、`--file-id` 一起交给 `run`；`--title` 可选，未指定时服务端取首句作为标题。也可只绑定已上传文件，详见 [资源与产出](resources.md)。接收状态未知时先查列表/网站，不能盲目再开启。
 
-## 异步提交一轮
+## 在已有会话提交一轮
 
 ```bash
 ccneed run "分析已绑定资料并生成报告" --thread-id THREAD_UUID
 ```
 
-输入是用户此次明确委托的内容。返回 `status: accepted`、`cloud_status`、`thread_id`、`turn_id`、`client_request_id`、`conversation_turn_idx`、`existing`，即云端已接收，不是分析完成。保存公开标识以继续观察同一回合；后续消息可在同一会话提交新回合，HITL 回答则用 `tasks reply` 而不是新建回合。
+输入是用户此次明确委托的内容。首次 `run` 和后续 `run --thread-id` 都返回 `status: accepted`、`cloud_status`、`thread_id`、`turn_id`、`client_request_id`、`conversation_turn_idx`、`existing`，即云端已接收，不是分析完成。保存公开标识以继续观察同一回合；后续消息可在同一会话提交新回合，HITL 回答则用 `tasks reply` 而不是新建回合。
 
 CLI 在单次提交前保存按 origin/thread 隔离的不可变 request ID 与输入摘要，不保存输入正文或凭证。