{"_id":"@anshiyatai/jzcq","name":"@anshiyatai/jzcq","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@anshiyatai/jzcq","version":"0.1.1","type":"module","bin":{"jzcq":"scripts/mcp-cli.mjs"},"engines":{"node":">=20.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.21.1"},"_id":"@anshiyatai/jzcq@0.1.1","gitHead":"14f203d84d1805a949771c2ed4e5299594bb7b5f","description":"终端直接调用精智萃取 MCP（Model Context Protocol）服务的命令行工具。","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-BFq88gxc8VkOWLmqhuYqpA15mhUscyEwW7YElthSLy/PhMG+HVpj7GF6itsHnZeyNCWoSfiDcRLbDHOhwAEhFg==","shasum":"f4cc45a2058131300406e60c7068d7bba7dd1562","tarball":"https://registry.npmjs.org/@anshiyatai/jzcq/-/jzcq-0.1.1.tgz","fileCount":3,"unpackedSize":15059,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDsAcrCRpAWWvJzokYXuTqmQjXgLq651X+1wHqRNilGpAiAW0Q/c6FAXc2nEqTJlKwamBSdLwTMMSvzKwS8eKSf7MQ=="}]},"_npmUser":{"name":"qiaoshic","email":"qiaoyadong@outlook.com"},"directories":{},"maintainers":[{"name":"qiaoshic","email":"qiaoyadong@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jzcq_0.1.1_1781690305531_0.5240947454751468"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-17T09:58:25.406Z","0.1.1":"2026-06-17T09:58:25.655Z","modified":"2026-06-17T09:58:25.909Z"},"maintainers":[{"name":"qiaoshic","email":"qiaoyadong@outlook.com"}],"description":"终端直接调用精智萃取 MCP（Model Context Protocol）服务的命令行工具。","readme":"# @anshiyatai/jzcq\n\n终端直接调用精智萃取 MCP（Model Context Protocol）服务的命令行工具。\n\n## 安装\n\n```bash\nnpm install -g @anshiyatai/jzcq\n```\n\n## 配置\n\n### 当前终端会话（临时）\n\n仅对当前终端窗口有效，关闭终端或重启电脑后失效：\n\n```bash\nexport JZCQ_MCP_BASE_URL=https://your-domain.com\nexport JZCQ_MCP_TOKEN=your-mcp-token\n```\n\n### 全局配置（永久生效）\n\n将环境变量写入 Shell 配置文件，每次开机自动加载，**只需配置一次**。\n\n#### macOS\n\nZsh（macOS 默认 Shell），编辑 `~/.zshrc`：\n\n```bash\necho 'export JZCQ_MCP_BASE_URL=https://your-domain.com' >> ~/.zshrc\necho 'export JZCQ_MCP_TOKEN=your-mcp-token' >> ~/.zshrc\nsource ~/.zshrc\n```\n\n如果使用 Bash，编辑 `~/.bash_profile`：\n\n```bash\necho 'export JZCQ_MCP_BASE_URL=https://your-domain.com' >> ~/.bash_profile\necho 'export JZCQ_MCP_TOKEN=your-mcp-token' >> ~/.bash_profile\nsource ~/.bash_profile\n```\n\n#### Windows\n\n**方法一：系统环境变量（推荐）**\n\n1. 按 `Win + R`，输入 `sysdm.cpl` 回车\n2. 点击「高级」→「环境变量」\n3. 在「用户变量」中新建：\n   - 变量名：`JZCQ_MCP_BASE_URL`，值：`https://your-domain.com`\n   - 变量名：`JZCQ_MCP_TOKEN`，值：`your-mcp-token`\n4. 确定保存，重启终端即可生效\n\n**方法二：命令行（PowerShell）**\n\n```powershell\n[Environment]::SetEnvironmentVariable(\"JZCQ_MCP_BASE_URL\", \"https://your-domain.com\", \"User\")\n[Environment]::SetEnvironmentVariable(\"JZCQ_MCP_TOKEN\", \"your-mcp-token\", \"User\")\n```\n\n**方法三：命令行（CMD）**\n\n```cmd\nsetx JZCQ_MCP_BASE_URL \"https://your-domain.com\"\nsetx JZCQ_MCP_TOKEN \"your-mcp-token\"\n```\n\n`JZCQ_MCP_BASE_URL` 只填写系统域名，不需要包含 `/api/mcp`。\n\n## 快速开始\n\n```bash\n# 列出所有可用工具和说明\njzcq\n\n# 无参工具 — 直接调用\njzcq list_projects\n\n# 有参工具 — key=value 传参（推荐）\njzcq get_project projectId=proj_demo_001\n\n# 多个参数用空格分隔\njzcq create_project title=示例项目 description=项目描述\n```\n\n参数支持两种格式（兼容旧用法）：\n\n```bash\n# key=value（推荐）\njzcq get_project projectId=proj_demo_001\n\n# JSON 字符串\njzcq get_project '{\"projectId\":\"proj_demo_001\"}'\n```\n\n## 使用示例\n\n以下示例假设你已完成环境变量配置，且拥有一个项目 ID 为 `proj_demo_001`。\n\n### 项目管理\n\n```bash\n# 查看所有可访问的项目\njzcq list_projects\n\n# 查看某个项目的详情\njzcq get_project projectId=proj_demo_001\n\n# 搜索项目\njzcq search_projects query=客户访谈\n\n# 获取项目摘要\njzcq get_project_brief projectId=proj_demo_001\n\n# 创建新项目\njzcq create_project title=客户访谈复盘 description=项目描述\n```\n\n### 素材与知识库\n\n```bash\n# 列出项目素材\njzcq list_materials projectId=proj_demo_001\n\n# 获取素材详情\njzcq get_material materialId=mat_demo_001\n\n# 搜索项目知识库\njzcq search_project_knowledge projectId=proj_demo_001 query=专家经验 topK=5\n\n# 跨项目搜索知识库\njzcq search_all_knowledge query=萃取流程 topK=5\n\n# 查找原文证据\njzcq find_evidence query=专家经验萃取 topK=5\n```\n\n### 专家与画像\n\n```bash\n# 获取项目专家画像\njzcq get_expert_profile projectId=proj_demo_001\n\n# 获取项目知识图谱\njzcq get_knowledge_graph projectId=proj_demo_001\n\n# 列出专家库专家\njzcq list_master_experts\n\n# 搜索专家\njzcq search_master_experts query=数据治理\n\n# 查看专家详情\njzcq get_master_expert masterExpertId=exp_demo_001\n\n# 查看专家历程图\njzcq get_master_expert_timeline masterExpertId=exp_demo_001\n\n# 查看专家知识图谱\njzcq get_master_expert_knowledge_graph masterExpertId=exp_demo_001\n```\n\n### 成果与工作流\n\n```bash\n# 列出项目成果\njzcq list_works projectId=proj_demo_001\n\n# 获取成果内容\njzcq get_work workId=work_demo_001\n\n# 搜索所有成果\njzcq search_works query=访谈提纲 topK=5\n\n# 按技能列出成果\njzcq list_works_by_skill projectId=proj_demo_001 skillId=skill_001\n\n# 查看项目工作流进度\njzcq get_project_workflow_status projectId=proj_demo_001\n\n# 检查项目健康度\njzcq get_project_health projectId=proj_demo_001\n\n# 查看项目活动时间线\njzcq get_project_activity projectId=proj_demo_001\n```\n\n### 创建与写入\n\n```bash\n# 创建项目成果\njzcq create_work projectId=proj_demo_001 title=萃取结果 content=正文内容\n\n# 创建萃取结果\njzcq create_extraction_result projectId=proj_demo_001 title=萃取结果 content=正文内容\n\n# 创建专家\njzcq create_master_expert name=张三 title=技术总监 organization=某公司\n\n# 绑定专家到项目\njzcq link_master_expert_to_project projectId=proj_demo_001 masterExpertId=exp_demo_001\n\n# 创建素材记录\njzcq create_material_record projectId=proj_demo_001 fileName=访谈记录.pdf fileSize=1024000 mimeType=application/pdf storageKey=materials/doc_001.pdf storageBucket=bucket_demo_001\n\n# 启动素材解析\njzcq start_material_processing materialId=mat_demo_001\n\n# 从模板创建工作流\njzcq create_project_workflow_from_template projectId=proj_demo_001 templateId=tpl_001\n\n# 提交技能成果并推进流程\njzcq submit_skill_result projectId=proj_demo_001 skillId=skill_001 title=访谈提纲 content=正文内容\n```\n\n### 组合使用（Shell 管道）\n\n```bash\n# 列出项目列表，提取项目 ID\njzcq list_projects | jq '.[].id'\n\n# 查看项目名称\njzcq get_project projectId=proj_demo_001 | jq '{title}'\n\n# 批量查看所有项目的摘要\nfor id in $(jzcq list_projects | jq -r '.[].id'); do\n  echo \"=== 项目 $id ===\"\n  jzcq get_project_brief projectId=$id | jq '.title'\ndone\n```\n\n## 可用工具\n\n### 项目与查询\n\n| 工具名              | 参数        | 说明                 |\n| ------------------- | ----------- | -------------------- |\n| `list_projects`     | 无          | 列出可访问的萃取项目 |\n| `get_project`       | `projectId` | 获取项目详情         |\n| `search_projects`   | `query`     | 搜索项目             |\n| `get_project_brief` | `projectId` | 获取项目摘要         |\n\n### 素材与知识库\n\n| 工具名                     | 参数                               | 说明             |\n| -------------------------- | ---------------------------------- | ---------------- |\n| `list_materials`           | `projectId`                        | 列出项目素材     |\n| `get_material`             | `materialId`                       | 获取素材内容     |\n| `search_project_knowledge` | `projectId`, `query`, `topK`(可选) | 搜索项目知识库   |\n| `search_all_knowledge`     | `query`, `topK`(可选)              | 跨项目搜索知识库 |\n| `find_evidence`            | `query`, `topK`(可选)              | 查找原文证据     |\n\n### 专家与图谱\n\n| 工具名                              | 参数             | 说明             |\n| ----------------------------------- | ---------------- | ---------------- |\n| `get_expert_profile`                | `projectId`      | 获取专家画像     |\n| `get_knowledge_graph`               | `projectId`      | 获取知识图谱     |\n| `list_master_experts`               | 无               | 列出专家库专家   |\n| `get_master_expert`                 | `masterExpertId` | 查看专家详情     |\n| `get_master_expert_timeline`        | `masterExpertId` | 查看专家历程图   |\n| `get_master_expert_knowledge_graph` | `masterExpertId` | 查看专家知识图谱 |\n| `search_master_experts`             | `query`          | 搜索专家         |\n| `list_master_expert_results`        | `masterExpertId` | 列出专家成果库   |\n\n### 成果与工作流\n\n| 工具名                        | 参数                   | 说明             |\n| ----------------------------- | ---------------------- | ---------------- |\n| `list_works`                  | `projectId`            | 列出项目成果     |\n| `get_work`                    | `workId`               | 获取成果内容     |\n| `search_works`                | `query`, `topK`(可选)  | 搜索所有成果     |\n| `list_works_by_skill`         | `projectId`, `skillId` | 按技能列出成果   |\n| `get_project_workflow_status` | `projectId`            | 查看工作流进度   |\n| `get_project_health`          | `projectId`            | 检查项目健康度   |\n| `get_project_material_status` | `projectId`            | 查看素材解析状态 |\n| `get_project_activity`        | `projectId`            | 查看活动时间线   |\n| `list_project_conversations`  | `projectId`            | 列出项目对话     |\n| `list_workflow_templates`     | 无                     | 列出工作流模板   |\n| `get_workflow_template`       | `templateId`           | 查看工作流模板   |\n| `list_skills`                 | 无                     | 列出萃取技能     |\n\n### 创建与写入\n\n| 工具名                                  | 参数                                                                                                                     | 说明             |\n| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ---------------- |\n| `create_project`                        | `title`, `description`(可选), `icon`(可选), `color`(可选), `workflowTemplateId`(可选)                                    | 创建项目         |\n| `create_work`                           | `projectId`, `title`, `content`, `conversationId`(可选), `skillId`(可选), `type`(可选)                                   | 创建成果         |\n| `create_extraction_result`              | `projectId`, `title`, `content`, `conversationId`(可选), `skillId`(可选)                                                 | 创建萃取结果     |\n| `create_master_expert`                  | `name`, `title`(可选), `department`(可选), `organization`(可选), `yearsOfExperience`(可选), `bio`(可选), `domains`(可选) | 创建专家         |\n| `link_master_expert_to_project`         | `projectId`, `masterExpertId`                                                                                            | 绑定专家到项目   |\n| `create_material_record`                | `projectId`, `fileName`, `fileSize`, `mimeType`, `storageKey`, `storageBucket`                                           | 创建素材记录     |\n| `start_material_processing`             | `materialId`                                                                                                             | 启动素材解析     |\n| `create_project_workflow_from_template` | `projectId`, `templateId`                                                                                                | 从模板创建工作流 |\n| `submit_skill_result`                   | `projectId`, `skillId`, `title`, `content`, `type`(可选), `conversationId`(可选), `workflowId`(可选)                     | 提交技能成果     |\n\n## 发布前检查\n\n```bash\npnpm typecheck\npnpm lint\nnode --check scripts/mcp-cli.mjs\nnpm pack --dry-run\n```\n\n确认项：\n\n- 包名是 `@anshiyatai/jzcq`\n- CLI 命令名是 `jzcq`\n- `scripts/mcp-cli.mjs` 与 `scripts/mcp-cli.ts` 同步\n- 文档不包含真实 token、真实客户 ID、内部 IP 或内网域名\n- 发布前已具备 `@anshiyatai` npm 组织权限\n\n## 依赖\n\n- Node.js 20+\n","readmeFilename":"README.md","_rev":"1-5533d1b3bd93e554886516fc87d182b8"}